Sofern Sie ANTHROPIC_DEFAULT_FABLE_MODEL nicht setzen, wird der Alias fable zu Fable 5.1 aufgelöst, außer in Claude-Apps-Gateway-Sitzungen, wo fable und best zu Fable 5 aufgelöst werden. Vor v2.1.257 wurde fable auf jedem Anbieter zu Fable 5 aufgelöst.

Ein Gateway, das nicht konfiguriert ist, um claude-fable-5-1 bereitzustellen, lehnt Anfragen für dieses Modell ab. Um Fable 5.1 über ein Gateway zu verwenden, das es bereitstellt, wählen Sie es mit /model claude-fable-5-1 aus.

Wenn ein Alias zu einem älteren Modell aufgelöst wird, sind neuere Modelle verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder ANTHROPIC_DEFAULT_OPUS_MODEL oder ANTHROPIC_DEFAULT_SONNET_MODEL setzen.

Vor v2.1.219 wurde opus zu Opus 4.8 auf der Anthropic API ab v2.1.154 und auf Claude Platform on AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.207 aufgelöst. Vor v2.1.207 wurde opus zu Opus 4.7 auf Claude Platform on AWS und zu Opus 4.6 auf Amazon Bedrock und Google Cloud's Agent Platform aufgelöst.

Aliase verweisen auf die empfohlene Version für Ihren Anbieter und werden im Laufe der Zeit aktualisiert. Um eine bestimmte Version zu fixieren, verwenden Sie den vollständigen Modellnamen, z. B. claude-opus-5, oder setzen Sie die entsprechende Umgebungsvariable wie ANTHROPIC_DEFAULT_OPUS_MODEL.

Mit Fable arbeiten

Claude Fable 5.1 und Claude Fable 5 sind die leistungsfähigsten Modelle in Claude Code, geeignet für Aufgaben, die größer als eine einzelne Sitzung sind. Sie halten lange autonome Sitzungen, untersuchen vor dem Handeln und überprüfen ihre Arbeit häufiger als kleinere Modelle. Fable 5.1 ist die neuere Version.

Keines der Fable-Modelle ist der Standard für den Kontotyp auf einem Plan oder Anbieter. Wählen Sie eines explizit aus:

• Fable 5.1: Führen Sie /model fable aus, oder starten Sie mit claude --model fable. In Claude-Apps-Gateway-Sitzungen, wo der Alias zu Fable 5 aufgelöst wird, führen Sie stattdessen /model claude-fable-5-1 aus.
• Fable 5: Wählen Sie es nach Modell-ID aus. Auf der Anthropic API führen Sie /model claude-fable-5 aus oder starten Sie mit claude --model claude-fable-5. Bei anderen Anbietern verwenden Sie die Fable-5-Modell-ID Ihres Anbieters oder fixieren Sie sie mit ANTHROPIC_DEFAULT_FABLE_MODEL.

Wenn Sie sich direkt mit der Anthropic API verbinden und Ihre Benutzereinstellungen claude-fable-5 oder claude-fable-5[1m] als Modell enthalten, z. B. weil Sie Fable in der /model-Auswahl vor v2.1.257 ausgewählt haben, ändert Claude Code diesen gespeicherten Wert beim ersten Ausführen von v2.1.257 oder später zu dem Alias fable oder fable[1m], und die Startmodellzeile zeigt (auto-updated) einmal an. Ein claude-fable-5-Wert in Projekt-, lokalen oder verwalteten Einstellungen wird unverändert gelassen.

Anfragen, die die Sicherheitsklassifizierer eines Fable-Modells kennzeichnen, meist in Cybersicherheits- und Biologie-Bereichen, lösen automatisches Modell-Fallback aus.

Um das Beste aus Fable herauszuholen:

• Beschreiben Sie das Ergebnis, nicht die Schritte: Geben Sie ihm das Ergebnis, das Sie möchten, und lassen Sie es den Weg planen. Um es auf dieses Ergebnis hinzuarbeiten, setzen Sie ein Ziel.
• Geben Sie ihm mehrdeutige Probleme: Root-Cause-Untersuchungen, Ausfalldebugging und Architekturentscheidungen sind Bereiche, in denen die zusätzliche Untersuchung und Überprüfung sich auszahlt.
• Überspringen Sie die Überprüfungserinnerungen: Es überprüft seine eigene Arbeit mit weniger Aufforderungen, daher sind Erinnerungen zum Testen oder Überprüfen normalerweise unnötig.
• Größere Aufgaben einschätzen: Geben Sie ihm Arbeit, die Sie normalerweise in Teile aufteilen würden. Es hält lange Sitzungen, ohne den Faden zu verlieren.

Auf der Anthropic API listet die /model-Auswahl ein Fable-Modell nur auf, nachdem der Server es als verfügbar für Ihre Organisation meldet. Wenn Sie /model fable oder eine Fable-Modell-ID eingeben, prüft Claude Code die Verfügbarkeit direkt mit dem Server, sodass eine eingegebene Auswahl erfolgreich sein kann, auch wenn die Auswahl den Eintrag nicht auflistet.

Fable und Nutzungsguthaben

Je nach Ihrem Plan und Seat-Tier kann die Fable-Nutzung zu Nutzungsguthaben abgerechnet werden, anstatt auf die in Ihrem Plan enthaltenen Limits zu ziehen. Wenn dies der Fall ist, zeigt die /model-Auswahl „Requires usage credits" in der Fable-Zeile an. Um Nutzungsguthaben zu verwalten, siehe Add usage credits to your subscription.

In interaktiven Sitzungen zeigt Claude Code eine Zustimmungsaufforderung an, bevor eine Fable-Anfrage Nutzungsguthaben abrechnet. Mitglieder von Enterprise-Plänen mit Organisationsabrechnung sehen die Aufforderung nicht. Sie können auf Fable mit Nutzungsguthaben fortfahren oder zu Ihrem Standardmodell wechseln. Sie können die Aufforderung auch ablehnen:

• In der /model-Auswahl behalten Sie Ihr aktuelles Modell.
• Während der Sitzung setzt Claude Code den Zug auf Ihrem Standardmodell fort.

Nachdem Sie sich entschieden haben, auf Fable mit Nutzungsguthaben fortzufahren, zeigt Claude Code die Aufforderung nicht erneut an.

In einer Sitzung mit verbundenem Remote Control, einer Hintergrund-Sitzung oder einer Sitzung eines Agent-Team-Teamkollegen kann niemand am Terminal sein, daher hält Claude Code die Zustimmungsaufforderung während der Sitzung bis zur dialogExpiry-Frist, standardmäßig fünf Minuten. Wenn bis zur Frist niemand geantwortet hat, beendet Claude Code den Zug ohne Senden der Anfrage und fügt eine Notiz zum Transkript hinzu, die der Remote-Control-Client auch anzeigt. Ihre Modellauswahl ist unverändert, und Claude Code fragt beim nächsten Mal nach Zustimmung.

Was Sie tun können, während die Aufforderung wartet, hängt von der Sitzung ab:

• Mit verbundenem Remote Control oder in einer Teamkollegen-Sitzung drücken Sie eine beliebige Taste am Terminal, um die Frist zu stornieren, und Claude Code wartet auf Ihre Antwort.
• In einer Hintergrund-Sitzung antworten Sie vor der Frist.
• Wenn Sie eine neue Nachricht vom Remote-Client senden, bevor jemand am Terminal eingegeben hat, beendet Claude Code den Zug auf die gleiche Weise, und Ihre neue Nachricht startet den nächsten Zug. Nachdem jemand am Terminal eingegeben hat, wartet Claude Code weiter auf die Antwort und reiht Ihre neue Nachricht dahinter ein.

Im nicht-interaktiven Modus mit dem -p-Flag und über das Agent SDK zeigt Claude Code die Zustimmungsaufforderung nie an. Wenn eine Fable-Anfrage dort zu Nutzungsguthaben abgerechnet würde, rechnet Claude Code sie ohne Nachfrage ab.

Ihr Modell einstellen

Sie können Ihr Modell auf mehrere Arten konfigurieren, aufgelistet nach Priorität:

