Migration vers Claude 4

Cette page fournit des conseils pour migrer 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 modifications minimales :

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

   • De : claude-3-7-sonnet-20250219
   • Vers : 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 notes de version de l’API pour plus de détails).

​

Nouveautés dans Claude 4

​

Nouvelle raison d’arrêt de 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 fournit tous les avantages d’intelligence de la réflexion étendue, tout en prévenant les abus.

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 renvoyées selon un modèle de livraison “par blocs”, avec des délais possibles entre les événements de streaming.

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.

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

​

Outil d’édition de texte mis à jour

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

• Type d’outil : text_editor_20250728
• 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.

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

# 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"
    }
]

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

​

Utilisation d’outils économe en jetons plus prise en charge

L’utilisation d’outils économe en jetons n’est disponible que dans Claude Sonnet 3.7.

Si vous migrez depuis Claude Sonnet 3.7 et utilisez l’utilisation d’outils économe en jetons, nous 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 plus prise en charge

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

Si vous migrez depuis Claude Sonnet 3.7, nous 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 d’utilisation d’outils renforcée

​

Claude Opus 4

• Modèle le plus capable 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 vérification de migration

• Mettre à jour l’id 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’édition 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 Claude 4 pour des résultats optimaux
• Tester en développement avant le déploiement en production

​

Besoin d’aide ?

• Consultez notre documentation API pour les spécifications détaillées.
• Consultez les capacités des modèles pour les comparaisons de performance.
• Consultez les notes de version de l’API pour les mises à jour de l’API.
• Contactez le support si vous rencontrez des problèmes lors de la migration.