Så migrerar du från Claude Code till Codex 2026: en steg-för-steg-guide

Ailoot-dokumentation: API, nycklar och konfiguration.

Varför behövs Codex migreringsverktyg över huvud taget?#

OpenAI lade till funktionen i Codex i början av juni 2026. Den officiella ändringsloggen beskriver det kort:

Med andra ord: när du startar Codex App för första gången, eller från inställningarna i en klient som redan körs, startar en guide som läser en annan agents lokala konfigurationer. Claude Code och Claude Cowork stöds för närvarande.

Det är tydligt varför OpenAI gör detta. Efter att Sites lanserades och Codex App uppdaterades i maj–juni 2026 fick Codex allt som Claude Code tidigare hade framför OpenAI: en terminal, pluginer, långa sessioner och orkestrering. Migreringen tar bort det sista hindret för team som redan har integrerat Claude Code i sin stack: "inställningar som stöds kan importeras och sedan kontrolleras mot ursprunglig inventering."

Varför du kan behöva det är mindre självklart. Jag jämförde dem sida vid sida i guiden Codex jämfört med Claude Code: Claude ligger fortfarande före när det gäller långa arkitekturdiskussioner och Plan Mode, medan Codex är snabbare på autonoma uppgifter och parallella PR:er. Om du har bestämt dig för att byta helt kan du läsa vidare. Om du funderar på att kombinera dem kan samarbetsmönstren vara mer relevanta.

Vad överför migreringsverktyget automatiskt?#

Jag går igenom grupperna och förklarar exakt vad som händer med varje del av ~/.claude.

1. Instruktioner och kontext. CLAUDE.md-filer—den globala i ~/.claude/ och projektfiler i kodförråd—konverteras till formatet AGENTS.md. Den globala filen hamnar i ~/.codex/AGENTS.md; projektfilerna blir kvar i kodförrådets rot och undermappar. Formatet AGENTS.md är i princip samma slags Markdown-fil med regler; skillnaderna är mest kosmetiska—rubriknamn och ett par specifika direktiv. Jag har förklarat vad AGENTS.md är och varför Codex behöver det.

2. Färdigheter. Hela mappen ~/.claude/skills/ skannas; varje färdighet anpassas till Codex struktur och placeras i $HOME/.agents/skills. Projektfärdigheter från .claude/skills/ i ett kodförråd flyttas till .agents/skills. Formatet SKILL.md med frontmatter överförs nästan som det är. Om en färdighet använder Claude-specifika utlösare flaggas den för granskning.

3. MCP-servrar. Konfigurationen .mcp.json (både global och på projektnivå) importeras till Codex-formatet. Servernamn, startkommandon och sökvägar bevaras. Det som inte överförs är token och miljövariabler. Av säkerhetsskäl ber Codex dig att ange API-nycklar och lösenord igen, så att de inte exponeras under migreringen. Detta är en engångsuppgift: öppna MCP-avsnittet i Codex App och ange tokenen du redan har i din lösenordshanterare.

4. Hooks. Det här är den komplicerade gruppen. Hooks med deterministisk logik (blockera rm -rf, avisera om sökvägar som liknar autentiseringsuppgifter, registrera belägg) överförs helt. Hooks med utlösare som saknar motsvarighet i Codex (till exempel specifika livscykelhändelser i Claude Code) markeras för "manuell granskning" och aktiveras inte automatiskt. Jag har förklarat i detalj hur hooks fungerar i Claude Code, som jämförelsepunkt—Codex har färre typer.

5. Sessionshistorik. Upp till de senaste 30 dagarna av aktivitet i Claude Code importeras som referens. Det betyder inte att du "fortsätter exakt där du slutade", men dina tidigare konversationer blir synliga i Codex så att du snabbt kan återkalla projektkontext utan att behöva förklara allt igen.

Migreringsverktyget skiljer inte mellan aktiva filer och experimentella artefakter—det överför allt. Efter migreringen är det klokt att manuellt rensa bort sådant du inte har använt på de senaste sex månaderna.

Vad överförs INTE, och varför?#

Jag går igenom varje grupp utifrån frågan "vad ska man göra efter migreringen?"

