Code Mode in Claude Code einschalten (und wann es sich lohnt)

Mit dem neuen, experimentellen Code Mode schreibt Claude in Claude Code JavaScript, das viele Tool-Aufrufe in einem Schritt ausführt. So schaltest du ihn ein, testest ihn und schaltest ihn wieder aus.

Graphic of a terminal with one code block branching into several tool icons, for a guide to Code Mode in Claude Code

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:

Code
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

Code
claude --version

Ist die Nummer kleiner als 2.1.323, aktualisiere:

Code
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:

Code
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

Windows PowerShell:

Code
$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:

Code
{
  "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
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:

Code
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:

Code
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:

Code
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:

Code
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 GrundLösung
it isn't open to your account yetAktualisiere, 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 APIEntferne Einstellungen, die Anfragen über einen Cloud-Anbieter, ein Gateway oder eine eigene ANTHROPIC_BASE_URL leiten
it doesn't work with an API key helperEntferne 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 modelsStarte mit einem unterstützten Modell, zum Beispiel claude --model opus
it needs settings that Claude Code downloads from AnthropicEntferne die Variable, die das Abrufen von Feature-Flags abschaltet, etwa DISABLE_TELEMETRY
your organization's settings don't allow itFrag 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 1 steht, und entferne jede 0.
  • 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 sein timeout.

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.

Von Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Über Mindloop Experience

Kommentare

Kommentar schreiben

Mehr von Mindloop Experience

Alle Artikel von Mindloop Experience

Du kannst bis zu 50-mal applaudieren.