Claude Code — Modell Konfiguration Referenz

Diese Seite dokumentiert wie du Modelle in Claude Code konfigurierst und wählst, einschließlich Aliases, Effort-Level, Extended Thinking und Provider-Konfiguration.

Verfügbare Modelle

Du kannst konfigurieren:

• Ein Modell-Alias (kurz, einfach zu merken)
• Ein vollständiger Modellname (spezifische Version)

Modell-Aliases

Aliases bieten eine bequeme Möglichkeit, Modell-Einstellungen zu wählen ohne exakte Versionsnummern zu merken:

Aliases zeigen immer auf die neueste Version. Um eine spezifische Version zu festigen, verwende den vollständigen Modellnamen (z.B. claude-opus-4-6) oder setze die entsprechende Umgebungsvariable wie ANTHROPIC_DEFAULT_OPUS_MODEL.

Modell setzen

Du kannst dein Modell auf mehrere Arten konfigurieren (in Prioritätsreihenfolge):

1. In Session — /model <alias|name> verwenden
2. Beim Starten — claude --model <alias|name>
3. Umgebungsvariable — ANTHROPIC_MODEL=<alias|name> setzen
4. Settings — Permanent in settings.json mit dem Feld model

Beispiele:

# Starte mit Opus
claude --model opus

# Wechsle zu Sonnet in Session
/model sonnet

# Oder mit Option
/model sonnet[1m]

settings.json:

{
  "permissions": { ... },
  "model": "opus"
}

Modell-Auswahl beschränken

Enterprise-Administratoren können availableModels in managed oder policy settings verwenden um zu beschränken welche Modelle Nutzer auswählen können.

Wenn availableModels gesetzt ist, können Nutzer nicht zu Modellen außerhalb dieser Liste wechseln via /model, --model Flag, Config Tool oder ANTHROPIC_MODEL Umgebungsvariable.

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

Standard-Modell unaffected

Die Default-Option im Modell-Picker ist NICHT affektiert von availableModels. Sie bleibt immer verfügbar und repräsentiert das System-Runtime-Default basierend auf Abonnement-Tier.

Selbst mit availableModels: [] können Nutzer Claude Code mit dem Default-Modell ihres Tiers nutzen.

Kontrolliere Modell-Erlebnis

Um volle Kontrolle über das Modell-Erlebnis zu haben, nutze availableModels zusammen mit dem model Setting:

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

Dies stellt sicher dass alle Nutzer Sonnet 4.6 nutzen und nur zwischen Sonnet und Haiku wählen können.

Effort Level (Reasoning Level)

Adaptive Reasoning allokiert Thinking-Tokens basierend auf Task-Komplexität. Drei Levels persistieren über Sessions, ein vierter Level max ist Einmal-Nutzung.

Drei persistente Levels

Max Level (Einmal)

Effort setzen

# In Session
/effort low
/effort medium
/effort high
/effort max       # nur Opus 4.6
/effort auto      # zurücksetzen zu Modell-Standard

# CLI Flag
claude --effort medium

# Umgebungsvariable (Vorrang vor allen anderen)
export CLAUDE_CODE_EFFORT_LEVEL=high

# settings.json
{
  "effortLevel": "high"
}

# Skill/Subagent Frontmatter
---
effort: high
---

Precedence (Reihenfolge)

1. Umgebungsvariable CLAUDE_CODE_EFFORT_LEVEL (höchst)
2. Session-konfiguriertes Level
3. Modell-Standard (niedrigst)

Frontmatter Effort in Skills/Subagents überschreibt Session-Level aber NICHT die Umgebungsvariable.

Verfügbarkeit: Opus 4.6 und Sonnet 4.6. Haiku und ältere Modelle unterstützen kein adaptives Reasoning.

Deaktivieren: Setze CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 um adaptives Reasoning zu deaktivieren und zum fixen Budget zurückzukehren (kontrolliert durch MAX_THINKING_TOKENS).

Extended Context (1M Token)

Opus 4.6 und Sonnet 4.6 unterstützen ein 1M-Token Context-Fenster für lange Sessions mit großen Codebases.

Verfügbarkeit nach Plan

Verwendung

# /model command
/model opus[1m]
/model sonnet[1m]

# CLI
claude --model opus[1m]

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

# settings.json
{
  "model": "opus[1m]"
}

Pricing

Keine Premium für Tokens über 200K. Für Plans mit included Extended Context bleibt Nutzung covered. Für Plans mit Extra Usage werden Tokens an Extra Usage berechnet.

Deaktivieren

export CLAUDE_CODE_DISABLE_1M_CONTEXT=1

Dies entfernt 1M-Model-Varianten aus dem Model-Picker.

