Kaip pereiti iš Claude Code į Codex 2026 m.: nuoseklus vadovas

Ailoot dokumentacija: API, raktai ir sąranka.

Kam apskritai reikalingas Codex Migration įrankis?#

OpenAI šią funkciją į Codex įtraukė 2026 m. birželio pradžioje. Oficialiame pakeitimų žurnale tai nusakyta trumpai:

Kitaip tariant, pirmą kartą paleidus Codex App arba jau veikiančios programos kliento nustatymuose įsijungia vedlys, kuris nuskaito kito agento vietines konfigūracijas. Šiuo metu palaikomi Claude Code ir Claude Cowork.

Kodėl OpenAI tai daro, aišku. Po Sites paleidimo ir Codex App atnaujinimo 2026 m. gegužę–birželį Codex įgijo viską, kuo Claude Code anksčiau lenkė OpenAI: terminalą, papildinius, ilgas sesijas ir orkestravimą. Migracija pašalina paskutinę kliūtį komandoms, kurios jau integravo Claude Code į savo technologijų rinkinį: „palaikomi nustatymai gali būti importuoti ir tada patikrinti pagal pradinį inventorių“.

Kodėl jums to gali prireikti, ne taip aišku. Palyginau juos tiesiogiai Codex ir Claude Code vadove: Claude vis dar pranašesnis ilgose architektūros diskusijose ir Plan Mode režime, o Codex greičiau atlieka autonomines užduotis ir paralelinius PR. Jei nusprendėte visiškai pereiti, skaitykite toliau. Jei svarstote derinti abu įrankius, aktualiau gali būti bendradarbiavimo modeliai.

Ką Migration įrankis perkelia automatiškai?#

Aptarsiu šias grupes ir tiksliai paaiškinsiu, kas nutinka kiekvienai ~/.claude daliai.

1. Instrukcijos ir kontekstas. CLAUDE.md failai — bendrasis failas iš ~/.claude/ ir projektų failai saugyklose — konvertuojami į AGENTS.md formatą. Bendrasis failas atsiduria adresu ~/.codex/AGENTS.md; projektų failai lieka saugyklos šakniniame kataloge ir poaplankiuose. AGENTS.md formatas iš esmės yra tokio paties tipo Markdown failas su taisyklėmis; skirtumai daugiausia kosmetiniai — skilčių pavadinimai ir kelios konkrečios direktyvos. Paaiškinau, kas yra AGENTS.md ir kodėl jo reikia Codex.

2. Skills. Visas ~/.claude/skills/ aplankas nuskenuojamas; kiekvienas skill pritaikomas Codex struktūrai ir įrašomas į $HOME/.agents/skills. Projektų skills iš saugyklos .claude/skills/ perkeliami į .agents/skills. SKILL.md formatas su frontmatter perkeliamas beveik nepakeistas. Jei skill naudoja Claude būdingus trigerius, jis pažymimas peržiūrai.

3. MCP serveriai. .mcp.json konfigūracija (tiek bendroji, tiek projekto lygmens) importuojama į Codex formatą. Serverių pavadinimai, paleidimo komandos ir keliai išsaugomi. Kas neperkeliama: žetonai ir aplinkos kintamieji. Saugumo sumetimais Codex vėl paprašys API raktų ir slaptažodžių, kad migracijos metu jie nebūtų atskleisti. Tai vienkartinė užduotis: atidarykite Codex App MCP skiltį ir įveskite žetonus, kuriuos jau turite slaptažodžių tvarkytuvėje.

4. Hooks. Tai sudėtingiausia grupė. Hooks su deterministine logika (blokuojantys rm -rf, perspėjantys apie prisijungimo duomenis primenančius kelius, fiksuojantys įrodymus) perkeliami visiškai. Hooks, kurių trigeriai Codex neturi atitikmens (pavyzdžiui, konkretūs Claude Code gyvavimo ciklo įvykiai), pažymimi „manual review“ ir automatiškai neaktyvuojami. Išsamiai paaiškinau kaip veikia hooks Claude Code — tai padės palyginti, nes Codex jų tipų turi mažiau.

5. Sesijų istorija. Kaip nuoroda importuojama iki paskutinių 30 dienų Claude Code veiklos. Tai nereiškia „tęsti tiksliai ten, kur baigėte“, tačiau ankstesni pokalbiai bus matomi Codex, todėl galėsite greitai prisiminti projekto kontekstą, visko neaiškindami iš naujo.

Migration įrankis neatskiria aktyvių failų nuo eksperimentinių artefaktų — perkelia viską. Po migracijos pravartu rankiniu būdu išvalyti tai, ko nenaudojote pastaruosius šešis mėnesius.

Kas NEPERSIKELIA ir kodėl?#

Kiekvieną grupę aptarsiu iš perspektyvos „ką daryti po migracijos“.

