Ultracode in Claude Code: was es Ihr Max-Limit kostet

Die kurze Antwort

Ultracode ist eine Einstellung in Claude Code, durch die Ihre Claude-Max-Limits deutlich schneller aufgebraucht werden als bei normaler Arbeit. Ist Ultracode an, plant Claude für jede größere Aufgabe selbst einen dynamischen Workflow. Ein solcher Workflow ist ein Skript, das viele Subagents gleichzeitig arbeiten lässt. In der laufenden Sitzung schalten Sie Ultracode mit /effort ultracode off ab. Jeder Subagent schickt eigene Anfragen an das Modell, und alle diese Tokens zählen auf dasselbe Nutzungsfenster von fünf Stunden. Deshalb kann eine einzige Sitzung mit Ultracode das Fenster leeren, obwohl Sie selbst nur wenige Nachrichten geschrieben haben.

Alle technischen Angaben in diesem Artikel stammen aus der offiziellen Dokumentation von Claude Code, Stand 1. Oktober 2026. Claude Code ändert sich oft. Prüfen Sie Ihre Version deshalb mit claude --version, bevor Sie sich auf eine Versionsgrenze verlassen.

Was ist Ultracode in Claude Code?

Ultracode erreichen Sie über den Befehl /effort. Trotzdem ist Ultracode keine Effort-Stufe. Effort (Denkaufwand) legt fest, wie gründlich das Modell nachdenkt, bevor es antwortet. Die Stufen heißen low, medium, high, xhigh und max. Mehr zu diesen Stufen und ihrem Verbrauch steht im Beitrag über Effort-Stufen in Claude: max gegen high.

Ultracode ändert dagegen die Arbeitsweise. Laut Dokumentation lässt Claude bei eingeschaltetem Ultracode für jede substanzielle Aufgabe einen dynamischen Workflow laufen. Das geschieht auf der Effort-Stufe, die die Sitzung gerade hat. Ein dynamischer Workflow ist ein JavaScript-Skript, das Claude für Ihre Aufgabe schreibt. Eine Laufzeitumgebung führt es im Hintergrund aus. Das Skript startet Subagents. Ein Subagent ist eine eigene Claude-Instanz mit eigenem Kontextfenster. Er erledigt einen Teil der Arbeit und gibt ein Ergebnis zurück.

Als typische Größe eines Workflows nennt die Dokumentation „Dutzende bis Hunderte Agents pro Lauf“. Die Laufzeit begrenzt einen Lauf auf 1.000 Agents insgesamt. Standardmäßig arbeiten bis zu 16 Agents gleichzeitig, auf Rechnern mit weniger CPUs entsprechend weniger. Diese Grenzen schützen vor einer Endlosschleife. Vor einem leeren Kontingent schützen sie nicht.

Woher kommt das Wort „ultracode“ in Ihrer Eingabe?

Ultracode begegnet Ihnen auf zwei Wegen, und die beiden verhalten sich unterschiedlich.

Der erste Weg ist das Schlüsselwort im Prompt. Schreiben Sie ultracode in eine Nachricht, markiert Claude Code das Wort farbig. Claude baut dann genau diese eine Aufgabe als Workflow, statt sie Schritt für Schritt im Gespräch zu bearbeiten. Die Effort-Stufe der Sitzung bleibt dabei unverändert. Haben Sie das Wort aus Versehen getippt, entfernen Sie die Markierung für diesen Prompt mit Alt+W unter Windows und Linux oder mit Option+W unter macOS. Soll das Wort nie wieder einen Workflow auslösen, schalten Sie in /config die Zeile Ultracode keyword trigger aus.

Der zweite Weg ist die Sitzungseinstellung. Nach /effort ultracode gilt Ultracode für jede Aufgabe der Sitzung, bis Sie es wieder ausschalten. Genau diese Variante ist für Ihr Limit gefährlich, weil Claude dann selbst entscheidet, wann eine Aufgabe einen Workflow bekommt.

