Claude Code auf Opus 5.5 umstellen und das Modell festlegen
Stelle Claude Code mit vollständiger ID oder opus-Alias um, behebe den 400-Fehler eines alten Clients und prüfe medium effort sowie Fallback nach einer Ablehnung.
Inhalt
Du führst /model aus, wählst Opus, doch Claude Code wirkt weiterhin wie ein anderes Modell – oder liefert schon vor der ersten Antwort einen 400-Fehler. Für einen zuverlässigen Wechsel zu Opus 5.5 musst du drei Dinge getrennt prüfen: den Modellbefehl, die Claude-Code-Version und einen möglichen Fallback nach einer Sicherheitsablehnung.
Nutze die vollständige Modell-ID, wenn die Konfiguration reproduzierbar sein soll. Verwende den Alias opus erst, nachdem du geprüft hast, worauf er aufgelöst wird. Beachte außerdem: Opus 5.5 verwendet standardmäßig medium als Effort, nicht mehr high wie Opus 5.
Mit der vollständigen ID legst du Opus 5.5 eindeutig fest
Der eindeutigste Befehl lautet:
/model claude-opus-5-5Anthropic dokumentiert claude-opus-5-5 als feste Modell-ID ohne Datumszusatz. Sie eignet sich deshalb besser für Team-Anleitungen, Projektdokumentation und eigene Provider: Jeder Client fordert sichtbar dasselbe Modell an.
Die kurze Alternative ist:
/model opusVerwende den Alias nur, wenn Claude Code oder der Dienst hinter deiner Base URL anzeigt, dass er tatsächlich zu Opus 5.5 aufgelöst wird. Für interaktive Arbeit ist er bequem, doch bei unerwartetem Verhalten lässt sich die vollständige ID leichter nachvollziehen.
| Ziel | Bevorzugte Option | Warum |
|---|---|---|
| Exaktes Modell festlegen | /model claude-opus-5-5 | Die angeforderte ID ist eindeutig und reproduzierbar |
| Aktuelles Opus schnell wählen | /model opus | Kürzer, aber das aufgelöste Modell muss geprüft werden |
| Einen Drittanbieter untersuchen | Zuerst die vollständige ID | Trennt Alias-Probleme von fehlender Modellverfügbarkeit |
Wenn du Claude Code über eine Anthropic-kompatible Base URL wie BetterToken betreibst, bleibt die Verwendung von /model gleich; prüfe jedoch, ob der Anbieter claude-opus-5-5 tatsächlich bereitstellt, bevor du einem Alias vertraust.
Aktualisiere Claude Code vor dem Wechsel
Ein Client, der älter als das Modell ist, kann die Auswahl ablehnen, obwohl dein Konto oder Provider das Modell bereits unterstützt. Aktualisiere zuerst:
claude updateStarte danach die aktive Claude-Code-Sitzung neu. Falls du die Claude-Desktop-App verwendest, aktualisiere auch sie und führe anschließend erneut den Befehl mit der vollständigen ID aus.
Ein Community-Issue dokumentierte am 22. September 2026 einen konkreten Fall: Claude Code 2.1.257 wurde mit claude_code_version_too_old abgewiesen; die Antwort verlangte 2.1.280 oder neuer. Das zeigt eine Versionssperre, ist aber kein dauerhaftes, universelles Mindestmaß. Halte dich an die Mindestversion in deiner tatsächlichen Fehlermeldung, denn spätere Releases können die Grenze anheben.
Stelle um und kontrolliere das Ergebnis
Gehe in dieser Reihenfolge vor, damit ein Fehler keinen anderen verdeckt:
- Führe
claude updateaus und starte Claude Code neu. - Gib in der gewünschten Arbeitssitzung
/model claude-opus-5-5ein. - Kontrolliere die Modellauswahl, die Claude Code danach anzeigt. Ein akzeptierter Befehl allein beweist noch keinen erfolgreichen Wechsel.
- Öffne vor einer langen oder kostspieligen Aufgabe erneut
/modelund prüfe die aktuelle Auswahl.
Wenn die vollständige ID funktioniert, /model opus aber ein unerwartetes Modell auswählt, bleibe bei der vollständigen ID. Das spricht für ein Problem mit der Alias-Auflösung und nicht gegen die generelle Verfügbarkeit von Opus 5.5.
Wenn keine Variante über einen Drittanbieter-Endpoint funktioniert, prüfe dort Modellverfügbarkeit und Mapping. Die offizielle Claude API kann die Standard-ID bereits anbieten, während ein kompatibles Gateway einen eigenen Katalog verwendet oder das Modell noch nicht freigeschaltet hat.
Der Standardwert für effort ist medium
Claude Opus 5.5 nutzt adaptive thinking immer; der dokumentierte Standard-Effort ist medium. Bei Opus 5 war es high. Deshalb können sich Latenz, Tokenverbrauch und Denktiefe nach dem Modellwechsel verändern, selbst wenn du in Claude Code keine weitere sichtbare Einstellung änderst.
Für die normale Nutzung musst du keinen Effort-Wert erfinden, nur um den Wechsel abzuschließen. Bestätige zuerst das Modell und bewerte dann das Standardverhalten an der echten Aufgabe. Falls dein Client oder API-Gateway einen Effort-Regler anbietet, wähle den Wert bewusst statt vom alten Opus-Standard auszugehen.
Eigene Integrationen müssen außerdem die Request-Regeln von Opus 5.5 beachten. Das Modell lehnt deaktiviertes thinking und ein manuelles thinking budget ab. Wird die Modellwahl akzeptiert, aber der erste Request endet mit 400, untersuche die Payload-Transformationen des Gateways, statt /model wiederholt auszuführen.
Eine markierte Nachricht kann über einen Fallback laufen
Eine Sicherheitsablehnung ist ein anderer Pfad als die normale Modellwahl. Auf API-Ebene kann Opus 5.5 HTTP 200 mit stop_reason: "refusal" und einem stop_details-Objekt zurückgeben. Ist beim Client oder Provider ein Fallback aktiviert, kann genau dieser Request auf einem anderen Modell wiederholt werden.
Behandle das als Request-spezifischen Fallback und nicht als Beweis, dass deine gespeicherte /model-Auswahl dauerhaft geändert wurde. Öffne vor wichtiger weiterer Arbeit erneut /model und prüfe das aktive Modell. Anthropic weist außerdem darauf hin, dass beim Wechsel von Opus 5.5 zu den meisten anderen Modellen spätere Turns ohne die bisherigen thinking blocks von Opus 5.5 laufen. Wiederhole daher zentrale Vorgaben, statt anzunehmen, dass die gesamte interne Herleitung erhalten blieb.
Praktisch gehst du so vor:
- Lies den Ablehnungs- oder Markierungshinweis und sende die identische Anfrage nicht unverändert erneut.
- Ist die Anfrage legitim, entferne oder formuliere den Teil um, der den Klassifikator ausgelöst hat.
- Prüfe, ob Client oder Provider ein Fallback-Modell verwendet haben.
- Bestätige Opus 5.5 erneut, bevor du eine Aufgabe fortsetzt, die ein festes Modell voraussetzt.
Häufige Fehler beheben
| Symptom | Zuerst prüfen | Nächster Schritt |
|---|---|---|
400 mit claude_code_version_too_old | Claude-Code- oder Desktop-Version | claude update ausführen, neu starten und vollständige ID erneut testen |
| Opus 5.5 fehlt in der Liste | Client- oder Provider-Katalog ist veraltet | Client aktualisieren, danach Verfügbarkeit beim Provider prüfen |
/model opus wählt ein unerwartetes Modell | Alias-Auflösung | /model claude-opus-5-5 verwenden und angezeigte Auswahl prüfen |
| Vollständige ID wird akzeptiert, erster Request liefert 400 | Inkompatible Upstream-Payload | Deaktiviertes/manuelles thinking und Gateway-Umschreibungen prüfen |
| Nachricht wird markiert, anderes Modell antwortet | Refusal-Fallback | Ablehnung lesen, Modell prüfen und wichtige Vorgaben wiederholen |
| Wechsel mitten in der Sitzung wirkt inkonsistent | Thinking blocks wurden möglicherweise nicht übertragen | Modell bestätigen und dem neuen Turn den nötigen Kontext geben |
Abschlussprüfung vor der eigentlichen Aufgabe
- Claude Code ist aktualisiert und neu gestartet.
/model claude-opus-5-5wird ohne Versionsfehler akzeptiert.- Die angezeigte Auswahl entspricht tatsächlich Opus 5.5.
- Ohne explizite Einstellung erwartest du den Standard-Effort
medium. - Nach einer markierten oder abgelehnten Anfrage hast du geprüft, ob ein Fallback verwendet wurde.
Sind alle fünf Punkte erfüllt, ist die vollständige ID die sicherste Methode für eine reproduzierbare Sitzung. Der Alias opus bleibt für schnelle Wechsel praktisch, sollte aber überprüft und nicht einfach vorausgesetzt werden.
