Workflow
Een taak van Claude Code aan Codex overdragen zonder context te verliezen
Je Claude-limiet is halverwege een refactor bereikt, of je wilt een second opinion. Dit moet er mee naar de volgende agent, en zo krijg je het daar op drie manieren.
Kort antwoord
Geen van beide agents laadt het transcript van de ander, dus je draagt de taak over met een briefing: het doel en je laatste instructie, het plan, de aangepaste bestanden en de git-status, met de code zelf op schijf. Zet gedeelde regels in AGENTS.md, commit je lopende werk of leg het vast met git stash create, en schrijf de briefing dan zelf, genereer hem met een tool als hop, of laat een app zoals Maude hem bouwen als je wisselt.
Je kunt midden in een taak van Claude Code naar Codex wisselen zonder opnieuw te beginnen, maar geen van beide agents pakt uit zichzelf het gesprek van de ander op. Wat een taak overdraagt, is een korte briefing: het doel, het plan, de aangepaste bestanden, de git-status en je laatste instructie, plus de code op schijf. Die briefing kun je met de hand schrijven, met een kleine tool genereren, of door een app laten bouwen als je wisselt.
Waarom je een taak tussen coding agents overdraagt
- Je loopt tegen een limiet aan. Dat is de meest voorkomende reden. Je Claude-abonnement is halverwege een refactor door zijn gebruik heen, en je ChatGPT-abonnement heeft nog ruimte. Wachten op de reset kost uren, en opnieuw beginnen in Codex kost de context.
- Een second opinion. Een agent draait rondjes rond een bug. Een ander model dat dezelfde code met een schone context leest, ziet vaak wat de eerste niet meer zag. Een agent de diff van een ander laten reviewen voordat je commit, is bovendien goedkoop.
- Verschillende sterke punten. Mensen gebruiken de ene agent voor planning en de andere voor lange mechanische wijzigingen, of houden er een aan voor een taal of framework waar die bij hen goed mee overweg kan. Wie waarin beter is, verandert met elke modelrelease, dus zie het als je eigen oordeel, niet als regel.
Kan Codex de sessie van Claude Code lezen?
Niet uit zichzelf. Beide agents bewaren volledige transcripten als JSONL-bestanden op schijf. Claude Code schrijft ze naar ~/.claude/projects/<project>/<session>.jsonl (documentatie van Claude Code), en Codex naar gedateerde rollout-*.jsonl-bestanden onder ~/.codex/sessions/. Elk hervat zijn eigen sessies (claude --resume, codex resume), maar geen van beide documenteert het laden van die van de ander. Het commando /import van Claude Code neemt de configuratie van een andere agent over, zoals instructiebestanden, MCP-servers en skills. Het gesprek neemt het niet over.
Je zou de nieuwe agent naar het ruwe transcriptbestand kunnen verwijzen. In de praktijk is dat een slechte briefing: lang, vol tooloutput, en het enige wat de nieuwe agent nodig heeft – waar je staat en wat er nu komt – raakt erin ondergesneeuwd.
Welke context mee moet
| Context | Waarom het ertoe doet | Waar het vandaan komt |
|---|---|---|
| Doel en laatste instructie | De nieuwe agent moet weten wat “klaar” betekent en waar je het laatst om vroeg | Je laatste prompt, woord voor woord |
| Plan / takenlijst | Het voorkomt dat de agent werk opnieuw plant dat al is afgebakend | De takenlijst van de vertrekkende agent |
| Aangepaste bestanden | Het vertelt de agent waar hij moet lezen voordat hij iets wijzigt | De wijzigingen in het transcript, plus git status |
| Git-status | Branch, HEAD en niet-gecommitte wijzigingen. Zonder die gegevens doet de nieuwe agent werk misschien opnieuw of commit hij eroverheen | git status, git diff --stat |
| Beslissingen en doodlopende sporen | Zodat de nieuwe agent geen aanpak opnieuw probeert die al mislukt is | Het recente gesprek, of een geschreven samenvatting |
Projectconventies, zoals buildcommando's en codestijl, horen helemaal niet in de briefing. Die horen in instructiebestanden die beide agents al lezen.
Zelf doen: gedeelde instructies met AGENTS.md en CLAUDE.md
Codex stelt zijn instructies samen uit AGENTS.md-bestanden, uit ~/.codex/ en van de git-root tot aan je werkmap (documentatie van Codex over AGENTS.md). Sinds v2.1.277 leest Claude Code ook AGENTS.md, maar standaard alleen als er geen CLAUDE.md of CLAUDE.local.md in je werkmap of erboven staat (documentatie van Claude Code over memory). De eenvoudigste opzet die beide agents lezen: zet gedeelde regels in AGENTS.md, en als je regels alleen voor Claude nodig hebt, begin je CLAUDE.md met een import:
@AGENTS.md
## Claude Code
Use plan mode for changes under src/billing/.De andere richting werkt ook. Met de instelling project_doc_fallback_filenames in ~/.codex/config.toml leest Codex extra bestandsnamen als er geen AGENTS.md is.
Zelf doen: een overdrachtsdocument en git
Vraag de vertrekkende agent vóór het wisselen om de briefing te schrijven zolang hij de context nog heeft, als hij nog gebruik over heeft:
Write HANDOFF.md for another coding agent taking over this task:
the goal, what is done, what is in progress or broken, decisions
and dead ends, files touched, and the exact next steps.
Don't change any other file.Maak daarna de toestand van de code eenduidig. Lopend werk naar een branch committen is de duidelijkste optie. Wil je liever niet committen, dan legt git stash create de niet-gecommitte wijzigingen aan gevolgde bestanden vast als commit-object, zonder je werkmap aan te raken. Zo heb je een vast punt om tegen te diffen als de volgende agent de mist ingaat. Start de andere agent in dezelfde map en zeg hem HANDOFF.md te lezen en bestanden opnieuw te lezen voordat hij iets wijzigt.
Tools die het automatiseren
hop (MIT) doet dit met één commando: hop codex van Claude Code naar Codex, hop cc andersom. Het leest de sessiebestanden van de bronagent direct, dus het werkt ook als die agent geen quotum meer heeft. Je kunt ! hop codex uitvoeren vanuit een vastgelopen Claude Code-sessie. Het schrijft een overdrachtsdocument met je instructies, de git-branch en het recente gesprek, binnen een groottebudget (standaard 48 KB), en opent de andere agent in een nieuw terminaltabblad. Vergelijkbare projecten zijn cli-handoff en session-handoff.
| Aanpak | Werkt zonder quotum | Moeite per wissel | Neemt het gesprek mee |
|---|---|---|---|
| Alleen gedeelde AGENTS.md | Ja | Geen, maar het draagt conventies over, niet de stand van de taak | Nee |
| Door de agent geschreven HANDOFF.md + git | Alleen als de vertrekkende agent nog antwoordt | Een prompt en een commit | Als samenvatting |
| hop en vergelijkbare CLI's | Ja | Eén commando | Recente beurten, binnen budget |
| Een app met ingebouwd wisselen | Ja | Eén tik | Hangt van de app af |
Hoe overdracht in Maude werkt
Maude draait je agents op je eigen server, en een sessie zit niet vast aan één agent. Zolang een sessie inactief is, kun je hem vanaf je telefoon wisselen van bijvoorbeeld Claude Code naar Codex (of OpenCode, Grok Build of Antigravity). De daemon op de server bouwt de briefing uit het eigen logboek van de sessie, niet uit een samenvatting die onder druk is geschreven:
- een kader dat de nieuwe agent vertelt dat hij het overneemt, dat de bestanden op schijf leidend zijn en dat hij opnieuw moet lezen voordat hij iets wijzigt
- je laatste instructie, vastgezet
- het huidige plan of de takenlijst
- de aangepaste bestanden, uit de wijzigingen van de agent plus de bestanden die git als gewijzigd meldt
- de git-status: branch, HEAD, korte status en diff-statistiek. Niet-gecommit werk wordt ook als snapshot vastgelegd met
git stash createen onder een ref bewaard, zonder je werkmap aan te raken - het recente gesprek, letterlijk, tot ongeveer 120.000 tekens
- een verwijzing naar het volledige transcript, als markdown geëxporteerd naar
.maude/handoff/in het project en buitengit statusgehouden
De briefing gaat vóór je volgende bericht naar de nieuwe agent, en de chat toont een scheidingslijn die je kunt uitklappen om precies te lezen wat er is verstuurd. Omdat de briefing uit het logboek van de sessie wordt gebouwd, hangt hij er niet van af of de vertrekkende agent nog kan antwoorden, en dat doet er het meest toe als die net zijn limiet heeft bereikt.
Terugwisselen werkt anders. Heeft de agent naar wie je terugkeert al in deze sessie gewerkt en ondersteunt hij hervatten, dan hervat Maude het eigen gesprek van die agent en stuurt alleen wat er gebeurde terwijl hij weg was. Hij krijgt geen tweede volledige briefing.
Maude is niet de enige app die dit doet. Met Happier wissel je midden in het gesprek van engine, en krijgt de nieuwe agent tools om het eerdere transcript te lezen. AgentsRoom maakt bij het wisselen van provider een overdrachtssamenvatting van gewijzigde bestanden, sessieactiviteit en het laatste antwoord. We vergelijken de afwegingen in Maude vs Happier. Welke agents je combineert, lees je in Claude Code vs Codex vs OpenCode.
Veelgestelde vragen
Kan Codex de sessie van Claude Code lezen?
~/.claude/projects/, en Codex laadt die niet. Je draagt de taak over met een briefing: zelf schrijven, genereren met een tool als hop, of een app gebruiken die hem bouwt als je wisselt.Botsen AGENTS.md en CLAUDE.md?
AGENTS.md alleen als er geen CLAUDE.md is. Om één bestand te delen, zet je je regels in AGENTS.md en zet je @AGENTS.md bovenaan CLAUDE.md. Codex leest AGENTS.md native.Wat als ik midden in een taak mijn Claude-limiet bereik?
Verlies ik mijn niet-gecommitte wijzigingen als ik van agent wissel?
git stash create uitvoeren geeft je een vast vergelijkingspunt als de volgende agent de mist ingaat.
