Migrace z Claude Code na Codex: návod krok za krokem

Dokumentace Ailoot: API, klíče a nastavení.

Proč je nástroj Codex Migration vůbec potřeba?#

OpenAI přidala tuto funkci do Codexu začátkem června 2026. Oficiální changelog to stručně popisuje takto:

Jinými slovy: při prvním spuštění aplikace Codex nebo v nastavení již spuštěného klienta se spustí průvodce, který načte místní konfigurace jiného agenta. V současnosti jsou podporovány Claude Code a Claude Cowork.

Je jasné, proč to OpenAI dělá. Po spuštění Sites a aktualizaci aplikace Codex v květnu až červnu 2026 získal Codex vše, čím měl Claude Code dosud nad OpenAI navrch: terminál, pluginy, dlouhé relace a orchestraci. Migrace odstraňuje poslední překážku pro týmy, které už Claude Code začlenily do svého technologického prostředí: „podporovaná nastavení lze importovat a pak porovnat s původním inventářem“.

Proč byste tuto funkci mohli potřebovat, je méně jednoznačné. Porovnal jsem oba nástroje přímo v návodu Codex vs. Claude Code: Claude je stále lepší v dlouhých architektonických diskusích a režimu Plan Mode, zatímco Codex je rychlejší při autonomních úkolech a paralelních PR. Pokud jste se rozhodli přejít úplně, čtěte dál. Pokud zvažujete kombinaci, mohou být užitečnější vzorce spolupráce.

Co automaticky přenáší nástroj Codex Migration z Claude Code?#

Proberu jednotlivé skupiny a přesně vysvětlím, co se stane s každou částí ~/.claude.

1. Instrukce a kontext. Soubory CLAUDE.md — globální soubor v ~/.claude/ i projektové soubory v repozitářích — se převedou do formátu AGENTS.md. Globální soubor skončí v ~/.codex/AGENTS.md; projektové soubory zůstanou v kořeni repozitáře a jeho podřízených složkách. Formát AGENTS.md je v zásadě stejný typ souboru Markdown s pravidly; rozdíly jsou převážně kosmetické — názvy oddílů a několik specifických direktiv. Vysvětlil jsem co je AGENTS.md a proč ho Codex potřebuje.

2. Skills. Prohledá se celá složka ~/.claude/skills/; každý skill se přizpůsobí struktuře Codexu a umístí do $HOME/.agents/skills. Projektové skills ze složky .claude/skills/ v repozitáři se přesunou do .agents/skills. Formát SKILL.md s frontmatter se přenese téměř beze změny. Pokud skill používá spouštěče specifické pro Claude, bude označen ke kontrole.

3. Servery MCP. Konfigurace .mcp.json (globální i na úrovni projektu) se importuje do formátu Codexu. Názvy serverů, spouštěcí příkazy a cesty se zachovají. Co se nepřenese: tokeny a proměnné prostředí. Z bezpečnostních důvodů vás Codex znovu požádá o API klíče a hesla, aby se během migrace neodhalily. Jde o jednorázový úkon: v aplikaci Codex otevřete sekci MCP a zadejte tokeny, které už máte ve správci hesel.

4. Hooks. Tato skupina je složitější. Hooks s deterministickou logikou (blokování rm -rf, upozornění na cesty připomínající přihlašovací údaje, zaznamenávání důkazů) se přenesou celé. Hooks se spouštěči, které v Codexu nemají obdobu (například konkrétní události životního cyklu Claude Code), budou označeny k „ruční kontrole“ a automaticky se neaktivují. Podrobně jsem vysvětlil jak hooks fungují v Claude Code; poslouží to jako srovnávací základ — Codex má méně typů.

5. Historie relací. Jako reference se importuje až posledních 30 dní aktivity v Claude Code. Neznamená to, že „budete pokračovat přesně tam, kde jste skončili“, ale předchozí konverzace budou v Codexu viditelné, takže si rychle připomenete kontext projektu a nebudete muset vše znovu vysvětlovat.

Nástroj Migration nerozlišuje mezi aktivními soubory a experimentálními artefakty — přenese všechno. Po migraci se vyplatí ručně uklidit vše, co jste posledních šest měsíců nepoužívali.

Co se NEPŘENÁŠÍ a proč?#

Proberu každou skupinu z pohledu toho, „co udělat po migraci“.

