Slik migrerer du fra Claude Code til Codex i 2026: en trinnvis veiledning

Ailoot-dokumentasjon: API, nøkler og oppsett.

Hvorfor er Codex-migreringsverktøyet egentlig nødvendig?#

OpenAI la til funksjonen i Codex tidlig i juni 2026. Den offisielle endringsloggen sier det kort:

Med andre ord: Når du starter Codex App for første gang, eller fra innstillingene til en klient som allerede kjører, starter en veiviser som leser lokale konfigurasjoner fra en annen agent. Claude Code og Claude Cowork støttes for øyeblikket.

Det er tydelig hvorfor OpenAI gjør dette. Etter at Sites ble lansert og Codex App ble oppdatert i mai–juni 2026, fikk Codex alt Claude Code tidligere hadde som OpenAI manglet: en terminal, programtillegg, lange økter og orkestrering. Migreringen fjerner den siste hindringen for team som allerede har integrert Claude Code i teknologistakken sin: "støttede innstillinger kan importeres og deretter kontrolleres mot originalinventaret."

Hvorfor du kan trenge det, er mindre opplagt. Jeg sammenlignet dem direkte i veiledningen Codex vs. Claude Code: Claude er fortsatt bedre på lange arkitekturdiskusjoner og Plan Mode, mens Codex er raskere på autonome oppgaver og parallelle PR-er. Hvis du har bestemt deg for å bytte helt, kan du lese videre. Hvis du vurderer å kombinere dem, kan samarbeidsmønstrene være mer relevante.

Hva overfører migreringsverktøyet automatisk?#

Jeg går gjennom gruppene og forklarer nøyaktig hva som skjer med hver del av ~/.claude.

1. Instruksjoner og kontekst. CLAUDE.md-filer — den globale filen i ~/.claude/ og prosjektfiler i repositorier — konverteres til AGENTS.md-formatet. Den globale filen havner i ~/.codex/AGENTS.md; prosjektfilene blir værende i rotmappen til repositoriet og i undermapper. AGENTS.md-formatet er i hovedsak den samme typen Markdown-fil med regler; forskjellene er for det meste kosmetiske — seksjonsnavn og et par spesifikke direktiver. Jeg har forklart hva AGENTS.md er, og hvorfor Codex trenger det.

2. Skills. Hele mappen ~/.claude/skills/ skannes; hver skill tilpasses Codex-strukturen og plasseres i $HOME/.agents/skills. Prosjektskills fra .claude/skills/ i et repositorium flyttes til .agents/skills. SKILL.md-formatet med frontmatter overføres nesten uendret. Hvis en skill bruker Claude-spesifikke utløsere, flagges den for gjennomgang.

3. MCP-servere. Konfigurasjonen .mcp.json (både globalt og på prosjektnivå) importeres til Codex-formatet. Servernavn, startkommandoer og stier bevares. Dette overføres ikke: tokener og miljøvariabler. Av sikkerhetsgrunner ber Codex deg om API-nøkler og passord på nytt, slik at de ikke eksponeres under migreringen. Dette er en engangsoppgave: åpne MCP-delen i Codex App og skriv inn tokenene du allerede har i passordbehandleren din.

4. Hooks. Dette er den kompliserte gruppen. Hooks med deterministisk logikk (blokkering av rm -rf, varsling om stier som ligner på legitimasjon, registrering av bevis) overføres i sin helhet. Hooks med utløsere som ikke har noen tilsvarende funksjon i Codex (for eksempel bestemte livssyklushendelser i Claude Code), merkes for "manuell gjennomgang" og aktiveres ikke automatisk. Jeg forklarte hvordan hooks fungerer i Claude Code i detalj som et sammenligningsgrunnlag — Codex har færre typer.

5. Økthistorikk. Opptil de siste 30 dagene med aktivitet i Claude Code importeres som referanse. Det betyr ikke at du "fortsetter nøyaktig der du slapp", men tidligere samtaler blir synlige i Codex, slik at du raskt kan hente frem prosjektkonteksten uten å forklare alt på nytt.

Migreringsverktøyet skiller ikke mellom aktive filer og eksperimentelle artefakter — det overfører alt. Etter migreringen er det nyttig å rydde opp manuelt i ting du ikke har brukt de siste seks månedene.

Hva overføres IKKE, og hvorfor?#

Jeg går gjennom hver gruppe med utgangspunkt i spørsmålet "hva gjør du etter migreringen?".