MCP-token och API-nycklar. Det här är den mest förutsägbara delen. Efter skanningen visar Codex en lista över alla MCP-servrar som hittats i Claude. Verktyget ber om nycklar och token för var och en. Det enklaste är att ha lösenordshanteraren till hands och gå igenom alla servrar vid ett och samma tillfälle. Därefter fungerar MCP likadant i Codex och Claude Code. Kontrollera att kommandot och anslutningsparametrarna för MCP-servern du valt stämmer med dess dokumentation.

Snedstreckskommandon /name. I Claude Code är du van vid att anropa en färdighet med /skill-name. I Codex är det kanoniska anropet annorlunda: $skill-name. Ett vanligt migreringsmisstag är att se /name-kommandon som bevis på att färdigheterna har laddats.

Testa efter migreringen några viktiga färdigheter med $skill-name i Codex. Om de fungerar har migreringen verkligen lyckats. Lita inte på kryssrutan "skills migrated" i guiden—verifiera genom att anropa dem.

Hooks utan motsvarighet i Codex. Om du hade en hook för specifika Claude Code-händelser—till exempel vid pre-tool-use för en viss kombination av verktyg—kanske den utlösaren inte finns i Codex. Migreringsverktyget flaggar dem och lämnar dem inaktiva. Du måste avgöra om du ska skriva om dem för en motsvarighet i Codex, ta bort dem eller behålla dem i Claude Code (om du kör det parallellt). En bra tumregel: överför bara deterministiska hooks; allt annat är ett skäl att inte kopiera stegen i den nya verktygskedjan.

Teamflöden som bygger på underagenter. Jag har förklarat vad underagenter är i Claude Code och hur man använder nästlade underagenter. I Codex organiseras underagenter genom profiler och roller (se nedan). Om du hade en komplex pipeline med flera underagenter i en kedja i Claude måste du skriva om den utifrån Codex profilkoncept. Migreringsverktyget markerar sådana konfigurationer som "kräver arkitektoniskt omarbete".

Omfattande, Claude-specifika CLAUDE.md-filer. Om en fil har vuxit till 2 000–3 000 rader med avsnitt för varje projekt kan Codex godta den, men det är ett dåligt upplägg. AGENTS.md är utformat för att vara kompakt och distribuerat: globala regler i ~/.codex/AGENTS.md, projektspecifika regler i kodförrådets rot och snäva åsidosättningar i undermappar. Låt inte CLAUDE.md vara en "gigantisk instruktionsfil" efter migreringen; dela upp den mellan nivåerna. Jag har förklarat hur man konfigurerar CLAUDE.md på rätt sätt; samma upplägg fungerar även för AGENTS.md.

Steg för steg: 4 åtgärder i Codex App#

Här är den konkreta checklistan.

1. Steg 1: Uppdatera Codex App till 26.608 eller senare

   Migreringsverktyget dök upp i version 26.608 (släppt den 9 juni 2026). På macOS öppnar du Codex App och söker efter uppdateringar. Gör samma sak på Windows. Om du kör Codex CLI ska du se till att det är kompatibelt med den aktuella appen. Utan den senaste versionen visas inte "Import other agent setup" i Settings.

2. Steg 2: Starta importen från Settings

   I Codex App öppnar du Settings och letar upp "Import other agent setup". Om du precis har installerat Codex App erbjuder guiden migrering under introduktionen. När den har startats skannar guiden filsystemet: ~/.claude/ och kodförråd som innehåller CLAUDE.md eller .claude/. Skanningen tar mellan 30 sekunder och flera minuter, beroende på antalet filer.

3. Steg 3: Bekräfta migreringsplanen

   Efter skanningen visar Codex en inventering: hur många färdigheter som hittades, hur många MCP-servrar, hur många CLAUDE.md-filer som hittades, vilka hooks som kan migreras och hur många dagars sessionshistorik som finns tillgänglig. Du kan avmarkera grupper du inte vill överföra. Som standard väljs allt som Codex bedömer säkert att importera.

