Ce guide couvre deux chemins de migration clés vers les modèles Claude 4.5 :
  • Claude Sonnet 3.7 → Claude Sonnet 4.5 : Notre modèle le plus intelligent avec des capacités de raisonnement, de codage et d’agents autonomes de longue durée de classe mondiale
  • Claude Haiku 3.5 → Claude Haiku 4.5 : Notre modèle Haiku le plus rapide et le plus intelligent avec des performances quasi-frontières pour les applications en temps réel et le traitement intelligent à haut volume
Les deux migrations impliquent des changements critiques qui nécessitent des mises à jour de votre implémentation. Ce guide vous accompagnera à travers chaque chemin de migration avec des instructions étape par étape et des changements critiques clairement marqués. Avant de commencer votre migration, nous recommandons de consulter Nouveautés dans Claude 4.5 pour comprendre les nouvelles fonctionnalités et capacités disponibles dans ces modèles, y compris la réflexion étendue, la conscience contextuelle et les améliorations comportementales.

​
Migration de Claude Sonnet 3.7 vers Claude Sonnet 4.5

Claude Sonnet 4.5 est notre modèle le plus intelligent, offrant des performances de classe mondiale pour le raisonnement, le codage et les agents autonomes de longue durée. Cette migration inclut plusieurs changements critiques qui nécessitent des mises à jour de votre implémentation.

​
Étapes de migration

  1. Mettez à jour le nom de votre modèle : 
    # Avant (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"

# Après (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
  2. Mettez à jour les paramètres d’échantillonnage
    Il s’agit d’un changement critique par rapport à Claude Sonnet 3.7.
    Utilisez uniquement temperature OU top_p, pas les deux : 
    # Avant (Claude Sonnet 3.7) - Ceci causera une erreur dans Sonnet 4.5
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Ne peut pas utiliser les deux
    ...
)

# Après (Claude Sonnet 4.5)
response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    temperature=0.7,  # Utilisez temperature OU top_p, pas les deux
    ...
)
  3. Gérez la nouvelle raison d’arrêt refusal Mettez à jour votre application pour gérer les raisons d’arrêt refusal : 
    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Gérez le refus de manière appropriée
    pass
  4. Mettez à jour l’outil d’édition de texte (si applicable)
    Il s’agit d’un changement critique par rapport à Claude Sonnet 3.7.
    Mettez à jour vers text_editor_20250728 (type) et str_replace_based_edit_tool (nom). Supprimez tout code utilisant la commande undo_edit. 
    # Avant (Claude Sonnet 3.7)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Après (Claude Sonnet 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    Voir Documentation de l’outil d’édition de texte pour les détails.
  5. Mettez à jour l’outil d’exécution de code (si applicable) Mettez à niveau vers code_execution_20250825. La version héritée code_execution_20250522 fonctionne encore mais n’est pas recommandée. Voir Documentation de l’outil d’exécution de code pour les instructions de migration.
  6. Supprimez l’en-tête bêta d’utilisation d’outils efficace en jetons L’utilisation d’outils efficace en jetons est une fonctionnalité bêta dans Claude 3.7. Tous les modèles Claude 4 ont une utilisation d’outils efficace en jetons intégrée, vous ne devriez donc plus inclure l’en-tête bêta. Supprimez l’en-tête bêta token-efficient-tools-2025-02-19 de vos requêtes : 
    # Avant (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["token-efficient-tools-2025-02-19"],  # Supprimez ceci
    ...
)

# Après (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Pas d'en-tête bêta token-efficient-tools
    ...
)
  7. Supprimez l’en-tête bêta de sortie étendue L’en-tête bêta output-128k-2025-02-19 pour la sortie étendue n’est disponible que dans Claude Sonnet 3.7. Supprimez cet en-tête de vos requêtes : 
    # Avant (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["output-128k-2025-02-19"],  # Supprimez ceci
    ...
)

# Après (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Pas d'en-tête bêta output-128k
    ...
)
  8. Mettez à jour vos prompts pour les changements comportementaux Claude Sonnet 4.5 a un style de communication plus concis et direct et nécessite une direction explicite. Consultez Meilleures pratiques d’ingénierie de prompts Claude 4 pour des conseils d’optimisation.
  9. Considérez l’activation de la réflexion étendue pour les tâches complexes Activez la réflexion étendue pour des améliorations significatives des performances sur les tâches de codage et de raisonnement (désactivée par défaut) : 
    response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)
    La réflexion étendue impacte l’efficacité de la mise en cache de prompts.
  10. Testez votre implémentation
Testez dans un environnement de développement avant de déployer en production pour vous assurer que tous les changements critiques sont correctement gérés.