MCP-tokener og API-nøkler. Dette er den mest forutsigbare delen. Etter skanningen viser Codex en liste over alle MCP-serverne det fant i Claude. Det ber om nøkler og tokener for hver av dem. Det enkleste er å ha passordbehandleren klar og gå gjennom alle serverne i én omgang. Etterpå fungerer MCP identisk i Codex og Claude Code. Kontroller kommandoen og tilkoblingsparametrene for MCP-serveren du har valgt, mot dokumentasjonen.

Skråstrekkommandoer /name. I Claude Code er du vant til å kalle opp en skill med /skill-name. I Codex er den kanoniske måten å kalle den opp på annerledes: $skill-name. En vanlig migreringsfeil er å se på /name-kommandoer som bevis på at skills er lastet inn.

Etter migreringen kan du teste noen viktige skills med $skill-name i Codex. Hvis de fungerer, var migreringen faktisk vellykket. Ikke stol på avkrysningsboksen "skills migrated" i veiviseren — kontroller ved å kalle dem opp.

Hooks uten et Codex-ekvivalent. Hvis du hadde en hook for bestemte hendelser i Claude Code — for eksempel ved pre-tool-use for en bestemt kombinasjon av verktøy — finnes kanskje ikke den utløseren i Codex. Migreringsverktøyet flagger dem og lar dem være inaktive. Du må bestemme om du skal skrive dem om for et Codex-ekvivalent, fjerne dem eller beholde dem i Claude Code (hvis du kjører begge parallelt). En god regel: overfør bare deterministiske hooks; alt annet er en grunn til ikke å kopiere hele stigen i det nye verktøyet.

Teamarbeidsflyter som bygger på underagenter. Jeg har forklart hva underagenter er i Claude Code og hvordan du bruker nestede underagenter. I Codex organiseres underagenter gjennom profiler og roller (se nedenfor). Hvis du hadde en kompleks pipeline i Claude med flere underagenter etter hverandre, må du skrive den om rundt Codex-konseptet med profiler. Migreringsverktøyet markerer slike oppsett med "requires architectural rework".

Omfattende CLAUDE.md-filer som er spesifikke for Claude. Hvis en fil har vokst til 2,000–3,000 linjer med seksjoner for hvert prosjekt, kan Codex godta den, men det er en dårlig praksis. AGENTS.md er utformet for å være kompakt og distribuert: globale regler i ~/.codex/AGENTS.md, prosjektspecifikke regler i rotmappen til repositoriet og avgrensede overstyringer i undermapper. Etter migreringen bør du ikke la CLAUDE.md bli liggende som en "gigantisk instruksjonsfil"; del den opp på flere nivåer. Jeg har forklart hvordan du konfigurerer CLAUDE.md riktig; den samme tilnærmingen gjelder for AGENTS.md.

Trinn for trinn: 4 handlinger i Codex App#

Her er den konkrete sjekklisten.

1. Trinn 1: Oppdater Codex App til versjon 26.608 eller nyere

   Migreringsverktøyet dukket opp i versjon 26.608 (utgitt 9. juni 2026). På macOS åpner du Codex App og ser etter oppdateringer. Gjør det samme på Windows. Hvis du kjører Codex CLI, må du kontrollere at den er kompatibel med den gjeldende App-versjonen. Uten den nyeste versjonen vises ikke "Import other agent setup" i Settings.

2. Trinn 2: Start importen fra Settings

   Åpne Settings i Codex App og finn "Import other agent setup". Hvis du nettopp har installert Codex App, tilbyr veiviseren migrering under introduksjonen. Når du starter, skanner veiviseren filsystemet: ~/.claude/ og repositorier som inneholder CLAUDE.md eller .claude/. Skanningen tar fra 30 sekunder til flere minutter, avhengig av antall filer.

3. Trinn 3: Bekreft migreringsplanen

   Etter skanningen viser Codex en oversikt: hvor mange skills som ble funnet, hvor mange MCP-servere, hvor mange CLAUDE.md-filer som ble funnet, hvilke hooks som kvalifiserer for migrering, og hvor mange dager med økthistorikk som er tilgjengelig. Du kan fjerne avmerkingen for grupper du ikke vil overføre. Som standard er alt Codex anser som trygt å importere, valgt.

4. Trinn 4: Vent til migreringen er ferdig, og skriv inn tokener

   Importen tar 1–5 minutter. Når den er ferdig, åpner Codex et oppfølgingsvindu: "dette klarte jeg ikke å overføre automatisk; kontroller det manuelt." Vanligvis er dette en liste over MCP-servere som trenger tokener. Åpne passordbehandleren og skriv inn nøklene i Codex-skjemaet. Etter det er hoveddelen av migreringen fullført.

