Inhaltsverzeichnis

Nur das Planen soll ein kluges Modell übernehmen, das eigentliche Schreiben des Codes ein schnelleres und günstigeres. Claude Code hat eine Einstellung, die genau das automatisch erledigt: opusplan.

Die kurze Antwort: opusplan ist eine Modellangabe, die im Planmodus mit Opus und sonst mit Sonnet läuft. Sie nutzen sie, indem Sie /model opusplan eingeben oder sie unter model in settings.json eintragen. Allerdings erscheint sie nicht in der /model-Liste, Sie finden sie also nur, wenn Sie den Namen kennen. Und weil das Modell bei jedem Betreten und Verlassen des Planmodus wechselt, sollten Sie beachten, dass dabei jedes Mal das gesamte Gespräch ohne Cache neu eingelesen wird.

Auf Basis der offiziellen Dokumentation, des Änderungsprotokolls von Claude Code (CHANGELOG) und der GitHub-Issues mit Stand 15. September 2026 fasst dieser Artikel zusammen, wie Sie es einrichten, wie die Arbeit abläuft, warum es nicht aufgelistet wird, worauf Sie bei Kosten und Cache achten sollten und wie es sich von ähnlichen Mechanismen (Advisor-Tool und Subagenten) unterscheidet.

Mit opusplan wechselt das Modell beim Betreten und Verlassen des Planmodus

Über die Anthropic API. Wohin opus und sonnet zeigen, hängt vom Anbieter ab

Im Planmodus

Opus 5

Untersucht den Code und schreibt einen Plan, ohne etwas zu bearbeiten

Plan genehmigen →

Alles andere (Implementierung)

Sonnet 5

Bearbeitet Dateien und führt Befehle gemäß dem Plan aus

Quelle: Claude Code Dokumentation, „Model configuration“ (opusplan model setting, wohin die Modell-Aliasse zeigen)

1. Was opusplan ist: Opus nur im Planmodus

opusplan ist wie sonnet oder opus ein Modell-Alias (Kurzname), den Sie an /model übergeben können. Die offizielle Dokumentation beschreibt ihn als speziellen Modus, der im Planmodus opus verwendet und für die Ausführung zu sonnet wechselt.

Ob gewechselt wird, entscheidet allein, ob Sie sich im Planmodus befinden. Im Planmodus liest Claude Dateien und untersucht per Befehl, schreibt einen Plan und bearbeitet Ihren Quellcode nicht, bevor Sie ihn genehmigen (einen Überblick über alle Berechtigungsmodi gibt Claude Code Berechtigungsmodi: die 5 Modi und ihr sicherer Einsatz).

ZustandModell unter opusplanGeeignet für (laut offizieller Dokumentation)
Im Planmodusopus (über die Anthropic API Opus 5)Komplexes Schlussfolgern und Architekturentscheidungen
Alles anderesonnet (über die Anthropic API Sonnet 5)Codegenerierung und Implementierung

Quelle: Claude Code Dokumentation, „Model configuration“ (Stand 15. September 2026). Wohin die Aliasse zeigen, hängt vom Anbieter ab; auf Amazon Bedrock und der Agent Platform von Google Cloud ist sonnet beispielsweise Sonnet 4.5

Es gibt noch einen ähnlichen Mechanismus. Eine Sitzung, die mit Haiku läuft, wechselt nur während des Planmodus automatisch zu Sonnet (eingeführt in v2.0.17 zusammen mit Haiku 4.5; zum Zeitpunkt der Einführung wurde auf Amazon Bedrock und Google Vertex AI nicht automatisch gewechselt). Das funktioniert ganz ohne Einstellung.

2. So richten Sie es ein

Sie legen es genauso fest wie jedes andere Modell. Hier die Wege, geordnet nach dem Vorrang laut offizieller Dokumentation, vom höchsten zum niedrigsten.

