Näin siirryt Claude Codesta Codexiin vuonna 2026: vaiheittainen opas

Ailoot-dokumentaatio: API, avaimet ja käyttöönotto.

Miksi Codexin Migration-työkalua ylipäätään tarvitaan?#

OpenAI lisäsi toiminnon Codexiin kesäkuun 2026 alussa. Virallinen muutosloki kuvaa sitä lyhyesti:

Toisin sanoen: kun käynnistät Codex Appin ensimmäisen kerran tai avaat jo käynnissä olevan asiakkaan asetukset, ohjattu toiminto lukee toisen agentin paikalliset määritykset. Claude Code ja Claude Cowork ovat tällä hetkellä tuettuja.

On selvää, miksi OpenAI tekee tämän. Sitesin julkaisun ja Codex Appin touko–kesäkuun 2026 päivitysten jälkeen Codex sai kaiken sen, missä Claude Code oli aiemmin OpenAI:ta edellä: päätteen, liitännäiset, pitkät istunnot ja orkestroinnin. Siirtymä poistaa viimeisen esteen tiimeiltä, jotka ovat jo integroineet Claude Coden työkalupinoonsa: "tuetut asetukset voidaan tuoda ja tarkistaa sitten alkuperäistä luetteloa vasten."

Se, miksi sinä saattaisit tarvita sitä, ei ole yhtä selvää. Vertailin työkaluja rinnakkain Codex vs. Claude Code -oppaassa: Claude on yhä edellä pitkissä arkkitehtuurikeskusteluissa ja Plan Modessa, kun taas Codex on nopeampi itsenäisissä tehtävissä ja rinnakkaisissa PR:issä. Jos olet päättänyt vaihtaa kokonaan, jatka lukemista. Jos harkitset niiden käyttämistä yhdessä, yhteistyömallit voivat olla hyödyllisempiä.

Mitä Migration-työkalu siirtää automaattisesti?#

Käyn ryhmät läpi ja selitän tarkasti, mitä kullekin ~/.claude-hakemiston osalle tapahtuu.

1. Ohjeet ja konteksti. CLAUDE.md-tiedostot—sekä ~/.claude/-hakemiston yleinen tiedosto että repositorioiden projektitiedostot—muunnetaan AGENTS.md-muotoon. Yleinen tiedosto päätyy sijaintiin ~/.codex/AGENTS.md; projektitiedostot jäävät repositorion juureen ja alikansioihin. AGENTS.md-muoto on pohjimmiltaan samanlainen Markdown-tiedosto sääntöineen; erot ovat enimmäkseen kosmeettisia—osioiden nimet ja pari erityistä direktiiviä. Olen selittänyt, mikä AGENTS.md on ja miksi Codex tarvitsee sitä.

2. Skillit. Koko ~/.claude/skills/-kansio skannataan; kukin skill mukautetaan Codexin rakenteeseen ja sijoitetaan kansioon $HOME/.agents/skills. Repositorion .claude/skills/-kansiossa olevat projektiskillit siirretään kansioon .agents/skills. Frontmatteria sisältävä SKILL.md-muoto siirtyy lähes sellaisenaan. Jos skill käyttää Claude-kohtaisia käynnistimiä, se merkitään tarkistettavaksi.

3. MCP-palvelimet. .mcp.json-määritys (sekä yleinen että projektikohtainen) tuodaan Codex-muotoon. Palvelinten nimet, käynnistyskomennot ja polut säilytetään. Tokenit ja ympäristömuuttujat eivät siirry. Turvallisuussyistä Codex pyytää sinua syöttämään API-avaimet ja salasanat uudelleen, jotta ne eivät paljastu siirron aikana. Tämä on kertaluonteinen tehtävä: avaa Codex Appin MCP-osio ja syötä tokenit, jotka ovat jo salasananhallinnassasi.

