Modellkonfiguration

Verfügbare Modelle

• Einen Modellalias
• Einen Modellnamen
  • Anthropic API: einen vollständigen Modellnamen
  • Amazon Bedrock: ein Inference-Profil-ARN
  • Microsoft Foundry: einen Bereitstellungsnamen
  • Google Cloud’s Agent Platform: einen Versionsnamen

Modellaliase

Mit Fable arbeiten

• Fable 5.2: Führen Sie /model fable aus oder starten Sie mit claude --model fable. In Claude apps gateway-Sitzungen führen Sie stattdessen /model claude-fable-5-2 aus.
• Fable 5.1 oder Fable 5: Wählen Sie es nach Modell-ID aus. Auf der Anthropic API führen Sie /model claude-fable-5-1 oder /model claude-fable-5 aus oder starten Sie mit claude --model claude-fable-5-1. Bei anderen Anbietern verwenden Sie die Modell-ID Ihres Anbieters oder fixieren Sie sie mit ANTHROPIC_DEFAULT_FABLE_MODEL.

• Pro-, Max- oder Ultra-Plan: Die Umstellung erfolgt beim ersten Ausführen von v2.1.321 oder später. Im Terminal kann die Startmodellzeile einmal (auto-updated) anzeigen.
• Team- oder Enterprise-Plan: Die Umstellung wartet auf die Einstellungen Ihrer Organisation und kann daher bei einem späteren Start oder gar nicht erfolgen. Sie gilt ab der nächsten Sitzung, ohne (auto-updated)-Zeile. Um Ihr Modell zu prüfen, führen Sie /model aus.

• 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 hinarbeiten zu lassen, setzen Sie ein Ziel.
• Geben Sie ihm mehrdeutige Probleme: Ursachenuntersuchungen, Ausfall-Debugging 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 Anleitung, 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.

Fable und Nutzungsguthaben

• Wenn Sie ein Fable-Modell mit /model auswählen, behalten Sie Ihr aktuelles Modell.
• Während der Sitzung setzt Claude Code den Turn auf Ihrem Standardmodell fort.

• Mit verbundenem Remote Control oder in der Sitzung eines Teammitglieds drücken Sie eine beliebige Taste am Terminal, um die Frist aufzuheben, 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 etwas eingegeben hat, beendet Claude Code den Turn auf die gleiche Weise, und Ihre neue Nachricht startet den nächsten Turn. Nachdem jemand am Terminal etwas eingegeben hat, wartet Claude Code weiter auf die Antwort und reiht Ihre neue Nachricht dahinter ein.

Ihr Modell einstellen

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 wann Claude Code Sie bittet, den Wechsel zu bestätigen
2. Beim Start: Starten Sie mit claude --model <alias|name>
3. Umgebungsvariable: Legen Sie ANTHROPIC_MODEL=<alias|name> fest
4. Einstellungen: Konfigurieren Sie dauerhaft in Ihrer Einstellungsdatei mit dem model-Feld
5. Standard für neue Sitzungen: Legen Sie ANTHROPIC_DEFAULT_MODEL=<alias|name> fest

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

• Wenn Ihr Admin kein Organisationsstandardmodell festgelegt hat, kann die Standard-Option zu dem aufgezeichneten Modell aufgelöst werden, und wenn dies der Fall ist, zeigt die Standard-Zeile der Auswahl den Namen dieses Modells.
• Wenn Modellbeschränkungen das aufgezeichnete Modell ausschließen oder es nicht für Ihr Konto verfügbar ist, und Ihr Admin kein Organisationsstandardmodell festgelegt hat, wird die Standard-Option aufgelöst, als ob nichts aufgezeichnet worden wäre.
• Wenn Sie Standard oder opusplan in /model auswählen, ändert sich die aufgezeichnete Auswahl nicht.

• Agent SDK oder eine App: Mit Claude Code v2.1.268 oder später bestätigt Claude Code die ID beim ersten Wechsel der Sitzung zu ihr bei Ihrem Anbieter, sofern Claude Code die Modell-ID nicht lokal akzeptiert, wie es bei Ihrer benutzerdefinierten Modelloption der Fall ist. Die Bestätigung läuft bei jedem Anbieter, und eine ID, die Ihr Anbieter nicht anbietet, wird beim Wechsel abgelehnt, anstatt bei Ihrer nächsten Anfrage fehlzuschlagen.
• Remote Control: Auf der Anthropic API prüft Claude Code den Wert lokal und sendet keine Anfrage.

claude --model opus

/model sonnet

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

Einen falsch geschriebenen Modellnamen korrigieren

⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?
Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

• Sie haben die ID falsch geschrieben: Ändern Sie sie überall dort, wo Sie das Modell festlegen, in den Vorschlag
• Die ID ist beabsichtigt: Lassen Sie sie unverändert. Die Sitzung sendet sie so, wie Sie sie geschrieben haben. Wenn das Kontextfenster, das Claude Code dafür annimmt, falsch ist, korrigieren Sie das Fenster

Ein Standardmodell für neue Sitzungen festlegen

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

• Sie legen sie auf default, inherit, opusplan oder haiku fest
• enforceAvailableModels ist aktiviert
• Die Modellbeschränkungen Ihrer Organisation schließen das Modell aus
• Das Modell ist nicht für Ihr Konto verfügbar

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

