Kako migrirati s Claude Code na Codex leta 2026: vodnik po korakih

Dokumentacija Ailoot: API, ključi in nastavitev.

Zakaj sploh potrebujemo orodje za migracijo v Codex?#

OpenAI je funkcijo dodal v Codex v začetku junija 2026. V uradnem dnevniku sprememb je kratko opisana:

Z drugimi besedami: ob prvem zagonu Codex App ali v nastavitvah že zagnanega odjemalca se zažene čarovnik, ki prebere lokalne konfiguracije drugega agenta. Trenutno sta podprta Claude Code in Claude Cowork.

Razlogi, zakaj OpenAI to počne, so jasni. Po zagonu Sites in posodobitvi Codex App maja–junija 2026 je Codex dobil vse, v čemer je Claude Code prej prekašal OpenAI: terminal, vtičnike, dolge seje in orkestracijo. Migracija odstrani še zadnjo oviro za ekipe, ki so Claude Code že vključile v svoj sklad: »podprte nastavitve je mogoče uvoziti in nato preveriti glede na izvirni popis«.

Manj jasno je, zakaj bi ga morda potrebovali vi. V vodniku Codex proti Claude Code sem ju primerjal neposredno: Claude je še vedno boljši pri dolgih arhitekturnih razpravah in Plan Mode, Codex pa je hitrejši pri samostojnih opravilih in vzporednih PR-jih. Če ste se odločili za popoln prehod, berite naprej. Če razmišljate o kombinaciji, so morda primernejši vzorci sodelovanja.

Kaj orodje za migracijo prenese samodejno?#

Pregledal bom posamezne skupine in natančno pojasnil, kaj se zgodi z vsakim delom mape ~/.claude.

1. Navodila in kontekst. Datoteke CLAUDE.md – globalna datoteka v ~/.claude/ in projektne datoteke v repozitorijih – se pretvorijo v obliko AGENTS.md. Globalna datoteka se znajde v ~/.codex/AGENTS.md; projektne datoteke ostanejo v korenski mapi repozitorija in podmapah. Oblika AGENTS.md je v bistvu ista vrsta datoteke Markdown s pravili; razlike so večinoma kozmetične – imena razdelkov in nekaj posebnih direktiv. Pojasnil sem, kaj je AGENTS.md in zakaj ga Codex potrebuje.

2. Veščine. Mapa ~/.claude/skills/ se pregleda v celoti; vsaka veščina se prilagodi strukturi Codexa in shrani v $HOME/.agents/skills. Projektne veščine iz .claude/skills/ v repozitoriju se premaknejo v .agents/skills. Oblika SKILL.md z metapodatki v glavi se prenese skoraj nespremenjena. Če veščina uporablja sprožilce, značilne za Claude, je označena za pregled.

3. Strežniki MCP. Konfiguracija .mcp.json (globalna in na ravni projekta) se uvozi v obliko Codexa. Imena strežnikov, ukazi za zagon in poti se ohranijo. Ne prenesejo se žetoni in spremenljivke okolja. Iz varnostnih razlogov vas bo Codex znova prosil za ključe API in gesla, da med migracijo ne bodo izpostavljeni. To je enkratno opravilo: odprite razdelek MCP v Codex App in vnesite žetone, ki jih že imate v upravljalniku gesel.

4. Hooks. To je zapletena skupina. Hooks z deterministično logiko (blokiranje rm -rf, opozarjanje na poti, ki so videti kot poverilnice, beleženje dokazov) se prenesejo v celoti. Hooks s sprožilci, ki v Codexu nimajo ustreznice (na primer določeni dogodki življenjskega cikla Claude Code), so označeni za »manual review« in se ne aktivirajo samodejno. Podrobno sem pojasnil, kako delujejo hooks v Claude Code, kot izhodišče za primerjavo – Codex ima manj vrst.

5. Zgodovina sej. Do zadnjih 30 dni dejavnosti v Claude Code se uvozi kot referenca. To ne pomeni »nadaljuj natanko tam, kjer si končal«, vendar bodo vaši pretekli pogovori vidni v Codexu, zato boste lahko hitro priklicali kontekst projekta, ne da bi morali vse znova razlagati.

Orodje za migracijo ne razlikuje med aktivnimi datotekami in eksperimentalnimi artefakti – prenese vse. Po migraciji je koristno ročno počistiti vse, česar niste uporabljali zadnjih šest mesecev.

Kaj se NE prenese in zakaj?#

