Sådan migrerer du fra Claude Code til Codex i 2026: en trinvis vejledning

Ailoot-dokumentation: API, nøgler og opsætning.

Hvorfor er Codex-migreringsværktøjet overhovedet nødvendigt?#

OpenAI tilføjede funktionen til Codex i begyndelsen af juni 2026. Den officielle changelog beskriver det kort:

Med andre ord: Når du starter Codex App for første gang, eller fra indstillingerne i en klient, der allerede kører, åbner en guide, som læser en anden agents lokale konfigurationer. Claude Code og Claude Cowork understøttes i øjeblikket.

Det er tydeligt, hvorfor OpenAI gør det. Efter lanceringen af Sites og opdateringen af Codex App i maj–juni 2026 fik Codex alt det, Claude Code tidligere havde foran OpenAI: en terminal, plugins, lange sessioner og orkestrering. Migreringen fjerner den sidste barriere for teams, der allerede har integreret Claude Code i deres stack: "understøttede indstillinger kan importeres og derefter kontrolleres mod den oprindelige oversigt."

Hvorfor du måske har brug for det, er mindre ligetil. Jeg sammenlignede dem direkte i vejledningen om Codex kontra Claude Code: Claude er stadig foran til lange arkitekturdiskussioner og Plan Mode, mens Codex er hurtigere til autonome opgaver og parallelle PR'er. Hvis du har besluttet dig for at skifte helt, så læs videre. Hvis du overvejer en kombination, kan samarbejdsmønstrene være mere relevante.

Hvad overfører migreringsværktøjet automatisk?#

Jeg gennemgår grupperne og forklarer præcist, hvad der sker med hver del af ~/.claude.

1. Instruktioner og kontekst. CLAUDE.md-filer—den globale fil i ~/.claude/ og projektfiler i repositories—konverteres til formatet AGENTS.md. Den globale fil ender i ~/.codex/AGENTS.md; projektfilerne forbliver i repositoryets rodmappe og undermapper. AGENTS.md-formatet er grundlæggende den samme slags Markdown-fil med regler; forskellene er for det meste kosmetiske—afsnitsnavne og et par specifikke direktiver. Jeg har forklaret hvad AGENTS.md er, og hvorfor Codex har brug for den.

2. Skills. Hele mappen ~/.claude/skills/ scannes; hver skill tilpasses Codex-strukturen og placeres i $HOME/.agents/skills. Projektskills fra .claude/skills/ i et repository flyttes til .agents/skills. Formatet SKILL.md med frontmatter overføres næsten uændret. Hvis en skill bruger Claude-specifikke udløsere, markeres den til gennemgang.

3. MCP-servere. Konfigurationen .mcp.json (både globalt og på projektniveau) importeres til Codex-formatet. Servernavne, startkommandoer og stier bevares. Det, der ikke overføres, er tokens og miljøvariabler. Af sikkerhedshensyn beder Codex dig om at indtaste API-nøgler og adgangskoder igen, så de ikke eksponeres under migreringen. Det er en engangsopgave: Åbn MCP-afsnittet i Codex App, og indtast de tokens, du allerede har i din adgangskodeadministrator.

4. Hooks. Det er den komplicerede gruppe. Hooks med deterministisk logik (blokering af rm -rf, alarmer ved stier, der ligner legitimationsoplysninger, registrering af dokumentation) overføres fuldt ud. Hooks med udløsere, der ikke har en tilsvarende funktion i Codex (for eksempel specifikke livscyklushændelser i Claude Code), markeres til "manuel gennemgang" og aktiveres ikke automatisk. Jeg har forklaret hvordan hooks fungerer i Claude Code i detaljer som sammenligningsgrundlag—Codex har færre typer.

5. Sessionshistorik. Op til de seneste 30 dages Claude Code-aktivitet importeres som reference. Det betyder ikke, at du "fortsætter præcis, hvor du slap", men dine tidligere samtaler bliver synlige i Codex, så du hurtigt kan genkalde projektkontekst uden at skulle forklare alting igen.

Migreringsværktøjet skelner ikke mellem aktive filer og eksperimentelle artefakter—det overfører alt. Efter migreringen er det nyttigt manuelt at rydde op i det, du ikke har brugt de seneste seks måneder.

Hvad overføres IKKE, og hvorfor?#

Jeg gennemgår hver gruppe med fokus på spørgsmålet "hvad skal du gøre efter migreringen?"

