---
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 des modèles Haiku antérieurs grâce à ce guide de migration. Les instructions pour activer Claude Haiku 5.5 comprennent 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.
---

<Note>
  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.
</Note>

Laissez Claude Code migrer votre code pour vous

```text
/claude-api migrate ce projet vers claude-haiku-5-5
```

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 [Guides de migration](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 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 de Claude Haiku 5.5 pour 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 les limites `max_tokens` ainsi que les 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 utilisez l’utilisation de l’ordinateur, remplacez `computer_20250124` par l’ensemble d’outils `computer_toolset_20260801`. Sur Amazon Bedrock, `computer_20251124` fonctionne également. Consultez [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 compte différent, 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 antérieurs 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 de protection](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).
11. Si vos prompts demandent au modèle d’écrire son raisonnement dans la réponse, par exemple dans des balises `<thinking>` ou `<reasoning>`, supprimez ces instructions. Claude Haiku 5.5 peut refuser une requête qui les contient et renvoyer la catégorie `reasoning_extraction`. Consultez [Refus des mesures de protection](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).

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’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 de Claude Haiku 5.5 pour votre plateforme.

| Plateforme | Claude Haiku 4.5 | Claude Haiku 5.5 |
| ----- | ----- | ----- |
| Claude API | `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` |
| Claude Models on Google Cloud (Anthropic managed) | `claude-haiku-4-5-20251001` | `claude-haiku-5-5` |
| Claude Models on Google Cloud (Google managed) | `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 » (analyseur en tokens) 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 structure. Ce qui change, c’est tout ce que vous mesurez ou budgétisez 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 du nombre de tokens de Claude Haiku 4.5 doivent être recalculées avec le nombre de tokens et les tarifs de Claude Haiku 5.5, y compris ses tarifs plus élevés pour les prompts longs. Consultez [Tarification](https://platform.claude.com/docs/fr/about-claude/pricing) et [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 côté 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 côté le plus long ou 1 568 tokens visuels. Une image de 2 000 pixels sur 1 500 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 l’« adaptive thinking » (réflexion adaptative). La valeur `thinking` change, et `output_config.effort` détermine 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 » (niveau d’effort)](https://platform.claude.com/docs/fr/build-with-claude/effort) comme levier de contrôle : 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 bas. À un niveau plus bas, 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 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 aviez 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 bas.

Les blocs de réflexion des tours précédents de l’assistant restent dans le contexte et comptent comme des tokens d’entrée, alors que Claude Haiku 4.5 ne conserve que ceux du dernier tour. Les conversations à plusieurs 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 [Conservation des blocs de réflexion selon le 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`, alors que Claude Haiku 4.5 renvoie 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 comporte 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.

Une conversation que vous faites passer de Claude Haiku 4.5 à Claude Haiku 5.5 conserve son raisonnement. Pour les autres changements, cela dépend des deux modèles :

| Changement | Conserve son raisonnement |
| ----- | ----- |
| Vers Claude Haiku 5.5, depuis Claude Haiku 4.5 ou antérieur, Claude Sonnet 5 ou antérieur, ou Claude Opus 4.8 ou antérieur | Oui |
| Vers Claude Haiku 5.5, depuis tout autre modèle | Non. L’API écarte les blocs de réflexion de ce modèle sans erreur. |
| Depuis Claude Haiku 5.5, vers Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2 ou Claude Mythos 5.2 | Oui, uniquement sur la Claude API et Claude Models on Google Cloud (Google managed) |
| Depuis Claude Haiku 5.5, vers tout autre modèle | Non |

Consultez [Changer de modèle puis revenir](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking#switching-models). Pour les changements qui n’impliquent pas Claude Haiku 5.5, consultez [Quels changements de modèle conservent le raisonnement sur l’API Claude](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking#which-model-switches-keep-reasoning).

## Supprimer les paramètres d’échantillonnage

Sur Claude Haiku 5.5, omettez `temperature`, `top_p` et `top_k` et utilisez plutôt le prompting pour guider le comportement du modèle.

## Remplacer le préremplissage de l’assistant

Un « prefill » (préremplissage) est un dernier tour 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 en fonction de 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.
* **Préambules :** demandez dans l’invite système une réponse directe.
* **Continuations :** déplacez-les dans le message de l’utilisateur, par exemple « Votre réponse précédente a été interrompue et se terminait par `[previous_response]`. Reprenez là où vous vous êtes arrêté. »
* **Rappels de contexte :** placez-les dans le tour de l’utilisateur.

## 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`. Claude Haiku 5.5 prend en charge l’utilisation de l’ordinateur via l’ensemble d’outils `computer_toolset_20260801`. Une requête adressée à Claude Haiku 5.5 qui déclare `computer_20250124` renvoie une erreur 400.

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). Effectuez la répartition en fonction des champs `name` et `toolset_name` de chaque bloc `tool_use` membre plutôt qu’en fonction de `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. Utilisé conjointement avec une entrée d’ensemble d’outils, il renvoie une erreur 400.

Sur Amazon Bedrock, Claude Haiku 5.5 accepte également l’outil `computer_20251124` avec l’en-tête bêta `computer-use-2025-11-24`.

Claude Haiku 5.5 prend 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 des 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 écarte le bloc avant que le modèle ne le reçoive, et la requête réussit sans ce raisonnement. Cela affecte le code qui stocke des conversations et les rejoue via un compte différent, 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 [Comptes et plateformes cloud](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking#account-bound-thinking).

## Conserver les tours antérieurs inchangés

Conservez les conversations en ajout seul. 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é : le prompt `system`, les `tools` et chaque message précédent.

Échouer à la [« prefix check » (vérification du préfixe)](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking/prefix-checks#prefix-check) peut entraîner ou non une [erreur 400](https://platform.claude.com/docs/fr/api/errors#thinking-block-conversation-mismatch). Pour identifier et gérer ces deux cas, consultez [Vérifications du préfixe sur les blocs de réflexion](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking/prefix-checks).

Pour connaître les modifications qui déclenchent l’erreur et ce qu’il faut faire à la place, consultez [Si votre code modifie l’invite système, les outils ou l’historique](https://platform.claude.com/docs/fr/build-with-claude/preserved-thinking/prefix-checks#what-to-check).

## 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 la Claude API, Amazon Bedrock et Claude Models on Google Cloud (Google managed). Claude Haiku 3 est retiré sur la Claude API et Claude Models on Google Cloud (Google managed). 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 ces modifications :

* **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 Claude Models on Google Cloud (Google managed), 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 `code_execution_20250522`, limité à Python, passez à l’une d’elles. Consultez [Passer à 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 [Raisons d’arrêt et repli](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 plus direct, et nécessitent des instructions explicites. Révisez vos prompts en vous appuyant sur [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 [Bonnes pratiques de prompting](https://platform.claude.com/docs/fr/build-with-claude/prompt-engineering/claude-prompting-best-practices).