• 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 legt das Modell fest. Ein model-Wert in Projekt- oder verwalteten Einstellungen, ANTHROPIC_MODEL in Ihrer Shell oder ein Organisationsstandardmodell, das Ihr Admin so festgelegt hat, dass es Benutzerauswahlen überschreibt, gilt bei jedem Start erneut. Ihre /model-Auswahl ist weiterhin gespeichert; sie wird nur übertroffen. Wenn Projekt- oder verwaltete Einstellungen das Modell festlegen, nennt der Startheader die Datei.
• Claude Code konnte Ihre Auswahl nicht speichern. /model schreibt model in ~/.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, gilt das ausgewählte Modell nur für die Sitzung, und der nächste Start liest den alten Wert. Legen Sie model in dem Tool fest, das die Datei generiert, oder machen Sie die Datei beschreibbar. Siehe Eine in Claude Code vorgenommene Änderung geht in neuen Sitzungen verloren.
• 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 zu verwenden.

Modellauswahl einschränken

• Einer Modellfamilie wie sonnet
• Einem Versionspräfix wie claude-sonnet-4-5. Es entspricht auch späteren Modell-IDs, die es um ein weiteres Segment erweitern. Beispielsweise lässt claude-fable-5 Fable 5, Fable 5.1 und Fable 5.2 zu, während claude-fable-5-1 nur Fable 5.1 zulässt
• Einer vollständigen Modell-ID wie claude-sonnet-4-5-20250929

• Modell der Hauptsitzung: /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 auf ein Modell außerhalb der Liste umleiten
• Fast-Modus: /fast verweigert das Umschalten, wenn dadurch implizit zu einem Opus-Modell außerhalb der Liste gewechselt würde, mit der Meldung “is not in your organization’s allowed models”
• Modelle von Subagenten und Teammitgliedern: das Feld model im Frontmatter von Subagenten, der Parameter model des Agent-Tools, Modelle von Teammitgliedern in Agent-Teams, CLAUDE_CODE_SUBAGENT_MODEL und, in v2.1.197 und früher, die Modellauswahl im /agents-Assistenten
• Modelle von Skills und Befehlen: das Frontmatter-Feld model in Skills und Befehlen
• Advisor-Modell: die konfigurierte Einstellung advisorModel und das Flag --advisor
• Modell für Hintergrund-Agenten: das in der Dispatch-Auswahl ausgewählte Modell

• /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 mit einer Warnung, die sowohl das angeforderte als auch das ersetzte Modell nennt, und die Sitzung startet mit dem Standardmodell
• ANTHROPIC_DEFAULT_MODEL: Claude Code ignoriert die Variable
• Überschreibung für Subagenten oder Teammitglieder: Claude Code führt den Subagenten oder das Teammitglied mit einem Fallback-Modell aus, anstatt die Anfrage fehlschlagen zu lassen. Siehe Ein Modell auswählen für den Fallback bei Subagenten und Teammitglieder und Modelle angeben für den Fallback bei Teammitgliedern. In interaktiven Sitzungen warnt Claude Code Sie, wenn es das Modell eines Subagenten ersetzt, sei es durch diesen Fallback oder durch die oben beschriebene Ersetzung durch die neueste zulässige Version, und nennt dabei das angeforderte und das ersetzte Modell; den Fallback eines Teammitglieds meldet es nicht. Wo die oben beschriebene Ersetzung durch die neueste zulässige Version greift, folgt ein blockierter Familien-Alias stattdessen dieser. Vor v2.1.222 fiel ein Alias bei jedem Anbieter wie jeder andere blockierte Wert auf den Fallback zurück
• Überschreibung für Skills oder Befehle: Claude Code ignoriert die Überschreibung, einschließlich eines blockierten Familien-Alias, und der Skill oder Befehl wird mit dem Sitzungsmodell ausgeführt. Ein Skill oder Befehl, der in einem Subagenten ausgeführt wird, folgt stattdessen dem oben beschriebenen Verhalten für Subagenten
• Einstellung advisorModel: Der Advisor wird für die Sitzung deaktiviert
• Flag --advisor: Claude Code wird beim Start mit einem Fehler beendet. In einer Hintergrundsitzung startet es die Sitzung stattdessen ohne den Advisor, anstatt sich zu beenden
• CLAUDE_CODE_AUTO_MODE_MODEL: Claude Code ignoriert die Variable und wählt das Modell für seine Anfragen des Auto-Modus-Klassifikators so, als hätten Sie sie nicht gesetzt

• Anthropic API, Claude Platform on AWS, Claude apps gateway oder ein über ANTHROPIC_BASE_URL festgelegtes LLM-Gateway: Eine von Ihnen aufgeführte Anthropic-Modell-ID, für die es keine integrierte Zeile in der Auswahl gibt, erscheint als eigene beschriftete Zeile. Claude Code fügt eine solche Zeile für Opus-, Sonnet- und Haiku-Versionen hinzu, etwa für eine ältere Version, die die Liste festlegt. Wenn Sie replaceBuiltInOptions in einer modelPicker-Zusammenstellung setzen, erscheint diese Zeile nicht. Vor v2.1.199 war eine solche ID nur durch Eingabe von /model <id> auswählbar.
• Amazon Bedrock, Google Cloud’s Agent Platform oder Microsoft Foundry: Sofern eine von Ihnen aufgeführte Modell-ID nicht mit anthropic. beginnt, fügt Claude Code keine Zeile dafür hinzu, unabhängig davon, ob es sich um eine Anthropic-Modell-ID oder eine anbieterspezifische ID handelt. Mantle-Modell-IDs tragen dieses Präfix. Um eine aufgeführte Version anzuzeigen, die keine integrierte Zeile hat, fügen Sie sie zusätzlich einer modelPicker-Zusammenstellung hinzu, die IDs im Format Ihres Anbieters akzeptiert.

