Ako migrovať z Claude Code na Codex v roku 2026: podrobný návod

Dokumentácia Ailoot: API, kľúče a nastavenie.

Prečo je nástroj Migration v Codexe vôbec potrebný?#

OpenAI pridala túto funkciu do Codexu začiatkom júna 2026. Oficiálny changelog to stručne opisuje takto:

Inými slovami: pri prvom spustení aplikácie Codex alebo v nastaveniach už spusteného klienta sa otvorí sprievodca, ktorý prečíta miestne konfigurácie iného agenta. V súčasnosti sú podporované Claude Code a Claude Cowork.

Dôvod, prečo to OpenAI robí, je jasný. Po spustení Sites a aktualizácii aplikácie Codex v máji až júni 2026 získal Codex všetko, v čom malo Claude Code predtým oproti OpenAI náskok: terminál, doplnky, dlhé relácie a orchestráciu. Migrácia odstraňuje poslednú prekážku pre tímy, ktoré už Claude Code integrovali do svojho technologického stacku: „podporované nastavenia možno importovať a potom porovnať s pôvodným inventárom“.

Dôvod, prečo by ste ho mohli potrebovať, je menej jednoznačný. Porovnal som ich priamo v sprievodcovi Codex vs. Claude Code: Claude má stále navrch pri dlhých architektonických diskusiách a režime Plan Mode, zatiaľ čo Codex je rýchlejší pri autonómnych úlohách a paralelných PR. Ak ste sa rozhodli úplne prejsť, čítajte ďalej. Ak zvažujete kombináciu, relevantnejšie môžu byť vzory spolupráce.

Čo nástroj Migration prenáša automaticky?#

Prejdem jednotlivé skupiny a presne vysvetlím, čo sa stane s každou časťou ~/.claude.

1. Pokyny a kontext. Súbory CLAUDE.md — globálny súbor v ~/.claude/ aj projektové súbory v repozitároch — sa konvertujú do formátu AGENTS.md. Globálny súbor sa uloží do ~/.codex/AGENTS.md; projektové súbory zostanú v koreňovom priečinku repozitára a v podpriečinkoch. Formát AGENTS.md je v podstate rovnaký typ súboru Markdown s pravidlami; rozdiely sú prevažne kozmetické — názvy sekcií a niekoľko konkrétnych direktív. Vysvetlil som čo je AGENTS.md a prečo ho Codex potrebuje.

2. Skills. Priečinok ~/.claude/skills/ sa celý skontroluje; každé skill sa prispôsobí štruktúre Codexu a uloží do $HOME/.agents/skills. Projektové skills z .claude/skills/ v repozitári sa presunú do .agents/skills. Formát SKILL.md s frontmatter sa prenesie takmer bez zmien. Ak skill používa spúšťače špecifické pre Claude, označí sa na kontrolu.

3. Servery MCP. Konfigurácia .mcp.json (globálna aj na úrovni projektu) sa importuje do formátu Codexu. Názvy serverov, príkazy na spustenie a cesty sa zachovajú. Čo sa neprenesie: tokeny a premenné prostredia. Z bezpečnostných dôvodov vás Codex znova požiada o kľúče API a heslá, aby sa počas migrácie neodhalili. Ide o jednorazovú úlohu: otvorte sekciu MCP v aplikácii Codex a zadajte tokeny, ktoré už máte v správcovi hesiel.

4. Hooks. Toto je komplikovaná skupina. Hooks s deterministickou logikou (blokovanie rm -rf, upozornenie na cesty pripomínajúce prihlasovacie údaje, zaznamenávanie dôkazov) sa prenesú v plnom rozsahu. Hooks so spúšťačmi, ktoré nemajú v Codexe ekvivalent (napríklad konkrétne udalosti životného cyklu Claude Code), sa označia na „manuálnu kontrolu“ a automaticky sa neaktivujú. Podrobne som vysvetlil ako fungujú hooks v Claude Code; poslúži to ako referenčný bod — Codex má menej typov.

5. História relácií. Až posledných 30 dní aktivity v Claude Code sa importuje ako referencia. Neznamená to „pokračovať presne tam, kde ste skončili“, ale predchádzajúce konverzácie budú v Codexe viditeľné, takže si rýchlo vybavíte kontext projektu bez toho, aby ste museli všetko znova vysvetľovať.

Nástroj Migration nerozlišuje medzi aktívnymi súbormi a experimentálnymi artefaktmi — prenesie všetko. Po migrácii je užitočné manuálne vyčistiť všetko, čo ste za posledných šesť mesiacov nepoužívali.

Čo sa NEPRENÁŠA a prečo?#

Prejdem každú skupinu z pohľadu „čo robiť po migrácii“.