4. Steg 4: Vänta tills det är klart och ange token

   Importen tar 1–5 minuter. När den är klar öppnar Codex ett uppföljningsfönster: "här är det jag inte kunde överföra automatiskt; kontrollera det manuellt." Vanligtvis är detta en lista över MCP-servrar som behöver token. Öppna lösenordshanteraren och ange nycklarna i Codex-formuläret. Därefter är huvuddelen av migreringen klar.

Verifiera sedan resultatet. Öppna ett projekt som du vanligtvis arbetade med i Claude Code och kontrollera:

• cat ~/.codex/AGENTS.md — finns dina globala regler där?
• Kör valfri färdighet: $skill-name. Den ska läsas in.
• Öppna .mcp.json i projektet och kontrollera att de nödvändiga servrarna körs.
• Starta en konversation som speglar hur du brukar arbeta. Codex visar vilka importerade hooks den inte kan använda; det här är specifika inventeringsposter att hantera manuellt; ingen fast återstående andel fastställs.

Hooks och underagenter: motsvarigheter i Codex och vad som behöver skrivas om#

Hooks. I Claude Code kan du koppla ett shell-kommando till varje livscykelhändelse (pre-tool-use, post-tool-use, on-error, on-context-load och så vidare). Codex har färre händelser: det kan kontrollera före körning, registrera belägg och blockera farliga kommandon. Om du hade en pre-tool-use-hook som filtrerade efter en viss kombination måste du i Codex lägga in den i en generell kontroll före körning eller ta bort den. Jag har förklarat arkitekturen för Claude Code-hooks i detalj; om du använde dem mycket listar du varje utlösare och nödvändig effekt, identifierar stött motsvarighet och verifierar den före aktivering.

Underagenter. I Claude Code är en underagent en separat kontext med en egen systemprompt, som startas via ett /command eller från huvudkonversationen. Codex har ett liknande koncept i profiler: du kan definiera en profil med en specifik uppsättning färdigheter, behörigheter och godkännandepolicy. Profiler löser ungefär samma problem—att isolera kontext för en viss typ av uppgifter—men via inställningar i stället för ett uttryckligt agentanrop.

Vad detta innebär i praktiken:

• Om du hade en "security-reviewer"-underagent med en egen prompt skapar du en security-review-profil i Codex med de behörigheter som krävs och högre resonemangsnivå.
• Om du hade en "feature-developer"-underagent är det helt enkelt en arbetsprofil som standard; inget särskilt behövs.
• Om du använde nästlade underagenter fungerar det inte ett till ett i Codex; tänk om och använd en kedja av profiler eller uttryckliga färdigheter.

Migreringsverktyget försöker skapa profiler med dina underagentnamn och flaggar vilka utlösare som inte överfördes. Arbetet beror på antal roller, utlösare, behörigheter och beroenden; testa varje nödvändig pipeline innan den räknas som migrerad.

När ska man migrera helt och när ska man behålla båda verktygen?#

Ett enkelt beslutsfilter:

Byt helt till Codex om:

• Du främst arbetar med autonoma PR:er och parallella uppgifter.
• Ditt GitHub-arbetsflöde är djupt integrerat och Codex Cloud Agent hanterar 80 % av arbetet.
• Du lägger inte mycket tid på arkitekturdiskussioner och Plan Mode.
• Du vill betala för ett verktyg i stället för två.

Behåll Claude Code och Codex tillsammans om:

• Du regelbundet använder Plan Mode för långa arkitekturbeslut.
• Du behöver arbeta parallellt: Codex körs i molnet med en uppgift medan Claude Code behåller kontexten för en annan.
• Du gör många engångshack och mikroprojekt där Plan Mode är överdrivet.
• Du har en komplex pipeline med underagenter som inte kan skrivas om på en kväll.

Jag använder personligen båda: Claude Code håller i den långa konversationen, medan Codex tar hand om "fixa N buggar parallellt" eller "granska en PR". Jag har förklarat mer om hur detta fungerar i guiden till att arbeta med Claude Code och Codex tillsammans.

Det viktigaste jag vill säga om migrering är detta: migreringsverktyget tar bort det tekniska hindret för att byta, men det besvarar inte frågan om du behöver byta från början. Bestäm först vilken typ av arbete du utför. Välj sedan verktyg.

Om du behöver åtkomst till neurala nätverk via Ailoot kan du ta en titt på Ailoot.