• Fallback-Modellketten: Einträge außerhalb der Allowlist werden verworfen
• Upgrades im Plan-Modus: Bei der Anthropic API und Claude Platform on AWS verwendet ein Upgrade wie opusplan auf ein ausgeschlossenes Modell die neueste zulässige Version der Upgrade-Familie. Bei Anbietern mit anbieterspezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung mit dem Modell der Sitzung fortgesetzt
• Automatischer Modell-Fallback: Ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, sodass die gekennzeichnete Anfrage stattdessen mit einer Ablehnung endet
• Auto-Modus-Klassifikator: Wenn die Allowlist das Standardmodell des Klassifikators ausschließt, werden Klassifikator-Anfragen, die dieses Modell verwenden würden, mit dem Sitzungsmodell ausgeführt oder in Fable-Sitzungen mit einem Opus-Modell. Bei anderen Anbietern als der Anthropic API läuft dieser Opus-Fallback mit dem Modell, das Sie in ANTHROPIC_DEFAULT_OPUS_MODEL festlegen, andernfalls mit Opus 5, ohne die Allowlist zu berücksichtigen. Erfordert Claude Code v2.1.210 oder höher
• Fast-Modus: Das Aktivieren des Fast-Modus wird verweigert, wenn das Modell, mit dem die Sitzung danach laufen würde, außerhalb der Allowlist liegt
• Verfügbarkeits-Fallback bei Amazon Bedrock und Google Cloud’s Agent Platform: Wenn Ihr Konto während einer Sitzung den Zugriff auf ein Modell verliert, überspringt der Wechsel zu einem anderen Modell ausgeschlossene Modelle. Die Prüfungen des Startmodells bei Amazon Bedrock und Google Cloud’s Agent Platform überspringen ausgeschlossene Modelle nur, wenn die verwalteten Einstellungen zusätzlich enforceAvailableModels setzen

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

Abdeckung der Oberflächen

• Cloud-Sitzungen, einschließlich derer, die Sie über die Desktop-App starten, laufen standardmäßig auf von Anthropic verwalteten VMs: Auf Ihrem Gerät bereitgestellte Einstellungen erreichen sie nicht, stellen Sie die Allowlist daher über serververwaltete Einstellungen bereit. Sitzungen, die Ihre Organisation an eine selbst gehostete Umgebung weiterleitet, laufen auf Ihrer eigenen Rechenleistung und lesen zusätzlich die Datei für verwaltete Einstellungen im Runner-Image. Wie Claude Code verwaltete Quellen kombiniert gibt an, wann diese Datei gilt. Ein Modellwechsel während einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Allowlist ausgeschlossen ist. Wenn die availableModels-Liste in Ihren serververwalteten Einstellungen nicht leer ist, lehnt der Server eine Anfrage ab, eine Cloud-Sitzung unter claude.ai/code oder über die Desktop-App mit einem Modell zu starten, das die Liste ausschließt.
• Claude Tag-Sitzungen laufen in Cloud-Umgebungen, erhalten aber keine serververwalteten Einstellungen; in einer selbst gehosteten Umgebung lesen sie dennoch die Datei für verwaltete Einstellungen im Runner-Image. Um das Modell für diese Sitzungen festzulegen, lesen Sie Choose the model for a scope im Admin-Leitfaden für Claude Tag.
• Cowork, der Tab für agentisches Arbeiten in der Claude Desktop-App, führt seine Sitzungen mit Claude Code aus, erhält aber konstruktionsbedingt keine serververwalteten Einstellungen aus der Admin-Konsole von claude.ai. Wenn die availableModels-Liste in Ihren serververwalteten Einstellungen nicht leer ist und ein Benutzer ein Modell außerhalb dieser Liste auswählt, lehnt der Server dieses Modell für eine Remote-Cowork-Sitzung ab. Eine Datei für verwaltete Einstellungen gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung läuft; Remote-Cowork-Sitzungen laufen auf von Anthropic verwalteten VMs, auf denen eine auf dem Gerät bereitgestellte Datei nicht vorhanden ist.
• Sitzungen bei Drittanbietern wie Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry und Claude Platform on AWS erhalten keine serververwalteten Einstellungen, stellen Sie die Allowlist dort daher über MDM oder Dateien für verwaltete Einstellungen bereit.
• Die Bereitstellung über die Admin-Konsole erfordert außerdem, dass die Sitzung die Einstellungen mit einer berechtigten Anmeldung bei Ihrer Organisation oder einem für sie ausgestellten OAuth-Token abruft. Für Geräteflotten, die sich mit API-Schlüsseln authentifizieren, ob direkt konfiguriert oder durch ein apiKeyHelper-Skript generiert, stellen Sie die Allowlist über MDM oder Dateien für verwaltete Einstellungen bereit.
• Der Code-Tab der Desktop-App hostet auch SSH-Sitzungen, die die Datei für verwaltete Einstellungen vom Remote-Host lesen, auf dem sie laufen. Siehe Verwaltete Einstellungen in Desktop.
• Die Modellauswahlen auf claude.ai und in der Desktop-App blenden Modelle, die durch die Allowlist Ihrer Organisation ausgeschlossen sind, aus oder grauen sie aus. Der Zustand der Auswahl dient nur der Benutzerfreundlichkeit; er setzt die Allowlist nicht durch.

Verhalten des Standardmodells

Die Allowlist für das Default-Modell durchsetzen

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

Steuern, mit welchem Modell Benutzer arbeiten