WegSchreibweiseGeltungsbereich
Mitten im Gespräch wechseln/model opusplanDie aktuelle Sitzung und alle danach neu gestarteten Sitzungen (wird in den Benutzereinstellungen gespeichert)
Beim Start angebenclaude --model opusplanDiese Sitzung
UmgebungsvariableANTHROPIC_MODEL=opusplanSitzungen, die in dieser Umgebung gestartet werden
Einstellungsdatei"model": "opusplan" in settings.jsonAlle neu gestarteten Sitzungen

Wenn Sie /model opusplan eingeben, wechselt nicht nur die aktuelle Sitzung: Der Wert wird unter model in Ihre Benutzereinstellungen geschrieben und damit auch zum Standard für neue Sitzungen. Um es nur dieses eine Mal auszuprobieren, starten Sie mit claude --model opusplan.

{
  "model": "opusplan"
}

Drei weitere Angaben sind nützlich zu kennen.

  • Die Modellversionen festlegen: Welches Opus opusplan im Planmodus nutzt, bestimmt ANTHROPIC_DEFAULT_OPUS_MODEL, welches Sonnet es sonst nutzt, ANTHROPIC_DEFAULT_SONNET_MODEL. Auf Amazon Bedrock und ähnlichen Anbietern tragen Sie hier die Modell-IDs Ihres Anbieters ein
  • Mit 1M Tokens Kontext nutzen: In Tarifen wie Max, Team und Enterprise, in denen Opus automatisch auf 1M erweitert wird, erhält auch die Opus-Seite von opusplan 1M. Andernfalls geben Sie opusplan[1m] an, um beide Seiten auf 1M zu bringen. Über /model opusplan[1m] geht das ab v2.1.265; in früheren Versionen verwenden Sie --model oder die Einstellungsdatei
  • In der Umgebungsvariable für das Standardmodell funktioniert es nicht: Tragen Sie opusplan in ANTHROPIC_DEFAULT_MODEL ein, die den Standard für neue Sitzungen festlegt, wird es ignoriert. Um es zum Standard zu machen, geben Sie /model opusplan ein oder tragen es unter model in settings.json ein

Quelle: Claude Code Dokumentation, „Model configuration“ (Setting your model, Environment variables, Extended context, opusplan model setting), ebenda, „Settings reference“ (model)