​
Liste de vérification de migration Sonnet 3.7 → 4.5

  • Mettre à jour l’ID du modèle vers claude-sonnet-4-5-20250929
  • CRITIQUE : Mettre à jour les paramètres d’échantillonnage pour utiliser uniquement temperature OU top_p, pas les deux
  • Gérer la nouvelle raison d’arrêt refusal dans votre application
  • CRITIQUE : Mettre à jour l’outil d’édition de texte vers text_editor_20250728 et str_replace_based_edit_tool (si applicable)
  • CRITIQUE : Supprimer tout code utilisant la commande undo_edit (si applicable)
  • Mettre à jour l’outil d’exécution de code vers code_execution_20250825 (si applicable)
  • 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)
  • Réviser et mettre à jour les prompts en suivant les meilleures pratiques Claude 4
  • Considérer l’activation de la réflexion étendue pour les tâches de raisonnement complexes
  • Gérer la raison d’arrêt model_context_window_exceeded (spécifique à Sonnet 4.5)
  • Considérer l’activation de l’outil mémoire pour les agents de longue durée (bêta)
  • Considérer l’utilisation de l’effacement automatique d’appels d’outils pour l’édition de contexte (bêta)
  • Tester dans l’environnement de développement avant le déploiement en production

​
Fonctionnalités supprimées de Claude Sonnet 3.7

  • Utilisation d’outils efficace en jetons : L’en-tête bêta token-efficient-tools-2025-02-19 n’est pas pris en charge (voir étape 6)
  • Sortie étendue : L’en-tête bêta output-128k-2025-02-19 n’est pas pris en charge (voir étape 7)
Les deux en-têtes peuvent être inclus dans les requêtes mais n’auront aucun effet.

​
Migration de Claude Haiku 3.5 vers Claude Haiku 4.5

Claude Haiku 4.5 est notre modèle Haiku le plus rapide et le plus intelligent avec des performances quasi-frontières, offrant une qualité de modèle premium avec des performances en temps réel pour les applications interactives et le traitement intelligent à haut volume. Cette migration inclut plusieurs changements critiques qui nécessitent des mises à jour de votre implémentation. Pour un aperçu complet des nouvelles capacités, voir Nouveautés dans Claude 4.5.
Tarification Haiku 4.5 : 1 parmilliondejetonsd′entreˊe,5par million de jetons d'entrée, 5 par million de jetons de sortie. Voir Tarification Claude pour les détails.

​
Étapes de migration

  1. Mettez à jour le nom de votre modèle : 
    # Avant (Haiku 3.5)
model="claude-3-5-haiku-20241022"

# Après (Haiku 4.5)
model="claude-haiku-4-5-20251001"
  2. Mettez à jour les versions d’outils (si applicable)
    Il s’agit d’un changement critique par rapport à Claude Haiku 3.5.
    Haiku 4.5 ne prend en charge que les dernières versions d’outils : 
    # Avant (Haiku 3.5)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Après (Haiku 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    • Éditeur de texte : Utilisez text_editor_20250728 et str_replace_based_edit_tool
    • Exécution de code : Utilisez code_execution_20250825
    • Supprimez tout code utilisant la commande undo_edit
  3. Mettez à jour les paramètres d’échantillonnage
    Il s’agit d’un changement critique par rapport à Claude Haiku 3.5.
    Utilisez uniquement temperature OU top_p, pas les deux : 
    # Avant (Haiku 3.5) - Ceci causera une erreur dans Haiku 4.5
response = client.messages.create(
    model="claude-3-5-haiku-20241022",
    temperature=0.7,
    top_p=0.9,  # Ne peut pas utiliser les deux
    ...
)

# Après (Haiku 4.5)
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    temperature=0.7,  # Utilisez temperature OU top_p, pas les deux
    ...
)
  4. Révisez les nouvelles limites de taux Haiku 4.5 a des limites de taux séparées de Haiku 3.5. Voir Documentation des limites de taux pour les détails.
  5. Gérez la nouvelle raison d’arrêt refusal Mettez à jour votre application pour gérer les raisons d’arrêt de refus.
  6. Considérez l’activation de la réflexion étendue pour les tâches complexes Activez la réflexion étendue pour des améliorations significatives des performances sur les tâches de codage et de raisonnement (désactivée par défaut) : 
    response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)
    La réflexion étendue impacte l’efficacité de la mise en cache de prompts.
  7. Explorez les nouvelles capacités Voir Nouveautés dans Claude 4.5 pour les détails sur la conscience contextuelle, la capacité de sortie augmentée (64K jetons), l’intelligence supérieure et la vitesse améliorée.
  8. Testez votre implémentation Testez dans un environnement de développement avant de déployer en production pour vous assurer que tous les changements critiques sont correctement gérés.