4. Hookit. Tämä ryhmä on monimutkainen. Determinististä logiikkaa sisältävät hookit (kuten rm -rf-komennon estäminen, tunnistetietoja muistuttavista poluista hälyttäminen ja todisteiden tallentaminen) siirtyvät kokonaisuudessaan. Hookit, joiden käynnistimille ei ole vastinetta Codexissa (esimerkiksi tietyt Claude Coden elinkaaritapahtumat), merkitään "manuaalisesti tarkistettaviksi", eikä niitä aktivoida automaattisesti. Olen selittänyt yksityiskohtaisesti miten hookit toimivat Claude Codessa vertailukohdaksi—Codexissa tyyppejä on vähemmän.

5. Istuntohistoria. Enintään viimeisten 30 päivän Claude Code -toiminta tuodaan viitteeksi. Tämä ei tarkoita, että "jatkat täsmälleen siitä, mihin jäit", mutta aiemmat keskustelusi näkyvät Codexissa, joten voit palauttaa projektin kontekstin nopeasti ilman, että sinun tarvitsee selittää kaikkea uudelleen.

Migration-työkalu ei erottele aktiivisia tiedostoja kokeiluista jääneistä tiedostoista—se siirtää kaiken. Siirron jälkeen kannattaa siivota manuaalisesti pois kaikki, mitä et ole käyttänyt viimeisen kuuden kuukauden aikana.

Mitä EI siirry, ja miksi?#

Käyn jokaisen ryhmän läpi kysymyksen "mitä siirron jälkeen pitää tehdä?" näkökulmasta.

MCP-tokenit ja API-avaimet. Tämä on ennakoitavin osa. Skannauksen jälkeen Codex näyttää luettelon kaikista Claudesta löytämistään MCP-palvelimista. Se pyytää kunkin palvelimen avaimia ja tokeneita. Helpointa on pitää salasananhallinta käsillä ja käydä palvelimet läpi yhdellä kertaa. Sen jälkeen MCP toimii samalla tavalla Codexissa ja Claude Codessa. Tarkista valitsemasi MCP-palvelimen komento ja yhteysparametrit sen dokumentaatiosta.

Slash-komennot /name. Claude Codessa olet tottunut kutsumaan skilliä komennolla /skill-name. Codexissa kanoninen kutsutapa on erilainen: $skill-name. Yleinen siirtovirhe on pitää /name-komentoja todisteena siitä, että skillit on ladattu.

Testaa siirron jälkeen muutamaa tärkeää skilliä Codexissa komennolla $skill-name. Jos ne toimivat, siirto todella onnistui. Älä luota ohjatun toiminnon "skills migrated" -valintaruutuun—varmista asia kutsumalla skillejä.

Hookit, joille ei ole vastinetta Codexissa. Jos käytössäsi oli hook tiettyihin Claude Code -tapahtumiin—esimerkiksi pre-tool-use tietylle työkaluyhdistelmälle—kyseistä käynnistintä ei ehkä ole Codexissa. Migration-työkalu merkitsee hookit ja jättää ne passiivisiksi. Sinun on päätettävä, kirjoitatko ne uudelleen Codex-vastineiksi, poistatko ne vai pidätkö ne Claude Codessa (jos käytät sitä rinnalla). Hyvä nyrkkisääntö: siirrä vain deterministiset hookit; kaikki muu on syy olla kopioimatta koko rakennetta uuteen työkaluun.

Aliagentteihin perustuvat tiimin työnkulut. Olen selittänyt, mitä aliagentit ovat Claude Codessa ja miten sisäkkäisiä aliagentteja käytetään. Codexissa aliagentit järjestetään profiilien ja roolien avulla (katso alla). Jos sinulla oli Claudessa monimutkainen putki, jossa useita aliagentteja ketjutettiin peräkkäin, sinun täytyy kirjoittaa se uudelleen Codexin profiilikonseptin ympärille. Migration-työkalu merkitsee tällaiset määritykset ilmoituksella "edellyttää arkkitehtuurin uudistamista".