Tokeny MCP a API klíče. Tato část je nejpředvídatelnější. Po skenování vám Codex zobrazí seznam všech serverů MCP nalezených v Claude. U každého si vyžádá klíče a tokeny. Nejjednodušší je mít po ruce správce hesel a projít všechny servery najednou. Poté MCP funguje v Codexu stejně jako v Claude Code. V dokumentaci vybraného serveru MCP ověřte příkaz a parametry připojení.

Příkazy slash /name. V Claude Code jste zvyklí vyvolat skill pomocí /skill-name. V Codexu je kanonické vyvolání jiné: $skill-name. Častou chybou při migraci je považovat příkazy /name za důkaz, že se skills načetly.

Po migraci v Codexu vyzkoušejte několik důležitých skills pomocí $skill-name. Pokud fungují, migrace se skutečně povedla. Nevěřte zaškrtávacímu políčku „skills migrated“ v průvodci — ověřte to jejich vyvoláním.

Hooks bez obdoby v Codexu. Pokud jste měli hook pro konkrétní události Claude Code — například při pre-tool-use pro určitou kombinaci nástrojů — tento spouštěč v Codexu nemusí existovat. Nástroj Migration je označí a ponechá neaktivní. Budete se muset rozhodnout, zda je přepsat pro ekvivalent v Codexu, odstranit, nebo ponechat v Claude Code (pokud ho používáte souběžně). Dobré pravidlo: přenášejte pouze deterministické hooks; cokoli jiného je důvodem neopakovat v novém nástroji celý ten žebřík.

Týmové pracovní postupy založené na subagentech. Vysvětlil jsem co jsou subagenti v Claude Code a jak používat vnořené subagenty. V Codexu se subagenti organizují pomocí profilů a rolí (viz níže). Pokud jste v Claude měli složitý postup s několika subagenty za sebou, budete ho muset přepsat podle konceptu profilů Codexu. Nástroj Migration takové nastavení označí jako „vyžaduje architektonické přepracování“.

Rozsáhlé soubory CLAUDE.md specifické pro Claude. Pokud soubor narostl na 2 000–3 000 řádků a obsahuje oddíly pro každý projekt, Codex ho možná přijme, ale jde o špatný vzor. AGENTS.md je navržený jako kompaktní a distribuovaný: globální pravidla v ~/.codex/AGENTS.md, pravidla specifická pro projekt v kořeni repozitáře a úzce zaměřená přepsání v podřízených složkách. Po migraci nenechávejte CLAUDE.md jako „obří soubor instrukcí“; rozdělte ho do více úrovní. Vysvětlil jsem jak správně nastavit CLAUDE.md; stejný přístup lze použít i pro AGENTS.md.

Krok za krokem: 4 úkony v aplikaci Codex#

Tady je konkrétní seznam kroků.

1. Krok 1: Aktualizujte aplikaci Codex na verzi 26.608 nebo novější

   Nástroj Migration se objevil ve verzi 26.608 (vydané 9. června 2026). V systému macOS otevřete aplikaci Codex a zkontrolujte aktualizace. Totéž udělejte ve Windows. Pokud používáte Codex CLI, ověřte, že je kompatibilní s aktuální aplikací. Bez nejnovější verze se v Settings nezobrazí „Import other agent setup“.

2. Krok 2: Spusťte import v Settings

   V aplikaci Codex otevřete Settings a najděte „Import other agent setup“. Pokud jste aplikaci Codex právě nainstalovali, průvodce vám migraci nabídne během úvodního nastavení. Po spuštění průvodce se prohledá souborový systém: ~/.claude/ a repozitáře obsahující CLAUDE.md nebo .claude/. Skenování trvá 30 sekund až několik minut podle počtu souborů.

3. Krok 3: Potvrďte plán migrace

   Po skenování Codex zobrazí inventář: kolik skills bylo nalezeno, kolik serverů MCP, kolik souborů CLAUDE.md a které hooks splňují podmínky migrace, a také kolik dní historie relací je k dispozici. Můžete zrušit výběr libovolné skupiny, kterou nechcete přenést. Ve výchozím nastavení je vybráno vše, co Codex považuje za bezpečné importovat.

4. Krok 4: Počkejte na dokončení a zadejte tokeny

   Import trvá 1–5 minut. Po dokončení Codex otevře další okno: „toto se nepodařilo přenést automaticky; zkontrolujte to ručně“. Obvykle jde o seznam serverů MCP, které potřebují tokeny. Otevřete správce hesel a zadejte klíče do formuláře Codexu. Tím je hlavní část migrace dokončena.

