Hogyan migrálj Claude Code-ról Codexre 2026-ban: lépésről lépésre útmutató

Ailoot dokumentáció: API, kulcsok és beállítás.

Miért van egyáltalán szükség a Codex Migráció eszközére?#

Az OpenAI 2026 júniusának elején adta hozzá ezt a funkciót a Codexhez. A hivatalos változásnapló röviden így fogalmaz:

Más szóval: a Codex App első indításakor vagy egy már futó kliens beállításaiból elindul egy varázsló, amely beolvassa egy másik ügynök helyi konfigurációit. Jelenleg a Claude Code és a Claude Cowork támogatott.

Világos, miért teszi ezt az OpenAI. A Sites elindítása és a Codex App 2026. május–júniusi frissítése után a Codex megkapott mindent, amivel a Claude Code korábban az OpenAI előtt járt: terminált, bővítményeket, hosszú munkameneteket és orchestrációt. A migráció megszünteti az utolsó akadályt azoknak a csapatoknak, amelyek már beépítették a Claude Code-ot a technológiai rendszerükbe: „a támogatott beállítások importálhatók, majd összevethetők az eredeti leltárral.”

Az már kevésbé egyértelmű, hogy neked miért lehet szükséged rá. A Codex és Claude Code összehasonlító útmutatójában közvetlenül összevetettem őket: a Claude továbbra is jobb a hosszú architekturális megbeszélésekben és a Plan Mode-ban, míg a Codex gyorsabb az önálló feladatokban és a párhuzamos PR-ekben. Ha már eldöntötted, hogy teljesen váltasz, olvass tovább. Ha a kettő kombinálását fontolgatod, a közös munkavégzési minták hasznosabbak lehetnek.

Mit visz át automatikusan a Migráció eszköz?#

Végigveszem a csoportokat, és pontosan elmagyarázom, mi történik a ~/.claude minden egyes részével.

1. Utasítások és kontextus. A CLAUDE.md fájlok – a ~/.claude/ mappában lévő globális fájl és a repozitóriumok projektfájljai – AGENTS.md formátumúvá alakulnak. A globális fájl a ~/.codex/AGENTS.md útvonalra kerül; a projektfájlok a repozitórium gyökerében és almappáiban maradnak. Az AGENTS.md formátum lényegében ugyanolyan, szabályokat tartalmazó Markdown-fájl; a különbségek többnyire kozmetikaiak – a szakaszok nevei és néhány konkrét direktíva tér el. Elmagyaráztam, mi az AGENTS.md, és miért van rá szüksége a Codexnek.

2. Skillek. A ~/.claude/skills/ mappát teljes egészében átvizsgálja; minden skillt a Codex struktúrájához igazít, majd a $HOME/.agents/skills mappába helyez. A repozitórium .claude/skills/ mappájában található projektskillek az .agents/skills mappába kerülnek. A frontmattert tartalmazó SKILL.md formátum szinte változtatás nélkül átkerül. Ha egy skill Claude-specifikus triggereket használ, ellenőrzésre jelöli.

3. MCP-szerverek. A .mcp.json konfiguráció (globális és projektszintű egyaránt) Codex-formátumban kerül importálásra. A szervernevek, az indítóparancsok és az elérési utak megmaradnak. Ami nem kerül át: tokenek és környezeti változók. Biztonsági okokból a Codex ismét elkéri az API-kulcsokat és jelszavakat, így azok nem kerülnek nyilvánosságra a migráció során. Ezt csak egyszer kell megtenni: nyisd meg a Codex App MCP-szakaszát, és írd be a jelszókezelődben már meglévő tokeneket.

4. Hookok. Ez a bonyolult csoport. A determinisztikus logikájú hookok (az rm -rf blokkolása, a hitelesítő adatokra hasonlító elérési utak jelzése, bizonyítékok rögzítése) teljes egészében átkerülnek. Azokat a hookokat, amelyek olyan triggerekhez kapcsolódnak, amelyeknek nincs megfelelőjük a Codexben (például bizonyos Claude Code-életciklus-eseményekhez), „manual review” jelöléssel látja el, és nem aktiválja automatikusan. Részletesen elmagyaráztam, hogyan működnek a hookok a Claude Code-ban; ez viszonyítási alapként szolgál – a Codexben kevesebb típus van.

5. Munkamenet-előzmények. A Claude Code legutóbbi 30 napnyi tevékenységét referenciaként importálja. Ez nem azt jelenti, hogy „pontosan ott folytathatod, ahol abbahagytad”, de a korábbi beszélgetéseid láthatók lesznek a Codexben, így gyorsan felidézheted a projekt kontextusát anélkül, hogy mindent újra el kellene magyaráznod.

A Migráció eszköz nem tesz különbséget az aktív fájlok és a kísérleti melléktermékek között – mindent átvisz. A migráció után érdemes manuálisan kitakarítani mindazt, amit az elmúlt hat hónapban nem használtál.

Mi NEM kerül át, és miért?#

Mindegyik csoportot abból a szempontból veszem végig, hogy „mit kell tenni a migráció után”.

