CLAUDE_CODE_MAX_OUTPUT_TOKENS erklärt: Ausgabelimits und Plugin-Ordner in Claude Code 2.1.265

Was claude_code_max_output_tokens steuert

Die Referenz der Umgebungsvariablen beschreibt CLAUDE_CODE_MAX_OUTPUT_TOKENS als Einstellung für „die maximale Anzahl an Ausgabetokens für die meisten Anfragen“. Diese Formulierung ist wichtig: Sie beschreibt ein Ausgabebudget für Anfragen, dessen Standardwerte und Obergrenzen je nach Modell variieren.

Die Variable ist daher relevant, wenn eine Ausgabebegrenzung von Claude Code untersucht wird. Sie sollte nicht als universelle Grenze für jede Art von Daten betrachtet werden, die Claude Code verarbeitet. Version 2.1.265 führt außerdem eine Speicherplatzgrenze für gespeicherte Tool-Ergebnisse ein. Diese Grenze misst jedoch gespeicherte Tool-Daten in Gigabyte und nicht generierte Ausgaben in Tokens.

Für die Konfigurationsdokumentation gilt ein historischer Vorbehalt. Die Referenz der Umgebungsvariablen wird laufend aktualisiert, und ihre genaue Fassung vom 10. September konnte nicht rekonstruiert werden. Ihre Beschreibung erklärt den Zweck der Variable, doch die Seite belegt nicht sämtliche Standardwerte, die für Claude Code 2.1.265 galten.

Für einen datierten Artikel liefern Release Notes mit Versionskennzeichnung die belastbarsten Zahlenbelege. Diese Hinweise belegen bestimmte frühere Änderungen, ohne dass aus der aktuellen Dokumentation eine vollständige Tabelle der Standardwerte abgeleitet werden muss.

Drei Grenzen, die getrennt betrachtet werden müssen

Ermitteln Sie bei der Diagnose einer Begrenzung zunächst, welche dieser Grenzen zutrifft. Eine Einstellung für das Token-Budget und eine Obergrenze für den Festplattenspeicher müssen unterschiedlich interpretiert werden, auch wenn beide während derselben Entwicklungssitzung auftreten.

Verifizierte Standardwerte und maximale Ausgabegrenzen

Das Release Notes zu v2.1.77 vom 17. März 2026 dokumentieren zwei relevante Änderungen: Der Standardwert für Claude Opus 4.6 wurde auf 64k Ausgabetokens erhöht, und die Obergrenze für Opus 4.6 und Sonnet 4.6 wurde auf 128k Tokens erhöht. Diese Änderungen sind auch im mit v2.1.265 gekennzeichneten Änderungsprotokoll festgehalten.

Diese Belege schließen es aus, „32,000 als Standardwert, 64,000 als Maximum“ als universelle Regel für Claude Code darzustellen. Sie rechtfertigen auch nicht, fehlende Standardwerte für andere Modelle zu ergänzen.

Entscheidend ist die sorgfältige Unterscheidung zwischen einer dokumentierten Änderung und einer vollständigen Konfigurationsreferenz. Die Veröffentlichung vom März belegt die oben genannten Änderungen; die verfügbaren datierten Quellen belegen keine vollständige Tabelle der Standardwerte pro Modell für v2.1.265.

Neuere Modellspezifikationen belegen keine CLI-Standardwerte

Das Release Notes der Modelle dokumentieren eine maximale Ausgabe von 128k und ein Kontextfenster von 1 Millionen Tokens für Claude Sonnet 5, Claude Opus 5 und Claude Fable 5.1. Ihre genauen API-IDs lauten claude-sonnet-5, claude-opus-5und claude-fable-5-1, in dieser Reihenfolge.

Diese Ankündigungen waren vor dem Veröffentlichungsstichtag verfügbar: Sonnet 5 am 30. Juni, Opus 5 am 24. Juli und Fable 5.1 am 1. September 2026. Ihre Modellspezifikationen sind jedoch kein Beleg für das standardmäßige Anfragebudget von Claude Code.