Suuret Claude-kohtaiset CLAUDE.md-tiedostot. Jos tiedosto on kasvanut 2 000–3 000 rivin mittaiseksi ja sisältää omat osiot jokaiselle projektille, Codex saattaa hyväksyä sen, mutta se on huono käytäntö. AGENTS.md on suunniteltu kompaktiksi ja hajautetuksi: yleiset säännöt sijoitetaan tiedostoon ~/.codex/AGENTS.md, projektikohtaiset säännöt repositorion juureen ja rajatut ohitusmääritykset alikansioihin. Älä jätä siirron jälkeen CLAUDE.md-tiedostoa "jättimäiseksi ohjetiedostoksi"; jaa sen sisältö eri tasoille. Olen selittänyt, miten CLAUDE.md määritetään oikein; sama lähestymistapa toimii AGENTS.md:n kanssa.

Vaihe vaiheelta: 4 toimintoa Codex Appissa#

Tässä on tarkka tarkistuslista.

1. Vaihe 1: Päivitä Codex App versioon 26.608 tai uudempaan

   Migration-työkalu tuli versioon 26.608 (julkaistu 9. kesäkuuta 2026). Avaa macOS:ssä Codex App ja tarkista päivitykset. Tee samoin Windowsissa. Jos käytät Codex CLI:tä, varmista, että se on yhteensopiva nykyisen App-version kanssa. Ilman uusinta versiota "Import other agent setup" ei näy Settings-kohdassa.

2. Vaihe 2: Käynnistä tuonti Settings-kohdasta

   Avaa Codex Appissa Settings ja etsi "Import other agent setup". Jos olet juuri asentanut Codex Appin, ohjattu toiminto tarjoaa siirtoa käyttöönoton aikana. Käynnistyttyään se skannaa tiedostojärjestelmän: ~/.claude/-hakemiston ja repositoriot, joissa on CLAUDE.md tai .claude/. Skannaus kestää 30 sekunnista useisiin minuutteihin tiedostojen määrästä riippuen.

3. Vaihe 3: Vahvista siirtosuunnitelma

   Skannauksen jälkeen Codex näyttää inventaarion: montako skilliä ja MCP-palvelinta löytyi, montako CLAUDE.md-tiedostoa löytyi, mitkä hookit voidaan siirtää ja monenko päivän istuntohistoria on saatavilla. Voit poistaa valinnan ryhmistä, joita et halua siirtää. Oletuksena valittuna on kaikki, minkä Codex katsoo turvalliseksi tuoda.

4. Vaihe 4: Odota valmistumista ja syötä tokenit

   Tuonti kestää 1–5 minuuttia. Kun se valmistuu, Codex avaa jatkoikkunan: "tässä on se, mitä en pystynyt siirtämään automaattisesti; tarkista se manuaalisesti." Tavallisesti kyseessä on luettelo MCP-palvelimista, jotka tarvitsevat tokeneita. Avaa salasananhallinta ja syötä avaimet Codex-lomakkeeseen. Sen jälkeen siirron pääosa on valmis.

Tarkista seuraavaksi tulos. Avaa projekti, jossa tavallisesti työskentelit Claude Codessa, ja tarkista:

• cat ~/.codex/AGENTS.md — löytyvätkö yleiset sääntösi sieltä?
• Suorita jokin skill: $skill-name. Sen pitäisi latautua.
• Avaa projektin .mcp.json ja tarkista, että tarvittavat palvelimet ovat käynnissä.
• Aloita keskustelu, joka vastaa tavallista työskentelytapaasi. Codex näyttää, mitä tuoduista hookeista se ei voi käyttää; nämä ovat luettelon yksittäisiä kohteita, jotka sinun täytyy käsitellä manuaalisesti; kiinteää jäljelle jäävää osuutta ei ole vahvistettu.

Hookit ja aliagentit: Codex-vastineet ja uudelleenkirjoitettavat osat#