MCP-tokenek és API-kulcsok. Ez a legkiszámíthatóbb rész. A vizsgálat után a Codex megmutatja a Claude-ban talált összes MCP-szervert. Mindegyikhez elkéri a kulcsokat és tokeneket. A legegyszerűbb, ha kéznél van a jelszókezelőd, és egy menetben végigmész az összes szerveren. Ezután az MCP ugyanúgy működik a Codexben és a Claude Code-ban. Ellenőrizd a választott MCP-szerver parancsát és kapcsolati paramétereit a dokumentációja alapján.

Perjeles parancsok: /name. A Claude Code-ban megszoktad, hogy egy skillt a /skill-name formával hívsz meg. A Codexben más a kanonikus hívás: $skill-name. Gyakori migrációs hiba a /name parancsokat annak bizonyítékának tekinteni, hogy a skillek betöltődtek.

A migráció után tesztelj néhány fontos skillt a Codexben a $skill-name formával. Ha működnek, a migráció valóban sikerült. Ne bízz a varázsló „skills migrated” jelölőnégyzetében – ellenőrizd a skillek meghívásával.

A Codexben nem létező megfelelővel rendelkező hookok. Ha egy hookot bizonyos Claude Code-eseményekhez használtál – például pre-tool-use eseményhez, egy adott eszközkombináció esetén –, ez a trigger nem biztos, hogy létezik a Codexben. A Migráció eszköz megjelöli ezeket, és inaktív állapotban hagyja. Neked kell eldöntened, hogy átírod-e őket egy Codex-kompatibilis megoldássá, elhagyod, vagy megtartod a Claude Code-ban (ha párhuzamosan futtatod). Egy jó ökölszabály: csak a determinisztikus hookokat vidd át; minden más ok arra, hogy ne építsd újra a teljes létrát az új eszközben.

Alügynökökre épülő csapatmunkafolyamatok. Elmagyaráztam, mik az alügynökök a Claude Code-ban, és hogyan használhatók a beágyazott alügynökök. A Codexben az alügynökök profilok és szerepkörök segítségével szervezhetők (lásd alább). Ha Claude-ban összetett, több alügynökből álló, láncolt folyamatod volt, át kell írnod a Codex profilkoncepciója köré. A Migráció eszköz az ilyen beállításokat „requires architectural rework” jelöléssel látja el.

Nagy, Claude-specifikus CLAUDE.md fájlok. Ha egy fájl 2 000–3 000 sorosra nőtt, és minden projekthez külön szakasz tartozik benne, a Codex talán elfogadja, de ez rossz minta. Az AGENTS.md tömör és elosztott működésre készült: a globális szabályok a ~/.codex/AGENTS.md fájlba kerülnek, a projektspecifikus szabályok a repozitórium gyökerébe, a szűkebb felülírások pedig az almappákba. A migráció után ne hagyd a CLAUDE.md fájlt „óriási utasításfájlként”; bontsd szét több szintre. Elmagyaráztam, hogyan kell helyesen beállítani a CLAUDE.md fájlt; ugyanez a megközelítés az AGENTS.md fájlra is alkalmazható.

Lépésről lépésre: 4 művelet a Codex Appban#

Íme a konkrét ellenőrzőlista.

1. 1. lépés: Frissítsd a Codex Appot a 26.608-as vagy újabb verzióra

   A Migráció eszköz a 26.608-as verzióban jelent meg (2026. június 9-én adták ki). macOS-en nyisd meg a Codex Appot, és ellenőrizd a frissítéseket. Ugyanezt tedd meg Windows rendszeren is. Ha a Codex CLI-t futtatod, ellenőrizd, hogy kompatibilis-e a jelenlegi Appal. A legújabb verzió nélkül az „Import other agent setup” nem jelenik meg a Beállításokban.

2. 2. lépés: Indítsd el az importálást a Beállításokból

   A Codex Appban nyisd meg a Beállításokat, és keresd meg az „Import other agent setup” lehetőséget. Ha most telepítetted a Codex Appot, a varázsló a kezdeti beállítás során ajánlja fel a migrációt. Az indítás után a varázsló átvizsgálja a fájlrendszert: a ~/.claude/ mappát és azokat a repozitóriumokat, amelyek CLAUDE.md fájlt vagy .claude/ mappát tartalmaznak. A vizsgálat 30 másodperctől néhány percig tarthat, a fájlok számától függően.

3. 3. lépés: Erősítsd meg a migrációs tervet

   A vizsgálat után a Codex megjelenít egy leltárt: hány skillt és MCP-szervert talált, hány CLAUDE.md fájlt talált, mely hookok jogosultak a migrációra, és hány napnyi munkamenet-előzmény áll rendelkezésre. Bármelyik csoportnál törölheted a jelölést, ha nem akarod átvinni. Alapértelmezés szerint minden ki van jelölve, amit a Codex biztonságosan importálhatónak tart.

4. 4. lépés: Várd meg a befejezést, és add meg a tokeneket

   Az importálás 1–5 percet vesz igénybe. Amikor befejeződik, a Codex egy követőablakot nyit meg: „ezeket nem tudtam automatikusan átvinni; ellenőrizd manuálisan”. Ez általában az MCP-szerverek listája, amelyekhez tokenek szükségesek. Nyisd meg a jelszókezelődet, és írd be a kulcsokat a Codex űrlapjába. Ezzel befejeződik a migráció fő része.