Für Entwickler, die ein Modell auswählen, bietet Leitfaden zu Claude Code-Modellen weiterführende Informationen. Betrachten Sie das veröffentlichte Maximum des Modells getrennt vom standardmäßigen Ausgabebudget der CLI.

Die Variable setzen und die Komprimierung verstehen

Die aktuelle Dokumentation unterstützt das Setzen der Variable vor dem Start von claude oder das Eintragen unter dem env -Schlüssel in settings.json. Da die genaue Dokumentationsfassung vom 10. September nicht rekonstruiert werden konnte, sind die folgenden Beispiele dokumentierte Konfigurationsmuster mit diesem historischen Vorbehalt.

Shell-Konfiguration

Das bereitgestellte Shell-Beispiel setzt das Ausgabebudget auf 64,000 Tokens:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

Das dokumentierte Muster besteht darin, die Variable vor dem Start von Claude Code zu setzen. Die Zahl in diesem Beispiel ist ein gewählter Konfigurationswert; sie ist keine Aussage darüber, dass 64,000 für jedes Modell der Standardwert oder das Maximum ist.

Wenn Sie die Konfiguration für ein Projekt oder eine Sitzung zur Fehlerbehebung dokumentieren, geben Sie neben dem angeforderten Budget auch das ausgewählte Modell an. Ohne das Modell lässt sich anhand eines Werts allein nicht erklären, ob er einem dokumentierten Standardwert entspricht oder innerhalb einer dokumentierten Obergrenze liegt.

Konfiguration in settings.json

Das entsprechende bereitgestellte JSON-Beispiel trägt die Variable ein unter env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

Der Wert ist in diesem Beispiel eine Zeichenfolge. Wie bei der Shell-Einstellung drückt der Ausschnitt ein angefordertes Budget aus, statt einen modellspezifischen Standardwert zu belegen.

Informationen zur entsprechenden Verwendung über die Befehlszeile finden Sie in CLI-Referenz für Claude Code. Die historischen Belege stützen hier die Rolle der Variable und die bereitgestellten Konfigurationsbeispiele, lassen die vollständigen Standardwerte von v2.1.265 jedoch offen.

Was ist zur Komprimierung verifiziert?

Das mit v2.1.265 gekennzeichnete Änderungsprotokoll dokumentiert eine frühere Fehlerbehebung in v2.1.69 für CLAUDE_CODE_MAX_OUTPUT_TOKENS , das bei der Gesprächskomprimierung ignoriert wurde. Dies ist ein verifizierter Zusammenhang zwischen dieser Einstellung und dem Komprimierungsverhalten.

Die aktuelle Referenz der Umgebungsvariablen erklärt außerdem, dass eine Erhöhung der Einstellung den effektiv verfügbaren Kontext vor der automatischen Komprimierung verringert. Das Veröffentlichungsdatum dieser Erklärung ist ungewiss, daher kann sie nicht als verifizierte Beschreibung vom 10. September dargestellt werden.

Die Einstellung sollte daher nicht als Vergrößerung des veröffentlichten Kontextfensters des Modells beschrieben werden. Die datierten Belege bestätigen eine Steuerung des Ausgabebudgets und eine Fehlerbehebung im Zusammenhang mit der Komprimierung; sie belegen keinen genauen Komprimierungsschwellenwert für jedes Modell in v2.1.265.

Wie Claude Code 2.1.265 Plugin-Ordner lädt

Claude Code v2.1.265 wurde am 8. September 2026 mit dem Release-Commit 8e02f6d veröffentlicht. Die Änderung beim Laden von Ordnern ermöglicht es, --plugin-dir auf einen Ordner mit mehreren Plugins verweisen zu lassen.

Der bereitgestellte Aufruf lautet:

claude --plugin-dir ./plugins

Die Veröffentlichung beschreibt die Erkennungsregel direkt: „Jeder Unterordner mit einem Manifest wird geladen“. Sie gibt außerdem an, dass hinzugefügte und entfernte Plugins während der Ausführung von Claude Code erkannt werden.