1. Während der Sitzung: Verwenden Sie /model <alias|name>, um sofort zu wechseln, oder führen Sie /model ohne Argument aus, um die Auswahl zu öffnen. Siehe wenn Claude Code Sie auffordert, den Wechsel zu bestätigen
2. Beim Start: Starten Sie mit claude --model <alias|name>
3. Umgebungsvariable: Setzen Sie ANTHROPIC_MODEL=<alias|name>
4. Einstellungen: Konfigurieren Sie dauerhaft in Ihrer Einstellungsdatei mit dem Feld model
5. Standard für neue Sitzungen: Setzen Sie ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model speichert Ihre Auswahl als Standard für neue Sitzungen, indem das Feld model in Ihren Benutzereinstellungen geschrieben wird. In der Auswahl:

• Enter: Modell wechseln und als Standard speichern
• s: Modell nur für diese Sitzung wechseln und Ihren Standard unverändert lassen. Um eine andere Taste zu verwenden, binden Sie modelPicker:thisSessionOnly neu.

Die direkte Eingabe von /model <name> verhält sich wie Enter. Um nur für diese Sitzung zu wechseln, öffnen Sie die Auswahl mit /model und drücken Sie s auf der Zeile des Modells.

Wenn Sie ein Modell mit /model im nicht-interaktiven Modus mit dem -p-Flag setzen, gilt Ihre Auswahl nur für die aktuelle Sitzung und wird nicht als Standard gespeichert; /model in diesem Modus erfordert Claude Code v2.1.205 oder später. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. Ein Organisations-Standard-Modell, das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.

In v2.1.144 bis v2.1.152 galt /model nur für die aktuelle Sitzung und d in der Auswahl speicherte einen Standard.

Das Flag --model und die Umgebungsvariable ANTHROPIC_MODEL gelten nur für die Sitzung, mit der Sie sie starten. Um verschiedene Modelle in verschiedenen Terminals gleichzeitig auszuführen, starten Sie jedes mit seinem eigenen --model-Flag, anstatt mit /model zu wechseln.

Preise in der /model-Auswahl werden angezeigt, wenn Claude Code mit der Anthropic API spricht, direkt oder über ein LLM-Gateway, das es proxiert, und der Preis in einer Zeile ist der Preis des Modells, das diese Zeile auswählt. Bei Drittanbieter-Anbietern wie Amazon Bedrock und beim Claude-Apps-Gateway bestimmt Ihr Anbieter oder Gateway, was Sie zahlen, daher zeigen Auswahl-Zeilen keinen Preis. Der Preis ist nur ein Anzeigelabel; er beeinflusst nicht, welches Modell eine Zeile auswählt oder was Ihr Anbieter abrechnet. Vor v2.1.206 zeigten Claude Platform on AWS und Gateway-Sitzungen Anthropic-Listenpreise, und eine Zeile könnte den Preis eines anderen Modells als dem, das sie auswählte, anzeigen.

Wiederaufgenommene Sitzungen, die mit claude --resume, --continue oder der /resume-Auswahl gestartet wurden, behalten das Modell, das sie beim Speichern des Transkripts verwendeten, unabhängig von der aktuellen model-Einstellung. Wenn das wiederhergestellte Modell eingestellt wurde oder von availableModels ausgeschlossen wird, fällt die Sitzung auf die normale Prioritätsreihenfolge zurück. Dies verhindert, dass die /model-Auswahl einer anderen Sitzung das Modell beim Fortsetzen ändert. Bei Anbietern, die anbieter-spezifische Bereitstellungs-IDs anstelle von Anthropic-Modell-IDs verwenden, wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, wird das Transkript-Modell überhaupt nicht wiederhergestellt und die Sitzung löst ihr Modell durch die normale Prioritätsreihenfolge auf.

Ein Modell, das Sie für den neuen Start mit --model oder ANTHROPIC_MODEL auswählen, hat weiterhin Vorrang vor dem wiederhergestellten Modell. Ab v2.1.195 gilt dies auch für eine ANTHROPIC_DEFAULT_OPUS_MODEL-Familienvariable. ANTHROPIC_DEFAULT_MODEL kann dies auch unter den in seinem Abschnitt aufgelisteten Bedingungen tun.

Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen statt aus Ihrer eigenen Auswahl stammt, zeigt der Start-Header, welche Einstellungsdatei es gesetzt hat. Führen Sie /model aus, um zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet. Auf Plattformen, die Claude Code einbetten und CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete availableModels-Zulassungsliste in Kraft bleibt, es sei denn, der Host liefert seine eigene; Exceptions to managed settings precedence sagt, welche Schlüssel und Variablen der Host überschreibt.

Wenn Sie oder Ihre Organisation PreModelSwitch-Hooks konfigurieren, werden sie ausgeführt, bevor ein angefordeter Wechsel angewendet wird, und können ihn blockieren oder Sie auffordern, ihn zu bestätigen.

Wenn Claude Code nicht feststellen kann, welche PreModelSwitch-Hooks Ihre Organisation's verwaltete Plugins bereitstellen, z. B. weil ein verwaltetes Plugin nicht geladen werden konnte, lehnt es den Wechsel ab, anstatt ihn unkontrolliert anzuwenden, und prüft ihn bei jedem neuen Versuch erneut. Siehe Model switch was blocked by a PreModelSwitch hook für die Nachricht und Wiederherstellung.

Wenn Sie Modelle über die Agent SDK-Methode setModel() wechseln oder von einem Gerät, das über Remote Control verbunden ist, oder eine App wie die Desktop-App, die die Claude Code CLI für Sie ausführt, Claude Code wechselt, prüft Claude Code, dass die Zeichenkette eine ist, die es erkennt, bevor es sie speichert. Diese Prüfung erfordert Claude Code v2.1.200 oder später. Das Überprüfen einer Remote-Control-Auswahl erfordert Claude Code v2.1.260 oder später auf Ihrem Computer. Auf der Anthropic API erkennt Claude Code:

• einen Modell-Alias
• einen Eintrag aus der /model-Auswahl
• jeden Namen, der mit claude- beginnt
• einen Wert, den Sie selbst als benutzerdefinierte Modelloption oder in modelOverrides konfiguriert haben

Claude Code lehnt eine unbekannte Zeichenkette mit Model "<name>" is not a recognized model id. ab und die Sitzung behält ihr aktuelles Modell, anstatt die Zeichenkette zu speichern und beim nächsten Request fehlzuschlagen. Siehe die Fehlerreferenz für Wiederherstellungsschritte.

Die Prüfung läuft nur auf der Anthropic API. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS und hinter einem LLM-Gateway oder einem benutzerdefinierten ANTHROPIC_BASE_URL definiert Ihr Anbieter oder Gateway die Modellnamen, daher gibt Claude Code jede Zeichenkette ohne Prüfung durch. Die Prüfung deckt auch nicht das Flag --model, die Umgebungsvariable ANTHROPIC_MODEL oder die Einstellung model ab; ein Tippfehler dort erzeugt There's an issue with the selected model beim ersten Request statt. Claude Code kann immer noch die unrecognized-model-Diagnosezeile zur Request-Zeit auf jedem Anbieter schreiben.

Wenn das angeforderte Modell ein geplantes Pensionierungsdatum hat oder automatisch zu einer neueren Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Start-Notiz. Ab v2.1.182 wird die gleiche Warnung im nicht-interaktiven Modus bei Verwendung des Standard-Textausgabeformats auf stderr geschrieben. Die Prüfung deckt auch ein in Subagent-Frontmatter gesetztes model ab. Die stderr-Warnung wird für --output-format json und stream-json unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem Feld modelUsage der Ergebnisnachricht.

Beispiel: Starten Sie eine Sitzung auf Opus:

claude --model opus

Wechseln Sie dann Modelle innerhalb der Sitzung:

/model sonnet

Beispiel-Einstellungsdatei:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Einen Standard-Modell für neue Sitzungen setzen

Setzen Sie ANTHROPIC_DEFAULT_MODEL=<alias|name>, um das Modell auszuwählen, auf dem Ihre Sitzungen standardmäßig starten. Erfordert Claude Code v2.1.236 oder später.

Claude Code startet eine neue Sitzung auf dem Modell der Variablen nur, wenn keines dieser Modelle auswählt:

• Das Flag --model
• ANTHROPIC_MODEL
• Ein model-Wert in einer beliebigen Einstellungsdatei, einschließlich der Auswahl, die Sie mit /model speichern
• Ein Organisations-Standard-Modell