​
Liste de vérification de migration Haiku 3.5 → 4.5

  • Mettre à jour l’ID du modèle vers claude-haiku-4-5-20251001
  • CRITIQUE : Mettre à jour les versions d’outils vers les dernières (par ex., text_editor_20250728, code_execution_20250825) - les versions héritées ne sont pas prises en charge
  • CRITIQUE : Supprimer tout code utilisant la commande undo_edit (si applicable)
  • CRITIQUE : Mettre à jour les paramètres d’échantillonnage pour utiliser uniquement temperature OU top_p, pas les deux
  • Réviser et ajuster pour les nouvelles limites de taux (séparées de Haiku 3.5)
  • Gérer la nouvelle raison d’arrêt refusal dans votre application
  • Considérer l’activation de la réflexion étendue pour les tâches de raisonnement complexes (nouvelle capacité)
  • Tirer parti de la conscience contextuelle pour une meilleure gestion des jetons dans les sessions longues
  • Se préparer pour des réponses plus importantes (sortie max augmentée de 8K à 64K jetons)
  • Réviser et mettre à jour les prompts en suivant les meilleures pratiques Claude 4
  • Tester dans l’environnement de développement avant le déploiement en production

​
Choisir entre Sonnet 4.5 et Haiku 4.5

Claude Sonnet 4.5 et Claude Haiku 4.5 sont tous deux des modèles Claude 4 puissants avec des forces différentes :

​
Choisissez Claude Sonnet 4.5 (le plus intelligent) pour :

  • Raisonnement et analyse complexes : Intelligence de classe mondiale pour les tâches sophistiquées
  • Agents autonomes de longue durée : Performance supérieure pour les agents travaillant de manière indépendante pendant des périodes prolongées
  • Tâches de codage avancées : Notre modèle de codage le plus fort avec planification avancée et ingénierie de sécurité
  • Flux de travail de contexte large : Gestion de contexte améliorée avec outil mémoire et capacités d’édition de contexte
  • Tâches nécessitant une capacité maximale : Quand l’intelligence et la précision sont les priorités principales

​
Choisissez Claude Haiku 4.5 (Haiku le plus rapide et le plus intelligent) pour :

  • Applications en temps réel : Temps de réponse rapides pour les expériences utilisateur interactives avec des performances quasi-frontières
  • Traitement intelligent à haut volume : Intelligence rentable à l’échelle avec vitesse améliorée
  • Déploiements sensibles aux coûts : Performance quasi-frontière à des prix plus bas
  • Architectures de sous-agents : Agents rapides et intelligents pour les systèmes multi-agents
  • Utilisation d’ordinateur à l’échelle : Automatisation de bureau et navigateur autonome rentable
  • Tâches nécessitant de la vitesse : Quand la faible latence est critique tout en maintenant une intelligence quasi-frontière

​
Recommandations de réflexion étendue

Les modèles Claude 4, particulièrement Sonnet et Haiku 4.5, montrent des améliorations significatives de performance lors de l’utilisation de la réflexion étendue pour les tâches de codage et de raisonnement complexe. La réflexion étendue est désactivée par défaut mais nous recommandons de l’activer pour les travaux exigeants. Important : La réflexion étendue impacte l’efficacité de la mise en cache de prompts. Quand du contenu non-résultat d’outil est ajouté à une conversation, les blocs de réflexion sont supprimés du cache, ce qui peut augmenter les coûts dans les conversations multi-tours. Nous recommandons d’activer la réflexion quand les bénéfices de performance l’emportent sur le compromis de mise en cache.

​
Autres scénarios de migration

Les chemins de migration principaux couverts ci-dessus (Sonnet 3.7 → 4.5 et Haiku 3.5 → 4.5) représentent les mises à niveau les plus courantes. Cependant, vous pourriez migrer d’autres modèles Claude vers Claude 4.5. Cette section couvre ces scénarios.

​
Migration de Claude Sonnet 4 → Sonnet 4.5

Changement critique : Ne peut pas spécifier à la fois temperature et top_p dans la même requête. Tous les autres appels API fonctionneront sans modification. Mettez à jour votre ID de modèle et ajustez les paramètres d’échantillonnage si nécessaire : 
# Avant (Claude Sonnet 4)
model="claude-sonnet-4-20250514"

# Après (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

​
Migration de Claude Opus 4.1 → Sonnet 4.5

Aucun changement critique. Tous les appels API fonctionneront sans modification. Mettez simplement à jour votre ID de modèle : 
# Avant (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Après (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Claude Sonnet 4.5 est notre modèle le plus intelligent avec des capacités de raisonnement, de codage et d’agents de longue durée de classe mondiale. Il offre une performance supérieure comparée à Opus 4.1 pour la plupart des cas d’usage.

​
Besoin d’aide ?