Dále ověřte výsledek. Otevřete projekt, na kterém jste obvykle pracovali v Claude Code, a zkontrolujte:

• cat ~/.codex/AGENTS.md — jsou tam vaše globální pravidla?
• Spusťte libovolný skill: $skill-name. Měl by se načíst.
• Otevřete v projektu .mcp.json a zkontrolujte, zda požadované servery běží.
• Zahajte konverzaci odpovídající vašemu obvyklému způsobu práce. Codex zobrazí hooks, které nemůže použít; jde o konkrétní položky inventáře k ručnímu řešení; pevný zbytek není prokázán.

Hooks a subagenti: obdoby v Codexu a co přepsat#

Hooks. V Claude Code můžete ke každé události životního cyklu připojit příkaz shellu (pre-tool-use, post-tool-use, on-error, on-context-load atd.). Codex má menší sadu událostí: může kontrolovat stav před spuštěním, zaznamenávat důkazy a blokovat nebezpečné příkazy. Pokud jste měli hook pre-tool-use, který filtroval konkrétní kombinaci, v Codexu ho budete muset obalit do obecné kontroly před spuštěním, nebo ho odstranit. Podrobně jsem vysvětlil architekturu hooks Claude Code; pokud jste je používali ve velké míře, sepište každý spouštěč a potřebný účinek, určete podporovaný ekvivalent a před zapnutím jej ověřte.

Subagenti. V Claude Code je subagent samostatný kontext s vlastním systémovým promptem, spuštěný pomocí /command nebo z hlavní konverzace. Codex má podobný koncept v profilech: můžete definovat profil s konkrétní sadou skills, oprávnění a zásadou schvalování. Profily řeší zhruba stejný problém — izolaci kontextu pro určitou třídu úloh — ale prostřednictvím nastavení místo explicitního vyvolání agenta.

Co to znamená v praxi:

• Pokud jste měli subagenta „security-reviewer“ s vlastním promptem, vytvořte v Codexu profil security-review s požadovanými oprávněními a vyšší úrovní uvažování.
• Pokud jste měli subagenta „feature-developer“, jde jednoduše o výchozí pracovní profil; nic zvláštního není potřeba.
• Pokud jste používali vnořené subagenty, nebude to v Codexu fungovat jedna ku jedné; zvažte postup založený na řetězci profilů nebo explicitních skills.

Nástroj Migration se pokusí vytvořit profily pomocí názvů vašich subagentů a označí spouštěče, které se nepřenesly. Práce závisí na počtu rolí, spouštěčů, oprávnění a závislostí; každý potřebný postup otestujte před označením za migrovaný.

Kdy přejít úplně a kdy používat oba nástroje#

Jednoduché rozhodovací vodítko:

Přejít úplně na Codex dává smysl, pokud:

• Většinou pracujete na autonomních PR a paralelních úlohách.
• Váš pracovní postup s GitHubem je hluboce integrovaný a Codex Cloud Agent zvládá 80 % práce.
• Architektonickým diskusím a režimu Plan Mode nevěnujete mnoho času.
• Chcete platit za jeden nástroj místo dvou.

Používat Claude Code a Codex společně, pokud:

• Pravidelně používáte Plan Mode pro dlouhá architektonická rozhodnutí.
• Potřebujete paralelní práci: Codex běží v cloudu na jednom úkolu, zatímco Claude Code drží kontext jiného.
• Často děláte jednorázové hacky a malé projekty, pro které je Plan Mode přehnaný.
• Máte složitý postup se subagenty, který nelze přepsat za jeden večer.

Osobně používám oba nástroje: Claude Code udržuje dlouhou konverzaci, zatímco Codex pracuje na úkolech „opravit N chyb paralelně“ nebo „zkontrolovat PR“. Podrobněji jsem vysvětlil, jak to funguje, v návodu na společnou práci s Claude Code a Codexem.

Hlavní věc, kterou bych o migraci řekl: nástroj Migration odstraňuje technickou překážku přechodu, ale neodpovídá na otázku, zda vůbec potřebujete přejít. Nejdřív se rozhodněte, jaký druh práce děláte. Pak zvolte nástroj.

Pokud potřebujete přístup k neuronovým sítím přes Ailoot, podívejte se na Ailoot.