Kontroller deretter resultatet. Åpne et prosjekt du vanligvis arbeidet med i Claude Code, og kontroller:

• cat ~/.codex/AGENTS.md — er de globale reglene dine der?
• Kjør en vilkårlig skill: $skill-name. Den skal lastes inn.
• Åpne .mcp.json i prosjektet og kontroller at de nødvendige serverne kjører.
• Start en samtale som gjenspeiler hvordan du vanligvis jobber. Codex viser hvilke importerte hooks det ikke kan bruke; dette er konkrete inventarelementer som må håndteres manuelt; ingen fast restandel er fastslått.

Hooks og underagenter: Codex-ekvivalenter og hva du må skrive om#

Hooks. I Claude Code kan du knytte en shell-kommando til hver livssyklushendelse (pre-tool-use, post-tool-use, on-error, on-context-load og så videre). Codex har et mindre utvalg hendelser: Det kan kontrollere før kjøring, registrere bevis og blokkere farlige kommandoer. Hvis du hadde en pre-tool-use-hook som filtrerte på en bestemt kombinasjon, må du i Codex pakke den inn i en generell kontroll før kjøring eller fjerne den. Jeg har forklart arkitekturen til Claude Code-hooks i detalj; hvis du brukte dem mye, list hver utløser og nødvendig effekt, finn støttet ekvivalent og verifiser den før aktivering.

Underagenter. I Claude Code er en underagent en separat kontekst med sin egen systemprompt, som startes via en /command eller fra hovedsamtalen. Codex har et tilsvarende konsept i profiler: Du kan definere en profil med et bestemt sett skills, tillatelser og godkjenningsregler. Profiler løser omtrent det samme problemet — å isolere konteksten for en bestemt kategori oppgaver — men gjennom innstillinger i stedet for en eksplisitt agentkall.

Dette betyr følgende i praksis:

• Hvis du hadde en "security-reviewer"-underagent med sin egen prompt, oppretter du en security-review-profil i Codex med de nødvendige tillatelsene og høyere reasoning effort.
• Hvis du hadde en "feature-developer"-underagent, er det ganske enkelt en standard arbeidsprofil; det trengs ikke noe spesielt.
• Hvis du brukte nestede underagenter, fungerer det ikke én til én i Codex; tenk det på nytt med en kjede av profiler eller eksplisitte skills.

Migreringsverktøyet prøver å opprette profiler ved hjelp av navnene på underagentene dine og markerer hvilke utløsere som ikke ble overført. Arbeidsmengden avhenger av antall roller, utløsere, tillatelser og avhengigheter. Test hver nødvendig pipeline før den regnes som migrert.

Når bør du migrere helt, og når bør du beholde begge verktøyene?#

Et enkelt beslutningsfilter:

Det gir mening å bytte helt til Codex hvis:

• Du hovedsakelig jobber med autonome PR-er og parallelle oppgaver.
• GitHub-arbeidsflyten din er dypt integrert, og Codex Cloud Agent håndterer 80 % av arbeidet.
• Du ikke bruker mye tid på arkitekturdiskusjoner og Plan Mode.
• Du vil betale for ett verktøy i stedet for to.

Behold Claude Code + Codex sammen hvis:

• Du jevnlig bruker Plan Mode til lange arkitekturbeslutninger.
• Du trenger parallelt arbeid: Codex kjører i skyen på én oppgave mens Claude Code holder konteksten for en annen.
• Du gjør mye engangshacking og mikroprosjekter der Plan Mode blir for omfattende.
• Du har en kompleks underagentpipeline som ikke kan skrives om på én kveld.

Jeg bruker personlig begge: Claude Code holder den lange samtalen, mens Codex kjører oppgaver som "fiks N feil parallelt" eller "gå gjennom en PR". Jeg har forklart mer om hvordan dette fungerer i veiledningen om å jobbe med Claude Code og Codex sammen.

Det viktigste jeg vil si om migrering, er dette: Migreringsverktøyet fjerner den tekniske hindringen for å bytte, men det svarer ikke på om du bør bytte i utgangspunktet. Bestem først hva slags arbeid du gjør. Velg deretter verktøyet.

Hvis du trenger tilgang til nevrale nettverk gjennom Ailoot, kan du ta en titt på Ailoot.