Hookit. Claude Codessa voit liittää shell-komennon jokaiseen elinkaaritapahtumaan (pre-tool-use, post-tool-use, on-error, on-context-load ja niin edelleen). Codexissa tapahtumia on vähemmän: se voi tarkistaa tilanteen ennen suoritusta, tallentaa todisteita ja estää vaarallisia komentoja. Jos sinulla oli pre-tool-use-hook, joka suodatti tiettyä yhdistelmää, Codexissa sinun on sisällytettävä se yleiseen suoritusta edeltävään tarkistukseen tai poistettava se. Olen selittänyt yksityiskohtaisesti Claude Code -hookien arkkitehtuurin; jos käytit niitä paljon, listaa jokainen laukaisin ja tarvittava vaikutus, etsi tuettu vastine ja tarkista se ennen käyttöönottoa.

Aliagentit. Claude Codessa aliagentti on erillinen konteksti, jolla on oma järjestelmäkehote ja joka käynnistetään /command-komennolla tai pääkeskustelusta. Codexissa profiilit tarjoavat samankaltaisen käsitteen: voit määrittää profiilin, jolla on tietty skillien, käyttöoikeuksien ja hyväksymiskäytännön yhdistelmä. Profiilit ratkaisevat suunnilleen saman ongelman—eristävät tietyn tehtäväluokan kontekstin—mutta asetusten avulla eksplisiittisen agenttikutsun sijaan.

Käytännössä tämä tarkoittaa seuraavaa:

• Jos sinulla oli "security-reviewer"-aliagentti omalla kehotteellaan, luo Codexiin security-review-profiili, jossa on tarvittavat käyttöoikeudet ja suurempi päättelytaso.
• Jos sinulla oli "feature-developer"-aliagentti, se on yksinkertaisesti oletusarvoinen työskentelyprofiili; mitään erityistä ei tarvita.
• Jos käytit sisäkkäisiä aliagentteja, se ei toimi Codexissa yksi yhteen; suunnittele se uudelleen profiilien ketjuna tai eksplisiittisinä skilleinä.

Migration-työkalu yrittää luoda profiileja aliagenttiesi nimien perusteella ja merkitsee, mitkä käynnistimet eivät siirtyneet. Tarvittava työ riippuu roolien, laukaisinten, oikeuksien ja riippuvuuksien määrästä. Testaa jokainen tarvittava putki ennen kuin pidät sitä siirrettynä.

Milloin kannattaa siirtyä kokonaan, ja milloin pitää molemmat työkalut?#

Yksinkertainen päätössuodatin:

Siirry kokonaan Codexiin, jos:

• Työskentelet pääasiassa itsenäisten PR:ien ja rinnakkaisten tehtävien parissa.
• GitHub-työnkulkusi on syvästi integroitu ja Codex Cloud Agent hoitaa 80 % työstä.
• Et käytä paljon aikaa arkkitehtuurikeskusteluihin ja Plan Modeen.
• Haluat maksaa yhdestä työkalusta kahden sijaan.

Käytä Claude Codea ja Codexia yhdessä, jos:

• Käytät säännöllisesti Plan Modea pitkiin arkkitehtuuripäätöksiin.
• Tarvitset rinnakkaista työskentelyä: Codex toimii pilvessä yhden tehtävän parissa, kun Claude Code säilyttää toisen tehtävän kontekstin.
• Teet paljon kertaluonteisia virityksiä ja miniprojekteja, joissa Plan Mode on tarpeettoman raskas.
• Sinulla on monimutkainen aliagenttiputki, jota ei voi kirjoittaa uudelleen yhdessä illassa.

Käytän itse molempia: Claude Code hoitaa pitkän keskustelun, kun taas Codex hoitaa tehtävät "korjaa N virhettä rinnakkain" tai "tarkista PR". Olen kertonut lisää niiden yhteiskäytöstä Claude Coden ja Codexin yhdessä käyttämistä käsittelevässä oppaassa.

Tärkein asia, jonka sanoisin siirtymisestä, on tämä: Migration-työkalu poistaa vaihtamisen teknisen esteen, mutta ei vastaa siihen, tarvitseeko sinun vaihtaa alun perinkään. Päätä ensin, millaista työtä teet. Valitse sitten työkalu.

Jos tarvitset pääsyn neuroverkkoihin Ailootin kautta, tutustu Ailootiin.