Tokeny MCP a kľúče API. Toto je najpredvídateľnejšia časť. Po skenovaní vám Codex zobrazí zoznam všetkých serverov MCP, ktoré našiel v Claude. Pri každom si vypýta kľúče a tokeny. Najjednoduchšie bude mať poruke správcu hesiel a prejsť všetky servery naraz. Potom MCP funguje v Codexe rovnako ako v Claude Code. Skontrolujte príkaz a parametre pripojenia vybraného servera MCP podľa jeho dokumentácie.

Lomkové príkazy /name. V Claude Code ste zvyknutí vyvolať skill pomocou /skill-name. V Codexe je štandardné vyvolanie iné: $skill-name. Častou chybou pri migrácii je považovať príkazy /name za dôkaz, že sa skills načítali.

Po migrácii otestujte niekoľko kľúčových skills v Codexe pomocou $skill-name. Ak fungujú, migrácia sa naozaj podarila. Nedôverujte začiarkavaciemu políčku „skills migrated“ v sprievodcovi — overte to ich vyvolaním.

Hooks bez ekvivalentu v Codexe. Ak ste mali hook pre konkrétne udalosti Claude Code — napríklad na pre-tool-use pre určitú kombináciu nástrojov — taký spúšťač v Codexe nemusí existovať. Nástroj Migration ho označí a ponechá neaktívny. Budete sa musieť rozhodnúť, či ho prepíšete tak, aby zodpovedal Codexu, zahodíte ho alebo ho ponecháte v Claude Code (ak ho používate súbežne). Dobré pravidlo: prenášajte len deterministické hooks; všetko ostatné je dôvodom, aby ste v novom nástroji neduplikovali celý rebrík.

Tímové pracovné postupy postavené na subagents. Vysvetlil som čo sú subagents v Claude Code a ako používať vnorené subagents. V Codexe sa subagents organizujú prostredníctvom profilov a rolí (pozri nižšie). Ak ste mali v Claude zložitý postup s viacerými subagents v reťazci, budete ho musieť prepísať podľa konceptu profilov v Codexe. Nástroj Migration takéto nastavenia označí ako „vyžadujú architektonické prepracovanie“.

Rozsiahle súbory CLAUDE.md špecifické pre Claude. Ak súbor narástol na 2 000–3 000 riadkov a obsahuje sekcie pre každý projekt, Codex ho možno prijme, ale je to zlý vzor. AGENTS.md je navrhnutý tak, aby bol stručný a rozdelený: globálne pravidlá v ~/.codex/AGENTS.md, pravidlá pre konkrétny projekt v koreňovom priečinku repozitára a úzko zamerané výnimky v podpriečinkoch. Po migrácii nenechávajte CLAUDE.md ako „obrovský súbor pokynov“; rozdeľte ho na jednotlivé úrovne. Vysvetlil som ako správne nakonfigurovať CLAUDE.md; rovnaký prístup platí aj pre AGENTS.md.

Krok za krokom: 4 úkony v aplikácii Codex#

Tu je konkrétny kontrolný zoznam.

1. Krok 1: Aktualizujte aplikáciu Codex na verziu 26.608 alebo novšiu

   Nástroj Migration sa objavil vo verzii 26.608 (vydanej 9. júna 2026). V systéme macOS otvorte aplikáciu Codex a skontrolujte aktualizácie. To isté urobte v systéme Windows. Ak používate Codex CLI, uistite sa, že je kompatibilný s aktuálnou aplikáciou. Bez najnovšej verzie sa položka „Import other agent setup“ v Nastaveniach nezobrazí.

2. Krok 2: Spustite import v Nastaveniach

   V aplikácii Codex otvorte Nastavenia a nájdite položku „Import other agent setup“. Ak ste aplikáciu Codex práve nainštalovali, sprievodca ponúkne migráciu počas úvodného nastavenia. Po spustení sprievodca skenuje súborový systém: ~/.claude/ a repozitáre obsahujúce CLAUDE.md alebo .claude/. Skenovanie trvá 30 sekúnd až niekoľko minút v závislosti od počtu súborov.

3. Krok 3: Potvrďte plán migrácie

   Po skenovaní Codex zobrazí inventár: koľko skills našiel, koľko serverov MCP, koľko súborov CLAUDE.md, ktoré hooks spĺňajú podmienky migrácie a koľko dní histórie relácií je dostupných. Zrušiť výber môžete pri každej skupine, ktorú nechcete preniesť. Predvolene je vybraté všetko, čo Codex považuje za bezpečné importovať.

