--- title: "Claude Code naar Codex migreren: wat neem je echt mee?" date: 2026-06-10 author: "Sam" featured_image: "https://promptcoaching.nl/wp-content/uploads/2026/06/openai-codex-import-flow-light-scaled.png" categories: - name: "Gidsen" url: "/category/gidsen.md" --- # Claude Code naar Codex migreren: wat neem je echt mee? Als je van Claude Code naar Codex overstapt, migreer je vooral je werkwijze. Niet alleen je prompt. Neem je instructiebestanden, skills, MCP servers, hooks, subagents en recente sessies mee. Controleer daarna per project of de agent nog dezelfde regels volgt, dezelfde tools mag gebruiken en dezelfde stopregels respecteert. De grootste fout is denken dat een importknop je teamgeheugen begrijpt. OpenAI’s Codex-migratieflow helpt met het overzetten van veel agent-context, maar jij moet beoordelen welke afspraken nog kloppen. Een oude Claude-regel kan in Codex te breed zijn. Een hook die in je vorige setup nuttig was, kan in een andere agent te veel rechten krijgen. En een sessie uit vorige week is handig als geheugensteun, maar geen bewijs dat de nieuwe agent je codebase kent. ## Wat OpenAI’s migratieflow doet OpenAI presenteert de migratiepagina als een manier om “from another coding agent” naar Codex te bewegen. De flow draait om drie stappen: 1. Importeren van bestaande agent-context. 2. Aanvullende setup nalopen. 3. Verder werken in Codex met de meegenomen context. De screenshots op de OpenAI-pagina laten precies zien waar dit interessant wordt: Codex kijkt niet alleen naar losse prompts, maar naar de werkafspraken om je project heen. Denk aan instructies, configuratie, skills, MCP servers, hooks, subagents en recente sessies. Dat is goed nieuws voor mensen die al serieus met Claude Code werkten. Je hoeft niet vanaf nul te beginnen. Maar importeren is geen kwaliteitscontrole. Zie het als een verhuisdoos: alles zit erin, ook de dingen die je beter niet opnieuw in je werkkamer zet. Er staat ook een officiele OpenAI-skill rond `migrate-to-codex` in de OpenAI skills-repository. Die skill richt zich op ondersteunde instructiebestanden, skills, agents en MCP-configuratie. Dat bevestigt het belangrijkste punt: migreren gaat niet over een losse prompt, maar over de operationele laag om je agent heen. ## Wat je wel en niet blind moet meenemen OnderdeelMeenemen?Controle`AGENTS.md`, `CLAUDE.md` of projectinstructiesJaHaal tool-specifieke commands eruit of maak ze expliciet per agent.Skills en workflowsJa, maar selectiefCheck triggers. Een te brede skill activeert op de verkeerde taak.MCP serversJa, met rechtencheckControleer toegang tot Gmail, GitHub, database, browser, filesystem en secrets.HooksAlleen als je ze begrijptEen hook die automatisch test of formatteert is prima. Een hook die live deployt vraagt om harde stopregels.SubagentsSelectiefZet alleen subagents over die een duidelijke taak, input en output hebben.Recente sessiesAls referentieGebruik ze niet als bron van waarheid voor requirements.Oude modelvoorkeurenNee, opnieuw kiezenModellen veranderen te snel. Kies opnieuw per taaktype.Mijn advies: importeer breed, activeer smal. Laat Codex eerst lezen, samenvatten en een migratieplan maken. Geef pas daarna toestemming voor edits, hooks of tools met schrijf- of deployrechten. ## Codex of Claude Code: kies niet religieus Veel mensen maken hier een fanboy-vraag van. Dat helpt niet. De praktische vraag is: welke agent maakt in jouw project de minste dure fouten? Claude Code blijft sterk als je al een volwassen Claude-setup hebt met goede `CLAUDE.md`-regels, terminalgewoontes en bestaande reviewflows. Codex is logisch als je dieper in OpenAI tooling zit, veel met OpenAI API’s werkt of je agentwerk vanuit een OpenAI-omgeving wilt standaardiseren. Voor serieuze projecten zou ik ze naast elkaar testen: TaakBeste testBugfix met bestaande testsLaat beide agents dezelfde failing test oplossen en vergelijk diff, testoutput en uitleg.Grote refactorMeet wie het kleinste werkende plan maakt en het minst ongevraagd verandert.Nieuwe featureKijk wie betere vragen stelt over randgevallen, data en UX.Content of promptworkflowCheck wie minder vulling schrijft en beter vasthoudt aan je tone-of-voice.Tooling en MCPControleer wie rechten, secrets en rollback beter behandelt.De winnaar is niet de agent met de mooiste uitleg. De winnaar is de agent die na verificatie de schoonste wijziging achterlaat. ## Laatste modellen: let op de taak, niet alleen op de naam Peildatum: 10 juni 2026. OpenAI noemt in de officiele modeldocs `gpt-5.5` als flagship voor complex reasoning en coding. Daarnaast staan `gpt-5.4`, `gpt-5.4-mini` en `gpt-5.4-nano` in de actuele modelkeuze voor lagere kosten of lagere latency. Anthropic noemt op dezelfde peildatum `claude-fable-5` als meest capabele breed beschikbare model, `claude-mythos-5` als limited availability via Project Glasswing, en daarnaast `claude-opus-4-8`, `claude-sonnet-4-6` en `claude-haiku-4-5`. Die namen zijn nuttig, maar ze lossen je migratie niet op. De vraag is per taak welk risico je neemt. De vuistregel: - Gebruik `gpt-5.5`, `claude-fable-5` of `claude-opus-4-8` voor architectuur, complexe refactors, securitygevoelige keuzes en migratieplannen. - Gebruik `gpt-5.4-mini`, `gpt-5.4-nano`, `claude-sonnet-4-6` of `claude-haiku-4-5` voor samenvatten, kleine tekstedits, simpele testfixes en bulkcontrole. - Gebruik geen goedkoop model voor taken met live systemen, klantdata, betalingen of productiedeploys. - Laat een agent nooit modelkeuze gebruiken als excuus om geen bewijs te leveren. Een goede migratieprompt noemt daarom niet alleen “gebruik het beste model”, maar ook: wat mag de agent lezen, wat mag hij aanpassen, welke tests gelden als bewijs en waar moet hij stoppen. ## Een migratieprompt die wel werkt Gebruik deze prompt nadat je de Codex-import hebt gedaan: ``` Lees eerst de geimporteerde agent-instructies, skills, MCP-configuratie, hooks en recente sessies. Maak daarna een migratierapport met: 1. Welke instructies nog bruikbaar zijn in Codex. 2. Welke instructies tool-specifiek zijn voor Claude Code, Cursor of een andere agent. 3. Welke MCP servers schrijf- of secret-risico hebben. 4. Welke hooks automatisch iets kunnen aanpassen, deployen, mailen, betalen of publiceren. 5. Welke skills te breed triggeren. 6. Welke drie projectregels je zou aanpassen voordat je code wijzigt. Voer nog geen edits uit. Geen hooks draaien. Geen externe tools gebruiken met schrijfrechten. Eindig met een korte safe-to-start checklist. ``` Die prompt is saai op de goede manier. Je laat de agent eerst de verhuizing inspecteren voordat hij de gereedschapskist openklapt. ## De KOMPAS-check voor agentmigratie Op Promptcoaching gebruiken we KOMPAS voor prompts en workflows. Voor Codex/Claude-migratie ziet die check er zo uit: - Kader: om welk project, welke repo, welke omgeving en welke rechten gaat het? - Opdracht: moet de agent analyseren, migreren, testen, documenteren of echt code wijzigen? - Maat: wat is klein genoeg voor deze sessie? - Paalwerk: welke bestanden, URL’s, tests en bronnen zijn leidend? - Afwerking: welk bewijs moet de agent opleveren? - Stopregels: wanneer moet de agent stoppen en jou vragen? Wie deze zes punten overslaat, krijgt vaak een agent die druk lijkt maar weinig controleerbaar werkt. ## Mijn nuchtere advies Zet Codex en Claude Code niet tegenover elkaar alsof je maar een gereedschap mag houden. Maak je agent-setup portabel. Schrijf projectregels in gewone markdown. Bewaar workflows als bestanden. Gebruik MCP bewust. Laat hooks nooit zonder stopregels draaien. En meet agentkwaliteit aan bewijs: tests, screenshots, logs, diff en rollback. De migratie naar Codex is dan geen sprong in het diepe. Het is een goede aanleiding om je AI-werkwijze op te ruimen. ## Update 12 juni 2026: wat OpenAI/Ona verandert aan Codex-werk OpenAI kondigde op 11 juni 2026 aan dat het Ona wil overnemen. De overname is nog niet definitief afgerond; OpenAI schrijft zelf dat de deal nog afhankelijk is van closing conditions en benodigde goedkeuringen. De relevante les voor deze migratiepagina is niet de overname zelf. Het gaat om de richting: Codex moet langer lopende taken kunnen doen in veilige, persistente werkomgevingen. Dat maakt een migratie van Claude Code naar Codex minder een promptverhuizing en meer een operationele keuze. Als een agent straks uren of dagen doorwerkt, moet je vóór de taak scherper zijn: - **Scope:** wat mag de agent aanpassen, en wat niet? - **Context:** welke bestanden, issues, rapporten en eerdere beslissingen zijn bron van waarheid? - **Credentials:** welke systemen mag de agent lezen, schrijven of juist niet aanraken? - **Checkpoints:** wanneer moet de agent stoppen voor review? - **Rollback:** hoe draai je een verkeerde wijziging terug zonder ander werk te raken? Mijn praktische regel blijft: importeer breed, activeer smal. Laat Codex eerst lezen, samenvatten en een plan maken. Geef pas daarna toestemming voor edits, hooks of tools met schrijf- en deployrechten. Bron: [OpenAI – OpenAI to acquire Ona](https://openai.com/index/openai-to-acquire-ona/). ## Verder lezen Claude reageert sterk op duidelijke rol, context en beoordelingscriteria. Geef dus niet alleen de taak, maar ook hoe het antwoord beoordeeld wordt. De instellingen die per model verschillen — en die je bij zo’n overstap opnieuw moet afwegen — staan in de [promptgidsen per model](/promptgidsen/).