Damit ist der übergeordnete Ordner die geeignete Einheit, um mehrere Plugins gemeinsam zu verwalten. Die dokumentierte Zusicherung betrifft Unterordner, die Manifeste enthalten; die Release Notes legen keine rekursive Erkennung fest. Gehen Sie nicht davon aus, dass ein beliebig verschachtelter Verzeichnisbaum durchsucht wird.

Manifeststruktur und historischer Vorbehalt

Die aktuelle Plugin-Referenz sieht das Manifest unter .claude-plugin/plugin.json und Komponentenverzeichnisse wie skills/, commands/und hooks/ im Stammverzeichnis des Plugins vor. Diese Referenz konnte nicht als datierter Stand von v2.1.265 rekonstruiert werden.

Unterscheiden Sie im Artikel vom 10. September diese aktuellen Hinweise zur Struktur von der ausdrücklichen Zusicherung der Veröffentlichung: Unterordner mit Manifesten werden geladen. Die Veröffentlichung belegt die Erkennung mehrerer Plugins in einem Ordner, ohne sämtliche Details der damaligen Strukturdokumentation zu belegen.

In der Veröffentlichung enthaltene Plugin-Fehlerbehebungen

Version 2.1.265 behebt außerdem drei Plugin-Probleme:

• Ein Plugin-Pfad mit umgekehrten Schrägstrichen konnte unter macOS und Linux die Begrenzung symbolischer Links auf den zulässigen Bereich umgehen.
• Verzeichnisse, deren Name mit zwei Punkten beginnt, wurden fälschlicherweise abgelehnt.
• Nicht lesbare Standard-Komponentenordner wurden ohne Meldung übersprungen; sie erscheinen jetzt in /plugin mit einem Fehlercode.

Diese Fehlerbehebungen betreffen Plugin-Pfade und das Laden von Komponenten. Wenn ein Plugin-Ordner nicht geladen wird, liefern sie relevanten Kontext zur Veröffentlichung. Die Einstellung für Ausgabetokens erklärt diese Probleme bei der Verzeichnisverarbeitung jedoch nicht.

Die Obergrenze von 1 GB für gespeicherte Tool-Ergebnisse ist eine separate Grenze

Version 2.1.265 fügt eine Obergrenze von 1 GB für auf der Festplatte gespeicherte Tool-Ergebnisse hinzu. Die Gesprächsvorschau meldet eine Kürzung.

Diese Grenze betrifft gespeicherte Tool-Daten. CLAUDE_CODE_MAX_OUTPUT_TOKENS betrifft die maximale Anzahl an Ausgabetokens für die meisten Anfragen. Die Veröffentlichung beschreibt die Umgebungsvariable nicht als Steuerung für die Speicherplatzgrenze. Eine Erhöhung ihres Werts sollte daher nicht als Lösung für die Kürzung gespeicherter Tool-Ergebnisse dargestellt werden.

Die Release Notes geben außerdem nicht an, ob die Obergrenze von 1 GB pro Ergebnis, pro Sitzung oder für eine andere Gruppierung gilt. Bewahren Sie diese Ungewissheit bei der Dokumentation des Verhaltens: „Obergrenze von 1 GB für auf der Festplatte gespeicherte Tool-Ergebnisse“ ist die verifizierte Beschreibung.

Für die Fehlerbehebung ist eine Unterscheidung anhand der Hinweise hilfreich, die dem Entwickler angezeigt werden. Eine Gesprächsvorschau, die eine Kürzung meldet, hängt mit dem neuen Verhalten für gespeicherte Ergebnisse zusammen. Eine Frage zum Budget für die generierte Ausgabe eines Modells gehört zum ausgewählten Modell und zur Token-Einstellung. Ein Plugin-Fehlercode in /plugin gehört zum Laden von Plugins.

Dies sind separate Steuerungsmöglichkeiten und Diagnosefunktionen, die im Kontext derselben Veröffentlichung eingeführt oder besprochen wurden. Werden sie getrennt betrachtet, wird verhindert, dass eine Änderung der Token-Konfiguration als Erklärung für ein davon unabhängiges Speicher- oder Ordnerverhalten herangezogen wird.

Die bis zum 10. September verfügbare Gateway-Folgeversion