• availableModels: schränkt ein, zu welchen benannten Modellen Benutzer wechseln können
• enforceAvailableModels: weitet die availableModels-Allowlist auf die Option „Default“ aus, sodass Default nicht zu einem Modell außerhalb der Liste aufgelöst werden kann
• deniedModels und availableModelsMatch: blockieren bestimmte Versionen, die ein availableModels-Eintrag andernfalls zulassen würde
• model: legt die anfängliche Modellauswahl beim Start einer Sitzung fest
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: steuern, wozu die Aliase sonnet, opus, haiku und fable aufgelöst werden und welche Version der Standard des Kontotyps verwendet

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

Zusammenführungsverhalten

Mantle-Modell-IDs

Bestimmte Modelle oder Versionen blockieren

• deniedModels: Führen Sie die zu blockierenden Modelle auf. Ein aufgeführtes Modell wird auch dann blockiert, wenn availableModels es zulässt, und der Schlüssel funktioniert auch ganz ohne Allowlist. Ein Release, das kein Eintrag blockiert, bleibt zulässig
• availableModelsMatch: Setzen Sie ihn auf "exact", damit jede Modell-ID in availableModels nur die genannte Version zulässt. Eine neuere Version einer aufgeführten Modell-ID bleibt dann blockiert, bis Sie sie der Liste hinzufügen

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

1. Die neueste zulässige Version derselben Familie
2. Nacheinander das neueste zulässige Modell jeder kostengünstigeren Familie: Sonnet, dann Haiku
3. Der erste availableModels-Eintrag, der ein zulässiges Modell nennt

Modelleinschränkungen der Organisation

• Das Deaktivieren eines Modells auf Organisationsebene entfernt es für jedes Mitglied.
• Der Zugriff auf Rollenebene gewährt verschiedenen benutzerdefinierten Rollen unterschiedliche Modelle, und ein Mitglied mit mehreren Rollen kann jedes Modell verwenden, das eine seiner Rollen gewährt.
• Haiku-Modelle sind immer verfügbar und können nicht deaktiviert werden, sodass jedes Mitglied mindestens ein nutzbares Modell behält.
• Eine Zugriffsänderung wird für neue Anfragen innerhalb von etwa einer Minute wirksam; die /model-Auswahl spiegelt sie beim nächsten Sitzungsstart wider.

Organisationsstandardmodell

• 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

• 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
• für ein Organisationsstandardmodell, das deniedModels oder eine "exact"-Liste blockiert, siehe Spezifische Modelle oder Versionen blockieren
• 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

Organisatorische Anstrengungsgrenzen

• 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. Wenn Sie einen einfachen Text---print-Lauf mit --effort über der Obergrenze starten, nennt eine Warnung auf stderr die angeforderte und die angewendete Stufe. In interaktiven Sitzungen, bei json- oder stream-json-Ausgabe oder in Hintergrund-Agenten wird diese Warnung stattdessen in das Debug-Log geschrieben.
• 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.

Spezielles Modellverhalten

default Modelleinstellung

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

opusplan Modelleinstellung

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

Fallback-Modellketten

claude --fallback-model sonnet,haiku

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

• Außerhalb der Allowlist: Claude Code löscht jeden Eintrag, der nicht von availableModels erlaubt 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 der Konversation abschneiden würde. Wenn jedes Fallback kleiner ist, zeigt die Komprimierung den ursprünglichen Fehler an und Sie können es erneut versuchen.

Automatisches Modell-Fallback

• Fable-Modelle und Opus 5.5: Biologie-gekennzeichnete Anfragen werden auf Opus 5 erneut ausgeführt, und Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt.
• Sonnet 5.5: Cybersicherheits-gekennzeichnete Anfragen werden auf Sonnet 5 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Sonnet 5.5 kein Biologie-Fallback-Modell hat.
• 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-Klassifikatoren ohne Fallback-Modell ausführt.

Effort-Stufe nach einem Fallback

• Ihre eigene Änderung: Sobald Sie eine Effort-Stufe wählen, ein Modell in /model auswählen oder die Sitzung später fortsetzen, wird die Stufe der gekennzeichneten Anfrage nicht mehr übernommen.
• Für einen Turn festgelegter Effort: Wenn Sie den gekennzeichneten Turn mit ultrathink angehoben haben oder das effort-Frontmatter eines Skills seine Stufe festgelegt hat, gilt diese Stufe für diesen Turn. Spätere Turns laufen mit der Stufe, die die Effort-Auflösungsreihenfolge für das Fallback-Modell ergibt.

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

Vor dem Wechsel fragen

• Wenn die gekennzeichnete Kategorie kein Fallback-Modell hat, wie eine Biologie-Kennzeichnung auf Opus 5 oder Sonnet 5.5, zeigt Claude Code die Abfrage nicht an und die Anfrage endet mit der Ablehnung.
• Wenn beide Modelle die gleiche Anfrage kennzeichnen, können Sie den Prompt bearbeiten und es erneut versuchen oder eine neue Sitzung starten.
• In Cloud-Sitzungen in der mobilen App wird das Bearbeiten und erneute Versuchen nicht unterstützt. Wechseln Sie das Modell oder setzen Sie die Sitzung in einem Desktop-Browser oder der Desktop-App fort.
• Im nicht interaktiven Modus und in SDK-Integrationen, die die Abfrage nicht anzeigen können, beendet eine gekennzeichnete Anfrage den Turn stattdessen mit einer Ablehnung.
• In einem Subagenten, den Claude mit dem Agent-Tool startet, pausiert Claude Code nicht, um nachzufragen, und der Subagent schlägt fehl, statt das Modell zu wechseln. Siehe Subagenten wechseln oder schlagen fehl, ohne zu fragen.
• Wenn das Fallback-Ziel von availableModels blockiert ist, zeigt Claude Code die Abfrage nicht an. Die gekennzeichnete Anfrage endet mit der Ablehnung, genau wie beim automatischen Fallback, wenn das Ziel blockiert ist.

