Migrationsleitfaden

Migration zu Claude 4.6

Claude Opus 4.6 ist ein nahezu direkter Ersatz für Claude 4.5 mit einigen Breaking Changes, auf die Sie achten sollten. Eine vollständige Liste der neuen Funktionen finden Sie unter What's new in Claude 4.6.

Aktualisieren Sie Ihren Modellnamen

# Opus-Migration
model="claude-opus-4-5"     # Vorher
model="claude-opus-4-6"       # Nachher

Breaking Changes

Prefill-Entfernung: Das Prefilling von Assistenten-Nachrichten gibt einen 400-Fehler bei Claude 4.6-Modellen zurück. Verwenden Sie stattdessen structured outputs, Systemaufforderungs-Anweisungen oder output_config.format.
Tool-Parameter-Anführungszeichen: Claude 4.6-Modelle können leicht unterschiedliche JSON-String-Escaping in Tool-Call-Argumenten erzeugen (z. B. unterschiedliche Behandlung von Unicode-Escapes oder Forward-Slash-Escaping). Wenn Sie Tool-Call-input als rohe Zeichenkette analysieren, anstatt einen JSON-Parser zu verwenden, überprüfen Sie Ihre Parsing-Logik. Standard-JSON-Parser (wie json.loads() oder JSON.parse()) handhaben diese Unterschiede automatisch.

Empfohlene Änderungen

Diese sind nicht erforderlich, verbessern aber Ihre Erfahrung:

Migration zu adaptivem Denken: thinking: {type: "enabled", budget_tokens: N} ist bei Claude 4.6-Modellen veraltet und wird in einer zukünftigen Modellversion entfernt. Wechseln Sie zu thinking: {type: "adaptive"} und verwenden Sie den effort-Parameter, um die Denktiefe zu steuern. Siehe Adaptive thinking.

Migration von Claude 4.1 oder früher zu Claude 4.6

Wenn Sie von Opus 4.1, Sonnet 4 oder früheren Modellen direkt zu Claude 4.6 migrieren, wenden Sie die Claude 4.6 Breaking Changes oben plus die zusätzlichen Änderungen in diesem Abschnitt an.

# Von Opus 4.1
model="claude-opus-4-1-20250805"    # Vorher
model="claude-opus-4-6"               # Nachher

# Von Sonnet 4
model="claude-sonnet-4-20250514"    # Vorher
model="claude-opus-4-6"              # Nachher

# Von Sonnet 3.7
model="claude-3-7-sonnet-20250219"  # Vorher
model="claude-opus-4-6"              # Nachher

Zusätzliche Breaking Changes

Sampling-Parameter

Dies ist ein Breaking Change von Claude 3.x-Modellen.

Verwenden Sie nur temperature ODER top_p, nicht beide:

# Vorher - Dies führt zu einem Fehler in Claude 4+-Modellen
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Kann nicht beide verwenden
    ...
)

# Nachher
response = client.messages.create(
    model="claude-opus-4-6",
    temperature=0.7,  # Verwenden Sie temperature ODER top_p, nicht beide
    ...
)

Zusätzliche empfohlene Änderungen

Entfernen Sie Legacy-Beta-Header: Entfernen Sie token-efficient-tools-2025-02-19 und output-128k-2025-02-19 — alle Claude 4+-Modelle haben integrierte Token-effiziente Tool-Nutzung und diese Header haben keine Auswirkung.

Claude 4.6 Migrations-Checkliste

Aktualisieren Sie die Modell-ID auf claude-opus-4-6
BREAKING: Entfernen Sie Assistenten-Nachricht-Prefills (gibt 400-Fehler zurück); verwenden Sie stattdessen strukturierte Ausgaben oder output_config.format
Empfohlen: Migrieren Sie von thinking: {type: "enabled", budget_tokens: N} zu thinking: {type: "adaptive"} mit dem effort-Parameter (budget_tokens ist veraltet und wird in einer zukünftigen Version entfernt)
Überprüfen Sie, dass Tool-Call-JSON-Parsing einen Standard-JSON-Parser verwendet
Entfernen Sie effort-2025-11-24 Beta-Header (Effort ist jetzt GA)
Entfernen Sie fine-grained-tool-streaming-2025-05-14 Beta-Header

Migration zu Claude Sonnet 4.5

Claude Sonnet 4.5 kombiniert starke Intelligenz mit schneller Leistung und ist ideal für alltägliche Codierung, Analyse und Content-Aufgaben.

Eine vollständige Übersicht der Funktionen finden Sie unter models overview.

Die Preisgestaltung für Sonnet 4.5 beträgt $3 pro Million Input-Token, $15 pro Million Output-Token. Siehe Claude pricing für Details.

Aktualisieren Sie Ihren Modellnamen:

# Von Sonnet 4
model="claude-sonnet-4-20250514"        # Vorher
model="claude-sonnet-4-5-20250929"      # Nachher

# Von Sonnet 3.7
model="claude-3-7-sonnet-20250219"      # Vorher
model="claude-sonnet-4-5-20250929"      # Nachher

Erwägen Sie die Aktivierung von Extended Thinking für erhebliche Leistungsverbesserungen bei Codierungs- und Reasoning-Aufgaben (standardmäßig deaktiviert):

response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)

Breaking Changes

Diese Breaking Changes gelten bei der Migration von Claude 3.x Sonnet-Modellen.

Sampling-Parameter

Dies ist ein Breaking Change von Claude 3.x-Modellen.

Verwenden Sie nur temperature ODER top_p, nicht beide.
Tool-Versionen

Dies ist ein Breaking Change von Claude 3.x-Modellen.