Eine Auswahl, die Sie mit /model speichern, hat auch bei späteren Starts Vorrang vor der Variablen. Mit stattdessen gesetztem ANTHROPIC_MODEL kehrt Claude Code beim nächsten Start zu dem Modell der Variablen zurück, unabhängig davon, was Sie mit /model gespeichert haben.

Claude Code löst auch die Option „Standard" zu dem Modell der Variablen auf, es sei denn, es gilt ein Organisations-Standard-Modell. Wenn die Option „Standard" zu dem Modell der Variablen aufgelöst wird, zeigt die Zeile „Standard" in der /model-Auswahl das Label „Set by ANTHROPIC_DEFAULT_MODEL".

Claude Code ignoriert die Variable in diesen Fällen, und die Option „Standard" wird aufgelöst, als hätten Sie sie nicht gesetzt:

• Sie setzen sie auf default, inherit, opusplan oder haiku
• enforceAvailableModels ist aktiviert
• availableModels oder Organisations-Modellbeschränkungen schließen das Modell aus
• Das Modell ist nicht für Ihr Konto verfügbar

Wenn eine neue Sitzung auf dem Modell der Variablen starten würde, startet auch eine Sitzung, die Sie mit claude --resume, --continue oder der /resume-Auswahl fortsetzen, auf ihm. Claude Code stellt das in dem Transkript dieser Sitzung gespeicherte Modell nicht wieder her. Andernfalls verwendet Claude Code die Variable nicht, wenn Sie eine Sitzung fortsetzen.

Eine neue Sitzung startet auf einem anderen Modell als Sie ausgewählt haben

Wenn Sie ein Modell mit /model auswählen und Ihre nächste Sitzung auf etwas anderem startet, sind dies die üblichen Ursachen:

• Sie haben es für eine Sitzung ausgewählt. Das Drücken von s in der Auswahl, das Starten mit --model und das Ausführen von /model im nicht-interaktiven Modus gelten alle für die aktuelle Sitzung und lassen Ihren gespeicherten Standard unverändert.
• Etwas mit höherer Priorität setzt das Modell. Ein model-Wert in Projekt- oder verwalteten Einstellungen, ANTHROPIC_MODEL in Ihrer Shell oder ein Organisations-Standard, den Ihr Administrator gesetzt hat, um Benutzerauswahlen zu überschreiben, gilt wieder bei jedem Start. Ihre /model-Auswahl ist immer noch gespeichert; sie wird übertroffen. Wenn Projekt- oder verwaltete Einstellungen das Modell setzen, benennt der Start-Header die Datei.
• Claude Code konnte Ihre Auswahl nicht speichern. /model schreibt model zu ~/.claude/settings.json. Wenn Sie nicht in diese Datei schreiben können, z. B. weil ein anderes Tool sie generiert oder mit einer schreibgeschützten Kopie verlinkt, dauert das Modell, das Sie ausgewählt haben, für die Sitzung an und der nächste Start liest den alten Wert. Setzen Sie model in dem Tool, das die Datei generiert, oder machen Sie die Datei beschreibbar. Siehe A change you made in Claude Code is lost in new sessions.
• Sie haben eine Sitzung fortgesetzt. Eine Sitzung, die Sie mit claude --resume oder --continue fortsetzen, behält normalerweise das Modell, das sie verwendete, anstatt Ihren aktuellen Standard.

Modellauswahl einschränken

Unternehmensadministratoren können availableModels in verwalteten oder Richtlinieneinstellungen verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Einträge entsprechen einer Modellfamilie wie sonnet, einem Versionspräfix wie claude-sonnet-4-5 oder einer vollständigen Modell-ID wie claude-sonnet-4-5-20250929. Ein Versionspräfix entspricht auch späteren Modell-IDs, die es um ein weiteres Segment erweitern, sodass claude-fable-5 sowohl Fable 5 als auch Fable 5.1 zulässt, während claude-fable-5-1 nur Fable 5.1 zulässt.

Auf Plattformen, die Claude Code einbetten und CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete availableModels-Allowlist in Kraft bleibt, es sei denn, der Host stellt seine eigene bereit; Ausnahmen von der Vorrangigkeit verwalteter Einstellungen gibt an, welche Schlüssel und Variablen der Host überschreibt.

Wenn availableModels gesetzt ist, gilt die Allowlist überall dort, wo ein Benutzer ein Modell angeben kann:

• Hauptsitzungsmodell: /model, das Flag --model, die Umgebungsvariable ANTHROPIC_MODEL, die Einstellung model, ANTHROPIC_DEFAULT_MODEL und das Modell, das beim Fortsetzen einer Sitzung wiederhergestellt wird
• Alias-Auflösung: die Umgebungsvariablen ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL und ANTHROPIC_DEFAULT_FABLE_MODEL können einen zulässigen Alias nicht zu einem Modell außerhalb der Liste umleiten
• Schnellmodus: /fast weigert sich umzuschalten, wenn dies implizit zu einem Opus-Modell außerhalb der Liste führen würde, mit der Meldung „is not in your organization's allowed models"
• Subagent- und Teamkollegen-Modelle: das Feld model in Subagent-Frontmatter, der Parameter model des Agent-Tools, Agent-Team-Teamkollegen-Modelle, CLAUDE_CODE_SUBAGENT_MODEL und in v2.1.197 und früher das Modellauswahlfeld im Assistenten /agents
• Skill- und Befehlsmodelle: das Frontmatter model in Skills und Befehlen
• Advisor-Modell: die konfigurierte Einstellung advisorModel und das Flag --advisor
• Hintergrund-Agent-Modell: das Modell, das in der Dispatch-Auswahl ausgewählt ist

Auf der Anthropic API und Claude Platform on AWS wird ein Modellfamilien-Alias, opus, sonnet, haiku oder fable, zu seinem üblichen Modell aufgelöst, wenn die Allowlist dieses Modell zulässt. Wenn die Allowlist dieses Modell blockiert, ersetzt Claude Code es durch die neueste Version der Familie, die die Allowlist zulässt, und zeigt einen Hinweis an, der sowohl das angeforderte als auch das ersetzte Modell benennt. Mit ["sonnet", "claude-opus-4-6"] wählen beispielsweise sowohl /model opus als auch --model opus Claude Opus 4.6, das neueste zulässige Opus. Vor v2.1.205 wurde ein Alias, dessen neueste veröffentlichte Version außerhalb der Liste lag, wie jede andere blockierte Auswahl abgelehnt oder ersetzt, auch wenn die Liste eine ältere Version zulässt.

Die Ersetzung benötigt eine zulässige Version zum Landen: Wenn die Allowlist keine Version der Aliasfamilie zulässt, folgt der Alias dem Ablehnungs- und Ersetzungsverhalten unten wie jeder andere blockierte Wert.

Claude Code behandelt jede andere blockierte Auswahl je nachdem, wo das Modell gesetzt wurde:

• /model: Claude Code lehnt den Wechsel mit einem Fehler ab

• Flag --model, ANTHROPIC_MODEL oder die Einstellung model: Claude Code ersetzt den Wert beim Start durch eine Warnung, die sowohl das angeforderte als auch das ersetzte Modell benennt, und die Sitzung startet auf dem Standardmodell

• ANTHROPIC_DEFAULT_MODEL: Claude Code ignoriert die Variable

• Subagent- oder Teamkollegen-Überschreibung: Claude Code führt den Subagent oder Teamkollegen auf einem Fallback-Modell aus, anstatt die Anfrage fehlschlagen zu lassen. Siehe Modell auswählen für den Subagent-Fallback und Teamkollegen und Modelle angeben für den Teamkollegen-Fallback.

  In interaktiven Sitzungen warnt Sie Claude Code, wenn es ein Subagent-Modell durch diesen Fallback oder durch die oben beschriebene Ersetzung der neuesten zulässigen Version ersetzt, und benennt die angeforderten und ersetzten Modelle; es meldet keinen Teamkollegen-Fallback.

  Wo die oben beschriebene Ersetzung der neuesten zulässigen Version gilt, folgt ein blockierter Familien-Alias stattdessen. Vor v2.1.222 fiel ein Alias auf jedem Provider wie jeder andere blockierte Wert zurück