MCP žetonai ir API raktai. Tai nuspėjamiausia dalis. Po nuskaitymo Codex parodys visų Claude rastų MCP serverių sąrašą. Kiekvienam serveriui paprašys raktų ir žetonų. Paprasčiausia turėti po ranka slaptažodžių tvarkytuvę ir visus serverius sutvarkyti vienu kartu. Tada MCP vienodai veikia ir Codex, ir Claude Code. Pagal pasirinkto MCP serverio dokumentaciją patikrinkite komandą ir prisijungimo parametrus.

Pasviruoju brūkšniu prasidedančios komandos /name. Claude Code esate įpratę skill iškviesti naudodami /skill-name. Codex įprastas iškvietimo būdas kitoks: $skill-name. Dažna migracijos klaida – laikyti /name komandas įrodymu, kad skill įkelti.

Po migracijos Codex išbandykite kelis svarbius skills su $skill-name. Jei jie veikia, migracija tikrai pavyko. Nepasitikėkite vedlio žymimuoju laukeliu „skills migrated“ — patikrinkite patys juos iškviesdami.

Hooks, neturintys atitikmens Codex. Jei turėjote hook konkretiems Claude Code įvykiams — pavyzdžiui, pre-tool-use tam tikram įrankių deriniui — tokio trigerio Codex gali nebūti. Migration įrankis juos pažymės ir paliks neaktyvius. Turėsite nuspręsti, ar perrašyti juos pagal Codex galimybes, atsisakyti, ar palikti Claude Code (jei jį naudojate lygiagrečiai). Gera taisyklė: perkelkite tik deterministinius hooks; visa kita — priežastis nekopijuoti visos struktūros į naują įrankį.

Komandiniai darbo procesai, sukurti naudojant subagents. Paaiškinau, kas yra subagents Claude Code ir kaip naudoti įdėtinius subagents. Codex aplinkoje subagents organizuojami naudojant profilius ir vaidmenis (žr. toliau). Jei Claude turėjote sudėtingą kelių subagents grandinę, ją teks perkurti pagal Codex profilių koncepciją. Migration įrankis tokias sąrankas pažymi kaip „requires architectural rework“.

Dideli, Claude pritaikyti CLAUDE.md failai. Jei failas išaugo iki 2 000–3 000 eilučių ir turi skiltis kiekvienam projektui, Codex galbūt jį priims, bet tai prasta praktika. AGENTS.md sukurtas taip, kad būtų glaustas ir paskirstytas: bendrosios taisyklės — ~/.codex/AGENTS.md, konkretaus projekto taisyklės — saugyklos šakniniame kataloge, o siauros išimtys — poaplankiuose. Po migracijos nepalikite CLAUDE.md kaip „milžiniško instrukcijų failo“; išskaidykite jį į kelis lygius. Paaiškinau, kaip tinkamai konfigūruoti CLAUDE.md; tas pats metodas tinka ir AGENTS.md.

Žingsnis po žingsnio: 4 veiksmai Codex App#

Štai konkretus kontrolinis sąrašas.

1. 1 žingsnis: atnaujinkite Codex App į 26.608 ar naujesnę versiją

   Migration įrankis pasirodė 26.608 versijoje (išleistoje 2026 m. birželio 9 d.). macOS sistemoje atidarykite Codex App ir patikrinkite, ar yra naujinimų. Tą patį atlikite Windows sistemoje. Jei naudojate Codex CLI, įsitikinkite, kad jis suderinamas su dabartine programa. Be naujausios versijos „Import other agent setup“ nebus rodoma Settings.

2. 2 žingsnis: pradėkite importavimą Settings skiltyje

   Codex App atidarykite Settings ir raskite „Import other agent setup“. Jei ką tik įdiegėte Codex App, vedlys pasiūlys migraciją pradinės sąrankos metu. Paleistas vedlys nuskaito failų sistemą: ~/.claude/ ir saugyklas, kuriose yra CLAUDE.md arba .claude/. Nuskaitymas trunka nuo 30 sekundžių iki kelių minučių, priklausomai nuo failų skaičiaus.

3. 3 žingsnis: patvirtinkite migracijos planą

   Baigęs nuskaityti Codex parodys inventorių: kiek rasta skills, kiek MCP serverių, kiek CLAUDE.md failų, kurie hooks tinkami migruoti ir kiek dienų sesijų istorijos pasiekiama. Galite panaikinti bet kurios grupės, kurios nenorite perkelti, žymėjimą. Pagal numatytuosius nustatymus pažymėta viskas, ką Codex laiko saugiu importuoti.

4. 4 žingsnis: palaukite, kol procesas baigsis, ir įveskite žetonus

   Importavimas trunka 1–5 minutes. Jam pasibaigus Codex atidarys tolesnį langą: „štai ko negalėjau perkelti automatiškai; patikrinkite rankiniu būdu“. Paprastai tai būna MCP serverių, kuriems reikia žetonų, sąrašas. Atidarykite slaptažodžių tvarkytuvę ir įveskite raktus Codex formoje. Tuo pagrindinė migracijos dalis bus baigta.