Das Schlüsselwort wirkt nur in einem Prompt, den Sie selbst eintippen. Ein Prompt über claude -p, ein geplanter Task oder ein weitergeleiteter Kommentar aus einem Pull Request startet keinen Workflow. Laut Dokumentation galt diese Einschränkung vor Version 2.1.210 noch nicht.

Warum leert Ultracode Ihr Fünf-Stunden-Fenster?

Ein Abo von Claude Pro oder Claude Max rechnet nicht pro Anfrage ab. Es gibt ein Sitzungslimit, das in einem Fenster von fünf Stunden gilt, und zusätzlich ein Wochenlimit. Wie und wann diese Fenster zurückgesetzt werden, erklärt der Beitrag über die Reset-Fenster der Claude-Max-Limits.

Ultracode belastet dieses Fenster aus mehreren Gründen gleichzeitig.

• Eine Anfrage wird zu mehreren Workflows. Laut Dokumentation kann ein einzelner Auftrag mehrere Workflows hintereinander auslösen: zuerst einen zum Verstehen des Codes, danach einen für die Änderung und am Ende einen zur Prüfung.
• Jeder Agent bezahlt seinen eigenen Kontext. Jeder Subagent schickt eigene Anfragen, zusätzlich zu den Anfragen Ihres Hauptgesprächs. Er liest Dateien, ruft Werkzeuge auf und denkt auf der gewählten Effort-Stufe nach. Lesen zehn Agents dieselbe Datei, landet sie zehnmal in einem Kontext.
• Bei Workflow-Agents hält der Cache kürzer. Der Prompt-Cache spart Tokens, wenn derselbe Anfang einer Anfrage erneut gesendet wird. Für das Hauptgespräch hält er im Abo eine Stunde. Für Workflow-Agents gilt laut Dokumentation standardmäßig eine Lebensdauer von fünf Minuten, auch im Abo. Wartet ein Agent länger, verarbeitet das Modell den Kontext erneut ohne Cache.
• Ultracode schaltet die Warnungen ab. Mehr dazu im nächsten Abschnitt.

Die Dokumentation zieht selbst die Konsequenz: Mit Ultracode verbraucht jede Anfrage mehr Tokens und dauert länger als dieselbe Anfrage ohne Workflow. Im Abo zählen diese Tokens auf Ihre Limits. Deshalb erreicht eine Sitzung mit Ultracode ein Sitzungs- oder Wochenlimit früher als dieselbe Arbeit ohne Ultracode. Wie sich Tokens in Claude Code grundsätzlich zusammensetzen, steht in der Erklärung zum Token-Verbrauch in Claude Code.

Welche Schutzmechanismen schaltet Ultracode ab?

Ohne Ultracode zeigt Claude Code die Warnung Large workflow, sobald ein Workflow mehr als 25 Agents einplant oder die geschätzte Token-Summe 1,5 Millionen übersteigt. Die Warnung steht in der Fortschrittszeile unter dem Eingabefeld. Sie verweist auf /workflows, wo Sie den Lauf stoppen können.

Mit eingeschaltetem Ultracode fällt diese Warnung weg. Die Dokumentation begründet das so: Wer Ultracode einschaltet, hat großen Läufen bereits zugestimmt. Aus demselben Grund setzt Claude Code das Limit für gleichzeitige Subagents nicht durch, die Claude über das Agent-Werkzeug startet. Im Berechtigungsmodus „auto“ entfällt zudem die Rückfrage vor dem ersten Workflow. Das Ergebnis: Ein großer Lauf startet ohne jeden Hinweis, und Sie bemerken ihn erst in der Nutzungsanzeige.

Ein Erfahrungsbericht: 4,4 Millionen Tokens an einem Nachmittag