4. Krok 4: Počkajte na dokončenie a zadajte tokeny

   Import trvá 1–5 minút. Po jeho dokončení Codex otvorí následné okno: „toto sa mi nepodarilo preniesť automaticky; skontrolujte to manuálne“. Zvyčajne ide o zoznam serverov MCP, ktoré potrebujú tokeny. Otvorte správcu hesiel a zadajte kľúče do formulára Codexu. Tým sa dokončí hlavná časť migrácie.

Potom overte výsledok. Otvorte projekt, na ktorom ste zvyčajne pracovali v Claude Code, a skontrolujte:

• cat ~/.codex/AGENTS.md — sú tam vaše globálne pravidlá?
• Spustite ľubovoľné skill: $skill-name. Malo by sa načítať.
• Otvorte v projekte .mcp.json a skontrolujte, či požadované servery bežia.
• Začnite konverzáciu, ktorá odráža váš typický spôsob práce. Codex zobrazí, ktoré importované hooks nedokáže použiť; ide o konkrétne položky inventára na ručné vyriešenie; pevný zvyšný podiel nie je doložený.

Hooks a subagents: ekvivalenty v Codexe a čo treba prepísať#

Hooks. V Claude Code môžete ku každej udalosti životného cyklu priradiť príkaz shellu (pre-tool-use, post-tool-use, on-error, on-context-load a podobne). Codex má menšiu množinu udalostí: dokáže kontrolovať pred spustením, zaznamenávať dôkazy a blokovať nebezpečné príkazy. Ak ste mali hook pre-tool-use, ktorý filtroval konkrétnu kombináciu, v Codexe ho budete musieť začleniť do všeobecnej kontroly pred spustením alebo ho odstrániť. Podrobne som vysvetlil architektúru hooks v Claude Code; ak ste ich používali rozsiahlo, spíšte každý spúšťač a potrebný účinok, nájdite podporovaný ekvivalent a pred zapnutím ho overte.

Subagents. V Claude Code je subagent samostatný kontext s vlastnou systémovou promptou, spustený cez /command alebo z hlavnej konverzácie. Codex má podobný koncept v profiloch: môžete definovať profil s konkrétnou množinou skills, oprávnení a zásad schvaľovania. Profily riešia približne rovnaký problém — izolujú kontext pre určitú triedu úloh — ale prostredníctvom nastavení namiesto explicitného vyvolania agenta.

Čo to znamená v praxi:

• Ak ste mali subagent „security-reviewer“ s vlastnou promptou, vytvorte v Codexe profil security-review s požadovanými oprávneniami a vyšším úsilím pri uvažovaní.
• Ak ste mali subagent „feature-developer“, je to jednoducho predvolený pracovný profil; netreba nič špeciálne.
• Ak ste používali vnorené subagents, v Codexe to nebude fungovať jedna k jednej; prepracujte to pomocou reťazca profilov alebo explicitných skills.

Nástroj Migration sa pokúsi vytvoriť profily s použitím názvov vašich subagents a označí spúšťače, ktoré sa nepreniesli. Práca závisí od počtu rolí, spúšťačov, oprávnení a závislostí; každý potrebný postup otestujte pred označením migrácie.

Kedy úplne migrovať a kedy používať oba nástroje#

Jednoduchý filter na rozhodnutie:

Úplný prechod na Codex má zmysel, ak:

• Venujete sa hlavne autonómnym PR a paralelným úlohám.
• Váš pracovný postup v GitHube je hlboko integrovaný a Codex Cloud Agent zvláda 80 % práce.
• Nevenujete veľa času architektonickým diskusiám a režimu Plan Mode.
• Chcete platiť za jeden nástroj namiesto dvoch.

Používajte Claude Code a Codex spoločne, ak:

• Pravidelne používate Plan Mode pri dlhých architektonických rozhodnutiach.
• Potrebujete paralelnú prácu: Codex vykonáva jednu úlohu v cloude, zatiaľ čo Claude Code uchováva kontext pre inú.
• Robíte veľa jednorazových hackov a mikrop projektov, pri ktorých je Plan Mode prehnaný.
• Máte zložitý postup so subagents, ktorý nemožno prepísať za jeden večer.

Osobne používam oboje: Claude Code vedie dlhú konverzáciu, zatiaľ čo Codex rieši úlohy „oprav N chýb paralelne“ alebo „skontroluj PR“. Viac o tom, ako to funguje, som vysvetlil v sprievodcovi spoločnou prácou s Claude Code a Codexom.

Hlavné, čo by som o migrácii povedal, je toto: nástroj Migration odstraňuje technickú prekážku prechodu, ale neodpovedá na otázku, či vôbec potrebujete prejsť. Najprv sa rozhodnite, aký typ práce vykonávate. Potom si vyberte nástroj.

Ak potrebujete prístup k neurónovým sieťam cez Ailoot, pozrite sa na Ailoot.