Lässt es sich in der Oberfläche auswählen?

  • In der Liste von /model im Terminal erscheint es nicht. Öffnen Sie /model ohne Argument, werden Opus, Sonnet, Haiku und weitere aufgelistet, opusplan aber nicht. Eine Anfrage auf GitHub, es in die Liste aufzunehmen (#26556), ist mit Stand 15. September 2026 weiterhin offen. 🟡 Die offizielle Dokumentation sagt nicht, ob es in der Liste erscheint; dieser Punkt beruht auf Berichten von Nutzern. Im selben Issue wird außerdem berichtet, dass sich mit der in v2.1.243 eingeführten Einstellung modelPicker keine eigene Zeile ergänzen lässt: Im Anhängen-Modus (append) gilt sie als Duplikat der Sonnet-Zeile und wird nicht angezeigt
  • 🟡 Ob opusplan in der Modellauswahl der VS-Code-Erweiterung und der Desktop-App erscheint, steht nicht in der offiziellen Dokumentation. Beide laufen auf Claude Code, das settings.json verwendet, aber wie sie es in der Oberfläche behandeln, ist nicht bestätigt; prüfen Sie daher vor der Nutzung, welches Modell angezeigt wird

3. So läuft die Arbeit ab

Allein durch das Festlegen von opusplan bleibt es bei Sonnet. Zu Opus wird es nur, wenn Sie selbst in den Planmodus wechseln.

  1. In den Planmodus wechseln: Im Terminal schalten Sie mit Shift+Tab dorthin oder stellen Ihrer Anfrage /plan voran. Um direkt darin zu starten, verwenden Sie claude --permission-mode plan. In der Desktop-App wählen Sie ihn über die Auswahl des Berechtigungsmodus (Modusauswahl)
  2. Opus schreibt den Plan: Es liest Dateien und untersucht per Befehl, dann stellt es einen Plan zusammen, ohne etwas zu bearbeiten. Mit Ctrl+G können Sie den Plan auch in Ihrem Editor öffnen und direkt ändern
  3. Den Plan genehmigen: Sie wählen zwischen „Yes, and use auto mode“ (mit dem Auto-Modus fortfahren), „Yes, manually approve edits“ (Änderungen einzeln genehmigen) und „No, keep planning“ (weiter planen); ist der Auto-Modus nicht verfügbar, lautet die erste Option „Yes, auto-accept edits“ (Änderungen automatisch akzeptieren). Mit der Genehmigung verlassen Sie den Planmodus, und ab hier implementiert Sonnet
  4. Wenn Sie erneut planen möchten: Kehren Sie mit Shift+Tab in den Planmodus zurück, oder stellen Sie der nächsten Anfrage /plan voran. Solange Sie dort sind, ist es wieder Opus

Setzen Sie die Einstellung showClearContextOnPlanAccept auf true, erscheint ganz oben in den Genehmigungsoptionen „Yes, clear context and …“ (der Rest nennt den Berechtigungsmodus), also Kontext löschen und genehmigen. Damit verwerfen Sie etwa die Inhalte der beim Planen gelesenen Dateien und beginnen die Implementierung nur mit dem Plan (Standard ist false). Wie Abschnitt 5 erklärt, wirkt sich das bei opusplan auch auf die Kosten aus.

Quelle: Claude Code Dokumentation, „Choose a permission mode“ (Analyze before you edit with plan mode, Review and approve a plan), ebenda, „Settings reference“ (showClearContextOnPlanAccept), ebenda, „Desktop“ (Auswahl des Berechtigungsmodus)

Fragen Sie nicht das Modell selbst, mit welchem Modell es gerade läuft. In einer GitHub-Diskussion im September 2025 schrieb ein Mitarbeiter von Anthropic, man solle nicht das Modell fragen, was es sei, sondern die Anzeige der Anwendung prüfen. Wie Sie das prüfen, fasst F3 in den FAQ zusammen.

4. Warum es nicht in der /model-Liste erscheint

opusplan ist keine neue Funktion. Dass es nicht aufgelistet wird, liegt daran, dass es zwischenzeitlich aus der Oberfläche entfernt wurde. Verfolgt man das Änderungsprotokoll und die GitHub-Issues, ergibt sich folgendes Bild.

ZeitpunktEreignis
v1.0.77Als „Opus Plan Mode“ zu /model hinzugefügt: Opus nur im Planmodus, sonst Sonnet
v1.0.88Mit ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_SONNET_MODEL lassen sich die Versionen festlegen, die opusplan nutzt
v2.0.0 (September 2025)Aus der Modellauswahl entfernt (nicht im Änderungsprotokoll vermerkt, bekannt aus dem Issue). Ein Nutzer eröffnet Issue #8358 mit der Frage, warum es entfernt wurde
29. September 2025Ein Mitarbeiter von Anthropic erklärt im Issue, man halte Sonnet 4.5 insgesamt für besser als Opus 4.1 und habe es deshalb bewusst aus der Auswahl entfernt; die Einstellung opusplan selbst funktioniere weiterhin
v2.0.17Sitzungen mit Haiku 4.5 nutzen im Planmodus automatisch Sonnet
18. Februar 2026Der Ersteller bestätigt, dass es mit /model opusplan funktioniert, und schließt #8358. Am selben Tag wird #26556 eröffnet, mit der Bitte, es in der Liste anzuzeigen (mit Stand 15. September 2026 ungelöst)
Februar bis März 2026Fehlerbericht #27237: opusplan wähle Sonnet 4.5 statt Sonnet 4.6. Er wurde ohne Reaktion von Anthropic automatisch geschlossen
v2.1.172Fehler behoben, durch den Opus im Planmodus in Tarifen mit Anspruch auf 1M-Kontext keine 1M erhielt
v2.1.265Fehler behoben, durch den /model opusplan[1m] mit „Model not found“ abgelehnt wurde

Quelle: Claude Code CHANGELOG, GitHub-Issue #8358, #26556, #27237 (alle geprüft am 15. September 2026)

🟡 Warum es heute nicht aufgelistet wird, hat Anthropic nicht erneut erklärt. Die Erklärung vom September 2025 verglich Sonnet 4.5 und Opus 4.1, wie sie damals waren. Ob dieselbe Einschätzung auch für die Kombination aus Opus 5 und Sonnet 5 gilt, ist unbekannt. Andererseits enthält die offizielle Dokumentation weiterhin einen Abschnitt zu opusplan, und das Änderungsprotokoll führt auch Korrekturen aus dem Jahr 2026 auf; als Einstellung ist es also weiterhin nutzbar.

Es gibt auch Berichte wie Issue #27237, nach denen die gewählten Versionen nicht den Erwartungen entsprachen. Die Modell-ID in diesem Bericht hat allerdings das Format von Google Cloud, und auch laut aktueller offizieller Dokumentation zeigt sonnet bei Google Cloud auf Sonnet 4.5; es könnte sich also um das dokumentierte Verhalten gehandelt haben (meine eigene Einschätzung). Wenn Sie das beunruhigt, legen Sie die Versionen mit den beiden Umgebungsvariablen oben fest und prüfen Sie, welches Modell tatsächlich lief.

5. Kosten und Cache: Jeder Wechsel liest alles neu ein

Die meisten nutzen opusplan, um Verbrauch oder Kosten zu senken. Geht die Implementierung an Sonnet, sinkt der Preis pro Token.

ModellEingabeAusgabeCache-Schreiben (5 Minuten)Cache-Schreiben (1 Stunde)Cache-Lesen
Claude Opus 55 $25 $6,25 $10 $0,50 $
Claude Sonnet 52 $10 $2,50 $4 $0,20 $

Quelle: Claude Platform Docs, „Pricing“ (pro Million Tokens, Stand 15. September 2026)

Allerdings gibt es einen Kostenpunkt, der leicht übersehen wird. Prompt-Caches sind pro Modell getrennt, und die offizielle Dokumentation schreibt, dass bei opusplan jedes Betreten oder Verlassen des Planmodus ein Modellwechsel ist und dabei jedes Mal ein neuer Cache aufgebaut wird. Das heißt: Die erste Antwort von Sonnet direkt nach dem Verlassen des Planmodus und die erste Antwort von Opus direkt nach der Rückkehr lesen jeweils das gesamte bisherige Gespräch ohne Cache ein.

Wie viel das ausmacht, habe ich für einen Wechsel an dem Punkt geschätzt, an dem das Gespräch auf 100.000 Tokens angewachsen ist. Im Abonnement gilt innerhalb Ihres Tarifs für das Hauptgespräch ein 1-Stunden-Cache, daher sind die Schreibvorgänge zum 1-Stunden-Preis gerechnet. Übrigens können Sie auch mit API-Schlüssel oder über einen Cloud-Anbieter dem Hauptgespräch einen 1-Stunden-Cache geben, indem Sie promptCacheTtl auf 1h setzen (ab v2.1.242); umgekehrt gilt auch im Abonnement ein 5-Minuten-Cache, solange Sie über den Tarif hinaus mit zusätzlichem Nutzungsguthaben (usage credits) bezahlen.

WechselNeu geschriebene MengeAPI-Schlüssel (5-Minuten-Cache)Abonnement (1-Stunden-Cache)
Planmodus verlassen (zu Sonnet 5)100.000 Tokensetwa 0,25 $entspricht etwa 0,40 $
In den Planmodus zurückkehren (zu Opus 5)100.000 Tokensetwa 0,63 $entspricht etwa 1,00 $

Quelle: eigene Schätzung auf Basis der offiziellen Preise (100.000 Tokens × Preis). 🟡 Dass die Limits eines Abonnements im Verhältnis dieser Beträge schrumpfen, ist nicht veröffentlicht. Lebensdauer des Cache laut Claude Code Dokumentation, „How Claude Code uses prompt caching“

Lesen Sie dieselben 100.000 Tokens weiter mit Opus, kostet jedes Cache-Lesen etwa 0,05 $. Wechseln Sie mehrmals in den Planmodus und wieder heraus, solange der Austausch zur Implementierung noch kurz ist, können die Schreibvorgänge beim Wechsel teurer werden. Es gibt drei Wege, die Kosten niedrig zu halten.

  • Früh im Gespräch planen: Wechseln Sie, solange der Kontext noch klein ist, bleibt auch die neu geschriebene Menge klein
  • Beim Genehmigen den Kontext löschen: Aktivieren Sie showClearContextOnPlanAccept und wählen Sie die Option zum Löschen des Kontexts, beginnt Sonnet nur mit dem Plan und liest weniger neu ein
  • Nicht ständig zwischen Planung und Implementierung hin- und herwechseln: Jede Rückkehr in den Planmodus löst auch auf der Opus-Seite ein erneutes Einlesen aus

Auch zu den Limits des Abonnements ein Hinweis. Das Sitzungslimit und das Wochenlimit gelten für alle Modelle gemeinsam; daneben gibt es Limits pro Modellfamilie wie ein „Opus-Limit“ und ein „Sonnet-Limit“. Da opusplan im Planmodus Opus verwendet, können Sie Opus im Planmodus nicht mehr nutzen, sobald Sie das Opus-Limit erreicht haben. Auf der Preisseite wird Opus auch im Pro-Tarif als verfügbar aufgeführt, laut offizieller Dokumentation benötigen Sie im Pro-Tarif für Opus mit 1M-Kontext jedoch zusätzliches Nutzungsguthaben (usage credits).

Quelle: Claude Code Dokumentation, „How Claude Code uses prompt caching“ (Switching models, Changing permission mode, Which TTL each request gets), ebenda, „Error reference“ (gemeinsame Limits für alle Modelle und Limits pro Modellfamilie), ebenda, „Model configuration“ (Extended context), Claude-Preisseite (Modelle pro Tarif)

6. Unterschiede zum Advisor-Tool und zu Subagenten

opusplan ist nicht der einzige Weg, ein starkes mit einem schnellen Modell zu kombinieren. Die offizielle Dokumentation vergleicht die Möglichkeiten danach, wann das stärkere Modell läuft.

WegWann das stärkere Modell läuftWie es beginnt
Advisor-ToolAn Entscheidungspunkten während der ArbeitClaude ruft es bei Bedarf auf
opusplanWährend des Planmodus, sofern availableModels es zulässt (Ausführung mit Sonnet)Sie wechseln selbst in den Planmodus
Subagent mit festgelegtem ModellFür die gesamte abgegebene AufgabeClaude gibt ab, oder Sie rufen ihn selbst auf
Wechsel mit /modelAb der nächsten Anfrage dauerhaftSie wechseln selbst

Quelle: Claude Code Dokumentation, „Escalate hard decisions with the advisor tool“ (Compare with related features)

Beim Advisor-Tool läuft die Hauptsitzung mit einem schnellen Modell, und Claude holt sich mitten in der Arbeit Rat bei einem stärkeren Modell. Anders als bei opusplan bleibt der Cache der Hauptsitzung beim Ein- und Ausschalten erhalten. Allerdings liest der Advisor bei jeder Beratung das gesamte Gespräch, und dieses Einlesen wird nicht gecacht. Mit Stand 15. September 2026 ist es eine experimentelle Funktion und nur über die Anthropic API verfügbar (nicht auf Amazon Bedrock und ähnlichen Anbietern).

Subagenten führen nur die abgegebene Arbeit mit einem anderen Modell aus. Einrichtung und Messungen behandelt Claude Code: Subagenten mit einem anderen Modell ausführen.

Quelle: Claude Code Dokumentation, „Escalate hard decisions with the advisor tool“ (Cost, Impact on prompt caching, Requirements)

7. Wofür es sich eignet und wofür nicht

Aus den bisher beschriebenen Mechanismen ergeben sich folgende Entscheidungshilfen (keine offizielle Empfehlung, sondern meine eigene Einordnung, abgeleitet aus der Funktionsweise).

Gut geeignet

Ein Ablauf aus „planen, genehmigen, dann lange implementieren“

Arbeit, bei der Sie ohnehin den Planmodus nutzen und nach einem einmal festgelegten Plan lange an der Implementierung arbeiten. Es gibt wenige Wechsel, und der niedrigere Preis für die Implementierung macht sich bemerkbar.

Mit etwas Sorgfalt nutzbar

Arbeit, bei der Sie erst planen, wenn der Kontext schon groß ist

Bei jedem Wechsel wird mehr neu eingelesen. Zusammen mit der Einstellung, die beim Genehmigen den Kontext löscht, lässt sich das erneute Einlesen auf der Sonnet-Seite begrenzen.

Weniger geeignet

Arbeit, die ständig zwischen Planung und Implementierung wechselt

Kehren Sie für jede kleine Korrektur in den Planmodus zurück, häuft sich das erneute Einlesen. Auch Arbeit, bei der die Implementierung selbst ein starkes Modell braucht, passt nicht zu opusplan, das mit Sonnet ausführt.

Im Zweifel ist der sichere Weg, dieselbe Art von Aufgabe einmal mit opusplan und einmal mit Ihrem üblichen Modell zu erledigen und die Zahlen in /usage sowie das Ergebnis zu vergleichen. Wie Sie den Verbrauch pro Sitzung im Detail ansehen, fasst Claude Code: Verbrauch pro Sitzung messen zusammen.

FAQ

F1. Ich habe /model geöffnet, finde opusplan aber nicht.
Das ist so vorgesehen: Es wird nicht in der Liste angezeigt (Stand 15. September 2026). Geben Sie den Namen direkt ein, also /model opusplan. So eingegeben wird es auch als Standard für neue Sitzungen gespeichert. Um es nur für diese eine Sitzung zu nutzen, starten Sie mit claude --model opusplan.

F2. Ich habe opusplan eingestellt, aber es bleibt die ganze Zeit bei Sonnet.
Das ist normal. opusplan nutzt Opus nur während des Planmodus und wechselt nicht von selbst in den Planmodus. Schalten Sie mit Shift+Tab dorthin, oder stellen Sie Ihrer Anfrage /plan voran.

F3. Kann ich prüfen, mit welchem Modell es gerade läuft?
Prüfen Sie die Anzeige der App, statt das Modell zu fragen. /status zeigt das aktuelle Modell; außerdem übergibt die Statusleiste das aktuelle Modell an Ihr Skript, sodass Sie sie so einrichten können, dass sie den Modellnamen anzeigt. Im Nachhinein ist in den Gesprächsprotokollen (den JSONL-Dateien in ~/.claude/projects) bei jeder Antwort unter message.model das Modell festgehalten, das tatsächlich geantwortet hat.

F4. Funktioniert es auch auf Amazon Bedrock oder Google Cloud?
Ja. Tragen Sie die Modell-IDs Ihres Anbieters in ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_SONNET_MODEL ein, um die Versionen festzulegen, die opusplan nutzt. Schließen die verwalteten Einstellungen Ihrer Organisation (availableModels) das neueste Opus aus, plant es über die Anthropic API und Claude Platform on AWS mit dem neuesten zugelassenen Opus; sind alle Opus-Modelle ausgeschlossen, bleibt es auch im Planmodus bei Sonnet. Auf Bedrock, Google Cloud, Microsoft Foundry und ähnlichen Anbietern plant es bei einem Ausschluss auch im Planmodus mit dem ursprünglichen Modell der Sitzung (beide Verhaltensweisen ab v2.1.205).

F5. Was ist opusplan[1m]?
Eine Angabe, mit der sowohl Opus im Planmodus als auch Sonnet bei der Ausführung mit 1 Million Tokens Kontext laufen. In Tarifen wie Max, Team und Enterprise, in denen Opus automatisch 1M erhält, bekommt die Opus-Seite auch ohne diesen Zusatz 1M. Sonnet 5 läuft über die Anthropic API ohnehin immer mit 1M. /model akzeptiert diese Schreibweise ab v2.1.265.

Quellen