• Skill- oder Befehlsüberschreibung: Claude Code ignoriert die Überschreibung, einschließlich eines blockierten Familien-Alias, und der Skill oder Befehl wird auf dem Sitzungsmodell ausgeführt. Ein Skill oder Befehl, der in einem Subagent ausgeführt wird, folgt stattdessen dem Subagent-Verhalten oben

• Einstellung advisorModel: der Advisor ist für die Sitzung deaktiviert

• Flag --advisor: Claude Code beendet sich beim Start mit einem Fehler. In einer Hintergrund-Sitzung startet es die Sitzung ohne den Advisor, anstatt sich zu beenden

Claude Code verbirgt ausgeschlossene Modelle vor der Auswahl /model. Eine vollständige Modell-ID in der Liste, die keine integrierte Auswahlzeile hat, wie eine ältere Version, die die Liste festlegt, erscheint in der Auswahl /model als eigene beschriftete Zeile, es sei denn, Claude Code ersetzt die integrierten Optionen durch eine modelPicker-Aufstellung. Vor v2.1.199 war eine solche ID nur durch Eingabe von /model <id> auswählbar.

Modelländerungen, die Claude Code in Ihrem Namen vornimmt, werden auf die gleiche Weise überprüft:

• Fallback-Modellketten: Einträge außerhalb der Allowlist werden gelöscht
• Plan-Modus-Upgrades: Auf der Anthropic API und Claude Platform on AWS verwendet ein Upgrade wie opusplan zu einem ausgeschlossenen Modell die neueste zulässige Version der Upgrade-Familie. Bei Providern mit Provider-spezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung wird auf dem Sitzungsmodell fortgesetzt
• Automatischer Modell-Fallback: Ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, sodass die gekennzeichnete Anfrage mit einer Ablehnung endet
• Auto-Modus-Klassifizierer: der Standard Claude Sonnet 5 des Klassifizierers gilt nur, wenn die Allowlist Sonnet 5 zulässt. Wenn es ausgeschlossen ist, wird der Klassifizierer auf dem Sitzungsmodell ausgeführt, das die Allowlist bereits regelt, oder auf einem Opus-Modell, wenn die Sitzung auf einem Fable-Modell läuft. Bei Providern außer der Anthropic API wird dieser Opus-Fallback auf dem Standard-Opus-Modell des Providers ausgeführt, ohne die Allowlist zu konsultieren. Erfordert Claude Code v2.1.210 oder später
• Schnellmodus: Das Aktivieren des Schnellmodus wird abgelehnt, wenn das Modell, auf dem die Sitzung danach läuft, außerhalb der Allowlist liegt

{
  "availableModels": ["sonnet", "haiku"]
}

Oberflächenabdeckung

Jede Oberfläche erzwingt die Allowlist, die sie erhält. Welcher Liefermechanismus jede Oberfläche erreicht, unterscheidet sich:

• Cloud-Sitzungen auf Claude Code im Web oder in der Desktop-App laufen standardmäßig auf von Anthropic verwalteten VMs: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Allowlist über server-verwaltete Einstellungen bereit. Sitzungen, die Ihre Organisation zu einer selbst gehosteten Umgebung leitet, laufen auf Ihrem eigenen Compute und lesen auch die verwaltete Einstellungsdatei im Runner-Image. Wie Claude Code verwaltete Quellen kombiniert gibt an, wann diese Datei gilt. Ein Modellwechsel in der Mitte einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Allowlist ausgeschlossen ist. Server-seitige Ablehnung bei der Sitzungserstellung gilt für Organisationsmodellbeschränkungen, nicht für den Einstellungsschlüssel availableModels.
• Cowork, die agentengesteuerte Arbeit-Registerkarte in der Claude Desktop-App, führt ihre Sitzungen auf Claude Code aus, erhält aber absichtlich keine server-verwalteten Einstellungen aus der Admin-Konsole von claude.ai. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung läuft; Remote-Cowork-Sitzungen laufen auf von Anthropic verwalteten VMs, wo eine auf dem Gerät bereitgestellte Datei nicht vorhanden ist.
• Sitzungen auf Drittanbieter-Providern wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS erhalten keine server-verwalteten Einstellungen, daher stellen Sie die Allowlist dort über MDM oder verwaltete Einstellungsdateien bereit.
• Server-verwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem zulässigen Login oder Schlüssel authentifiziert. Flotten, die Schlüssel nur über ein apiKeyHelper-Skript generieren, sollten die Allowlist über MDM oder verwaltete Einstellungsdateien bereitstellen.
• Die Desktop-Code-Registerkarte hostet auch SSH-Sitzungen, die die verwaltete Einstellungsdatei vom Remote-Host lesen, auf dem sie laufen. Siehe Desktop-verwaltete Einstellungen.
• Die Modellauswahlfelder auf claude.ai und in der Desktop-App verbergen oder grau aus Modelle, die durch die Allowlist Ihrer Organisation ausgeschlossen sind. Der Auswahlzustand ist eine Bequemlichkeit für Benutzer; die Erzwingung erfolgt in der Sitzung.

Standardmodell-Verhalten

Für sich allein lässt availableModels die Option Standard auf dem Laufzeit-Standard des Systems für das Konto, bis Sie auch enforceAvailableModels setzen. Wenn dieser Standard ein Modell ist, das Sie einschränken möchten, setzen Sie auch enforceAvailableModels.

Ein leeres availableModels-Array aktiviert niemals die Erzwingung des Standardmodells: Mit availableModels: [] werden benannte Modellauswahlen blockiert, aber das Standardmodell für den Kontotyp bleibt unabhängig von enforceAvailableModels nutzbar.

Allowlist für das Standardmodell erzwingen

Setzen Sie enforceAvailableModels: true zusammen mit einem nicht leeren availableModels in verwalteten Einstellungen, um die Allowlist auf die Option Standard zu erweitern. Dies erfordert Claude Code v2.1.175 oder später.

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

Die Option Standard wird zu dem Kontotyp-Standard aufgelöst, oder zu dem Organisationsstandardmodell, wenn ein Administrator eines gesetzt hat. Wenn dieses Modell nicht in der Allowlist ist, wird die Option Standard stattdessen zu dem ersten availableModels-Eintrag aufgelöst, der ein zulässiges, verfügbares Modell benennt, und die Zeile Standard der Auswahl /model zeigt dieses Modell. Dies gilt überall dort, wo der Standard erreicht wird: Sitzungsstart, Auswahl von Standard in /model, das Schlüsselwort "default" in Fallback-Modellketten und der Fallback, der verwendet wird, wenn eine ausgeschlossene Auswahl gelöscht wird.

enforceAvailableModels ordnet die Option Standard nur neu zu, wenn availableModels nicht leer ist. Mit availableModels: [] bleibt das Standardmodell für den Kontotyp nutzbar, sodass die Einstellung Benutzer nicht von jedem Modell ausschließen kann. Wenn availableModels nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung übersprungen und Standard wird zu dem Kontotyp-Standard aufgelöst, mit einer Warnung, die nur unter --debug sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.

Stellen Sie beide Schlüssel zusammen in der höchstrangigen verwalteten Quelle bereit, die Sie bereitstellen. Standardmäßig liest Claude Code nur diese Quelle, daher wird ein Paar, das in einer verwalteten Einstellungsdatei platziert ist, ignoriert, wenn die Admin-Konsole Einstellungen bereitstellt; unter dem Opt-in-Merge in wie Claude Code verwaltete Quellen kombiniert ignoriert Claude Code immer noch eine modelOverrides-Map aus einer Quelle, die unter der Quelle rangiert, die availableModels setzt.

Kontrollieren Sie das Modell, auf dem Benutzer laufen

Die Einstellung model ist eine anfängliche Auswahl, keine Erzwingung. Sie legt fest, welches Modell aktiv ist, wenn eine Sitzung startet, aber Benutzer können immer noch /model öffnen und Standard auswählen, das zu dem Laufzeit-Standard des Systems aufgelöst wird, unabhängig davon, was model gesetzt ist, es sei denn, enforceAvailableModels leitet es um.

Um die Modellerfahrung vollständig zu kontrollieren, kombinieren Sie diese Einstellungen:

• availableModels: schränkt ein, welche benannten Modelle Benutzer wechseln können
• enforceAvailableModels: erweitert die availableModels-Allowlist auf die Option Standard, sodass Standard nicht zu einem Modell außerhalb der Liste aufgelöst werden kann
• model: legt die anfängliche Modellauswahl fest, wenn eine Sitzung startet
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: kontrollieren, zu welchen Modellen die Aliase sonnet, opus, haiku und fable aufgelöst werden, und welche Version der Kontotyp-Standard verwendet

