Normalerweise fordert Claude Code jeden Tool-Aufruf direkt an und liest das Ergebnis, bevor es über den nächsten Schritt entscheidet. Code Mode, eingeführt mit Version 2.1.323 am 12. November 2026, lässt Claude ein kurzes Stück JavaScript schreiben, das mehrere Tool-Aufrufe in einem Schritt erledigt. Diese Anleitung zeigt dir, wie du ihn einschaltest, an einer echten Aufgabe ausprobierst, den von Claude geschriebenen Code liest und ihn wieder ausschaltest.
Stand 15. November 2026 ist Code Mode experimentell und standardmäßig aus. Laut Anthropics Dokumentation kann er sich in jedem Release ändern oder wieder entfernt werden.
Was Code Mode macht
In einer normalen Sitzung fordert Claude Tools wie Bash, Read oder Edit direkt an und liest jedes Ergebnis vor dem nächsten Schritt. In einer Code-Mode-Sitzung schreibst du deinen Prompt weiterhin in normaler Sprache, aber Claude schreibt JavaScript, um ihn umzusetzen. Ein einziges Stück Code kann Befehle parallel ausführen, ein Ergebnis an den nächsten Aufruf weitergeben und nur den Teil der Ausgabe zurückgeben, den Claude wirklich lesen muss.
Anthropics Dokumentation zu Code Mode zeigt dieses Beispiel dafür, was Claude schreiben könnte, wenn es ein Retry-Limit erhöhen soll. Der Code findet die Datei, bearbeitet sie und führt die Tests aus:
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() });
Du schreibst diesen Code nicht, und standardmäßig siehst du ihn auch nicht. Die Unterhaltung zeigt die Tool-Aufrufe, etwa den Diff der Änderung.
Die Dokumentation empfiehlt, es bei Aufgaben mit vielen zusammenhängenden Tool-Aufrufen auszuprobieren:
- eine Änderung, die sich über viele Dateien wiederholt;
- eine Suche, deren Ergebnisse gefiltert werden müssen, bevor Claude sie liest;
- mehrere unabhängige Befehle, die gleichzeitig laufen können.
Lies zuerst die Einschränkungen
Code Mode bringt echte Kompromisse mit sich. Prüfe, ob du damit leben kannst, bevor du ihn einschaltest:
- Fortsetzen: Eine Code-Mode-Sitzung lässt sich nur im Terminal fortsetzen, und nur mit eingeschaltetem Code Mode.
- Lang laufender Code: Wenn der Code nicht im Hintergrund laufen kann (siehe Schritt 6), wartest du darauf, und nach zehn Minuten wird er abgebrochen.
- Fehlende Funktionen: Remote Control, Claude in Chrome und Computer Use funktionieren in einer Code-Mode-Sitzung nicht, und du kannst die Sitzung nicht in die Desktop-App verschieben.
Was du brauchst
- Claude Code v2.1.323 oder neuer, installiert als native Version.
- Ein Claude-Abo oder ein Claude-Console-Konto. Code Mode funktioniert nicht über ein Gateway, Amazon Bedrock, Claude Platform on AWS, die Agent Platform von Google Cloud oder Microsoft Foundry.
- Eines dieser Modelle: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 oder Fable 5.2.
- Eine interaktive
claude-Sitzung im Terminal. Es funktioniert nicht mit-p, dem Agent SDK, dem VS-Code-Panel, der Desktop-App oder Cloud-Sitzungen. - Unter Windows: installiertes Git for Windows.
- Eine Organisation, die weder die HIPAA-Konfiguration noch Zero Data Retention nutzt.
Schritt 1: Version prüfen
claude --version
Ist die Nummer kleiner als 2.1.323, aktualisiere:
claude update
Wenn du auf dem Release-Kanal stable bist und das Update noch nicht auf 2.1.323 kommt, solltest du laut Dokumentation warten, bis stable nachzieht, oder auf latest wechseln.
Schritt 2: Claude Code mit Code Mode starten
Code Mode wird über eine einzige Umgebungsvariable gesteuert: CLAUDE_CODE_EXPERIMENTAL_CODE_MODE. Zum einmaligen Ausprobieren setzt du die Variable nur für einen Start.
macOS, Linux oder WSL:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Windows PowerShell:
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
Um ihn für jede neue Sitzung einzuschalten, füge deiner Benutzer-Einstellungsdatei unter ~/.claude/settings.json einen env-Block hinzu:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Claude Code ignoriert diese Variable in den Einstellungsdateien eines Projekts. Ein Repository, das du klonst, kann Code Mode also nicht für dich einschalten.
Schritt 3: Die Abfrage bestätigen
Vor deiner ersten Code-Mode-Sitzung bittet Claude Code dich um eine Bestätigung. Wähle Yes, turn on Code Mode (Ja, Code Mode einschalten). Claude Code startet neu und zeigt diese Zeile oben in der Sitzung:
Code Mode (experimental) is on · this session can be resumed only with Code Mode on
Siehst du eine andere Zeile oder gar keine, spring weiter unten zum Abschnitt mit den Fehlern.
Schritt 4: Gib Claude eine Aufgabe mit vielen Tool-Aufrufen
Probier in einem Projekt, das du gut kennst, den Prompt aus der Dokumentation aus:
Read every Markdown file in this project and list the links that point to local files that don't exist.
Ein weiterer Prompt, der zum Muster passt:
Run the linter, the type checker and the unit tests at the same time, then summarize only the failures.
Erwartetes Ergebnis: Claude antwortet wie gewohnt, und du siehst die Tool-Aufrufe, die es gemacht hat.
Schritt 5: Den Code lesen, den Claude geschrieben hat
Drück Ctrl+O, um die Transkript-Ansicht zu öffnen. Jedes Stück Code erscheint als eingeklappte Zeile Code. Klapp eine auf, um das JavaScript hinter den Tool-Aufrufen zu sehen, und drück dann noch einmal Ctrl+O, um zur Unterhaltung zurückzukehren.
Schritt 6: Berechtigungen und lange Jobs im Griff behalten
Deine bestehenden Sicherheitseinstellungen gelten weiterhin. Jeder Tool-Aufruf, den der Code macht, durchläuft deine Berechtigungsregeln deny und ask sowie deine PreToolUse-Hooks, und du musst keine Regel für ein Tool wie Bash ändern.
Was sich ändert, ist die Art, wie der Code geprüft wird:
- Im Auto-Modus prüft ein Klassifikator jedes Stück Code, bevor es läuft, nicht jeden einzelnen Tool-Aufruf. Werte, die erst während der Ausführung entstehen, etwa ein Pfad aus einer Suchausgabe, sieht er nicht. Behalte Regeln oder Hooks für alles, was du unbedingt kontrollieren musst.
- In anderen Berechtigungsmodi startet der Code ohne Prüfung, und du bekommst für jeden Tool-Aufruf eine Abfrage, der dich normalerweise auch fragen würde.
Bei langen Builds oder Testläufen wartet Claude entweder auf den Code, der nach zehn Minuten abbricht, oder lässt ihn im Hintergrund weiterlaufen, wo er bis zu zwei Stunden laufen kann, während du weiterredest. Hintergrund-Code braucht eine Sitzung, die im Auto-Modus oder im Modus bypassPermissions gestartet wurde. Wenn dir der Auto-Modus zur Verfügung steht, nennt die Dokumentation diesen Weg, um darin neu zu starten:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue --permission-mode auto
Um den Code selbst mit einem eigenen Skript zu prüfen, schreibst du einen PreToolUse-Hook, der auf REPL passt, das Tool, das Claudes Code ausführt, und liest das JavaScript aus tool_input.code.
Schritt 7: Fortsetzen oder ausschalten
Um später zu einer Code-Mode-Sitzung zurückzukehren, lass die Variable beim Fortsetzen gesetzt:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue
Mit ausgeschaltetem Code Mode weigert sich Claude Code, diese Sitzung fortzusetzen. Sitzungen, die du ohne Code Mode gestartet hast, werden auch mit gesetzter Variable ohne ihn fortgesetzt.
Zum Ausschalten entfernst du CLAUDE_CODE_EXPERIMENTAL_CODE_MODE aus deiner Shell und aus ~/.claude/settings.json und startest dann eine neue Sitzung. Du kannst den Wert auch auf 0 setzen. Eine 0 an einer Stelle hält Code Mode aus, selbst wenn an der anderen Stelle 1 steht.
Administratoren können ihn für eine ganze Organisation sperren, indem sie denselben env-Block mit dem Wert "0" in die verwalteten Einstellungen (Managed Settings) schreiben. Verwaltete Einstellungen können Code Mode nur sperren, aber nicht für Nutzer einschalten.
Häufige Fehler und Lösungen
Beginnt die Sitzung mit Code Mode (experimental) isn't available, steht der Grund in derselben Zeile, und /status zeigt ihn ebenfalls an. Behebe die Ursache und starte eine neue Sitzung. Die Tabelle deckt mehrere Gründe ab; die übrigen stehen in der Dokumentation.
| Angezeigter Grund | Lösung |
|---|---|
it isn't open to your account yet | Aktualisiere, wenn du unter v2.1.323 bist. Andernfalls prüf deine Netzwerkverbindung und starte neu. Bleibt der Fehler, versuch es an einem anderen Tag |
it only works with the Anthropic API | Entferne Einstellungen, die Anfragen über einen Cloud-Anbieter, ein Gateway oder eine eigene ANTHROPIC_BASE_URL leiten |
it doesn't work with an API key helper | Entferne apiKeyHelper, ANTHROPIC_AUTH_TOKEN und jeden Authorization– oder X-Api-Key-Header in ANTHROPIC_CUSTOM_HEADERS, und melde dich dann an oder setze ANTHROPIC_API_KEY |
it only works with Opus 5.5, Sonnet 5.5 and later models | Starte mit einem unterstützten Modell, zum Beispiel claude --model opus |
it needs settings that Claude Code downloads from Anthropic | Entferne die Variable, die das Abrufen von Feature-Flags abschaltet, etwa DISABLE_TELEMETRY |
your organization's settings don't allow it | Frag deinen Administrator nach der verwalteten Einstellung |
Weitere Probleme:
- Gar keine Zeile zu Code Mode: Prüf die Version, prüf, dass die Variable in deiner Shell oder deinen Benutzereinstellungen auf
1steht, und entferne jede0. - Eine Berechtigungsabfrage mit Countdown: Wenn Claude im Auto-Modus neuen Code startet, während älterer Code noch läuft, wirst du eventuell zu den restlichen Aufrufen des älteren Codes gefragt. Antworte, bevor der Countdown abläuft, sonst wird dieser Aufruf abgelehnt.
- Claude meldet einen abgelehnten Tool-Aufruf: Ein
PreToolUse-Hook ist fehlgeschlagen oder hat das Zeitlimit überschritten. Repariere den Hook oder erhöhe seintimeout.
Fazit
Code Mode ist einen Versuch wert, wenn deine Sitzungen viele wiederholte Suchen, Änderungen und Testläufe enthalten. Starte ihn für eine Sitzung mit der Umgebungsvariable, gib ihm eine Aufgabe mit vielen Schritten und lies den Code mit Ctrl+O. Rechne mit Änderungen, solange er experimentell ist.
Wenn du dein Claude-Code-Setup ausbaust, sind unsere Anleitungen zu Agent Skills in Claude Code und dazu, deinem Agenten mit Chrome DevTools MCP einen echten Browser zu geben, gute nächste Lektüre.
Quellen
Links zuletzt geprüft am 15. November 2026.





Kommentar schreiben