Version 2.1.266 wurde ebenfalls am 8. September veröffentlicht und liegt damit innerhalb des Stichtags dieses Artikels. Die Release Notes zu v2.1.266 beheben eine in v2.1.265 eingeführte Regression bei der Gateway-Authentifizierung im Zusammenhang mit CLAUDE_CODE_USE_GATEWAY.

Die relevante Fehlermeldung lautet „Nicht beim Cloud-Gateway angemeldet“. Laut Versionshinweisen ist keine Konfigurationsänderung erforderlich.

Für Entwickler, die unter v2.1.265 genau auf diese Regression stoßen, ist die Folgeversion unmittelbar relevant. Das Erhöhen des Ausgabetoken-Budgets oder das Umorganisieren von Plugin-Ordnern ist nicht die dokumentierte Lösung.

Dieselben Workflows lassen sich über ein API-Gateway wie AI Prime Tech ausführen; siehe Claude Code mit einem API-Schlüssel verwenden für entsprechende Hinweise zur Einrichtung. AI Prime Tech arbeitet unabhängig und ist weder mit Anthropic noch mit OpenAI verbunden.

Wichtige Erkenntnisse

• CLAUDE_CODE_MAX_OUTPUT_TOKENS legt die maximale Anzahl an Ausgabetokens für die meisten Anfragen fest; Standardwerte und Obergrenzen variieren je nach Modell.
• v2.1.77 erhöhte den Standardwert von Opus 4.6 auf 64k und die Obergrenze von Opus 4.6/Sonnet 4.6 auf 128k. Eine vollständige Tabelle der Standardwerte für v2.1.265 ist weiterhin nicht verifiziert.
• Die maximale Modellausgabe, die Kontextkapazität des Modells und der Speicherplatz für gespeicherte Werkzeugergebnisse sind separate Grenzen.
• In v2.1.265 --plugin-dir können mehrere Plugins aus Unterordnern mit Manifesten geladen und hinzugefügte sowie entfernte Plugins während der Ausführung erkannt werden.
• v2.1.265 führt die Speicherobergrenze von 1 GB für gespeicherte Werkzeugergebnisse ein; v2.1.266 behebt die Regression bei der Gateway-Authentifizierung, ohne dass eine Konfigurationsänderung erforderlich ist.

FAQ

Was steuert CLAUDE_CODE_MAX_OUTPUT_TOKENS?

CLAUDE_CODE_MAX_OUTPUT_TOKENS legt die maximale Anzahl an Ausgabetokens für die meisten Anfragen fest. Die Standardwerte und Obergrenzen variieren je nach Modell und sind unabhängig von der Obergrenze von 1 GB für auf dem Datenträger gespeicherte Werkzeugergebnisse in v2.1.265.

Welche Standardwerte und Höchstgrenzen gelten für die Ausgabe?

v2.1.77 erhöhte den Standardwert von Claude Opus 4.6 auf 64k Ausgabetokens und die Obergrenze von Opus 4.6/Sonnet 4.6 auf 128k. Die geprüften datierten Quellen belegen weder den Standardwert von Sonnet 4.6 noch eine vollständige Tabelle der Standardwerte für jedes Modell in v2.1.265.

Vergrößert ein höherer Wert das Kontextfenster?

Der dokumentierte Zweck besteht darin, ein Ausgabetoken-Budget festzulegen, nicht das veröffentlichte Kontextfenster des Modells zu vergrößern. v2.1.69 behob einen Fehler, durch den die Variable bei der Komprimierung ignoriert wurde. Das Veröffentlichungsdatum der Erklärung in der aktuellen Dokumentation zu ihrer Wirkung auf die automatische Komprimierung ist jedoch unklar.

Wie erkennt --plugin-dir mehrere Plugins?

In Claude Code 2.1.265 --plugin-dir kann ein übergeordneter Ordner angegeben werden, und jeder Unterordner mit einem Manifest wird geladen. Hinzugefügte und entfernte Plugins werden während der Ausführung von Claude Code erkannt; eine rekursive Erkennung ist in den Versionshinweisen nicht angegeben.