Dieses Beispiel startet Benutzer auf Sonnet 4.5, begrenzt die Auswahl auf Sonnet und Haiku und stellt sicher, dass Standard zu einem Modell in der Allowlist aufgelöst wird, anstatt zum Tier-Standard:

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Ohne enforceAvailableModels oder den env-Block erhält ein Benutzer, der Standard in der Auswahl auswählt, den Laufzeit-Standard anstelle der in model festgelegten Version. Die beiden Einstellungen decken unterschiedliche Bereiche ab: enforceAvailableModels macht Standard der Allowlist gehorchen, während der env-Block festlegt, zu welcher Version ein zulässiger Alias wie sonnet aufgelöst wird. Verwenden Sie enforceAvailableModels allein, wenn das Einschränken von Modellfamilien ausreicht; fügen Sie den env-Block hinzu, wenn Sie auch eine bestimmte Version festlegen müssen.

Merge-Verhalten

Wenn die verwalteten Einstellungen, die Claude Code anwendet, availableModels definieren, gilt diese Liste allein, abgesehen von einer Host-Plattform, die ihre eigene bereitstellt: Einträge in Benutzer-, Projekt- oder lokalen Einstellungen können sie nicht erweitern, und Claude Code führt availableModels auch nie über verwaltete Quellen hinweg zusammen; wie Claude Code verwaltete Quellen kombiniert gibt an, welche Quellenliste gilt. Andernfalls werden Listen aus Benutzer-, Projekt- und lokalen Einstellungen wie andere Array-Einstellungen verkettet und dedupliziert. Vor Claude Code v2.1.175 wurden Einträge aus Bereichen mit niedrigerer Priorität in die verwaltete Liste zusammengeführt, anstatt sie zu ersetzen.

Innerhalb der effektiven Liste deaktiviert ein Eintrag, der ein bestimmtes Modell in einer Familie benennt, ob ein Versionspräfix oder eine vollständige Modell-ID, den Wildcard-Eintrag dieser Familie: ["sonnet", "claude-sonnet-4-5"] erlaubt nur Sonnet 4.5-Versionen, nicht jedes Sonnet-Modell.

Mantle-Modell-IDs

Wenn der Amazon Bedrock Mantle-Endpunkt aktiviert ist, werden Einträge in availableModels, die mit anthropic. beginnen, als benutzerdefinierte Optionen zur Auswahl /model hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme von der Alias-Zuordnung, die in Modelle für Drittanbieter-Bereitstellungen festlegen beschrieben ist. Die Einstellung schränkt die Auswahl immer noch auf aufgelistete Einträge ein, und eine Mantle-ID bettet einen Familiennamen ein, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Neben allen Mantle-IDs listen Sie die Versionspräfixe oder vollständigen IDs auf, die Sie auswählbar behalten möchten. Siehe Merge-Verhalten.

Organisationsmodellbeschränkungen

Organisationsadministratoren in Claude Enterprise-Plänen schränken ein, welche Modelle Mitglieder ausführen können, indem sie einzelne Modelle in der Admin-Konsole von claude.ai deaktivieren. Diese Beschränkung wird mit den Berechtigungen des Kontos bereitgestellt, wenn Claude Code sich authentifiziert, getrennt von jeder availableModels-Liste in Einstellungen, und der Server erzwingt die gleiche Beschränkung unabhängig, wenn eine Sitzung erstellt wird. Erfordert Claude Code v2.1.187 oder später.

Die Beschränkung gilt, wenn sich ein Mitglied anmeldet oder seinen eigenen API-Schlüssel verwendet. Organisationsbezogene Anmeldedaten, wie Organisationsdienst-Schlüssel, sind nicht an einen Benutzer gebunden, daher gilt die Beschränkung nicht für sie.

Die Claude Console hat keine Modellbeschränkungskontrolle. Organisationen ohne Claude Enterprise-Plan, einschließlich derjenigen, deren Mitglieder sich über die Anthropic API authentifizieren, schränken Modelle stattdessen mit availableModels in verwalteten Einstellungen ein und fügen enforceAvailableModels hinzu, um die Option Standard abzudecken. Diese Einstellungen werden von Claude Code selbst erzwungen, nicht vom Server.

Ein eingeschränktes Modell ist in der Auswahl /model verborgen. Wenn Sie es mit --model, der Umgebungsvariable ANTHROPIC_MODEL oder der Einstellung model nach Name auswählen, wird die Meldung Model "<name>" is restricted by your organization's settings. Using <model> instead. angezeigt und die Sitzung startet auf einem zulässigen Modell. Wenn Sie /model <name> für ein eingeschränktes Modell eingeben, wird es mit Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. abgelehnt und die Sitzung behält ihr aktuelles Modell.

Ein Modellfamilien-Alias wie opus wird zu seinem üblichen Modell aufgelöst, wenn die Organisation es zulässt. Wenn die Organisation dieses Modell einschränkt, ersetzt Claude Code es durch die neueste Version der Familie, die die Organisation zulässt, mit dem gleichen Ersetzungshinweis. /model <alias> wird nur abgelehnt, wenn jede Version seiner Familie eingeschränkt ist; ein Alias, der mit --model, ANTHROPIC_MODEL oder der Einstellung model gesetzt ist, wird in diesem Fall immer noch beim Start ersetzt. Vor v2.1.205 wurde ein Familien-Alias basierend auf seiner neuesten veröffentlichten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version zulässig war.

Beschränkungen gelten organisationsweit oder pro Rolle:

• Das Deaktivieren eines Modells auf Organisationsebene entfernt es für jedes Mitglied.
• Rollenbezogener Zugriff gewährt verschiedenen benutzerdefinierten Rollen unterschiedliche Modelle, und ein Mitglied, das mehrere Rollen innehat, kann jedes Modell verwenden, das eine seiner Rollen gewährt.
• Haiku-Modelle sind immer verfügbar und können nicht deaktiviert werden, daher behält jedes Mitglied mindestens ein nutzbares Modell.
• Eine Zugangsänderung tritt bei neuen Anfragen innerhalb von etwa einer Minute in Kraft; die Auswahl /model spiegelt dies wider, wenn eine Sitzung das nächste Mal startet.

Beide Beschränkungen gelten zusammen: Ein Modell ist nur auswählbar, wenn es durch availableModels zulässig ist und nicht durch die Organisation eingeschränkt ist. Organisationsbeschränkungen erreichen Sitzungen nur auf der Anthropic API und LLM-Gateway-Bereitstellungen; bei jedem anderen Provider verwenden Sie stattdessen availableModels.

Organisationsstandardmodell

Organisationsadministratoren in Claude Enterprise-Plänen können ein Standardmodell für Claude Code-Mitglieder über die claude.ai-Administrationskonsole festlegen – für die gesamte Organisation oder pro benutzerdefinierte Rolle. Wenn ein Standardmodell festgelegt ist, wird die Option „Standard" zu diesem Modell aufgelöst. Erfordert Claude Code v2.1.196 oder später.

Die Zeile „Standard" in der /model-Auswahl zeigt den Namen des Organisationsstandardmodells mit der Bezeichnung „Org-Standard". Die Bezeichnung lautet „Org-Standard", unabhängig davon, ob der Administrator den Standard für die gesamte Organisation oder für Ihre Rolle festgelegt hat. Ein Rollenstandard gilt für Mitglieder dieser benutzerdefinierten Rolle und hat Vorrang vor dem organisationsweiten Standard. Wenn mehrere Ihrer Rollen unterschiedliche Standards festlegen, wird das leistungsfähigste Modell angewendet.

Das Organisationsstandardmodell ist ein Ausgangspunkt, keine Einschränkung. Diese Auswahlmöglichkeiten haben Vorrang vor ihm:

• das Flag --model und die Umgebungsvariable ANTHROPIC_MODEL
• ein model-Wert in verwalteten Einstellungen oder bereitgestellt über --settings
• ein model-Wert in Ihren Benutzer-, Projekt- oder lokalen Einstellungen, einschließlich eines Modells, das Sie mit /model speichern