Wie das in der Praxis aussieht, zeigt ein Bericht im GitHub-Issue #66762. Laut Bericht lief die Sitzung in der Desktop-App auf dem Max-Plan für 200 US-Dollar im Monat. Was diese Stufe vom kleineren Max-Plan unterscheidet, steht im Vergleich Claude Max für 100 oder 200 US-Dollar.

In einer einzigen Sitzung mit Ultracode liefen laut Bericht drei Workflows nacheinander. Der erste war eine Analyse mit 22 Agents und rund 1,7 Millionen Subagent-Tokens. Danach kam ein gegenseitiger Review mit 12 Agents und rund 0,9 Millionen Tokens. Zum Schluss lief ein zweiter Review mit 20 Agents und rund 1,5 Millionen Tokens. Zusammen gingen rund 4,4 Millionen Tokens an Subagents. Laut Bericht verbrauchte das den größten Teil des Fünf-Stunden-Fensters. Das sichtbare Ergebnis waren Änderungen an einigen Dutzend Dateien.

Lesen Sie diese Zahlen als Bericht einer einzelnen Person, nicht als Messung. Ihr Verbrauch hängt vom Modell ab, von der Effort-Stufe, von der Größe Ihrer Codebasis und davon, wie Claude die Aufgabe zerlegt. Das Issue wurde als „not planned“ geschlossen. Eine Änderung an diesem Verhalten ist demnach nicht geplant, und die Kontrolle liegt bei Ihnen.

So schalten Sie Ultracode ab

In der laufenden Sitzung genügt ein Befehl:

/effort ultracode off

Alternativ öffnen Sie mit /effort ohne Argument den Regler. Dort schaltet Tab den Schalter Ultracode um, und Enter übernimmt die Änderung. Öffnen Sie danach noch einmal /effort. Der Schalter Ultracode muss jetzt aus sein.

Die Form /effort ultracode off und der Schalter im Regler brauchen Claude Code ab Version 2.1.284. Ältere Versionen koppeln Ultracode fest an die Stufe xhigh. Dort schalten Sie Ultracode ab, indem Sie eine andere Stufe wählen, zum Beispiel /effort high. Ihre Version zeigt dieser Befehl:

claude --version

Warum ist Ultracode bei jedem Start wieder an?

/effort ultracode gilt nur für die aktuelle Sitzung. Startet Ultracode in jeder neuen Sitzung von selbst, hat das eine von zwei Ursachen.

Die erste Ursache ist ein Startbefehl mit --effort ultracode, oft versteckt in einem Shell-Alias oder einem Skript. Dieser Start setzt die Sitzung zusätzlich auf xhigh. Entfernen Sie die Option aus dem Alias.

Die zweite Ursache ist der Eintrag "ultracode": true in einer Einstellungsdatei. Suchen Sie danach in Ihrer Benutzerdatei ~/.claude/settings.json und in der Datei .claude/settings.json Ihres Projekts. Löschen Sie die Zeile, und starten Sie Claude Code neu.

An zwei anderen Stellen suchen Sie vergeblich. Die gespeicherte Einstellung effortLevel und die Umgebungsvariable CLAUDE_CODE_EFFORT_LEVEL akzeptieren den Wert ultracode nicht. Eine Änderung dort schaltet Ultracode auch nicht ab. Legt CLAUDE_CODE_EFFORT_LEVEL die Stufe fest, bleibt Ultracode laut Dokumentation an und läuft nur auf dieser Stufe weiter.

Workflows ganz abschalten

Wollen Sie überhaupt keine Workflows, schalten Sie in /config die Zeile Dynamic workflows aus. Diese Einstellung bleibt über Sitzungen hinweg erhalten. Für einen einzelnen Start setzen Sie die Umgebungsvariable:

CLAUDE_CODE_DISABLE_WORKFLOWS=1 claude