Ezután ellenőrizd az eredményt. Nyiss meg egy projektet, amelyen általában a Claude Code-ban dolgoztál, és ellenőrizd a következőket:

• cat ~/.codex/AGENTS.md — ott vannak a globális szabályaid?
• Futtass egy tetszőleges skillt: $skill-name. Be kell töltődnie.
• Nyisd meg a projektben a .mcp.json fájlt, és ellenőrizd, hogy futnak-e a szükséges szerverek.
• Indíts egy, a szokásos munkamódszeredet tükröző beszélgetést. A Codex megmutatja, mely importált hookokat nem tudja használni; ezek a saját leltárad konkrét, manuálisan kezelendő elemei; nincs megállapított, állandó maradékarány.

Hookok és alügynökök: Codex-megfelelők és az átírandó elemek#

Hookok. A Claude Code-ban minden életciklus-eseményhez shellparancsot rendelhetsz (pre-tool-use, post-tool-use, on-error, on-context-load és így tovább). A Codex kevesebb eseményt kínál: végrehajtás előtt ellenőrizhet, bizonyítékot rögzíthet és veszélyes parancsokat blokkolhat. Ha volt egy pre-tool-use hookod, amely egy adott kombinációra szűrt, a Codexben ezt általános végrehajtás előtti ellenőrzésbe kell csomagolnod, vagy el kell hagynod. Részletesen ismertettem a Claude Code hookjainak architektúráját; ha széles körben használtad őket, sorold fel az egyes kiváltó eseményeket és a kívánt hatásukat, keress támogatott megfelelőket, és ellenőrizd őket, mielőtt engedélyezed.

Alügynökök. A Claude Code-ban az alügynök egy külön kontextus, saját rendszerprompttal, amelyet egy /command paranccsal vagy a fő beszélgetésből indítasz el. A Codexben a profilok hasonló fogalmat jelentenek: meghatározhatsz egy profilt adott skillkészlettel, jogosultságokkal és jóváhagyási szabályzattal. A profilok nagyjából ugyanazt a problémát oldják meg – egy adott feladatcsoporthoz tartozó kontextus elkülönítését –, de explicit ügynökhívás helyett beállításokon keresztül.

Mit jelent ez a gyakorlatban:

• Ha volt egy saját prompttal rendelkező „security-reviewer” alügynököd, hozz létre egy security-review profilt a Codexben a szükséges jogosultságokkal és magasabb következtetési szinttel.
• Ha volt egy „feature-developer” alügynököd, az egyszerűen lehet az alapértelmezett munkaprofil; nincs szükség semmi különlegesre.
• Ha beágyazott alügynököket használtál, azok nem vihetők át egy az egyben a Codexbe; gondold újra őket profilok láncaként vagy explicit skillekként.

A Migráció eszköz megpróbál profilokat létrehozni az alügynökeid neve alapján, és megjelöli az át nem vitt triggereket. A szükséges munka a szerepkörök, kiváltó események, jogosultságok és függőségek számától függ; minden szükséges folyamatot tesztelj, mielőtt migráltnak tekinted.

Mikor érdemes teljesen átállni, és mikor érdemes mindkét eszközt megtartani?#

Egyszerű döntési szempontok:

Teljes átállás a Codexre akkor ésszerű, ha:

• Főként önálló PR-eken és párhuzamos feladatokon dolgozol.
• A GitHub-munkafolyamatod mélyen integrált, és a Codex Cloud Agent végzi a munka 80%-át.
• Nem töltesz sok időt architekturális megbeszélésekkel és Plan Mode-dal.
• Két eszköz helyett egyért szeretnél fizetni.

Tartsd meg együtt a Claude Code-ot és a Codexet, ha:

• Rendszeresen használod a Plan Mode-ot hosszú architekturális döntésekhez.
• Párhuzamos munkára van szükséged: a Codex egy feladaton dolgozik a felhőben, míg a Claude Code egy másik feladat kontextusát tartja kézben.
• Sok egyszeri hacket és mikróprojektet végzel, amelyekhez túlzás a Plan Mode.
• Olyan összetett alügynök-folyamatod van, amelyet nem lehet egyetlen este alatt átírni.

Én személy szerint mindkettőt használom: a Claude Code kezeli a hosszú beszélgetést, míg a Codex olyan feladatokat végez, mint „javíts ki párhuzamosan N hibát” vagy „nézz át egy PR-t”. Bővebben elmagyaráztam, hogyan működik ez a Claude Code-dal és a Codexszel való közös munkáról szóló útmutatóban.

A migrációval kapcsolatban a legfontosabb, amit mondanék: a Migráció eszköz megszünteti a váltás technikai akadályát, de arra nem ad választ, hogy egyáltalán váltanod kell-e. Először döntsd el, milyen munkát végzel. Utána válaszd ki az eszközt.

Ha az Ailooton keresztül szeretnél hozzáférni neurális hálózatokhoz, nézd meg az Ailootot.