Administratoren können auch das Organisationsstandardmodell so konfigurieren, dass es die Benutzerauswahl überschreibt. Wenn die Überschreibung aktiviert ist, hat sie Vorrang vor dem model-Wert in Benutzer-, Projekt- und lokalen Einstellungen. Ein Modell, das Sie mit /model speichern, gilt also für die aktuelle Sitzung, und das Organisationsstandardmodell wird beim nächsten Start wieder angewendet. Wenn sich Ihre Auswahl unterscheidet, zeigt /model Your organization's default (<model>) applies on restart an. Das Flag --model, ANTHROPIC_MODEL, verwaltete Einstellungen und --settings haben auch bei aktivierter Überschreibung weiterhin Vorrang. Die Überschreibung ist für einen begrenzten Satz von Organisationen verfügbar. Fragen Sie Ihr Anthropic-Kontoteam nach der Verfügbarkeit.

Um einzuschränken, welche Modelle Mitglieder auswählen können, verwenden Sie stattdessen Organisationsmodellbeschränkungen oder availableModels.

Claude Code liest das Organisationsstandardmodell einmal beim Start ein. Ein Standard, den der Administrator während einer Sitzung ändert, wird also beim nächsten Start wirksam.

Wenn das Organisationsstandardmodell die Benutzerauswahl nicht überschreibt, löscht der erste interaktive Start nach der Änderung durch den Administrator den model-Schlüssel aus Ihren Benutzereinstellungen einmalig, damit der neue Standard angewendet wird. Es ändert nichts anderes in der Datei, und ein Modell, das Sie nach diesem Start mit /model speichern, wird beibehalten.

Das Organisationsstandardmodell durchläuft diese Beschränkungsprüfungen, bevor es übernommen wird:

• availableModels allein gilt nicht für das Organisationsstandardmodell, daher wird ein Organisationsstandardmodell außerhalb der Zulassungsliste trotzdem angewendet. Wenn auch enforceAvailableModels festgelegt ist, wird ein Organisationsstandardmodell außerhalb der Zulassungsliste wie jedes andere Standardmodell zum ersten Eintrag der Zulassungsliste neu zugeordnet
• ein Organisationsstandardmodell, das Organisationsmodellbeschränkungen für Ihr Konto verweigern, wird durch das neueste zulässige Modell in seiner Familie ersetzt, oder durch eine kostengünstigere Familie, wenn jede Version davon eingeschränkt ist
• ein Organisationsstandardmodell, das für Ihr Konto überhaupt nicht verfügbar ist, wird übersprungen, und die Option „Standard" wird aufgelöst, wie es ohne ein Organisationsstandardmodell der Fall wäre

Ab v2.1.199 behält die /model-Auswahl eine separate Zeile für die übliche Familie bei, wenn das Organisationsstandardmodell eine andere Modellfamilie ist als die übliche Standard des Kontotyps, sodass Sie für eine Sitzung trotzdem zu ihr wechseln können. In v2.1.196 bis v2.1.198 fehlt diese Zeile in der Auswahl.

Das Organisationsstandardmodell gilt nur für Sitzungen, die mit der Anthropic API authentifiziert sind. Um einen Standard an anderer Stelle festzulegen, einschließlich LLM-Gateway-Bereitstellungen, verwenden Sie stattdessen den model-Schlüssel in verwalteten Einstellungen.

Organisatorische Anstrengungsgrenzen

Ihre Organisation kann die Anstrengungsstufe auf zwei Wege begrenzen. Bei einem Claude Enterprise-Plan legen Organisationsadministratoren Anstrengungsgrenzen pro Rolle fest, wie unten beschrieben. Bei jedem Plan und jedem Anbieter, einschließlich Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, begrenzt die verwaltete Einstellung maxEffortLevel die Anstrengung stattdessen auf dem Client. Wenn beide auf ein Modell zutreffen, gilt die niedrigere Obergrenze.

Organisationsadministratoren in Claude Enterprise-Plänen können eine maximale Anstrengungsstufe pro Modell für jede benutzerdefinierte Rolle festlegen, zusammen mit Rollenbeschränkungen auf Organisationsmodellebene. Stufen über der Obergrenze werden nicht in der /effort-Auswahl angeboten, und das Benennen einer höheren Stufe mit --effort oder /effort wird stattdessen mit der Obergrenze ausgeführt. In interaktiven Sitzungen und einfachen Text---print-Läufen warnt eine Meldung vor den angeforderten und angewendeten Stufen; bei json- oder stream-json-Ausgabe oder in Hintergrund-Agenten wird die Begrenzung stillschweigend angewendet. Obergrenzen gelten pro Modell, daher kann der Wechsel von Modellen ändern, welche Stufen verfügbar sind. Wenn mehrere Ihrer Rollen dasselbe Modell gewähren, gilt die am wenigsten restriktive Obergrenze. Erfordert Claude Code v2.1.195 oder später.

Anstrengungsgrenzen werden zusammen mit Organisationsmodellbeschränkungen bereitgestellt und erreichen dieselben Sitzungen.

Spezielles Modellverhalten

`default` Modelleinstellung

Das Verhalten von default hängt von Ihrem Kontotyp ab:

• Max, Team Premium, Enterprise und Anthropic API: Standard ist Opus 5
• Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform: Standard ist Opus 5
• Pro und Team Standard: Standard ist Sonnet 5
• Microsoft Foundry: Standard ist Sonnet 4.5

Vor v2.1.219 wurde default auf der Anthropic API zu Opus 4.8 aufgelöst, auf Max, Team Premium und Enterprise Pay-as-you-go ab v2.1.154 und auf Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.207. Vor v2.1.207 wurde default auf Claude Platform auf AWS zu Opus 4.7 aufgelöst und auf Amazon Bedrock und Google Cloud's Agent Platform zu Sonnet 4.5.

Wenn ein Administrator ein Organisationsstandardmodell festgelegt hat, wird default stattdessen zu diesem Modell aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Erfordert Claude Code v2.1.196 oder später. default kann auch zu dem Modell aufgelöst werden, das Sie mit ANTHROPIC_DEFAULT_MODEL festlegen, unter den in dessen Abschnitt aufgelisteten Bedingungen.

Wenn verwaltete Einstellungen die Zulassungsliste für das Standardmodell erzwingen und der Kontotyp-Standard nicht in availableModels enthalten ist, wird default zum erzwungenen Standard aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Wenn beide zutreffen, ersetzt der Organisationsstandard zuerst den Kontotyp-Standard und die Erzwingung wird dann darauf angewendet: Ein auf der Zulassungsliste befindlicher Organisationsstandard wird beibehalten, während einer außerhalb der Liste zum erzwungenen Standard aufgelöst wird.

Fable-Modelle sind auf keinem Plan oder Provider der Kontotyp-Standard. Wenn Sie eines mit /model auswählen, wird es als das ausgewählte Modell in Ihren Benutzereinstellungen gespeichert, sodass spätere Sitzungen damit beginnen. Für die einmalige Änderung, die Claude Code an einer gespeicherten Fable 5-Auswahl in v2.1.257 vornimmt, siehe Mit Fable arbeiten.

`opusplan` Modelleinstellung

Der opusplan Modellalias bietet einen automatisierten Hybrid-Ansatz:

• Im Plan-Modus: verwendet opus für komplexe Überlegungen und Architekturentscheidungen
• Im Ausführungsmodus: wechselt automatisch zu sonnet für Code-Generierung und Implementierung

Dies verbindet Opus's Überlegungen für die Planung mit Sonnets Effizienz für die Ausführung.

Die Plan-Modus-Opus-Phase verwendet das gleiche Kontextfenster wie die opus Modelleinstellung. Bei Abonnement-Stufen, bei denen Opus automatisch auf 1M-Kontext aktualisiert wird, erhält opusplan die Aktualisierung auch im Plan-Modus. Um 1M-Kontext für beide Phasen zu erzwingen, wenn Sie sich nicht auf einer Auto-Upgrade-Stufe befinden, setzen Sie das Modell auf opusplan[1m], zum Beispiel mit /model opusplan[1m]. Das Setzen mit /model erfordert Claude Code v2.1.265 oder später; verwenden Sie auf früheren Versionen stattdessen das --model Flag oder die model Einstellung.