Subagenten wechseln oder schlagen fehl, ohne zu fragen

• Switch automatically oder noch keine Wahl: Die Anfrage wird auf dem Fallback-Modell erneut ausgeführt, und das Modell Ihrer Sitzung bleibt unverändert
• Ask each time: Der Subagent schlägt mit Agent terminated early due to an API error und der Ablehnungsmeldung fehl. Claude erhält diesen Fehler und entscheidet, wie mit der unerledigten Aufgabe umgegangen wird. Damit Subagenten das Modell wechseln können, wählen Sie Switch automatically. Ihre Hauptkonversation wechselt dann ebenfalls, ohne zu fragen.

Fallback auf Bedrock, Agent Platform und Foundry aktivieren

• Claude Code muss das aktuelle Modell als Fallback-Quelle erkennen. Fable-Modelle 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.5, Sonnet 5.5 und Opus 5 werden durch ihre Provider-Modell-ID oder eine modelOverrides Zuordnung erkannt.
• Ein Opus-Ziel muss sich in Ihrer Bereitstellung auflösen, unabhängig davon, welches Modell abgelehnt hat: Stellen Sie ANTHROPIC_DEFAULT_OPUS_MODEL ein oder behalten Sie einen Opus 4.8-Eintrag in der Modelliste des Providers. Ohne einen bleibt das Fallback für jedes Quellmodell aus, einschließlich Sonnet 5.5, und gekennzeichnete Anfragen enden mit einer Ablehnung.
• Das Fallback-Modell der gekennzeichneten Kategorie muss sich in Ihrer Bereitstellung auflösen. Von einem Fable-Modell, Opus 5.5 oder Opus 5, wenn Sie ANTHROPIC_DEFAULT_OPUS_MODEL einstellen, werden gekennzeichnete Anfragen auf diesem Modell für jede Kategorie erneut ausgeführt, die ein Fallback hat; eine Biologie-Kennzeichnung auf Opus 5 endet immer noch mit einer Ablehnung. Wenn Sie es nicht einstellen, werden Cybersicherheits-gekennzeichnete Anfragen auf dem Opus 4.8-Eintrag erneut ausgeführt und Biologie-gekennzeichnete Anfragen von einem Fable-Modell oder Opus 5.5 auf einem Opus 5-Eintrag. Von Sonnet 5.5 werden Cybersicherheits-gekennzeichnete Anfragen auf dem Modell erneut ausgeführt, das Sie in ANTHROPIC_DEFAULT_SONNET_MODEL einstellen, oder auf einem Sonnet 5-Eintrag in der Modelliste des Providers, wenn Sie es nicht einstellen.

• Fable-Modelle: Stellen Sie ANTHROPIC_DEFAULT_FABLE_MODEL auf Ihre Fable-Modell-ID ein, damit Claude Code sie als Fallback-Quelle erkennt.
• Jedes Quellmodell: Stellen Sie ANTHROPIC_DEFAULT_OPUS_MODEL auf eine Opus-Modell-ID ein, um das Fallback einzuschalten und den gekennzeichneten Kategorien ein Ziel zu geben. Ein Pin, der ein Modell außerhalb der Opus-Familie benennt oder das Modell, das abgelehnt hat, lässt die Ablehnung stehen.
• Sonnet 5.5: Zusätzlich zum Opus-Pin stellen Sie ANTHROPIC_DEFAULT_SONNET_MODEL ein oder behalten Sie einen Sonnet 5-Eintrag in der Modelliste des Providers, um das Modell bereitzustellen, auf dem die Anfrage erneut ausgeführt wird. Ein Sonnet-Pin, der ein Modell außerhalb der Sonnet-Familie benennt oder Sonnet 5.5 selbst, lässt die Ablehnung stehen.

Sicherheitsforschung und Biologie-Workloads

Effort-Stufe anpassen

1. Die CLAUDE_CODE_EFFORT_LEVEL Umgebungsvariable
2. Eine Stufe, die Sie in der Sitzung auswählen, etwa mit /effort, dem /model Picker oder applyFlagSettings()
3. Start mit --effort
4. Ihre Einstellungen: die Stufe, die Sie für das Modell gespeichert haben, oder ein effortLevel Schlüssel, mit dem Vorrang zwischen ihnen und über Einstellungsdateien hinweg, wie unter modelSettings angegeben
5. Der Standard-Effort des Modells: Fable 5.2, Opus 5.5, Sonnet 5.5 und Haiku 5.5 verwenden standardmäßig medium, und Opus 4.7 verwendet standardmäßig xhigh. Andere Modelle in der Tabelle der Effort-Stufen verwenden standardmäßig high. Wenn Ihre Organisation eine Standard-Effort-Stufe für ihr Organisations-Standardmodell festlegt, ist diese Stufe der Standard, wenn Sie dieses Modell ausführen.

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

• /effort: Führen Sie /effort ultracode aus, um es für die aktuelle Sitzung einzuschalten, oder /effort ultracode off, um es auszuschalten. Drücken Sie im /effort Slider Tab, um den Ultracode Umschalter umzulegen, dann Enter, um es anzuwenden
• --effort Flag: Starten Sie mit claude --effort ultracode, das die Sitzung mit xhigh Effort und eingeschaltetem Ultracode startet
• ultracode Einstellung: Stellen Sie "ultracode": true in einer Einstellungsdatei, mit --settings oder in einer Agent SDK Steuerungsanfrage ein. Eine applyFlagSettings() Anfrage akzeptiert auch effortLevel: "ultracode", was es einschaltet und die Effort-Stufe auf xhigh setzt