Tada patikrinkite rezultatą. Atidarykite projektą, su kuriuo paprastai dirbote Claude Code, ir patikrinkite:

• cat ~/.codex/AGENTS.md — ar ten yra jūsų bendrosios taisyklės?
• Paleiskite bet kurį skill: $skill-name. Jis turėtų būti įkeltas.
• Atidarykite projekto .mcp.json ir patikrinkite, ar veikia reikiami serveriai.
• Pradėkite įprastą jūsų darbo būdą atitinkantį pokalbį. Codex parodys, kurių importuotų hooks negali naudoti; tai konkretūs inventoriaus elementai, kuriuos turite sutvarkyti rankiniu būdu; fiksuotas likutis nenustatytas.

Hooks ir subagents: Codex atitikmenys ir ką reikia perrašyti#

Hooks. Claude Code prie kiekvieno gyvavimo ciklo įvykio galite pridėti shell komandą (pre-tool-use, post-tool-use, on-error, on-context-load ir pan.). Codex įvykių rinkinys mažesnis: jis gali patikrinti prieš vykdymą, užfiksuoti įrodymus ir blokuoti pavojingas komandas. Jei turėjote pre-tool-use hook, filtruojantį tam tikrą derinį, Codex turėsite jį įtraukti į bendrą patikrą prieš vykdymą arba atsisakyti. Išsamiai paaiškinau Claude Code hooks architektūrą; jei hook naudojote plačiai, išvardykite kiekvieną aktyviklį ir reikiamą poveikį, raskite palaikomą atitikmenį ir patikrinkite jį prieš įjungdami.

Subagents. Claude Code subagent yra atskiras kontekstas su savo system prompt, paleidžiamas per /command arba iš pagrindinio pokalbio. Codex turi panašią profilių koncepciją: galite apibrėžti profilį su konkrečiu skills, leidimų ir patvirtinimo politikos rinkiniu. Profiliai sprendžia maždaug tą pačią problemą — atskiria kontekstą konkrečiai užduočių klasei — tačiau tai daro per nustatymus, o ne aiškiai iškviečiant agentą.

Ką tai reiškia praktiškai:

• Jei turėjote „security-reviewer“ subagent su savo prompt, sukurkite Codex security-review profilį su reikiamais leidimais ir didesnėmis samprotavimo pastangomis.
• Jei turėjote „feature-developer“ subagent, tai tiesiog numatytasis darbo profilis; nieko ypatingo nereikia.
• Jei naudojote įdėtinius subagents, Codex tai neveiks vienas prie vieno; pergalvokite sprendimą naudodami profilių grandinę arba aiškiai iškviečiamus skills.

Migration įrankis bandys sukurti profilius pagal jūsų subagents pavadinimus ir pažymės trigerius, kurie nebuvo perkelti. Darbo apimtis priklauso nuo vaidmenų, aktyviklių, teisių ir priklausomybių skaičiaus; kiekvieną privalomą eigą išbandykite prieš laikydami ją perkelta.

Kada visiškai pereiti ir kada naudoti abu įrankius#

Paprastas sprendimo kriterijus:

Visiškai pereiti prie Codex verta, jei:

• Daugiausia dirbate su autonominiais PR ir paralelinėmis užduotimis.
• Jūsų GitHub darbo eiga glaudžiai integruota, o Codex Cloud Agent atlieka 80 % darbo.
• Nedaug laiko skiriate architektūros diskusijoms ir Plan Mode režimui.
• Norite mokėti už vieną įrankį, o ne du.

Naudokite Claude Code ir Codex kartu, jei:

• Ilgiems architektūriniams sprendimams reguliariai naudojate Plan Mode.
• Reikia paralelinio darbo: Codex debesijoje atlieka vieną užduotį, o Claude Code išlaiko kitos užduoties kontekstą.
• Dažnai kuriate vienkartinius sprendimus ir mažus projektus, kuriems Plan Mode per sudėtingas.
• Turite sudėtingą subagents grandinę, kurios neįmanoma perrašyti per vieną vakarą.

Aš pats naudoju abu: Claude Code palaiko ilgą pokalbį, o Codex atlieka tokias užduotis kaip „ištaisyti N klaidų lygiagrečiai“ arba „peržiūrėti PR“. Daugiau apie tai, kaip tai veikia, paaiškinau darbo su Claude Code ir Codex kartu vadove.

Svarbiausia, ką pasakyčiau apie migraciją: Migration įrankis pašalina techninę kliūtį pereiti, bet neatsako, ar apskritai reikia pereiti. Pirmiausia nuspręskite, kokį darbą atliekate. Tada pasirinkite įrankį.

Jei jums reikia per Ailoot pasiekti neuroninius tinklus, apsilankykite Ailoot.