Wenn availableModels das neueste Opus ausschließt, aber eine ältere Version zulässt, zum Beispiel ["sonnet", "claude-opus-4-6"], verwendet opusplan das neueste zulässige Opus für die Planung und bleibt nur bei Sonnet, wenn jedes Opus ausgeschlossen ist. Eine Haiku-Sitzung, die normalerweise im Plan-Modus zu Sonnet aktualisiert würde, verwendet ebenfalls das neueste zulässige Sonnet und bleibt nur bei Haiku, wenn jedes Sonnet ausgeschlossen ist. Vor v2.1.205 blieb der Plan-Modus beim Modell der Sitzung, wenn die neueste Version der Upgrade-Familie ausgeschlossen war, auch wenn die Zulassungsliste eine ältere Version zuließ.

Die Substitution einer älteren zulässigen Version gilt auf der Anthropic API und Claude Platform auf AWS. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Mantle, deren Bereitstellungen Provider-spezifische Modell-IDs verwenden, bleibt der Plan-Modus beim Modell der Sitzung, wenn das Upgrade-Modell ausgeschlossen ist.

Für einen Hybrid-Ansatz, bei dem Claude während einer Aufgabe entscheidet, wann ein zweites Modell konsultiert werden soll, anstatt an der Plan-Grenze zu wechseln, siehe das Advisor-Tool.

Fallback-Modellketten

Wenn das primäre Modell überlastet ist, nicht verfügbar ist oder einen anderen nicht wiederholbaren Serverfehler zurückgibt, kann Claude Code zu einem Fallback-Modell wechseln, anstatt die Anfrage fehlschlagen zu lassen. Authentifizierungs-, Abrechnungs-, Rate-Limit-, Anfragegröße- und Transportfehler sowie eine Ablehnung durch die Richtlinienprüfung Ihrer Organisation lösen niemals einen Wechsel aus; diese folgen ihrer normalen Wiederholung und Fehlerbehandlung.

Konfigurieren Sie ein oder mehrere Fallback-Modelle und Claude Code versucht sie der Reihe nach, wobei eine Benachrichtigung angezeigt wird, wenn es wechselt. Der Wechsel dauert nur für den aktuellen Zug, sodass Ihre nächste Nachricht zuerst wieder das primäre Modell versucht. Claude Code begrenzt Ketten auf drei Modelle nach Duplikatentfernung und ignoriert zusätzliche Einträge.

Legen Sie eine Kette für eine Sitzung mit dem --fallback-model Flag fest, das eine kommagetrennte Liste akzeptiert:

claude --fallback-model sonnet,haiku

Um eine Kette über Sitzungen hinweg beizubehalten, setzen Sie fallbackModel in Einstellungen als Array:

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Das --fallback-model Flag hat Vorrang vor der fallbackModel Einstellung. Jeder Eintrag akzeptiert einen Modellnamen oder Alias, und "default" wird zum Standardmodell erweitert.

Claude Code bestätigt die Kette beim Start nicht und /status zeigt sie nicht an. Die Benachrichtigung, die angezeigt wird, wenn ein Wechsel stattfindet, ist das erste sichtbare Zeichen, dass ein Fallback konfiguriert ist.

Wenn eine Anfrage fehlschlägt, versucht Claude Code jeden Eintrag der Reihe nach, bis einer ihn akzeptiert. Ein Eintrag, der auch nicht erreichbar ist, wie ein in Einstellungen angeheftetes pensioniertes Modell, schlägt auf die gleiche Weise zum nächsten fehl. Claude Code entfernt zwei Arten von Einträgen, bevor dieser Durchgang beginnt:

• Außerhalb der Zulassungsliste: Claude Code löscht jeden Eintrag, der nicht von availableModels zulässig ist, wenn es die Kette liest.
• Kleineres Kontextfenster während der Komprimierung: die Kette deckt auch Komprimierung ab, aber Claude Code wird nicht zu einem Modell mit einem kleineren Kontextfenster als das des primären zurückfallen, da die Zusammenfassung dort zuerst einen Teil des Gesprächs abschneiden würde. Wenn jedes Fallback kleiner ist, zeigt die Komprimierung den ursprünglichen Fehler an und Sie können erneut versuchen.

Claude Code wendet die Kette auch auf Subagenten an. Wenn die Anfrage eines Subagenten fehlschlägt, versucht Claude Code Ihre konfigurierten Fallback-Modelle der Reihe nach, und der Subagent wird auf dem Modell fortgesetzt, das die Anfrage akzeptiert. Das Modell Ihrer Sitzung bleibt unverändert. Vor v2.1.247 endete ein Fehler, den die Kette abdeckte, den Subagenten.

Automatisches Modell-Fallback

Dieser Abschnitt behandelt inhaltsbasiertes Fallback von Fable-Modellen und Opus 5. Für verfügbarkeitsbasiertes Fallback, wenn ein Modell überlastet oder nicht verfügbar ist, siehe Fallback-Modellketten.

Fable-Modelle und Opus 5 werden mit Sicherheitsklassifizierer ausgeführt, die am häufigsten Cybersicherheits- und Biologie-Inhalte kennzeichnen. Wenn ein Klassifizierer eine Anfrage kennzeichnet und die gekennzeichnete Kategorie ein Fallback-Modell hat, führt Claude Code die Anfrage auf diesem Modell erneut aus und zeigt eine Benachrichtigung im Transkript an. Für diese beiden Kategorien hängt das Fallback-Modell davon ab, welches Modell abgelehnt hat:

• Fable 5.1 und Fable 5: Biologie-gekennzeichnete Anfragen werden auf Opus 5 erneut ausgeführt, und Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt.
• Opus 5: Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Opus 5 seine eigenen Biologie-Klassifizierer mit keinem Fallback-Modell ausführt.

Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry löst Claude Code diese Ziele stattdessen durch Ihre Bereitstellung auf, und wenn Sie ANTHROPIC_DEFAULT_OPUS_MODEL setzen, werden Kategorien, die ein Fallback haben, auf dem angehefteten Modell erneut ausgeführt; siehe Fallback auf Bedrock, Agent Platform und Foundry aktivieren.

Nach einem Fallback wird die Sitzung auf dem Fallback-Modell fortgesetzt. Um zu Ihrem ursprünglichen Modell zurückzukehren, führen Sie /model aus.

Kategoriebasiertes Fallback erfordert Claude Code v2.1.219 oder später. Vor v2.1.219 wurde jede gekennzeichnete Fable 5-Anfrage auf dem Standard-Opus-Modell Ihres Providers erneut ausgeführt, und Opus 5 war keine Fallback-Quelle.

Das Fallback-Modell wird gegen availableModels überprüft. Wenn es blockiert ist, findet kein Fallback statt. Die Ablehnung wird als normaler Fehler angezeigt und das Modell der Sitzung bleibt unverändert.

Überprüfen Sie, was das Fallback ausgelöst hat

Das Fallback kann bei der ersten Anfrage einer Sitzung ausgelöst werden, bevor Sie etwas Ungewöhnliches senden, da die erste Anfrage Arbeitsbereich-Kontext wie Ihren CLAUDE.md-Inhalt und Git-Status trägt. Ein Repository, das Sicherheits- oder Biologie-Material enthält, kann den Klassifizierer allein auf diesem Kontext auslösen.

Um zu überprüfen, ob Anpassungen der Auslöser sind, starten Sie eine Sitzung mit claude --safe-mode, das Anpassungen wie CLAUDE.md, Skills, MCP-Server und Hooks deaktiviert. Git-Status und Verzeichnisnamen sind keine Anpassungen und sind immer noch enthalten.

Vor dem Wechsel fragen

Um zu entscheiden, was jedes Mal passiert, wenn eine Anfrage gekennzeichnet wird, anstatt automatisch zu wechseln, führen Sie /config aus und schalten Sie Modelle wechseln, wenn eine Nachricht gekennzeichnet wird aus, oder setzen Sie switchModelsOnFlag auf false in Ihrer Einstellungsdatei. Eine gekennzeichnete Anfrage pausiert dann die Sitzung mit zwei Optionen: zum Fallback-Modell wechseln oder die Eingabeaufforderung bearbeiten und auf dem aktuellen Modell erneut versuchen.

Einige Fälle verhalten sich anders:

