Normaal vraagt Claude Code elke toolaanroep direct aan en leest het het resultaat voordat het beslist wat de volgende stap is. Met Code Mode, toegevoegd in versie 2.1.323 op 12 november 2026, schrijft Claude een kort stukje JavaScript dat meerdere toolaanroepen in één stap doet. In deze handleiding lees je hoe je hem aanzet, uitprobeert op een echte taak, de code leest die Claude schreef en hem weer uitzet.
Op 15 november 2026 is Code Mode experimenteel en staat hij standaard uit. Volgens de documentatie van Anthropic kan hij in elke release veranderen of verdwijnen.
Wat Code Mode doet
In een normale sessie vraagt Claude tools zoals Bash, Read of Edit direct aan en leest het elk resultaat voor de volgende stap. In een Code Mode-sessie typ je je prompt nog steeds in gewone taal, maar schrijft Claude JavaScript om hem uit te voeren. Eén stuk code kan commando’s parallel draaien, het ene resultaat doorgeven aan de volgende aanroep en alleen het deel van de uitvoer teruggeven dat Claude echt moet lezen.
De documentatie over Code Mode van Anthropic geeft dit voorbeeld van wat Claude zou kunnen schrijven als je vraagt een retry-limiet te verhogen. De code zoekt het bestand, bewerkt het en draait de tests:
const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });
Jij schrijft deze code niet en standaard zie je hem ook niet. Het gesprek toont de toolaanroepen, zoals de diff van de bewerking.
De documentatie raadt aan het te proberen bij taken met veel samenhangende toolaanroepen:
- een wijziging die in veel bestanden terugkomt;
- een zoekopdracht waarvan de resultaten gefilterd moeten worden voordat Claude ze leest;
- meerdere losse commando’s die tegelijk kunnen draaien.
Lees eerst de beperkingen
Code Mode heeft echte nadelen. Check of je daarmee kunt leven voordat je hem aanzet:
- Hervatten: een Code Mode-sessie kun je alleen in de terminal hervatten, met Code Mode aan.
- Code die lang draait: tenzij de code op de achtergrond kan draaien (zie stap 6), wacht je erop, en na tien minuten stopt hij.
- Ontbrekende functies: Remote Control, Claude in Chrome en computer use werken niet in een Code Mode-sessie, en je kunt de sessie niet naar de Desktop-app verplaatsen.
Wat je nodig hebt
- Claude Code v2.1.323 of nieuwer, geïnstalleerd met de native build.
- Een Claude-abonnement of een Claude Console-account. Code Mode werkt niet via een gateway, Amazon Bedrock, Claude Platform on AWS, het Agent Platform van Google Cloud of Microsoft Foundry.
- Een van deze modellen: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 of Fable 5.2.
- Een interactieve
claude-sessie in een terminal. Het werkt niet met-p, de Agent SDK, het VS Code-paneel, de Desktop-app of cloudsessies. - Op Windows: Git for Windows geïnstalleerd.
- Een organisatie die geen HIPAA-configuratie of zero data retention gebruikt.
Stap 1: controleer je versie
claude --version
Is het nummer lager dan 2.1.323, update dan:
claude update
Zit je op het releasekanaal stable en komt de update nog niet tot 2.1.323, dan zegt de documentatie dat je moet wachten tot stable bijgewerkt is, of moet overstappen naar latest.
Stap 2: start Claude Code met Code Mode aan
Code Mode wordt geregeld met één omgevingsvariabele, CLAUDE_CODE_EXPERIMENTAL_CODE_MODE. Wil je het één keer proberen, stel de variabele dan in voor één keer opstarten.
macOS, Linux of WSL:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Windows PowerShell:
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
Wil je hem voor elke nieuwe sessie aanzetten, voeg dan een env-blok toe aan je gebruikersinstellingen in ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Claude Code negeert deze variabele in de instellingenbestanden van een project, dus een repository die je kloont kan Code Mode niet voor je aanzetten.
Stap 3: bevestig de vraag
Voor je eerste Code Mode-sessie vraagt Claude Code je om te bevestigen. Kies Yes, turn on Code Mode (ja, zet Code Mode aan). Claude Code start opnieuw op en toont deze regel bovenaan de sessie:
Code Mode (experimental) is on · this session can be resumed only with Code Mode on
Zie je een andere regel, of helemaal geen, ga dan naar het deel over fouten hieronder.
Stap 4: geef Claude een taak met veel toolaanroepen
Probeer in een project dat je goed kent de prompt uit de documentatie:
Read every Markdown file in this project and list the links that point to local files that don't exist.
Nog een prompt die in het patroon past:
Run the linter, the type checker and the unit tests at the same time, then summarize only the failures.
Verwacht resultaat: Claude antwoordt zoals gewoonlijk, en je ziet de toolaanroepen die het deed.
Stap 5: lees de code die Claude schreef
Druk op Ctrl+O om de transcriptweergave te openen. Elk stuk code verschijnt als een ingeklapte rij Code. Klap er een uit om het JavaScript achter de toolaanroepen te zien en druk daarna weer op Ctrl+O om terug te gaan naar het gesprek.
Stap 6: regel rechten en lange taken
Je bestaande veiligheidsinstellingen blijven gelden. Elke toolaanroep die de code doet, gaat langs je rechtenregels deny en ask en je PreToolUse-hooks, en je hoeft geen regel te wijzigen voor een tool als Bash.
Wat verandert, is hoe de code wordt beoordeeld:
- In auto mode beoordeelt een classifier elk stuk code voordat het draait, niet elke toolaanroep. Hij ziet geen waarden die pas tijdens het draaien ontstaan, zoals een pad uit zoekresultaten. Houd regels of hooks aan voor alles wat je echt onder controle moet hebben.
- In andere rechtenmodi start de code zonder beoordeling, en krijg je een vraag bij elke toolaanroep waarvoor je normaal ook een vraag zou krijgen.
Bij lange builds of testruns wacht Claude op de code, die na tien minuten stopt, of laat het hem op de achtergrond doorlopen, waar hij tot twee uur kan draaien terwijl jij gewoon verder praat. Achtergrondcode vereist een sessie die gestart is in auto mode of in de modus bypassPermissions. Heb je toegang tot auto mode, dan geeft de documentatie deze manier om daarin opnieuw te starten:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue --permission-mode auto
Wil je de code zelf met je eigen script controleren, schrijf dan een PreToolUse-hook die matcht op REPL, de tool die Claudes code uitvoert, en lees het JavaScript uit tool_input.code.
Stap 7: hervatten of uitzetten
Wil je later terug naar een Code Mode-sessie, laat de variabele dan ingesteld staan als je hervat:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue
Met Code Mode uit weigert Claude Code die sessie te hervatten. Sessies die je zonder Code Mode startte, worden zonder hervat, ook als de variabele is ingesteld.
Om Code Mode uit te zetten verwijder je CLAUDE_CODE_EXPERIMENTAL_CODE_MODE uit je shell en uit ~/.claude/settings.json, en start je een nieuwe sessie. Je kunt de waarde ook op 0 zetten. Een 0 op één plek houdt Code Mode uit, zelfs als er op de andere plek 1 staat.
Beheerders kunnen hem voor een hele organisatie blokkeren door hetzelfde env-blok, met de waarde "0", in de beheerde instellingen (managed settings) te zetten. Beheerde instellingen kunnen Code Mode alleen blokkeren. Ze kunnen hem niet voor gebruikers aanzetten.
Veelvoorkomende fouten en oplossingen
Start de sessie met Code Mode (experimental) isn't available, dan staat de reden op dezelfde regel, en /status toont hem ook. Los de oorzaak op en start een nieuwe sessie. De tabel behandelt een aantal redenen; de rest staat in de documentatie.
| Getoonde reden | Oplossing |
|---|---|
it isn't open to your account yet | Update als je onder v2.1.323 zit. Controleer anders je netwerk en start opnieuw. Blijft het zo, probeer het dan een andere dag |
it only works with the Anthropic API | Verwijder instellingen die verzoeken via een cloudprovider, een gateway of een eigen ANTHROPIC_BASE_URL laten lopen |
it doesn't work with an API key helper | Verwijder apiKeyHelper, ANTHROPIC_AUTH_TOKEN en elke Authorization– of X-Api-Key-header in ANTHROPIC_CUSTOM_HEADERS, en log daarna in of stel ANTHROPIC_API_KEY in |
it only works with Opus 5.5, Sonnet 5.5 and later models | Start met een ondersteund model, bijvoorbeeld claude --model opus |
it needs settings that Claude Code downloads from Anthropic | Verwijder de variabele die het ophalen van feature flags uitzet, zoals DISABLE_TELEMETRY |
your organization's settings don't allow it | Vraag je beheerder naar de beheerde instelling |
Andere problemen:
- Helemaal geen regel over Code Mode: controleer de versie, check of de variabele op
1staat in je shell of gebruikersinstellingen, en verwijder elke0. - Een rechtenvraag met aftelklok: als Claude in auto mode nieuwe code start terwijl eerdere code nog draait, kan je gevraagd worden naar de resterende aanroepen van die eerdere code. Antwoord voordat de tijd om is, anders wordt die aanroep geweigerd.
- Claude meldt een geweigerde toolaanroep: een
PreToolUse-hook is mislukt of liep tegen een time-out aan. Repareer de hook of verhoog zijntimeout.
Tot slot
Code Mode is het proberen waard als je sessies veel herhaalde zoekacties, bewerkingen en testruns bevatten. Start hem voor één sessie met de omgevingsvariabele, geef hem een taak met veel stappen en lees de code met Ctrl+O. Reken op veranderingen zolang hij experimenteel is.
Ben je je Claude Code-setup aan het uitbreiden, dan zijn onze handleidingen over agent skills in Claude Code en over je agent een echte browser geven met Chrome DevTools MCP goede vervolgstappen.
Bronnen
Links voor het laatst gecontroleerd op 15 november 2026.





Schrijf een reactie