Vsako skupino bom predstavil z vidika »kaj storiti po migraciji«.

Žetoni MCP in ključi API. To je najbolj predvidljiv del. Po pregledu vam Codex prikaže seznam vseh strežnikov MCP, ki jih je našel v Claudeu. Za vsakega bo zahteval ključe in žetone. Najlažje je, da imate pri roki upravljalnik gesel in v enem zamahu uredite vse strežnike. Nato MCP deluje enako v Codexu in Claude Code. V dokumentaciji izbranega strežnika MCP preverite ukaz in parametre povezave.

Poševni ukazi /name. V Claude Code ste navajeni veščino poklicati z /skill-name. V Codexu je kanonični način klicanja drugačen: $skill-name. Pogosta napaka pri migraciji je, da ukaze /name razumete kot dokaz, da so se veščine naložile.

Po migraciji v Codexu preizkusite nekaj ključnih veščin z $skill-name. Če delujejo, je migracija res uspela. Ne zaupajte potrditvenemu polju »skills migrated« v čarovniku – preverite jih tako, da jih pokličete.

Hooks brez ustreznice v Codexu. Če ste imeli hook za določene dogodke Claude Code – na primer ob pre-tool-use za določeno kombinacijo orodij –, ta sprožilec v Codexu morda ne obstaja. Orodje za migracijo jih bo označilo in pustilo neaktivne. Odločiti se boste morali, ali jih boste prepisali za ustreznico v Codexu, opustili ali obdržali v Claude Code (če ga izvajate vzporedno). Dobro pravilo: prenesite samo deterministične hooks; vse drugo je razlog, da novega orodja ne obremenite s podvajanjem lestve.

Ekipni poteki dela, zgrajeni na podagentih. Pojasnil sem, kaj so podagenti v Claude Code in kako uporabljati ugnezdene podagente. V Codexu se podagenti organizirajo prek profilov in vlog (glejte spodaj). Če ste imeli v Claudeu zapleten cevovod z več podagenti v verigi, ga boste morali prepisati po konceptu profilov v Codexu. Orodje za migracijo takšne nastavitve označi z »requires architectural rework«.

Obsežne datoteke CLAUDE.md, značilne za Claude. Če je datoteka narasla na 2.000–3.000 vrstic z razdelki za vsak projekt, jo Codex morda sprejme, vendar je to slab vzorec. AGENTS.md je zasnovan tako, da je strnjen in porazdeljen: globalna pravila v ~/.codex/AGENTS.md, projektna pravila v korenski mapi repozitorija in ozke izjeme v podmapah. Po migraciji ne pustite CLAUDE.md kot »orjaške datoteke z navodili«; razdelite ga po ravneh. Pojasnil sem, kako pravilno nastaviti CLAUDE.md; enak pristop velja za AGENTS.md.

Korak za korakom: 4 dejanja v Codex App#

Tukaj je natančen kontrolni seznam.

1. 1. korak: posodobite Codex App na različico 26.608 ali novejšo

   Orodje za migracijo se je pojavilo v različici 26.608 (izdani 9. junija 2026). V macOS odprite Codex App in preverite, ali so na voljo posodobitve. Enako storite v sistemu Windows. Če uporabljate Codex CLI, se prepričajte, da je združljiv s trenutno različico App. Brez najnovejše različice se »Import other agent setup« ne bo prikazal v Settings.

2. 2. korak: začnite uvoz v Settings

   V Codex App odprite Settings in poiščite »Import other agent setup«. Če ste Codex App pravkar namestili, bo čarovnik ponudil migracijo med začetno nastavitvijo. Ko jo zaženete, čarovnik pregleda datotečni sistem: ~/.claude/ in repozitorije, ki vsebujejo CLAUDE.md ali .claude/. Pregled traja od 30 sekund do nekaj minut, odvisno od števila datotek.

3. 3. korak: potrdite načrt migracije

   Po pregledu vam Codex prikaže popis: koliko veščin je našel, koliko strežnikov MCP, koliko datotek CLAUDE.md je našel, kateri hooks so primerni za migracijo in koliko dni zgodovine sej je na voljo. Počistite lahko izbiro pri vseh skupinah, ki jih ne želite prenesti. Privzeto je izbrano vse, kar Codex oceni kot varno za uvoz.

4. 4. korak: počakajte na zaključek in vnesite žetone

   Uvoz traja 1–5 minut. Ko se konča, Codex odpre nadaljnje okno: »tega nisem mogel samodejno prenesti; preverite ročno«. Običajno je to seznam strežnikov MCP, ki potrebujejo žetone. Odprite upravljalnik gesel in vnesite ključe v obrazec Codex. S tem je glavni del migracije končan.