• Wenn die gekennzeichnete Kategorie kein Fallback-Modell hat, wie eine Biologie-Kennzeichnung auf Opus 5, zeigt Claude Code die Eingabeaufforderung nicht an und die Anfrage endet mit der Ablehnung.
• Wenn beide Modelle die gleiche Anfrage kennzeichnen, können Sie die Eingabeaufforderung bearbeiten und erneut versuchen oder eine neue Sitzung starten.
• Auf mobilen Claude Code im Web Sitzungen wird das Bearbeiten und erneute Versuchen nicht unterstützt. Wechseln Sie Modelle oder setzen Sie die Sitzung in einem Desktop-Browser oder der Desktop-App fort.
• Im nicht-interaktiven Modus und SDK-Integrationen, die die Eingabeaufforderung nicht anzeigen können, endet eine gekennzeichnete Anfrage den Zug mit einer Ablehnung.
• Wenn das Fallback-Ziel von availableModels blockiert wird, zeigt Claude Code die Eingabeaufforderung nicht an. Die gekennzeichnete Anfrage endet mit der Ablehnung, genauso wie automatisches Fallback, wenn das Ziel blockiert ist.

Fallback auf Bedrock, Agent Platform und Foundry aktivieren

Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry sind Modell-IDs Provider-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:

• Claude Code muss das aktuelle Modell als Fallback-Quelle erkennen. Fable 5.1 und Fable 5 werden erkannt, wenn die Modell-ID claude-fable-5 enthält, dem Wert von ANTHROPIC_DEFAULT_FABLE_MODEL entspricht oder mit modelOverrides zugeordnet ist. Opus 5 wird durch seine Provider-Modell-ID oder eine modelOverrides Zuordnung erkannt.
• Das Fallback-Modell muss in Ihrer Bereitstellung aufgelöst werden. Wenn Sie ANTHROPIC_DEFAULT_OPUS_MODEL setzen, werden gekennzeichnete Anfragen für jede Kategorie, die ein Fallback hat, auf diesem Modell erneut ausgeführt; eine Biologie-Kennzeichnung auf Opus 5 endet immer noch mit einer Ablehnung. Wenn Sie es nicht setzen, werden Cybersicherheits-gekennzeichnete Anfragen auf einem Opus 4.8-Eintrag in der Modelliste des Providers erneut ausgeführt, und Biologie-gekennzeichnete Anfragen von einem Fable-Modell auf einem Opus 5-Eintrag.

Wenn eines der Modelle nicht identifiziert werden kann, wechselt Claude Code nicht automatisch. Die gekennzeichnete Anfrage endet mit einer Ablehnungsmeldung, und Sie können Modelle mit /model wechseln und erneut versuchen. Das Setzen von ANTHROPIC_DEFAULT_FABLE_MODEL auf Ihre Fable-Modell-ID ermöglicht die Fable-Erkennung. Das Setzen von ANTHROPIC_DEFAULT_OPUS_MODEL auf eine Opus-Modell-ID gibt den gekennzeichneten Kategorien ein Fallback-Ziel, es sei denn, die Angeheftung benennt ein Modell außerhalb der Opus-Familie oder das Modell, das abgelehnt hat; dann wechselt Claude Code nicht und die Ablehnung bleibt bestehen.

Sicherheitsforschung und Biologie-Workloads

Workloads in offensiver Sicherheit oder Biologie, einschließlich Penetrationstests, Capture the Flag (CTF) Übungen und Biologie-nahe Codebases, lösen häufig Fallback aus, oft bei der ersten Anfrage. Für substantive Biologie-Arbeit auf Fable 5.1 oder Fable 5 verschiebt Claude Code die Sitzung bei der ersten gekennzeichneten Anfrage zu Opus 5, und später Biologie-gekennzeichnete Anfragen enden dort in Ablehnungen, da Opus 5 kein Biologie-Fallback hat. Auf Opus 5 erhalten Sie diese Ablehnungen von der ersten gekennzeichneten Anfrage an.

Dies ist erwartetes Routing für diese Domänen, keine Kontoflagge. Wenn Ihre Organisation Fable-Klasse-Fähigkeit für diese Arbeit benötigt, wenden Sie sich an Ihr Anthropic-Kontoteam bezüglich vertrauenswürdiger Zugriffsprogramme.

Anstrengungsstufe anpassen

Anstrengungsstufen steuern adaptive Überlegungen, die es dem Modell ermöglichen, bei jedem Schritt basierend auf der Aufgabenkomplexität zu entscheiden, ob und wie viel es denken soll. Niedrigere Anstrengung ist schneller und billiger für einfache Aufgaben, während höhere Anstrengung tiefere Überlegungen für komplexe Probleme bietet.

Die verfügbaren Anstrengungsstufen hängen vom Modell ab. Modelle, die hier nicht aufgelistet sind, unterstützen keine Anstrengung:

Wenn Sie eine Stufe setzen, die das aktive Modell nicht unterstützt, fällt Claude Code auf die höchste unterstützte Stufe bei oder unter der von Ihnen gesetzten zurück. Zum Beispiel wird xhigh auf Opus 4.6 als high ausgeführt. Ihre Organisation oder Ihre eigenen Einstellungen können auch begrenzen, welche Stufen ein Modell anbietet; siehe Organisationsanstrengungsgrenzen.

Mit der ultracode Einstellung aus löst Claude Code die Anstrengungsstufe der Sitzung in dieser Reihenfolge auf und nimmt die erste, die zutrifft:

1. Eine explizite Wahl: die CLAUDE_CODE_EFFORT_LEVEL Umgebungsvariable, Start mit --effort oder /effort in der Sitzung (ein nicht-interaktives /effort hat engere Auswirkungen)
2. Die Standard-Anstrengung des Modells, auf Fable 5, Opus 4.8 oder Opus 4.7: ab dem ersten Mal, wenn Sie eines dieser Modelle ausführen, behält Claude Code die Standard-Anstrengung dieses Modells über Sitzungen hinweg, auch wenn Ihre Einstellungen eine andere Stufe auflösen. Opus 5 und Fable 5.1 haben keinen solchen Halt. Ob eine Stufe, die Sie setzen, den Halt beendet, hängt davon ab, wie Sie sie setzen, zum Beispiel:
   • Beendet den Halt: Bestätigung einer Stufe interaktiv, mit Enter im /effort Schieber oder dem /model Picker oder mit einer Stufe, die nach /effort eingegeben wird, oder Auswahl einer Stufe aus der Remote Control Anstrengungskontrolle eines verbundenen Geräts
   • Lässt den Halt für spätere Sitzungen bestehen: --effort beim Start oder s im /effort Schieber oder dem /model Picker
3. Ihre Einstellungen: die Stufe, die Sie für das Modell gespeichert haben, oder ein effortLevel Schlüssel, mit der Vorrangigkeit zwischen ihnen und über Einstellungsdateien hinweg, die unter modelSettings angegeben ist
4. Die Standard-Anstrengung des Modells: high auf jedem Modell, das Anstrengung unterstützt, außer dass Opus 4.7 auf xhigh standardmäßig ist und, wenn Ihre Organisation eine Standard-Anstrengungsstufe für sein Organisationsstandardmodell setzt, diese Stufe der Standard ist, wenn Sie dieses Modell ausführen

Wenn Sie low, medium, high oder xhigh in einer interaktiven Sitzung auf Ihrem Computer setzen, wählen Sie, wie lange es dauert, indem Sie bestätigen:

• Enter im /effort Schieber oder dem /model Picker oder eine Stufe, die nach /effort eingegeben wird: speichern Sie die Stufe als Ihren Standard und wenden Sie sie in späteren Sitzungen an
• s im /effort Schieber oder dem /model Picker: wenden Sie die Stufe nur auf diese Sitzung an. Erfordert Claude Code v2.1.257 oder später

Claude Code speichert die Stufe pro Modell unter dem modelSettings Schlüssel in Ihren Benutzereinstellungen, sodass jedes Modell seine eigene gespeicherte Stufe behält.

max ist die tiefste Überlegungsstufe. Sofern Sie sie nicht über die CLAUDE_CODE_EFFORT_LEVEL Umgebungsvariable setzen, wendet Claude Code max nur auf die aktuelle Sitzung an.

# Verwenden Sie den opus[1m] oder sonnet[1m] Alias
/model opus[1m]
/model sonnet[1m]

# Oder hängen Sie [1m] an einen vollständigen Modellnamen an
/model claude-opus-4-8[1m]

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}