• Workflows ausgeschaltet sind
• Das Modell xhigh Effort nicht unterstützt

Wählen Sie eine Effort-Stufe

Verwenden Sie Ultrathink für einmalige tiefe Überlegungen

• Geben Sie es erneut außerhalb von Elementen wie Anführungszeichen, Klammern, einem Pfad oder einem Befehl ein, in einem Prompt, der nicht mit / beginnt
• Entfernen Sie CLAUDE_CODE_EFFORT_LEVEL, wenn die Variable unter xhigh gesetzt ist, erhöhen Sie Ihr eigenes maxEffortLevel auf xhigh oder höher, oder bitten Sie einen Admin Ihrer Organisation, das Limit Ihrer Organisation anzuheben
• Führen Sie /model in Ihrer Sitzung aus, um zu einem Opus 5.5-, Sonnet 5.5-, Haiku 5.5-, Fable 5.2- oder Fable 5.1-Modell zu wechseln. Wo das Wort einen Turn nicht anheben kann, etwa auf Amazon Bedrock, stellen Sie stattdessen die Effort-Stufe ein

Stellen Sie die Effort-Stufe ein

• /effort: Führen Sie /effort ohne Argumente aus, um einen interaktiven Slider zu öffnen, /effort gefolgt von einem Stufennamen, um sie direkt einzustellen, oder /effort auto, um Ihre gespeicherte Stufe für das aktive Modell zu löschen
• In /model: Verwenden Sie die Pfeiltasten links/rechts, um den Effort-Slider anzupassen, wenn Sie ein Modell auswählen. Die neue Stufe gilt spätestens ab Ihrer nächsten Nachricht. Bis dahin kann Claude auf der alten Stufe weiterarbeiten, selbst auf einem neuen Modell. Solange eine Quelle gilt, die Vorrang vor Ihrer Auswahl hat, etwa CLAUDE_CODE_EFFORT_LEVEL, arbeitet Claude stattdessen auf der Stufe dieser Quelle.
• --effort Flag: Übergeben Sie einen Stufennamen, um ihn beim Start von Claude Code für eine einzelne Sitzung einzustellen
• Umgebungsvariable: Setzen Sie CLAUDE_CODE_EFFORT_LEVEL auf einen Stufennamen. Damit Claude Code keine Effort-Stufe sendet, setzen Sie sie stattdessen auf auto oder unset
• Einstellungen: Stellen Sie eine Stufe pro Modell in modelSettings ein oder setzen Sie effortLevel auf low, medium, high oder xhigh als Standard für Modelle ohne eigene Stufe. max wird in keinem der beiden Schlüssel als Stufe akzeptiert, und ultracode hat seinen eigenen ultracode Schlüssel
• Von einem verbundenen Gerät: Wählen Sie in einer Remote Control-Sitzung eine Stufe über die Effort-Steuerung auf Ihrem Telefon oder in Ihrem Browser. Die Stufe gilt nur für die aktuelle Sitzung. Erfordert Claude Code v2.1.234 oder später
• Skill- und Subagent-Frontmatter: Stellen Sie effort in einer Skill- oder Subagent-Markdown-Datei ein, um die Effort-Stufe zu überschreiben, wenn dieser Skill oder Subagent läuft

Effort-Stufe von Subagenten und Teammates

Die eingestellte Effort-Stufe überprüfen

Wann eine neue Effort-Stufe beginnt

• Nach dem Ende des Turns: Bis dahin müssen Sie nichts tun, und es ist zu erwarten, dass der Turn auf der alten Stufe endet
• Während Claude noch arbeitet: Geben Sie eine Nachricht ein, etwa keep going, und drücken Sie Enter, um sie in die Warteschlange zu stellen, ohne den Turn zu unterbrechen. Claude erhält sie, wenn die aktuellen Tool-Aufrufe abgeschlossen sind, spätestens jedoch am Ende des Turns, und arbeitet ab dann auf der neuen Stufe.

Keine Effort-Stufe senden

export CLAUDE_CODE_EFFORT_LEVEL=auto

• Effort level: auto: Es wird keine Effort-Stufe gesendet.
• Effort level: auto (currently <level>): Es wird weiterhin eine Stufe gesendet. Wenn eine maxEffortLevel-Einstellung unterhalb von max für das aktive Modell gilt, sendet Claude Code seinen eigenen Standard für das Modell, abgesenkt auf diese Obergrenze. Entfernen Sie die Einstellung oder setzen Sie sie auf max.

Adaptive Überlegungen und feste Thinking-Budgets

Extended Thinking

Wo Sie Thinking nicht ausschalten können

• Anthropic API: Sie können Thinking auf Modellen wie claude-opus-5, claude-sonnet-5 und claude-haiku-4-5 ausschalten. Aliase wie sonnet wählen Modelle aus, bei denen das nicht möglich ist, daher legen Sie das Modell über seine ID fest.
• Drittanbieter-Provider: Bei Providern wie Amazon Bedrock und Microsoft Foundry können Modelle mit adaptiven Überlegungen auch bei ausgeschaltetem Thinking weiterhin nachdenken. Senken Sie die Effort-Stufe, um das Thinking zu reduzieren.

Erweiterter Kontext

1M-Kontext für Opus 4.6 oder Sonnet 4.6 auswählen