Nato preverite rezultat. Odprite projekt, na katerem ste običajno delali v Claude Code, in preverite:

• cat ~/.codex/AGENTS.md — ali so tam vaša globalna pravila?
• Zaženite poljubno veščino: $skill-name. Morala bi se naložiti.
• Odprite .mcp.json v projektu in preverite, ali potrebni strežniki delujejo.
• Začnite pogovor, ki odraža vaš običajni način dela. Codex bo pokazal, katerih uvoženih hookov ne more uporabljati; to so konkretne postavke popisa za ročno obdelavo; stalni preostali delež ni potrjen.

Hooks in podagenti: ustreznice v Codexu in kaj je treba prepisati#

Hooks. V Claude Code lahko vsakemu dogodku življenjskega cikla pripnete ukaz lupine (pre-tool-use, post-tool-use, on-error, on-context-load in tako naprej). Codex ima manjši nabor dogodkov: pred izvajanjem lahko opravi preverjanje, zabeleži dokaze in blokira nevarne ukaze. Če ste imeli hook pre-tool-use, ki je filtriral določeno kombinacijo, ga boste morali v Codexu vključiti v splošno preverjanje pred izvajanjem ali ga opustiti. Podrobno sem pojasnil arhitekturo hookov Claude Code; če ste jih obsežno uporabljali, za vsak sprožilec naštejte zahtevani učinek, poiščite podprto ustreznico in jo pred vklopom preverite.

Podagenti. V Claude Code je podagent ločen kontekst z lastnim sistemskim pozivom, ki se zažene prek /command ali iz glavnega pogovora. Codex ima podoben koncept v profilih: določite lahko profil s posebnim naborom veščin, dovoljenj in pravilom odobritve. Profili rešujejo približno isti problem – izolacijo konteksta za določen razred opravil –, vendar prek nastavitev namesto z izrecnim klicem agenta.

Kaj to pomeni v praksi:

• Če ste imeli podagenta »security-reviewer« z lastnim pozivom, v Codexu ustvarite profil security-review z zahtevanimi dovoljenji in višjo stopnjo sklepanja.
• Če ste imeli podagenta »feature-developer«, je to preprosto privzeti delovni profil; nič posebnega ni potrebno.
• Če ste uporabljali ugnezdene podagente, tega v Codexu ni mogoče prenesti ena proti ena; premislite o verigi profilov ali izrecnih veščinah.

Orodje za migracijo bo poskusilo ustvariti profile z imeni vaših podagentov in označilo sprožilce, ki se niso prenesli. Potrebno delo je odvisno od števila vlog, sprožilcev, dovoljenj in odvisnosti; vsak potrebni cevovod preizkusite, preden ga štejete za preseljenega.

Kdaj v celoti preiti in kdaj obdržati obe orodji#

Preprost filter za odločitev:

Popoln prehod na Codex je smiseln, če:

• Večinoma delate samostojne PR-je in vzporedna opravila.
• Je vaš potek dela v GitHubu globoko integriran in Codex Cloud Agent opravi 80 % dela.
• Ne porabite veliko časa za arhitekturne razprave in Plan Mode.
• Želite plačevati za eno orodje namesto dveh.

Obdržite Claude Code in Codex skupaj, če:

• Redno uporabljate Plan Mode za dolge arhitekturne odločitve.
• Potrebujete vzporedno delo: Codex v oblaku opravlja eno nalogo, medtem ko Claude Code ohranja kontekst za drugo.
• Pogosto izvajate enkratne zvijače in mikroprojekte, pri katerih je Plan Mode pretiran.
• Imate zapleten cevovod podagentov, ki ga ni mogoče prepisati v enem večeru.

Sam uporabljam oba: Claude Code ohranja dolg pogovor, Codex pa izvaja opravila, kot sta »vzporedno odpravi N napak« ali »preglej PR«. Več o tem, kako deluje, sem pojasnil v vodniku za skupno delo s Claude Code in Codex.

Glavno sporočilo o migraciji je naslednje: orodje za migracijo odstrani tehnično oviro za prehod, ne odgovori pa na vprašanje, ali morate sploh preiti. Najprej se odločite, kakšno delo opravljate. Nato izberite orodje.

Če potrebujete dostop do nevronskih mrež prek Ailoota, obiščite Ailoot.