# Migrace z Claude Code na Codex: návod krok za krokem > Codex umí importovat podporované nastavení Claude Code. Instrukce, skilly, připojení MCP, hooky a postupy ověřte proti inventáři; ruční práce závisí na sestavě. Source: https://ailoot.ai/blog/cs/migrate-claude-code-to-codex/ Canonical: https://ailoot.ai/blog/cs/migrate-claude-code-to-codex/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-174 Revision: sha256-1cfa1d4f1fa480f54f80db72b3c68e8af2c51f44ff164de6c5753cf0462e0626
Hlavní poznatek Dne 2. června 2026 přidala společnost OpenAI do Codexu funkci „Import other agent setup“. Prohledá ~/.claude, načte skills, konfiguraci MCP, instrukce a až 30 dní historie relací a převede CLAUDE.md na AGENTS.md. Rozsah přenosu závisí na inventáři a podporovaných funkcích importéru; výsledek skenu porovnejte s vlastním seznamem potřebného nastavení. Co se nepřenese: hooks se spouštěči, které v Codexu nemají obdobu, tokeny MCP a příkazy slash ve formátu `/name`. V tomto návodu vysvětluji, co nástroj Migration načte, co je potřeba dokončit ručně a kdy vůbec dává smysl přejít úplně.
[Dokumentace Ailoot: API, klíče a nastavení](https://ailoot.ai/docs/). ## Proč je nástroj Codex Migration vůbec potřeba?
Hlavní poznatek Před 2. červnem 2026 bylo přecházení z Claude Code na Codex celodenním manuálním projektem: přejmenovat CLAUDE.md na AGENTS.md, přepsat cesty ke skills, znovu připojit servery MCP a obnovit subagenty z paměti. Nástroj Migration to zvládne jediným skenováním: otevřete aplikaci Codex, klikněte na „Import other agent setup“ a získáte inventář složky `~/.claude` a plán migrace.
OpenAI přidala tuto funkci do Codexu začátkem června 2026. [Oficiální changelog](https://developers.openai.com/codex/changelog) to stručně popisuje takto:

Přidány postupy Migrate to Codex pro import podporovaných nastavení z Claude Code a Claude Cowork, včetně nastavení při prvním spuštění.

— OpenAI Codex Changelog, https://developers.openai.com/codex/changelog
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](https://ailoot.ai/blog/cs/codex-vs-claude-code-choice/): 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](https://ailoot.ai/blog/cs/claude-code-codex-together/). ## Co automaticky přenáší nástroj Codex Migration z Claude Code?
Hlavní poznatek Skenovací nástroj načítá pět hlavních skupin: instrukce (CLAUDE.md → AGENTS.md), uživatelské skills, konfiguraci serverů MCP, hooks s deterministickou logikou a až 30 dní historie relací. Zde není prokázané změřené procento přenosu ani čas dokončení. V každé skupině sečtěte požadované položky a označte je jako importované a ověřené, k ruční kontrole nebo nepodporované. Z inventáře odhadněte zbývající práci.
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](https://ailoot.ai/blog/cs/agents-md-guide-template/) 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](https://ailoot.ai/blog/cs/claude-code-hooks/); 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č?
Hlavní poznatek Existuje pět skupin, které v Codexu chybí nebo fungují zásadně jinak. Nástroj Migration je označí, ale nepřevede. Patří sem tokeny MCP a proměnné prostředí, příkazy slash ve formátu `/name`, hooks životního cyklu specifické pro Claude Code, týmové pracovní postupy založené na subagentech a rozsáhlé instrukce přizpůsobené formátu CLAUDE.md.
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](https://ailoot.ai/blog/cs/claude-code-subagents/) a [jak používat vnořené subagenty](https://ailoot.ai/blog/cs/claude-code-nested-subagents/). 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](https://ailoot.ai/blog/cs/claude-memory-claude-md-auto-memory/); stejný přístup lze použít i pro AGENTS.md. ## Krok za krokem: 4 úkony v aplikaci Codex
Hlavní poznatek Doba migrace a ověřování závisí na velikosti `~/.claude` a množství konfigurace specifické pro Claude. Stáhněte si nejnovější aplikaci Codex, otevřete Settings, vyberte „Import other agent setup“, počkejte na skenování a potvrďte import. Pak otestujte skills vyvoláním `$skill-name`, zadejte tokeny MCP a zkontrolujte hooks, které nebyly aktivovány.
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
Hlavní poznatek Hooks v Codexu jsou z hlediska typů spouštěčů méně vyspělé než hooks v Claude Code, ale na základní bezpečnostní úlohy stačí. Subagenty nahrazují profily a role. Pokud jste měli složitý postup se subagenty, nelze ho přenést jedna ku jedné; je potřeba ho znovu promyslet pomocí profilů. Podle inventáře postupů může jít o významnou ruční práci.
**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](https://ailoot.ai/blog/cs/claude-code-hooks/); 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](https://ailoot.ai/blog/cs/claude-code-nested-subagents/), 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
Hlavní poznatek Úplný přechod na Codex dává smysl, když se vaše technologické prostředí skládá z autonomních PR, dlouhých paralelních úloh a hluboké integrace s GitHubem. Kombinace obou nástrojů je silnější, když vaše práce zahrnuje architektonické i realizační úkoly. Z mé zkušenosti podnikatelé, kteří programují pomocí AI, častěji těží z kombinace než z úplného přechodu.
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](https://ailoot.ai/blog/cs/claude-code-codex-together/). 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.
### Zdroje - [Codex Changelog (developers.openai.com)](https://developers.openai.com/codex/changelog) — oficiální poznámky k vydáním včetně záznamu o postupech Migrate to Codex. - [Codex vs. Claude Code 2026 (Ailoot)](https://ailoot.ai/blog/cs/codex-vs-claude-code-choice/) — přímé srovnání obou nástrojů před rozhodnutím, zda migrovat. - [Claude Code and Codex Together (Ailoot)](https://ailoot.ai/blog/cs/claude-code-codex-together/) — vzorce spolupráce, pokud si nejste jistí úplným přechodem. - [Hooks in Claude Code (Ailoot)](https://ailoot.ai/blog/cs/claude-code-hooks/) — jak hooks fungují v Claude, abyste lépe rozuměli tomu, co přenést.
Pokud potřebujete přístup k neuronovým sítím přes Ailoot, podívejte se na [Ailoot](https://ailoot.ai/). ## Časté otázky ### Jak poznám, že import skutečně fungoval? Inventář průvodce porovnejte s vlastním seznamem instrukcí, skillů, MCP, hooků a postupů. Načtěte důležité skilly, ověřte cesty instrukcí, podle potřeby obnovte přihlášení a vyzkoušejte relevantní postupy; zaškrtnutý import sám není důkaz. ### Kolik ruční práce očekávat po migraci? Záleží na inventáři a chování specifickém pro Claude. Zaznamenejte importované položky, položky ke kontrole a nepodporované části a práci odhadněte ze seznamu místo pevného procenta nebo půlhodinového termínu. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.