Sind Workflows abgeschaltet, ist Ultracode nicht verfügbar. Das Schlüsselwort ultracode löst nichts mehr aus, und der Schalter verschwindet aus /effort. Ein Workflow, der schon läuft, arbeitet allerdings weiter. Stoppen Sie ihn deshalb zusätzlich in /workflows.

Wann ist Ultracode gar nicht verfügbar?

Ultracode fehlt in zwei Fällen: wenn Workflows abgeschaltet sind, und wenn das Modell die Stufe xhigh nicht unterstützt. Laut der Tabelle in der Dokumentation gilt der zweite Fall zum Beispiel für Opus 4.6 und Sonnet 4.6. In beiden Fällen startet claude --effort ultracode die Sitzung ohne Ultracode, auf der höchsten erlaubten Stufe bis xhigh.

Vor Version 2.1.203 kannte die Option --effort den Wert noch nicht. Claude Code meldete dann:

Unknown --effort value 'ultracode'

Die Sitzung startete in diesem Fall auf der Standardstufe.

Auf Claude Pro sind Workflows laut Dokumentation verfügbar. Sie müssen aber zuerst in /config über die Zeile Dynamic workflows eingeschaltet werden. Ab Version 2.1.271 gilt für Pro außerdem die kleinste Größenempfehlung als Standard. Mehr dazu weiter unten.

Wie sehen Sie, was ein Workflow verbraucht?

Für den Verbrauch nennt die Dokumentation zwei Befehle. Der erste zeigt einzelne Läufe:

/workflows

Die Liste enthält laufende und beendete Workflows. Wählen Sie einen Lauf mit den Pfeiltasten und öffnen Sie ihn mit Enter. Die Ansicht zeigt jede Phase mit der Anzahl der Agents, der Token-Summe und der Laufzeit. Mit p pausieren Sie den Lauf, mit x stoppen Sie ihn. Agents, die schon fertig sind, behalten dabei in der Regel ihr Ergebnis.

Der zweite Befehl zeigt Ihr Kontingent:

/usage

Auf Pro und Max zeigt /usage Balken für Ihre Plan-Limits und eine Aufschlüsselung. Daraus geht hervor, welcher Anteil der jüngsten Nutzung auf Subagents, Skills, Plugins und MCP-Server entfällt. Mit d und w wechseln Sie zwischen den letzten 24 Stunden und den letzten 7 Tagen. Die Zahlen sind Näherungswerte aus dem lokalen Verlauf dieses Rechners. Nutzung auf anderen Geräten oder auf claude.ai fehlt darin. Den Dollarbetrag im Block „Session“ oben können Abonnenten ignorieren, denn er ist für Nutzer der API gedacht.

Ist der Anteil der Subagents hoch, war Ultracode oder ein einzelner Workflow die Ursache. Prüfen Sie vor einem großen Lauf außerdem /model, weil Workflow-Agents ohne eigene Vorgabe das Modell Ihrer Sitzung verwenden.

Ultracode gezielt statt dauerhaft nutzen

Workflows sind ein gutes Werkzeug. Für die Prüfung einer ganzen Codebasis oder eine Migration über Hunderte Dateien sind sie oft die richtige Wahl. Das Problem ist der Dauerbetrieb, bei dem jede kleine Frage einen Lauf auslösen kann. Diese Regeln halten den Verbrauch planbar:

• Lassen Sie Ultracode in der Sitzung aus. Schreiben Sie das Schlüsselwort nur in den einen Prompt, der wirklich einen Workflow braucht.
• Testen Sie eine große Aufgabe zuerst an einem kleinen Ausschnitt, etwa an einem Verzeichnis statt am ganzen Repository. So sehen Sie in /workflows, was ein Agent kostet, bevor hundert davon laufen.
• Setzen Sie die Größenempfehlung herunter. Nach /config workflowSizeGuideline=small plant Claude Workflows mit weniger als 5 Agents. Das ist ein Ratschlag an Claude und keine harte Grenze. Ein Prompt, der ausdrücklich mehr verlangt, hat Vorrang.
• Bitten Sie Claude, für einfache Phasen ein kleineres Modell zu nehmen.