# Append [1m] to a full model name
/model claude-opus-4-6[1m]
/model claude-sonnet-4-6[1m]

# Or to an alias: the suffix applies to the model the alias resolves to
/model opus[1m]

Kontextfenster hinter einem LLM-Gateway

1M-Kontext ausschalten

• Bei eingeschalteter automatischer Komprimierung komprimieren Sitzungen an der 200K-Grenze durch automatische Komprimierung. Ein Fenster für die automatische Komprimierung über 200K hebt diese Begrenzung nicht auf, da Claude Code dieses Fenster auf das Kontextfenster des Modells begrenzt.
• Bei ausgeschalteter automatischer Komprimierung stoppen Sitzungen an der 200K-Grenze mit dem Kontext-Limit-Fehler, statt zu komprimieren.

Haiku 5.5 Kontextfenster und Preise

Kontextfenster und automatische Komprimierung

Fenster für automatische Komprimierung einstellen

• Für das aktuelle Modell, in dieser Sitzung und späteren: Führen Sie /autocompact mit einem Wert aus, z. B. /autocompact 500k. Claude Code speichert es in Ihren Benutzereinstellungen unter dem aktuellen Modell in modelSettings und wendet es auf die aktuelle Sitzung an. Wenn ein höher priorisierter Geltungsbereich für Einstellungen wie verwaltete Einstellungen ein eigenes Fenster für dieses Modell oder für jedes Modell festlegt, speichert der Befehl Ihren Wert, aber die Sitzung behält das Fenster dieses Geltungsbereichs bei, und der Befehl teilt dies mit. Führen Sie /autocompact auto aus, um zum für Ihr Modell optimierten Fenster zurückzukehren. Vor v2.1.288 speicherte der Befehl ein einziges Fenster für jedes Modell, als autoCompactWindow auf oberster Ebene.
• Für jedes Modell: Setzen Sie autoCompactWindow in einer Einstellungsdatei, z. B. "autoCompactWindow": 200000 in ~/.claude/settings.json. Ein Fenster, das Sie mit /autocompact für ein Modell gespeichert haben, hat für dieses Modell Vorrang vor diesem Schlüssel in derselben Datei.
• Für einen Start: Übergeben Sie --autocompact beim Starten von Claude Code. Das Flag überschreibt Ihre gespeicherte Einstellung für diesen Start, ohne sie zu ändern, und claude --autocompact auto führt die Sitzung mit dem optimierten Fenster aus, auch wenn Ihre gespeicherte Einstellung einen Wert hat. Im Gegensatz zu /autocompact wird das Flag nicht durch einen höher priorisierten Geltungsbereich für Einstellungen wie verwaltete Einstellungen verdrängt.
• In Skripten und Cloud-Umgebungen: Setzen Sie CLAUDE_CODE_AUTO_COMPACT_WINDOW auf eine Token-Anzahl wie 200000. Sofern Claude Code den Wert nicht ignoriert, hat die Variable Vorrang vor dem Befehl, dem Flag und der Einstellung autoCompactWindow. /autocompact meldet dann die Überschreibung, ohne zu speichern. Der Wert used_percentage der Statuszeile bezieht sich auf das vollständige Kontextfenster des Modells. Solange die Variable gesetzt ist, zeigt dieser Prozentsatz daher nicht an, wann die Komprimierung ausgeführt wird.
• Für einen Subagenten: Siehe Fenster für automatische Komprimierung für einen Subagenten einstellen.

• Eine einfache Token-Anzahl, z. B. 200000
• Ein k- oder M-Suffix, z. B. 500k oder 1M
• Eine bloße Zahl von 100 bis 1000, was Tausende bedeutet, also setzt 200 200.000

Werte und Warnungen für CLAUDE_CODE_AUTO_COMPACT_WINDOW

Standard-Schwellwerte für automatische Komprimierung

• Cloud-Sitzungen komprimieren, wenn sich die Konversation dem Limit des Modells nähert
• Sonnet 4.6 und Opus 4.6 ohne erweiterten Kontext komprimieren bei der 200K-Grenze
• Wenn Sie CLAUDE_CODE_DISABLE_1M_CONTEXT=1 setzen, komprimieren Modelle mit einem nativen 1M-Fenster, wie Sonnet 5 und die Fable-Modelle, bei der 200K-Grenze
• Modelle, die mit einem nativen 1M-Fenster laufen, komprimieren, bevor das Fenster voll wird, standardmäßig bei etwa 967K Token. Dazu gehören die Fable-Modelle, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später. Hinter einer benutzerdefinierten ANTHROPIC_BASE_URL siehe das Kontextfenster hinter einem Gateway
• Sitzungen auf einer Modell-ID, die Claude Code nicht erkennt, z. B. ein LLM-Gateway-Alias, komprimieren bei dem Kontextfenster, das Claude Code für die ID annimmt; siehe Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren

Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren

⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...
Claude Code doesn't recognize the model "my-gateway-opus", so it assumes a context window of 200k tokens. Update Claude Code, or see https://code.claude.com/docs/en/model-config#correct-the-window-for-a-gateway-or-custom-model-id to set the window.