Aktualisieren Sie auf die neuesten Tool-Versionen (text_editor_20250728, code_execution_20250825). Entfernen Sie jeden Code, der den undo_edit-Befehl verwendet.
Behandeln Sie den refusal Stop-Grund

Aktualisieren Sie Ihre Anwendung, um refusal Stop-Gründe zu behandeln.
Aktualisieren Sie Ihre Prompts für Verhaltensänderungen

Sonnet 4.5 Migrations-Checkliste

Aktualisieren Sie die Modell-ID auf claude-sonnet-4-5-20250929
BREAKING: Aktualisieren Sie Tool-Versionen auf die neuesten (text_editor_20250728, code_execution_20250825) — Legacy-Versionen werden nicht unterstützt (falls Migration von 3.x)
BREAKING: Entfernen Sie jeden Code, der den undo_edit-Befehl verwendet (falls zutreffend)
BREAKING: Aktualisieren Sie Sampling-Parameter, um nur temperature ODER top_p zu verwenden, nicht beide (falls Migration von 3.x)
Behandeln Sie neuen refusal Stop-Grund in Ihrer Anwendung
Überprüfen und aktualisieren Sie Prompts nach prompting best practices

Migration zu Claude Haiku 4.5

Claude Haiku 4.5 ist unser schnellstes und intelligentestes Haiku-Modell mit nahezu Frontier-Leistung und bietet Premium-Modellqualität für interaktive Anwendungen und Hochvolumen-Verarbeitung.

Eine vollständige Übersicht der Funktionen finden Sie unter models overview.

Die Preisgestaltung für Haiku 4.5 beträgt $1 pro Million Input-Token, $5 pro Million Output-Token. Siehe Claude pricing für Details.

Aktualisieren Sie Ihren Modellnamen:

# Von Haiku 3.5
model="claude-3-5-haiku-20241022"      # Vorher
model="claude-haiku-4-5-20251001"      # Nachher

Überprüfen Sie neue Rate Limits: Haiku 4.5 hat separate Rate Limits von Haiku 3.5. Siehe Rate limits documentation für Details.

Erwägen Sie die Aktivierung von Extended Thinking für erhebliche Leistungsverbesserungen bei Codierungs- und Reasoning-Aufgaben (standardmäßig deaktiviert):

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)

Extended Thinking beeinflusst die prompt caching Effizienz.

Erkunden Sie neue Funktionen: Siehe models overview für Details zu Kontextbewusstsein, erhöhter Ausgabekapazität (64K Token), höherer Intelligenz und verbesserter Geschwindigkeit.

Breaking Changes

Diese Breaking Changes gelten bei der Migration von Claude 3.x Haiku-Modellen.

Sampling-Parameter

Dies ist ein Breaking Change von Claude 3.x-Modellen.

Verwenden Sie nur temperature ODER top_p, nicht beide.
Tool-Versionen

Dies ist ein Breaking Change von Claude 3.x-Modellen.

Aktualisieren Sie auf die neuesten Tool-Versionen (text_editor_20250728, code_execution_20250825). Entfernen Sie jeden Code, der den undo_edit-Befehl verwendet.
Behandeln Sie den refusal Stop-Grund

Aktualisieren Sie Ihre Anwendung, um refusal Stop-Gründe zu behandeln.
Aktualisieren Sie Ihre Prompts für Verhaltensänderungen

Haiku 4.5 Migrations-Checkliste

Aktualisieren Sie die Modell-ID auf claude-haiku-4-5-20251001
BREAKING: Aktualisieren Sie Tool-Versionen auf die neuesten (text_editor_20250728, code_execution_20250825) — Legacy-Versionen werden nicht unterstützt
BREAKING: Entfernen Sie jeden Code, der den undo_edit-Befehl verwendet (falls zutreffend)
BREAKING: Aktualisieren Sie Sampling-Parameter, um nur temperature ODER top_p zu verwenden, nicht beide
Behandeln Sie neuen refusal Stop-Grund in Ihrer Anwendung
Überprüfen und passen Sie sich an neue Rate Limits an (getrennt von Haiku 3.5)
Überprüfen und aktualisieren Sie Prompts nach

Benötigen Sie Hilfe?

Überprüfen Sie unsere API documentation für detaillierte Spezifikationen
Überprüfen Sie model capabilities für Leistungsvergleiche
Überprüfen Sie API release notes für API-Updates
Kontaktieren Sie den Support, wenn Sie während der Migration auf Probleme stoßen

response = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 32000
    },
    betas=["interleaved-thinking-2025-05-14"],
    messages=[...]
)

Tool-Versionen

Dies ist ein Breaking Change von Claude 3.x-Modellen.

Aktualisieren Sie auf die neuesten Tool-Versionen. Entfernen Sie jeden Code, der den undo_edit-Befehl verwendet.

# Vorher
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Nachher
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

Text-Editor: Verwenden Sie text_editor_20250728 und str_replace_based_edit_tool. Siehe Text editor tool documentation für Details.
Code-Ausführung: Aktualisieren Sie auf code_execution_20250825. Siehe Code execution tool documentation für Migrationsanweisungen.

Behandeln Sie den refusal Stop-Grund

Aktualisieren Sie Ihre Anwendung, um refusal Stop-Gründe zu behandeln:

response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Behandeln Sie die Ablehnung angemessen
    pass

Behandeln Sie den model_context_window_exceeded Stop-Grund

Claude 4.5+-Modelle geben einen model_context_window_exceeded Stop-Grund zurück, wenn die Generierung aufgrund des Erreichens des Kontextfenster-Limits stoppt, anstatt des angeforderten max_tokens-Limits. Aktualisieren Sie Ihre Anwendung, um diesen neuen Stop-Grund zu behandeln:

response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # Behandeln Sie das Kontextfenster-Limit angemessen
    pass