Diese Seite bietet Anleitungen für die Migration von Claude 3.7 Modellen zu Claude 4 Modellen (Opus 4 und Sonnet 4).

In den meisten Fällen können Sie zu Claude 4 Modellen mit minimalen Änderungen wechseln:

  1. Aktualisieren Sie Ihren Modellnamen:

    • Von: claude-3-7-sonnet-20250219
    • Zu: claude-sonnet-4-20250514 oder claude-opus-4-20250514

  2. Bestehende API-Aufrufe sollten weiterhin ohne Änderungen funktionieren, obwohl sich das API-Verhalten bei Claude 4 Modellen leicht geändert hat (siehe API-Versionshinweise für Details).

​
Was ist neu in Claude 4

​
Neuer Ablehnungs-Stopp-Grund

Claude 4 Modelle führen einen neuen refusal Stopp-Grund für Inhalte ein, die das Modell aus Sicherheitsgründen ablehnt zu generieren, aufgrund der erhöhten Intelligenz der Claude 4 Modelle:

{"id":"msg_014XEDjypDjFzgKVWdFUXxZP",
"type":"message",
"role":"assistant",
"model":"claude-sonnet-4-20250514",
"content":[{"type":"text","text":"I would be happy to assist you. You can "}],
"stop_reason":"refusal",
"stop_sequence":null,
"usage":{"input_tokens":564,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":22}
}

Bei der Migration zu Claude 4 sollten Sie Ihre Anwendung aktualisieren, um refusal Stopp-Gründe zu behandeln.

​
Zusammengefasstes Denken

Mit aktiviertem erweiterten Denken gibt die Messages API für Claude 4 Modelle eine Zusammenfassung von Claudes vollständigem Denkprozess zurück. Zusammengefasstes Denken bietet die vollen Intelligenzvorteile des erweiterten Denkens und verhindert gleichzeitig Missbrauch.

Während die API bei Claude 3.7 und 4 Modellen konsistent ist, können Streaming-Antworten für erweitertes Denken in einem “stückweisen” Liefermuster zurückkehren, mit möglichen Verzögerungen zwischen Streaming-Ereignissen.

Die Zusammenfassung wird von einem anderen Modell verarbeitet als dem, das Sie in Ihren Anfragen anvisieren. Das Denkmodell sieht die zusammengefasste Ausgabe nicht.

Für weitere Informationen siehe die Dokumentation zum erweiterten Denken.

​
Verschachteltes Denken

Claude 4 Modelle unterstützen die Verschachtelung von Tool-Verwendung mit erweitertem Denken, was natürlichere Gespräche ermöglicht, bei denen Tool-Verwendungen und Antworten mit regulären Nachrichten gemischt werden können.

Verschachteltes Denken befindet sich in der Beta-Phase. Um verschachteltes Denken zu aktivieren, fügen Sie den Beta-Header interleaved-thinking-2025-05-14 zu Ihrer API-Anfrage hinzu.

Für weitere Informationen siehe die Dokumentation zum erweiterten Denken.

​
Aktualisiertes Texteditor-Tool

Das Texteditor-Tool wurde für Claude 4 Modelle mit den folgenden Änderungen aktualisiert:

  • Tool-Typ: text_editor_20250728
  • Tool-Name: str_replace_based_edit_tool
  • Der undo_edit Befehl wird in Claude 4 Modellen nicht mehr unterstützt.

Das str_replace_editor Texteditor-Tool bleibt für Claude Sonnet 3.7 unverändert.

Wenn Sie von Claude Sonnet 3.7 migrieren und das Texteditor-Tool verwenden:

# Claude Sonnet 3.7
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

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

Für weitere Informationen siehe die Dokumentation zum Texteditor-Tool.

​
Token-effiziente Tool-Verwendung nicht mehr unterstützt

Token-effiziente Tool-Verwendung ist nur in Claude Sonnet 3.7 verfügbar.

Wenn Sie von Claude Sonnet 3.7 migrieren und token-effiziente Tool-Verwendung nutzen, empfehlen wir, den token-efficient-tools-2025-02-19 Beta-Header aus Ihren Anfragen zu entfernen.

Der token-efficient-tools-2025-02-19 Beta-Header kann weiterhin in Claude 4 Anfragen enthalten sein, hat aber keine Wirkung.

​
Erweiterte Ausgabe nicht mehr unterstützt

Der output-128k-2025-02-19 Beta-Header für erweiterte Ausgabe ist nur in Claude Sonnet 3.7 verfügbar.

Wenn Sie von Claude Sonnet 3.7 migrieren, empfehlen wir, output-128k-2025-02-19 aus Ihren Anfragen zu entfernen.

Der output-128k-2025-02-19 Beta-Header kann weiterhin in Claude 4 Anfragen enthalten sein, hat aber keine Wirkung.

​
Leistungsüberlegungen

​
Claude Sonnet 4

  • Verbesserte Reasoning- und Intelligenzfähigkeiten im Vergleich zu Claude Sonnet 3.7
  • Erhöhte Tool-Verwendungsgenauigkeit

​
Claude Opus 4

  • Leistungsfähigstes Modell mit überlegener Reasoning- und Intelligenz
  • Langsamer als Sonnet-Modelle
  • Am besten für komplexe Aufgaben, die tiefe Analyse erfordern

​
Migrations-Checkliste

  • Modell-ID in Ihren API-Aufrufen aktualisieren
  • Bestehende Anfragen testen (sollten ohne Änderungen funktionieren)
  • token-efficient-tools-2025-02-19 Beta-Header entfernen, falls zutreffend
  • output-128k-2025-02-19 Beta-Header entfernen, falls zutreffend
  • Neuen refusal Stopp-Grund behandeln
  • Texteditor-Tool-Typ und -Name aktualisieren, falls verwendet
  • Code entfernen, der den undo_edit Befehl verwendet
  • Neue Tool-Verschachtelungsfähigkeiten mit erweitertem Denken erkunden
  • Claude 4 Prompt-Engineering-Best-Practices für optimale Ergebnisse überprüfen
  • In der Entwicklung testen vor Produktionsbereitstellung

​
Benötigen Sie Hilfe?

  • Überprüfen Sie unsere API-Dokumentation für detaillierte Spezifikationen.
  • Überprüfen Sie Modellfähigkeiten für Leistungsvergleiche.
  • Überprüfen Sie API-Versionshinweise für API-Updates.
  • Kontaktieren Sie den Support, wenn Sie während der Migration auf Probleme stoßen.