Default Modell Verhalten

Das Verhalten von default hängt von deinem Konto-Typ ab:

Claude Code kann automatisch zu Sonnet fallback wenn du Usage-Limit mit Opus erreichst.

opusplan Special Mode

Der opusplan Alias bietet eine automatisierte Hybrid-Herangehensweise:

Dies gibt dir das Beste aus beiden: Opus Reasoning und Sonnet Effizienz.

Aktuelles Modell prüfen

Sieh welches Modell du aktuell nutzt in mehreren Wegen:

1. In Status-Linie (falls konfiguriert)
2. In /status — zeigt auch Account-Informationen

Benutzerdefiniertes Modell hinzufügen

Nutze ANTHROPIC_CUSTOM_MODEL_OPTION um einen benutzerdefinierten Eintrag zum /model Picker zu ergänzen ohne eingebaute Aliases zu ersetzen. Nützlich für LLM-Gateway-Deployments oder Testing.

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

Der benutzerdefinierte Eintrag erscheint unten im /model Picker. ANTHROPIC_CUSTOM_MODEL_OPTION_NAME und Beschreibung sind optional. Wenn weggelassen wird die Model-ID als Name verwendet.

Claude Code skipped Validierung für die Model-ID in ANTHROPIC_CUSTOM_MODEL_OPTION, daher kannst du jeden String verwenden den dein API-Endpoint akzeptiert.

Prompt Caching Konfiguration

Claude Code nutzt automatisch Prompt Caching zur Performance-Optimierung und Kostenreduktion. Du kannst es global oder pro Modell-Tier deaktivieren:

Diese Variables geben dir fein-granulierte Kontrolle. Die globale DISABLE_PROMPT_CACHING hat Vorrang über Modell-spezifische Einstellungen.

Modell-Umgebungsvariablen

Diese müssen vollständige Modellnamen sein (oder Equivalent für deinen Provider):

Deprecated: ANTHROPIC_SMALL_FAST_MODEL — nutze stattdessen ANTHROPIC_DEFAULT_HAIKU_MODEL.

Modelle für Third-Party Deployments festigen

Bei Deployment über Bedrock, Vertex AI, oder Foundry, festige Modell-Versionen bevor du zu Nutzern rollst.

Ohne Festigung verwendet Claude Code Model-Aliases die zur neuesten Version auflösen. Wenn Anthropic ein neues Modell released, werden Nutzer deren Accounts die neue Version nicht haben, silently brechen.

Setze alle drei Model-Umgebungsvariablen zu spezifischen Version-IDs als Teil deiner initialen Setup:

Wende das gleiche Pattern auf ANTHROPIC_DEFAULT_SONNET_MODEL und ANTHROPIC_DEFAULT_HAIKU_MODEL an. Für aktuelle Modell-IDs über alle Provider siehe Models Overview.

Um Nutzer zu einer neuen Modell-Version zu upgraden, update diese Umgebungsvariablen und redeploy.

Extended Context zu festgelegten Modellen

Um Extended Context für ein festgelegtes Modell zu aktivieren, append [1m] zur Model-ID:

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

Claude Code entfernt das [1m] Suffix bevor die Model-ID zu deinem Provider gesendet wird. Append [1m] nur wenn das zugrundeliegende Modell 1M-Context unterstützt (z.B. Opus 4.6, Sonnet 4.6).

modelOverrides pro Provider

Die Family-Level Umgebungsvariablen oben konfigurieren eine Model-ID pro Familie. Falls du mehrere Versionen within der gleichen Familie zu unterschiedlichen Provider-IDs mappen musst, nutze das modelOverrides Setting stattdessen.

modelOverrides mappt individuelle Anthropic Model-IDs zu provider-spezifischen Strings die Claude Code an deine Provider API sendet. Wenn ein Nutzer ein gemapptes Modell im /model Picker auswählt, nutzt Claude Code deinen konfigurierten Wert statt des Built-In Standards.

Dies ermöglicht Enterprise-Administratoren, jede Modell-Version zu einer spezifischen Bedrock Inference Profile ARN, Vertex AI Version-Name, oder Foundry Deployment-Name zu routen für Governance, Cost-Allokation oder regionales Routing.

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

Keys müssen Anthropic Model-IDs sein wie in der Models Overview gelistet. Für datierte Model-IDs, include das Date-Suffix genau wie es dort erscheint.

Siehe auch

• Claude Code Umgebungsvariablen
• Claude Code Settings
• Claude Code Performance

Quellen und Links

• Model Configuration
• Official Claude Code Documentation
• CLI Reference
• GitHub (Anthropic)
• Anthropic SDK Python
• Anthropic SDK TypeScript
• Claude Code Docs Index