• Ein Modell, das neuer ist als Ihre Claude Code-Version: Führen Sie claude update in Ihrer Shell aus. Wenn Claude Code die ID nach dem Update erkennt, müssen Sie nichts weiter konfigurieren.
• Der Name Ihres Gateways oder Anbieters für ein Modell, das Claude Code kennt: Fügen Sie einen modelOverrides-Eintrag hinzu, der die Anthropic-Modell-ID auf Ihre ID abbildet, z. B. "claude-opus-4-8": "my-gateway-opus". Alternativ können Sie Ihre ID in einer modelPicker-Zeile aufführen, in der behavesAs auf dieses Modell gesetzt ist. In beiden Fällen behandelt Claude Code die ID dann als dieses Modell.
• Ein Modell mit einem 1M-Fenster: Hängen Sie [1m] an die ID an, wo Sie das Modell festlegen, z. B. claude --model 'my-gateway-opus[1m]' in Ihrer Shell. Wenn Sie den 1M-Kontext deaktiviert haben, erhalten Sie mit oder ohne Suffix dasselbe Fenster.
• Jedes andere Fenster: Setzen Sie CLAUDE_CODE_MAX_CONTEXT_TOKENS in der Umgebung, die Claude Code startet, auf die Fenstergröße in Token, z. B. CLAUDE_CODE_MAX_CONTEXT_TOKENS=400000. Für eine nicht erkannte ID, die nicht mit claude- beginnt und kein [1m]-Suffix hat, wird die Variable von selbst wirksam. Prüfen Sie für jede andere ID zunächst, für welche IDs sie gilt.

Für welche IDs CLAUDE_CODE_MAX_CONTEXT_TOKENS gilt

• Wenn Claude Code einen Anbieter oder eine benutzerdefinierte Schreibweise nicht zu einem Modell auflösen kann, das es erkennt, und die ID kein [1m] enthält, wird die Variable direkt angewendet und die proaktive Komprimierung wird bei dem deklarierten Fenster fortgesetzt.
• Wenn Claude Code einen Anbieter oder eine benutzerdefinierte Schreibweise nicht zu einem Modell auflösen kann, das es erkennt, und die ID enthält [1m], in beliebiger Schreibweise, nimmt Claude Code ein 1M-Fenster dafür an und die Variable wird nicht von selbst angewendet. Um das Fenster zu korrigieren und gleichzeitig die proaktive Komprimierung beizubehalten, setzen Sie auch CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Mit dieser Variable gesetzt, dimensioniert Claude Code die ID wie dieselbe Schreibweise ohne [1m], daher wird CLAUDE_CODE_MAX_CONTEXT_TOKENS angewendet, wenn es auf diese ungetaggte Schreibweise angewendet würde. Mit einem deklarierten Fenster über 200K ist die Warnung, dass das 200K-Limit nicht erzwungen wird, in dieser Konfiguration zu erwarten.
• Wenn die ID zu einem Modell aufgelöst wird, das Claude Code erkennt, oder die ID ein bloßer claude--Name ohne Suffix ist, das Claude Code entfernen kann, in beliebiger Schreibweise, wird die Variable nur wirksam, wenn auch DISABLE_COMPACT gesetzt ist, was alle Komprimierung deaktiviert. Beispielsweise löst eine ID, die einen Claude-Modellnamen enthält, den Claude Code kennt, wie anthropic/claude-opus-4-8, us.anthropic.claude-…-v1:0, oder das datierte claude-sonnet-4-5@20250929, zu diesem Modell auf. Dies umfasst IDs, die auch [1m] enthalten: Claude Code löst claude-opus-4-8[1m] zu Opus 4.8 auf, auch wenn CLAUDE_CODE_DISABLE_1M_CONTEXT gesetzt ist.

Überprüfung Ihres aktuellen Modells

• In der Statuszeile, falls Sie eine konfiguriert haben
• In /status, das auch Ihre Kontoinformationen anzeigt

Benutzerdefinierte Modelloption hinzufügen

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

• Wenn Sie den Namen weglassen, zeigt der Eintrag den Namen des Modells an, wenn Claude Code die ID erkennt, und die Modell-ID andernfalls.
• Wenn Sie die Beschreibung weglassen, verwendet Claude Code Custom model (<model-id>).

Umgebungsvariablen

Modelle für Drittanbieter-Bereitstellungen fixieren

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

• Claude Code entfernt das Suffix, bevor die Modell-ID an Ihren Anbieter gesendet wird.
• Fügen Sie [1m] nur an, wenn das zugrunde liegende Modell 1M-Kontext unterstützt.
• Das Suffix wird pro Variable gelesen, nicht pro Modell. Bei Amazon Bedrock, Google Cloud’s Agent Platform und Microsoft Foundry verwendet eine Opus-4.6- oder Sonnet-4.6-ID ohne [1m] in einer Variable 200K-Kontext, auch wenn eine andere Variable das gleiche Modell mit dem Suffix setzt.

Anzeige und Funktionen des fixierten Modells anpassen

• Erkannt: die genaue ID eines Modells, das Claude Code kennt, wie seine Anthropic-API-ID oder die Form Ihres Anbieters oder Gateways, mit oder ohne das [1m]-Suffix. Fixieren Sie us.anthropic.claude-sonnet-4-5-20250929-v1:0 und die Zeile liest Sonnet 4.5.
• Nicht erkannt: jede andere ID, wie ein Anwendungs-Inferenzprofil-ARN oder eine Modellversion, die Claude Code nicht kennt, es sei denn, ein modelOverrides-Eintrag ordnet ein Modell dieser ID zu. Bei Microsoft Foundry sind Bereitstellungsnamen benutzerdefiniert, daher erkennt Claude Code eine fixierte ID dort niemals, zugeordnet oder nicht, und die Zeile zeigt standardmäßig den Bereitstellungsnamen.

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'

Modell-IDs pro Version überschreiben

{
  "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"
  }
}

Prompt-Caching-Konfiguration

Versionsverlauf