Auch ein großer Kontext im Hauptgespräch kostet bei jeder Anfrage Tokens. Wie Sie ihn klein halten, zeigt der Leitfaden zum Kontextmanagement in Claude Code.

Was passiert, wenn das Limit mitten im Workflow erreicht ist?

Ab Version 2.1.271 bricht ein Workflow nicht sofort ab, wenn ein Agent Ihr Limit erreicht. Die betroffenen Agents warten auf den Reset, und es starten keine neuen Agents. Kurz nach dem Reset läuft der Workflow von selbst weiter. Die Fortschrittszeile und der Kopf von /workflows zeigen, wann das Limit zurückgesetzt wird.

Diese Pause gibt es nur unter bestimmten Bedingungen. Die Sitzung muss interaktiv sein und mit einem Abo von claude.ai angemeldet sein. Die Einstellung autoContinueAtUsageLimit muss an sein. Der Reset muss innerhalb von 24 Stunden liegen, was bei einem Wochenlimit oft nicht zutrifft. Außerdem darf der Lauf noch nicht zweimal gewartet haben. Fehlt eine dieser Bedingungen, schlägt der betroffene Agent fehl.

Die Meldung You've hit your session limit betrifft ein Fenster, das für alle Modelle gemeinsam gilt. Ein Wechsel des Modells mit /model hilft deshalb nicht. Welche Möglichkeiten Sie bis zum Reset haben, beschreibt der Beitrag dazu, was Sie bei erreichtem Claude-Limit tun können. Wenn Sie früher gewarnt werden wollen, lesen Sie außerdem, was die Warnung bei 90 Prozent des Sitzungslimits bedeutet.

FAQ

Wie schalte ich Ultracode in Claude Code aus?

Geben Sie in der laufenden Sitzung /effort ultracode off ein. Das funktioniert ab Claude Code 2.1.284. In älteren Versionen wählen Sie eine andere Effort-Stufe, zum Beispiel /effort high, denn dort hängt Ultracode fest an xhigh. Startet Ultracode bei jeder Sitzung neu, entfernen Sie "ultracode": true aus Ihrer settings.json oder --effort ultracode aus Ihrem Startbefehl.

Warum verbraucht Ultracode so viel von meinem Claude-Max-Limit?

Mit Ultracode plant Claude für jede größere Aufgabe einen Workflow, und ein Auftrag kann mehrere Workflows nacheinander auslösen. Jeder Workflow startet viele Subagents, und jeder Subagent schickt eigene Anfragen mit eigenem Kontext. Alle diese Tokens zählen auf dasselbe Fenster von fünf Stunden und auf das Wochenlimit. Ein Bericht in GitHub-Issue #66762 nennt rund 4,4 Millionen Subagent-Tokens aus drei Workflows, die den größten Teil des Fünf-Stunden-Fensters verbraucht haben.

Warum sehe ich keine Warnung „Large workflow“, obwohl viele Agents laufen?

Normalerweise zeigt Claude Code diese Warnung bei mehr als 25 geplanten Agents oder ab 1,5 Millionen geschätzten Tokens. Bei eingeschaltetem Ultracode erscheint sie nicht, weil das Einschalten bereits als Zustimmung zu großen Läufen gilt. Den Verbrauch sehen Sie dann nur in /workflows und in /usage.

Kann ich Ultracode mit Claude Pro nutzen?

Ja. Laut offizieller Dokumentation sind Workflows auf allen bezahlten Plänen verfügbar. Auf Pro schalten Sie sie zuerst in /config über die Zeile Dynamic workflows ein. Die Standardgröße für Workflows ist dort die kleinste Stufe. Das Kontingent von Pro ist kleiner als das von Max, deshalb erreichen Sie das Limit mit Workflows entsprechend früher.