Cette page fournit des conseils sur la migration des modèles Claude 3.7 vers les modèles Claude 4 (Opus 4 et Sonnet 4).

Dans la plupart des cas, vous pouvez passer aux modèles Claude 4 avec des changements minimes :

  1. Mettez à jour le nom de votre modèle :

    • De : claude-3-7-sonnet-20250219
    • À : claude-sonnet-4-20250514 ou claude-opus-4-20250514
  2. Les appels API existants devraient continuer à fonctionner sans modification, bien que le comportement de l’API ait légèrement changé dans les modèles Claude 4 (voir les notes de version de l’API pour plus de détails).

Nouveautés de Claude 4

Nouvelle raison d’arrêt pour refus

Les modèles Claude 4 introduisent une nouvelle raison d’arrêt refusal pour le contenu que le modèle refuse de générer pour des raisons de sécurité, en raison de l’intelligence accrue des modèles Claude 4 :

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

Lors de la migration vers Claude 4, vous devriez mettre à jour votre application pour gérer les raisons d’arrêt refusal.

Réflexion résumée

Avec la réflexion étendue activée, l’API Messages pour les modèles Claude 4 renvoie un résumé du processus de réflexion complet de Claude. La réflexion résumée offre tous les avantages intellectuels de la réflexion étendue, tout en empêchant les utilisations abusives.

Bien que l’API soit cohérente entre les modèles Claude 3.7 et 4, les réponses en streaming pour la réflexion étendue peuvent être livrées selon un modèle “par blocs”, avec des délais possibles entre les événements de streaming.

La synthèse est traitée par un modèle différent de celui que vous ciblez dans vos requêtes. Le modèle de réflexion ne voit pas la sortie résumée.

Pour plus d’informations, consultez la documentation sur la réflexion étendue.

Réflexion entrelacée

Les modèles Claude 4 prennent en charge l’entrelacement de l’utilisation d’outils avec la réflexion étendue, permettant des conversations plus naturelles où les utilisations d’outils et les réponses peuvent être mélangées avec des messages réguliers.

La réflexion entrelacée est en version bêta. Pour activer la réflexion entrelacée, ajoutez l’en-tête bêta interleaved-thinking-2025-05-14 à votre requête API.

Pour plus d’informations, consultez la documentation sur la réflexion étendue.

Outil d’éditeur de texte mis à jour

L’outil d’éditeur de texte a été mis à jour pour les modèles Claude 4 avec les changements suivants :

  • Type d’outil : text_editor_20250429
  • Nom de l’outil : str_replace_based_edit_tool
  • La commande undo_edit n’est plus prise en charge dans les modèles Claude 4.

L’outil d’éditeur de texte str_replace_editor reste le même pour Claude Sonnet 3.7.

Si vous migrez depuis Claude Sonnet 3.7 et utilisez l’outil d’éditeur de texte :

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

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

Pour plus d’informations, consultez la documentation de l’outil d’éditeur de texte.

Utilisation d’outils économe en tokens non prise en charge

L’utilisation d’outils économe en tokens est uniquement disponible dans Claude Sonnet 3.7.

Si vous migrez depuis Claude Sonnet 3.7 et utilisez l’utilisation d’outils économe en tokens, nous vous recommandons de supprimer l’en-tête bêta token-efficient-tools-2025-02-19 de vos requêtes.

L’en-tête bêta token-efficient-tools-2025-02-19 peut toujours être inclus dans les requêtes Claude 4, mais il n’aura aucun effet.

Sortie étendue non prise en charge

L’en-tête bêta output-128k-2025-02-19 pour la sortie étendue est uniquement disponible dans Claude Sonnet 3.7.

Si vous migrez depuis Claude Sonnet 3.7, nous vous recommandons de supprimer output-128k-2025-02-19 de vos requêtes.

L’en-tête bêta output-128k-2025-02-19 peut toujours être inclus dans les requêtes Claude 4, mais il n’aura aucun effet.

Considérations de performance

Claude Sonnet 4

  • Capacités de raisonnement et d’intelligence améliorées par rapport à Claude Sonnet 3.7
  • Précision accrue dans l’utilisation des outils

Claude Opus 4

  • Modèle le plus performant avec un raisonnement et une intelligence supérieurs
  • Plus lent que les modèles Sonnet
  • Idéal pour les tâches complexes nécessitant une analyse approfondie

Liste de contrôle pour la migration

  • Mettre à jour l’identifiant du modèle dans vos appels API
  • Tester les requêtes existantes (devraient fonctionner sans changements)
  • Supprimer l’en-tête bêta token-efficient-tools-2025-02-19 si applicable
  • Supprimer l’en-tête bêta output-128k-2025-02-19 si applicable
  • Gérer la nouvelle raison d’arrêt refusal
  • Mettre à jour le type et le nom de l’outil d’éditeur de texte si vous l’utilisez
  • Supprimer tout code qui utilise la commande undo_edit
  • Explorer les nouvelles capacités d’entrelacement d’outils avec la réflexion étendue
  • Consulter les meilleures pratiques d’ingénierie de prompt pour Claude 4 pour des résultats optimaux
  • Tester en développement avant le déploiement en production

Besoin d’aide ?