---
title: Guide de migration vers Claude Haiku 5.5
url: https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide
description: Passez à Claude Haiku 5.5 depuis les modèles Haiku antérieurs grâce à ce guide de migration. Les instructions pour activer Claude Haiku 5.5 incluent le nouvel identifiant de modèle, les paramètres qui renvoient des erreurs, les changements liés à la réflexion et une liste de vérification pour chaque modèle de départ.
---
Ce guide couvre la migration du code de la [Messages API](https://platform.claude.com/docs/fr/build-with-claude/working-with-messages). Si vous utilisez [Claude Managed Agents](https://platform.claude.com/docs/fr/managed-agents/overview), aucune modification n'est requise au-delà de la mise à jour du nom du modèle.
**Automatisez votre migration avec la skill Claude API.** Dans Claude Code, exécutez `/claude-api migrate` pour invoquer la [skill Claude API](https://platform.claude.com/docs/fr/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model) intégrée. Elle fonctionne avec n'importe quel modèle Claude actuel comme cible :
Laissez Claude Code migrer votre code pour vous
```text
/claude-api migrate ce projet vers claude-haiku-5-5
```
La skill applique le remplacement de l'identifiant du modèle et, si nécessaire, les changements de paramètres non rétrocompatibles, le remplacement du préremplissage (prefill) et le calibrage de l'effort pour votre modèle cible dans l'ensemble de votre base de code, puis produit une liste de contrôle des éléments à vérifier manuellement. Elle vous demande de confirmer la portée de la migration (répertoire de travail entier, un sous-répertoire ou une liste de fichiers spécifique) avant de modifier le moindre fichier. La skill détecte également les clients Amazon Bedrock et Claude Platform on AWS, et ajuste les formats d'identifiants de modèle ainsi que les changements de fonctionnalités pour ces plateformes.
Ce guide explique comment faire passer du code qui appelle Claude Haiku 4.5 à Claude Haiku 5.5. Pour du code qui appelle Claude Haiku 3.5 ou Claude Haiku 3, effectuez également les modifications décrites dans [Migrer vers Claude Haiku 5.5 depuis Claude Haiku 3.5 et les modèles Haiku antérieurs](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#migrating-from-haiku-35). Pour passer plutôt à un modèle Sonnet ou Opus, consultez [Mettre à niveau entre les versions de modèles](https://platform.claude.com/docs/fr/about-claude/models/migration-guide). Pour savoir combien de temps Claude Haiku 4.5 reste disponible, consultez [Dépréciations de modèles](https://platform.claude.com/docs/fr/about-claude/model-deprecations).
## Liste de vérification de la migration par modèle de départ
Parcourez les groupes dans l'ordre et arrêtez-vous après celui qui mentionne votre modèle actuel. Si vous utilisez Claude Haiku 4.5, le premier groupe constitue la liste complète. Chaque élément correspond à une modification à apporter à votre code.
### Tous les modèles de départ
1. Remplacez l'identifiant de modèle par l'identifiant Claude Haiku 5.5 de votre plateforme. Consultez [Utiliser l'identifiant de modèle Claude Haiku 5.5](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
2. Recomptez vos prompts et revoyez vos limites `max_tokens` et vos estimations de coûts, car le même texte compte davantage de tokens et les grandes images comptent davantage de tokens visuels. Consultez [Recompter les tokens](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#recount-tokens).
3. Si vos requêtes envoient `thinking: {"type": "enabled", "budget_tokens": N}`, remplacez `thinking` par `{"type": "adaptive"}`. Consultez [Configurer la réflexion](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#configure-thinking).
4. Si votre code lit le premier bloc de contenu comme étant la réponse, sélectionnez plutôt les blocs par `type`. Consultez [Configurer la réflexion](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#configure-thinking).
5. Supprimez `temperature`, `top_p` et `top_k` de vos requêtes. Consultez [Supprimer les paramètres d'échantillonnage](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#remove-sampling-parameters).
6. Si vos requêtes terminent `messages` par un tour de l'assistant que le modèle doit poursuivre, terminez-les plutôt par un tour de l'utilisateur. Consultez [Remplacer le préremplissage de l'assistant](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#replace-assistant-prefill).
7. Si vous recourez à l'utilisation de l'ordinateur, remplacez `computer_20250124` : sur l'API Claude et Google Cloud, par l'ensemble d'outils `computer_toolset_20260801` ; sur Amazon Bedrock, par `computer_20251124` et l'en-tête bêta `computer-use-2025-11-24`. Consultez [Faire passer l'utilisation de l'ordinateur à l'ensemble d'outils](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#computer-use-toolset).
8. Si vous rejouez des conversations stockées via un autre compte, rejouez chacune d'elles via le compte qui l'a produite. Consultez [Rejouer les blocs de réflexion via le compte qui les a produits](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#replay-thinking-blocks-through-the-producing-account).
9. Si votre code modifie `system`, `tools` ou des `messages` antérieurs entre les requêtes d'une conversation et renvoie des blocs de réflexion, conservez la conversation en ajout seul. Consultez [Conserver les tours précédents inchangés](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#keep-earlier-turns-unchanged).
10. Gérez `stop_reason: "refusal"`. Claude Haiku 5.5 exécute des classificateurs de sécurité qui peuvent refuser une requête, et il ne dispose d'aucun repli côté serveur. Consultez [Refus des mesures de protection](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).
11. Si vous utilisez les [sorties structurées](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs) (`output_config.format` ou des outils `strict: true`) sur Amazon Bedrock, décrivez le format dans le prompt ou utilisez un outil sans `strict`, et validez la sortie dans votre code. Les sorties structurées ne sont pas disponibles pour Claude Haiku 5.5 sur Amazon Bedrock.
Si votre organisation dispose d'un engagement [Priority Tier](https://platform.claude.com/docs/fr/api/service-tiers#supported-models) sur Claude Haiku 4.5, planifiez la capacité séparément : Priority Tier n'est pas pris en charge sur Claude Haiku 5.5.
### Claude Haiku 3.5 ou antérieur
1. Remplacez l'identifiant de modèle Claude Haiku 3.5 ou Claude Haiku 3 par l'identifiant de Claude Haiku 5.5 pour votre plateforme. Consultez [Migrer vers Claude Haiku 5.5 depuis Claude Haiku 3.5 et les modèles Haiku antérieurs](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#migrating-from-haiku-35).
2. Si vous utilisez l'ancien outil `code_execution_20250522`, passez à `code_execution_20250825` ou à une version ultérieure.
3. Si vous utilisez l'outil d'édition de texte, passez à `text_editor_20250728`.
4. Gérez les raisons d'arrêt `refusal` et `model_context_window_exceeded`.
5. Si votre code compare exactement les paramètres de type chaîne des appels d'outils, tenez compte des sauts de ligne finaux.
6. Révisez vos prompts.
## Utiliser l'identifiant de modèle Claude Haiku 5.5
Remplacez l'identifiant de modèle Claude Haiku 4.5 par l'identifiant Claude Haiku 5.5 de votre plateforme.
| Plateforme | Claude Haiku 4.5 | Claude Haiku 5.5 |
| ---------------------- | ------------------------------------------------- | ---------------------------- |
| API Claude | `claude-haiku-4-5-20251001` ou `claude-haiku-4-5` | `claude-haiku-5-5` |
| Amazon Bedrock | `anthropic.claude-haiku-4-5` | `anthropic.claude-haiku-5-5` |
| Claude Platform on AWS | `claude-haiku-4-5` | `claude-haiku-5-5` |
| Google Cloud | `claude-haiku-4-5@20251001` | `claude-haiku-5-5` |
| Microsoft Foundry | `claude-haiku-4-5` | `claude-haiku-5-5` |
`claude-haiku-5-5` est un identifiant de modèle fixe, sans suffixe de date ni alias distinct.
## Recompter les tokens
Claude Haiku 5.5 utilise le même tokenizer plus récent que Claude 4.7 et les modèles ultérieurs. Comme pour tous les modèles qui utilisent ce tokenizer, le même texte d'entrée produit environ 30 % de tokens de plus sur Claude Haiku 5.5 que sur Claude Haiku 4.5. L'augmentation exacte dépend du contenu. Les requêtes, les réponses et les événements de streaming conservent la même forme. Ce qui change, c'est tout ce que vous mesurez ou budgétez en tokens :
* Les champs `usage` et les résultats du [comptage de tokens](https://platform.claude.com/docs/fr/build-with-claude/token-counting) sont plus élevés pour le même texte.
* Un nombre donné de tokens contient moins de texte.
* Une limite `max_tokens` ajustée pour Claude Haiku 4.5 peut tronquer une sortie équivalente.
* Les estimations de coûts établies à partir des nombres de tokens de Claude Haiku 4.5 doivent être recalculées avec les nombres de tokens et les [tarifs](https://platform.claude.com/docs/fr/about-claude/pricing) de Claude Haiku 5.5, y compris ses tarifs plus élevés pour les prompts longs. Consultez [Tarification du contexte long](https://platform.claude.com/docs/fr/about-claude/pricing#long-context-pricing).
Les grandes images peuvent également coûter davantage de tokens. Claude Haiku 5.5 utilise le niveau d'image haute résolution, qui réduit les images dépassant 2 576 pixels sur le bord le plus long ou 4 784 tokens visuels. Claude Haiku 4.5 et les modèles Haiku antérieurs utilisent le niveau standard, qui réduit les images dépassant 1 568 pixels sur le bord le plus long ou 1 568 tokens visuels. Une image de 2 000 par 1 500 pixels coûte environ 2,5 fois plus de tokens visuels sur Claude Haiku 5.5 que sur Claude Haiku 4.5. Consultez [Résolution et coût en tokens](https://platform.claude.com/docs/fr/build-with-claude/vision#evaluate-image-size).
Comptez vos prompts avec `model` défini sur `claude-haiku-5-5` plutôt que de réutiliser les nombres mesurés sur Claude Haiku 4.5.
## Configurer la réflexion
Claude Haiku 5.5 configure la réflexion différemment de Claude Haiku 4.5. Une valeur `thinking` de `{"type": "enabled", "budget_tokens": N}` renvoie une erreur 400 ; une requête qui l'envoie a donc besoin d'une nouvelle valeur `thinking`.
Avant, une requête à Claude Haiku 4.5 définissait `thinking` sur `enabled` avec un budget de tokens :
```json
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}
```
Après, la même requête à Claude Haiku 5.5 utilise la réflexion adaptative. La valeur `thinking` change, et `output_config.effort` définit le degré de réflexion du modèle :
```json
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}
```
La réflexion adaptative est activée par défaut ; une réponse peut donc commencer par un ou plusieurs blocs `thinking` même lorsque la requête ne définit pas `thinking`. Laissez `thinking` non défini ou définissez-le sur `{"type": "adaptive"}`, et utilisez l'[effort](https://platform.claude.com/docs/fr/build-with-claude/effort) comme levier : là où Claude Haiku 4.5 fonctionnait sans réflexion, ou avec un petit budget pour économiser des tokens, choisissez un niveau d'effort plus faible. À un niveau plus faible, le modèle réfléchit moins, et il peut ignorer entièrement la réflexion pour les requêtes plus simples. Pour des conseils de prompting, consultez [Utiliser l'effort pour contrôler la réflexion](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking). Sélectionnez les blocs de contenu par leur champ `type` plutôt que par leur position, et renvoyez les blocs `thinking` sans modification avec les résultats d'outils.
Les « thinking tokens » (tokens de réflexion) sont comptabilisés dans `max_tokens` ; une requête avec un petit `max_tokens` peut donc s'arrêter avec `stop_reason: "max_tokens"` après un bloc `thinking` et avant tout texte. Si vous avez défini un petit `max_tokens` pour Claude Haiku 4.5, augmentez-le pour laisser de la place à la réflexion, ou choisissez un niveau d'[effort](https://platform.claude.com/docs/fr/build-with-claude/effort) plus faible.
Les blocs de réflexion des tours précédents de l'assistant restent dans le contexte et sont comptabilisés comme tokens d'entrée, alors que Claude Haiku 4.5 ne conservait que ceux du dernier tour. Les conversations multi-tours comportent donc davantage de tokens d'entrée que ce que le seul changement de tokenizer explique. Pour supprimer les blocs plus anciens, utilisez l'[effacement des blocs de réflexion](https://platform.claude.com/docs/fr/build-with-claude/context-editing#thinking-block-clearing). Consultez [Préservation des blocs de réflexion par modèle](https://platform.claude.com/docs/fr/build-with-claude/thinking#thinking-block-preservation-by-model).
Par défaut, Claude Haiku 5.5 renvoie chaque bloc `thinking` avec un champ `thinking` vide et uniquement une `signature`, là où Claude Haiku 4.5 renvoyait une réflexion résumée. Pour recevoir une réflexion résumée, définissez `thinking: {"type": "adaptive", "display": "summarized"}`.
Claude Haiku 5.5 accepte un `tool_choice` forcé (`any` ou un outil nommé), mais la réponse commence par l'appel d'outil et ne contient aucun bloc `thinking`. Pour permettre au modèle de réfléchir avant d'appeler un outil, utilisez `tool_choice: {"type": "auto"}` et indiquez dans le prompt quand utiliser l'outil.
Claude Haiku 5.5 lit les blocs de réflexion de Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 et des modèles antérieurs ; une conversation que vous faites passer de Claude Haiku 4.5 à Claude Haiku 5.5 conserve donc son raisonnement. Il ne lit pas les blocs de Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5, ni d'aucun modèle Claude Fable ou Claude Mythos ; l'API les supprime sans erreur. Sur l'API Claude et Google Cloud, Claude Opus 5.5 et Claude Sonnet 5.5 lisent les blocs de Claude Haiku 5.5. Consultez [Changer de modèle en cours de conversation](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking#switching-models).
## Supprimer les paramètres d'échantillonnage
Claude Haiku 4.5 accepte `temperature`, `top_p` et `top_k`. Sur Claude Haiku 5.5, omettez ces trois paramètres et utilisez plutôt le prompting pour guider le comportement du modèle. Si une requête inclut `temperature`, sa valeur doit être `1`. Si elle inclut `top_p`, sa valeur doit être `0.99`, sa valeur par défaut. Toute autre valeur de `temperature` ou de `top_p` renvoie une erreur 400, y compris un `top_p` de `1`. Il en va de même pour toute valeur de `top_k`, ainsi que pour une requête qui inclut à la fois `temperature` et `top_p`.
## Remplacer le préremplissage de l'assistant
Un préremplissage est un tour final de l'assistant dans `messages` que le modèle poursuit. Claude Haiku 4.5 en accepte un lorsque la réflexion est désactivée. Claude Haiku 5.5 le rejette avec une erreur 400, même lorsque la réflexion est désactivée. Terminez `messages` par un tour de l'utilisateur, et remplacez chaque préremplissage selon son objectif :
* **Format de sortie :** utilisez les [sorties structurées](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs), ou des outils avec des champs enum pour la classification. Sur Amazon Bedrock, les sorties structurées ne sont pas disponibles pour Claude Haiku 5.5. Dans ce cas, décrivez le format dans le prompt ou utilisez un outil sans `strict`, et validez la sortie dans votre code.
* **Préambules :** demandez une réponse directe dans l'invite système.
* **Continuations :** déplacez-les dans le message de l'utilisateur, par exemple « Votre réponse précédente a été interrompue et s'est terminée par `[previous_response]`. Reprenez là où vous vous êtes arrêté. »
* **Rappels de contexte :** placez-les dans le tour de l'utilisateur.
## Faire passer l'utilisation de l'ordinateur à l'ensemble d'outils
Claude Haiku 4.5 prend en charge l'[utilisation de l'ordinateur](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/computer-use-tool) via l'outil `computer_20250124`, avec l'en-tête bêta `computer-use-2025-01-24`. Sur l'API Claude et Google Cloud, Claude Haiku 5.5 prend en charge l'utilisation de l'ordinateur uniquement via l'ensemble d'outils `computer_toolset_20260801`, et une requête qui déclare `computer_20250124` renvoie une erreur 400. Sur Amazon Bedrock, Claude Haiku 5.5 n'accepte pas non plus `computer_20250124` ; utilisez la version d'outil `computer_20251124` avec l'en-tête bêta `computer-use-2025-11-24`.
Pour faire passer une intégration à l'ensemble d'outils, supprimez l'en-tête bêta `computer-use-2025-01-24` et remplacez l'entrée `tools` par `{"type": "computer_toolset_20260801"}`. Effectuez ensuite les autres modifications de requête et de boucle d'agent décrites dans [Migrer depuis `computer_20251124`](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124) : répartissez le traitement selon le `name` et le `toolset_name` de chaque bloc `tool_use` membre plutôt que selon `input.action`, traitez chacun de ces blocs dans un tour, et renvoyez `toolset_name` dans les résultats. Le zoom est activé par défaut dans l'ensemble d'outils ; si votre environnement ne l'implémente pas, ajoutez `"configs": {"zoom": {"enabled": false}}`. Si vous envoyez l'en-tête bêta `fine-grained-tool-streaming-2025-05-14`, supprimez-le. Associé à une entrée d'ensemble d'outils, il renvoie une erreur 400. Pour les autres plateformes, consultez la section [Compatibilité](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/computer-use-tool#compatibility) de l'outil d'utilisation de l'ordinateur.
Sur l'API Claude et Google Cloud, Claude Haiku 5.5 prend également en charge l'[outil d'utilisation du navigateur](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/browser-use-tool) (`browser_toolset_20260801`) pour les tâches au sein de pages web. Claude Haiku 4.5 ne le prend pas en charge.
## Rejouer les blocs de réflexion via le compte qui les a produits
Les blocs de réflexion de Claude Haiku 5.5 ne fonctionnent que dans le compte qui les a produits, ou dans un compte qui lui est lié. Lorsqu'un autre compte envoie l'un de ces blocs, l'API supprime le bloc avant que le modèle ne le voie, et la requête réussit sans ce raisonnement. Cela concerne le code qui stocke des conversations et les rejoue via un autre compte, par exemple un service qui sert plusieurs clients à partir d'un même stockage de conversations. Rejouez chaque conversation via le compte qui l'a produite. Consultez [Les blocs de réflexion restent liés au compte qui les a produits](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking#account-bound-thinking).
## Conserver les tours précédents inchangés
Un bloc de réflexion de Claude Haiku 5.5 ne reste valide que tant que tout ce qui a été envoyé avant lui reste inchangé : une requête qui renvoie un bloc de réflexion après une modification de `system`, de `tools` ou de `messages` antérieurs renvoie une erreur 400. Claude Haiku 4.5 n'effectue pas cette vérification. Conservez les conversations en ajout seul. Sur les comptes créés avant le 31 août 2026 à 00:00 UTC, l'erreur ne se produit que pour les requêtes qui définissent `thinking.block_binding.prefix_mismatch_behavior`. Pour connaître les modifications qui déclenchent l'erreur et ce qu'il faut faire à la place, consultez [Qui doit modifier quelque chose](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking#who-is-affected).
## Migrer vers Claude Haiku 5.5 depuis Claude Haiku 3.5 et les modèles Haiku antérieurs
Claude Haiku 3.5 est retiré sur l'API Claude et Amazon Bedrock, et Claude Haiku 3 est retiré sur l'API Claude et Google Cloud. Les requêtes adressées à un modèle retiré échouent. Google Cloud indique que Claude Haiku 3.5 est déprécié et disponible uniquement pour les clients existants. Consultez [Dépréciations de modèles](https://platform.claude.com/docs/fr/about-claude/model-deprecations).
Depuis l'un ou l'autre de ces modèles, appliquez d'abord toutes les sections précédentes, puis les modifications suivantes :
* **Identifiant de modèle :** remplacez `claude-3-5-haiku-20241022`, son alias `claude-3-5-haiku-latest`, ou `claude-3-haiku-20240307` par `claude-haiku-5-5`. Sur Google Cloud, remplacez `claude-3-5-haiku@20241022` par `claude-haiku-5-5`. Sur Amazon Bedrock, utilisez l'identifiant de Claude Haiku 5.5 indiqué dans [Utiliser l'identifiant de modèle Claude Haiku 5.5](https://platform.claude.com/docs/fr/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
* **Exécution de code :** Claude Haiku 5.5 accepte `code_execution_20250825` et les versions ultérieures. Si vous utilisez l'ancien `code_execution_20250522`, limité à Python, passez à l'une de ces versions. Consultez [Mettre à niveau vers la dernière version de l'outil](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version).
* **Éditeur de texte :** si vous utilisez l'outil d'édition de texte, passez à `text_editor_20250728` (nom d'outil `str_replace_based_edit_tool`), qui ne dispose pas de la commande `undo_edit`. Consultez [Outil d'édition de texte](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/text-editor-tool).
* **Raisons d'arrêt :** gérez `refusal` et `model_context_window_exceeded`. Consultez [Gérer les raisons d'arrêt](https://platform.claude.com/docs/fr/build-with-claude/handling-stop-reasons).
* **Sauts de ligne finaux :** Claude 4.5 et les modèles ultérieurs conservent les sauts de ligne finaux dans les paramètres de type chaîne des appels d'outils. Si votre code compare exactement ces chaînes, tenez-en compte.
* **Prompts :** Claude 4 et les modèles ultérieurs ont un style de communication plus concis et direct, et nécessitent des instructions explicites. Révisez vos prompts à l'aide de [Rédiger des prompts pour Claude Haiku 5.5](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5) et des [bonnes pratiques de prompting](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/claude-prompting-best-practices).