MCP-tokens og API-nøgler. Dette er den mest forudsigelige del. Efter scanningen viser Codex en liste over alle de MCP-servere, den fandt i Claude. Den beder om nøgler og tokens til hver enkelt. Det er nemmest at have adgangskodeadministratoren ved hånden og gennemgå alle serverne på én gang. Derefter fungerer MCP ens i Codex og Claude Code. Kontrollér kommandoen og forbindelsesparametrene for den MCP-server, du har valgt, i forhold til dens dokumentation.

Slash-kommandoer /name. I Claude Code er du vant til at kalde en skill med /skill-name. I Codex er den kanoniske måde at kalde den på anderledes: $skill-name. En almindelig migreringsfejl er at betragte /name-kommandoer som bevis på, at skills er indlæst.

Efter migreringen bør du teste nogle vigtige skills med $skill-name i Codex. Hvis de virker, er migreringen faktisk lykkedes. Stol ikke på afkrydsningsfeltet "skills migrated" i guiden—bekræft det ved at kalde dem.

Hooks uden en tilsvarende funktion i Codex. Hvis du havde en hook til bestemte Claude Code-hændelser—for eksempel ved pre-tool-use for en bestemt kombination af værktøjer—findes den udløser måske ikke i Codex. Migreringsværktøjet markerer dem og lader dem være inaktive. Du må beslutte, om du vil omskrive dem til noget tilsvarende i Codex, fjerne dem eller beholde dem i Claude Code (hvis du kører det parallelt). En god tommelfingerregel: Overfør kun deterministiske hooks; alt andet er en grund til ikke at kopiere hele stigen til det nye værktøj.

Teamarbejdsgange baseret på underagenter. Jeg har forklaret hvad underagenter er i Claude Code og hvordan man bruger indlejrede underagenter. I Codex organiseres underagenter gennem profiler og roller (se nedenfor). Hvis du havde en kompleks pipeline med flere underagenter i en kæde i Claude, skal du omskrive den med udgangspunkt i Codex' profilkoncept. Migreringsværktøjet markerer sådanne opsætninger som "kræver arkitektonisk omarbejdning".

Store, Claude-specifikke CLAUDE.md-filer. Hvis en fil er vokset til 2.000–3.000 linjer med afsnit for hvert projekt, accepterer Codex den måske, men det er en dårlig praksis. AGENTS.md er designet til at være kompakt og fordelt: globale regler i ~/.codex/AGENTS.md, projektspecifikke regler i repositoryets rodmappe og snævre tilsidesættelser i undermapper. Efter migreringen skal du ikke lade CLAUDE.md være en "kæmpe instruktionsfil"; fordel indholdet på flere niveauer. Jeg har forklaret hvordan man konfigurerer CLAUDE.md korrekt; samme fremgangsmåde gælder for AGENTS.md.

Trin for trin: 4 handlinger i Codex App#

Her er den konkrete tjekliste.

1. Trin 1: Opdater Codex App til 26.608 eller nyere

   Migreringsværktøjet kom i version 26.608 (udgivet den 9. juni 2026). På macOS åbner du Codex App og søger efter opdateringer. Gør det samme på Windows. Hvis du bruger Codex CLI, skal du sikre dig, at den er kompatibel med den aktuelle App. Uden den nyeste version vises "Import other agent setup" ikke i Settings.

2. Trin 2: Start importen fra Settings

   Åbn Settings i Codex App, og find "Import other agent setup". Hvis du lige har installeret Codex App, tilbyder guiden migrering under introduktionen. Når den er startet, scanner guiden filsystemet: ~/.claude/ og repositories, der indeholder CLAUDE.md eller .claude/. Scanningen tager fra 30 sekunder til flere minutter, afhængigt af antallet af filer.

3. Trin 3: Bekræft migreringsplanen

   Efter scanningen viser Codex en oversigt: hvor mange skills der blev fundet, hvor mange MCP-servere, hvor mange CLAUDE.md-filer der blev fundet, hvilke hooks der kan migreres, og hvor mange dages sessionshistorik der er tilgængelig. Du kan fjerne markeringen af grupper, du ikke vil overføre. Som standard er alt, hvad Codex anser for sikkert at importere, valgt.

4. Trin 4: Vent, til importen er færdig, og indtast tokens

   Importen tager 1–5 minutter. Når den er færdig, åbner Codex et opfølgningsvindue: "her er det, jeg ikke kunne overføre automatisk; kontrollér det manuelt." Normalt er det en liste over MCP-servere, der skal bruge tokens. Åbn adgangskodeadministratoren, og indtast nøglerne i Codex-formularen. Derefter er hoveddelen af migreringen færdig.

Bekræft derefter resultatet. Åbn et projekt, du normalt arbejdede på i Claude Code, og kontrollér:

• cat ~/.codex/AGENTS.md — er dine globale regler der?
• Kør en vilkårlig skill: $skill-name. Den bør blive indlæst.
• Åbn .mcp.json i projektet, og kontrollér, at de nødvendige servere kører.
• Start en samtale, der afspejler, hvordan du typisk arbejder. Codex viser, hvilke importerede hooks den ikke kan bruge; det er konkrete oversigtsposter, du skal håndtere manuelt; ingen fast rest er dokumenteret.

Hooks og underagenter: tilsvarende funktioner i Codex, og hvad der skal omskrives#

Hooks. I Claude Code kan du knytte en shell-kommando til hver livscyklushændelse (pre-tool-use, post-tool-use, on-error, on-context-load osv.). Codex har færre hændelser: Den kan kontrollere før udførelse, registrere dokumentation og blokere farlige kommandoer. Hvis du havde en pre-tool-use-hook, der filtrerede efter en bestemt kombination, skal du i Codex indarbejde den i en generel kontrol før udførelse eller fjerne den. Jeg har forklaret arkitekturen bag Claude Code-hooks i detaljer; hvis du brugte dem meget, skal du opregne hver udløser og krævet effekt, finde en understøttet tilsvarende funktion og verificere den før aktivering.

Underagenter. I Claude Code er en underagent en separat kontekst med sin egen systemprompt, der startes via en /command eller fra hovedsamtalen. Codex har et lignende koncept i profiler: Du kan definere en profil med et bestemt sæt skills, tilladelser og godkendelsespolitik. Profiler løser omtrent det samme problem—at isolere kontekst til en bestemt opgaveklasse—men via indstillinger i stedet for et eksplicit agentkald.

Hvad det betyder i praksis:

• Hvis du havde en "security-reviewer"-underagent med sin egen prompt, skal du oprette en security-review-profil i Codex med de nødvendige tilladelser og et højere niveau for ræsonnering.
• Hvis du havde en "feature-developer"-underagent, er det blot en arbejdsprofil som standard; der kræves ikke noget særligt.
• Hvis du brugte indlejrede underagenter, fungerer det ikke én til én i Codex; gentænk det med en kæde af profiler eller eksplicitte skills.

Migreringsværktøjet forsøger at oprette profiler med dine underagentnavne og markerer, hvilke udløsere der ikke blev overført. Arbejdsbehovet afhænger af antal roller, udløsere, tilladelser og afhængigheder; test hver nødvendig pipeline, før du betragter den som migreret.

Hvornår skal du migrere helt, og hvornår skal du beholde begge værktøjer?#

En enkel beslutningsmodel:

Skift helt til Codex, hvis:

• Du hovedsageligt arbejder med autonome PR'er og parallelle opgaver.
• Dit GitHub-arbejdsforløb er dybt integreret, og Codex Cloud Agent håndterer 80 % af arbejdet.
• Du ikke bruger meget tid på arkitekturdiskussioner og Plan Mode.
• Du vil betale for ét værktøj i stedet for to.

Brug Claude Code og Codex sammen, hvis:

• Du jævnligt bruger Plan Mode til lange arkitekturbeslutninger.
• Du har brug for parallelle arbejdsgange: Codex kører i skyen på én opgave, mens Claude Code holder konteksten for en anden.
• Du laver mange engangshacks og mikroprojekter, hvor Plan Mode er for omfattende.
• Du har en kompleks pipeline med underagenter, der ikke kan omskrives på én aften.

Jeg bruger personligt begge: Claude Code holder den lange samtale, mens Codex tager sig af "ret N fejl parallelt" eller "gennemgå en PR". Jeg har forklaret mere om, hvordan det fungerer, i vejledningen til at arbejde med Claude Code og Codex sammen.

Det vigtigste, jeg vil sige om migrering, er dette: Migreringsværktøjet fjerner den tekniske barriere for at skifte, men det besvarer ikke, om du overhovedet behøver at skifte. Beslut først, hvilken slags arbejde du udfører. Vælg derefter værktøjet.

Hvis du har brug for adgang til neurale netværk via Ailoot, kan du se nærmere på Ailoot.