Nouveautés de Claude Sonnet 5.5

Claude Sonnet 5.5 offre la meilleure combinaison de vitesse et d’intelligence. Cinq changements incompatibles peuvent affecter le code qui s’exécute déjà sur Claude Sonnet 5 :

• Désactivez la réflexion préalable avec between_tools.
• L’utilisation d’outils forcée renvoie une erreur.
• Les blocs de réflexion sont liés au modèle et à la conversation.
• Certaines versions de l’outil d’utilisation de l’ordinateur ne sont pas prises en charge.
• L’outil advisor rejette quatre modèles en tant que conseillers : Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 et Claude Haiku 5.5.

Un autre changement modifie la forme de la réponse sans faire échouer aucune requête : le texte entre les appels d’outils est renvoyé dans des blocs thinking. Une application qui transmet ce texte en « streaming » à ses utilisateurs reste silencieuse entre les appels d’outils jusqu’à ce qu’elle définisse une valeur display qui renvoie le texte, ou qu’elle désactive la réflexion préalable avec between_tools.

Nouveau modèle

La réflexion adaptative est activée par défaut, et le paramètre d’effort contrôle la profondeur de la réflexion. Sa valeur par défaut sur l’API Claude est high. Le tokenizer est le même que celui de Claude Sonnet 5, de sorte que le même texte produit le même nombre de tokens. Pour la « context window » (fenêtre de contexte), les limites de sortie, la date limite des connaissances et les tarifs, consultez la page du modèle Claude Sonnet 5.5.

Pour tous les modèles actuels, consultez Aperçu des modèles.

Changements incompatibles

Désactivez la réflexion préalable avec between_tools

Pour désactiver la réflexion préalable sur Claude Sonnet 5.5, envoyez thinking: {"type": "between_tools"} au lieu de "disabled". C’est le réglage de réflexion le plus bas sur ce modèle. Il est disponible sur toutes les plateformes qui proposent Claude Sonnet 5.5. Les courtes mises à jour de progression que le modèle rédige entre les appels d’outils sont toujours renvoyées sous forme de blocs thinking avec leur texte de résumé. Renvoyez ces blocs sans modification avec le reste du tour de l’assistant. Un bloc de mise à jour de progression que vous renvoyez donne au modèle la note complète qu’il a rédigée, et non le résumé. Si vos requêtes n’utilisent pas d’outils, la réponse ne contient que du texte, comme avec disabled sur Claude Sonnet 5.

Sur Claude Sonnet 5.5, une requête qui envoie thinking: {"type": "disabled"} renvoie une erreur 400 invalid_request_error dont le message oriente vers between_tools.

between_tools est accepté aux niveaux d’effort low, medium et high. Aux niveaux d’effort xhigh ou max, une requête avec between_tools renvoie une erreur 400. Pour fonctionner à xhigh ou max, utilisez la réflexion adaptative : omettez le champ thinking ou envoyez thinking: {"type": "adaptive"}, ce qui est équivalent. Avec between_tools, l’effort ne peut pas changer en cours de conversation : un output_config.effort par message qui diffère du niveau en vigueur renvoie une erreur 400. Pour faire varier l’effort à chaque tour, utilisez la réflexion adaptative.

between_tools n’accepte aucun autre champ : display, budget_tokens ou block_binding envoyé avec lui renvoie une erreur 400. Les budgets de réflexion manuels (thinking: {"type": "enabled", "budget_tokens": N}) renvoient une erreur 400. Consultez Réflexion et Désactiver la réflexion préalable dans le guide de migration.

L’utilisation d’outils forcée n’est pas prise en charge

Claude Sonnet 5.5 ne prend pas en charge l’utilisation d’outils forcée. Un tool_choice défini sur {"type": "any"} ou {"type": "tool", "name": "..."} renvoie une erreur 400 invalid_request_error :

tool_choice: type "tool" and "any" are not supported for this model.

tool_choice: {"type": "auto"} (la valeur par défaut) et {"type": "none"} sont pris en charge. La même vérification s’applique au point de terminaison de comptage des tokens. Pour obtenir une entrée d’outil conforme au schéma, conservez tool_choice: {"type": "auto"} et définissez strict: true avec l’utilisation d’outils stricte, ou déplacez le schéma vers les sorties structurées. Pour que le modèle appelle un outil plutôt que de répondre en texte, indiquez dans le prompt quand l’outil s’applique. La section L’utilisation d’outils forcée n’est pas prise en charge du guide de migration présente l’avant et l’après.

Les blocs de réflexion sont liés au modèle et à la conversation

Chaque bloc de réflexion enregistre le modèle qui l’a produit. Une conversation qui change de modèle ne conserve son raisonnement antérieur que si le modèle vers lequel elle passe peut lire les blocs de réflexion du modèle précédent :

Lorsqu’une requête contient un bloc que le modèle cible ne peut pas lire, l’API l’écarte avant que le modèle ne le reçoive. La requête réussit, et les blocs écartés ne sont pas facturés. Avec l’en-tête bêta thinking-binding-controls-2026-08-01, l’API signale le bloc écarté dans un tableau input_transformations de premier niveau. Consultez Changer de modèle puis revenir. Pour les changements qui n’impliquent pas Claude Sonnet 5.5, consultez Quels changements de modèle conservent le raisonnement sur l’API Claude.

L’API vérifie également si quelque chose a changé avant un bloc de réflexion de Claude Sonnet 5.5 depuis que le modèle a produit ce bloc. Cette vérification du préfixe couvre l’invite system, les tools et chaque message antérieur. Gardez la conversation « append-only » (en ajout seul) : modifiez les instructions ou les outils avec des messages système en cours de conversation plutôt qu’avec des modifications.

Échouer à la « prefix check » (vérification du préfixe) peut entraîner ou non une erreur 400. Pour identifier et gérer ces deux cas, consultez Vérifications du préfixe sur les blocs de réflexion.

La vérification du préfixe s’exécute sur l’API Claude et sur certaines plateformes cloud.

Consultez Réflexion préservée et la note sur les blocs de réflexion du guide de migration.

Certaines versions de l’outil d’utilisation de l’ordinateur ne sont pas prises en charge

Claude Sonnet 5.5 prend en charge le « computer use » (utilisation de l’ordinateur) via l’ensemble d’outils computer_toolset_20260801. Sur Amazon Bedrock, Claude Sonnet 5.5 accepte également l’outil computer_20251124 avec l’en-tête bêta computer-use-2025-11-24. Claude Sonnet 5.5 renvoie une erreur 400 pour toute version de l’outil computer use qu’il n’accepte pas, comme computer_20251124 sur l’API Claude. Le message invalid_request_error de l’API Claude nomme le type rejeté et, après Did you mean one of, liste les types d’outils que le modèle accepte. Le message commence ainsi :

'claude-sonnet-5-5' does not support tool types: computer_20251124.

Les intégrations qui utilisent l’ensemble d’outils ne nécessitent aucune modification. Pour faire passer une intégration computer_20251124 à l’ensemble d’outils, suivez Migrer depuis computer_20251124, qui montre la requête avant et après. Retirez l’en-tête bêta et remplacez l’entrée tools par {"type": "computer_toolset_20260801"}. Mettez ensuite à jour votre boucle d’agent pour les blocs tool_use des membres, les actions par lots et toolset_name dans les résultats.

Certaines associations de l’outil advisor ne sont pas prises en charge

L’outil advisor est en bêta. Un exécuteur Claude Sonnet 5.5 n’accepte que les conseillers suivants :

• Claude Mythos 5.2 et Claude Fable 5.2
• Claude Mythos 5.1 et Claude Fable 5.1
• Claude Mythos 5 et Claude Fable 5
• Claude Opus 5.5 et Claude Opus 5
• Claude Sonnet 5.5 lui-même

Les conseillers Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 et Claude Haiku 5.5 fonctionnent avec un exécuteur Claude Sonnet 5. Avec un exécuteur Claude Sonnet 5.5, ils renvoient une erreur 400 invalid_request_error. Chaque conseiller accepté par Claude Sonnet 5.5 renvoie son conseil chiffré, sous forme de bloc advisor_redacted_result. Votre client ne peut donc pas lire le texte du conseil. Consultez les sections Compatibilité des modèles et Variantes de résultat de l’outil advisor.

Prise en charge des fonctionnalités

Claude Sonnet 5.5 prend en charge les fonctionnalités suivantes :

• L’effort par message, qui est en bêta
• Les messages système en cours de conversation
• Les modifications d’outils en cours de conversation, qui sont en bêta
• La mise en cache des prompts, avec un prompt minimal pouvant être mis en cache de 512 tokens
• Le traitement par lots
• L’API Files
• La prise en charge des PDF
• La vision
• Les outils côté serveur et côté client (consultez Utilisation d’outils avec Claude)

Claude Sonnet 5 ne prend pas en charge l’effort par message, les messages système en cours de conversation ni les modifications d’outils en cours de conversation. Sur Claude Sonnet 5, le prompt minimal pouvant être mis en cache est de 1 024 tokens. Consultez la page de chaque fonctionnalité pour connaître la disponibilité des modèles.

Compaction à la demande (bêta)

Avec l’en-tête bêta compact-2026-09-04, une requête qui envoie le paramètre compaction de premier niveau renvoie un bloc compaction signé qui résume les messages de cette requête. Dans les requêtes suivantes, le bloc est placé en premier dans messages, à la place des messages qu’il résume. Vous choisissez quand compacter et quels tours conserver après le bloc. Sur Claude Sonnet 5.5, les blocs de réflexion des tours conservés peuvent rester valides après la compaction. Pour connaître les conditions, consultez Compaction et réflexion préservée. Consultez Compaction à la demande pour la disponibilité par plateforme et le flux de requête complet.

Définir des outils dans un message (bêta)

Avec l’en-tête bêta inline-tools-2026-09-15, un bloc tool_addition dans un message système en cours de conversation peut contenir une définition d’outil complète au lieu d’une référence. Vous pouvez ajouter un outil, modifier son schéma ou faire passer un outil serveur à une version plus récente en cours de conversation sans modifier tools et sans perdre le cache des prompts. Consultez Définir des outils dans un message.

Les blocs de réflexion restent attachés au compte qui les a produits

Les blocs de réflexion produits par Claude Sonnet 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. Les blocs de Claude Haiku 5.5, Claude Fable 5.2 et Claude Mythos 5.2 suivent la même règle.

Sur l’API Claude et Claude Models on Google Cloud (Google managed), vous pouvez voir quels blocs ont été écartés. Envoyez l’en-tête bêta thinking-binding-controls-2026-08-01, et la réponse liste chaque bloc écarté dans input_transformations avec reason: "organization_binding_mismatch". Consultez Comptes et plateformes cloud.

Différences de comportement

Pour des recommandations sur chacun des points suivants, consultez Rédiger des prompts pour Claude Sonnet 5.5. Claude Sonnet 5.5 diffère de Claude Sonnet 5 de ces façons, qui apparaissent sans aucune modification du code :

• Les niveaux d’effort sont recalibrés. Un niveau d’effort ne produit pas la même quantité de réflexion que sur Claude Sonnet 5. Refaites votre balayage des niveaux d’effort plutôt que de reprendre un réglage existant. Commencez à high, sauf si votre charge de travail est agentique ou sensible à la « latency » (latence). Pour le codage agentique et l’utilisation d’outils en plusieurs étapes, commencez à medium pour les tâches bien spécifiées et passez à high pour les tâches plus difficiles ou plus longues. Pour le chat et les autres travaux sensibles à la latence, commencez à medium ou low.
• Le texte entre les appels d’outils est renvoyé dans des blocs de réflexion. Entre les appels d’outils, les notes de plus d’une ou deux phrases sont renvoyées sous forme de blocs thinking de mise à jour de progression. Les remarques plus courtes restent en text. Avec la valeur par défaut display: "omitted", le texte des blocs de mise à jour de progression est vide, de sorte qu’une application qui diffuse ces notes à ses utilisateurs reste silencieuse entre les appels d’outils, sans erreur. Si vous désactivez la réflexion préalable avec between_tools, le texte est renvoyé. Pour le recevoir, consultez Le texte entre les appels d’outils est renvoyé dans des blocs de réflexion dans le guide de migration.
• Catégories de protection. Les protections du modèle peuvent refuser une requête dans cinq catégories stop_details. "cyber" signifie que la requête pourrait permettre un préjudice cybernétique. "bio" signifie qu’elle pourrait permettre un préjudice biologique. "frontier_llm" signifie qu’elle pourrait aider au développement de modèles d’IA concurrents. "reasoning_extraction" signifie qu’elle demande au modèle de reproduire son raisonnement interne dans le texte de la réponse. "general_harms" signifie qu’elle relève d’un autre domaine de la politique d’utilisation. Consultez Refus, repli et facturation.

Refus, repli et facturation

Tout ce qui figure dans Refus et repli s’applique à Claude Sonnet 5.5. Une requête refusée renvoie HTTP 200 avec stop_reason: "refusal" et un objet stop_details nommant le domaine de politique concerné.

Gérez les refus dans votre code et configurez le repli. Avec le repli côté serveur (fallbacks: "default"), une requête refusée dans la catégorie "cyber" ou "frontier_llm" est exécutée à nouveau sur Claude Sonnet 5. Une requête refusée dans la catégorie "bio", "reasoning_extraction" ou "general_harms" n’est pas relancée. Le repli côté serveur est en bêta sur l’API Claude et sur Claude Models on Google Cloud (Anthropic managed). Vous pouvez également utiliser le middleware du SDK ou votre propre mécanisme de relance.

Un refus survenant avant toute sortie est facturé dans certaines catégories de refus et pas dans d’autres. Dans tous les cas, il est décompté de vos limites de débit. Consultez Comment les refus sont facturés.

Tarifs

Claude Sonnet 5.5 a les mêmes tarifs que Claude Sonnet 5, à l’exception des lectures du cache des prompts, qui coûtent 0,10 $ USD par million de tokens, soit la moitié du tarif de Claude Sonnet 5. Consultez Tarification pour la liste complète, la résidence des données et la tarification des outils.

Disponibilité

Claude Sonnet 5.5 est disponible sur :

• API Claude : tous les clients, sous le nom claude-sonnet-5-5
• AWS : Claude dans Amazon Bedrock, sous le nom anthropic.claude-sonnet-5-5, et Claude Platform on AWS, sous le nom claude-sonnet-5-5
• Google Cloud : Claude Models on Google Cloud (Anthropic managed), sous le nom claude-sonnet-5-5, et Claude Models on Google Cloud (Google managed), sous le nom claude-sonnet-5-5
• Microsoft Foundry : Claude dans Microsoft Foundry, sous le nom claude-sonnet-5-5

Migrer depuis Claude Sonnet 5

Mettez à jour votre ID de modèle :

model = "claude-sonnet-5"  # Before
model = "claude-sonnet-5-5"  # After

Vérifiez ensuite six points :

1. Si votre code désactive la réflexion avec disabled, envoyez plutôt between_tools, avec un effort high ou inférieur.
2. Remplacez les types tool_choice any et tool par auto associé à l’utilisation d’outils stricte.
3. Gardez les conversations en ajout seul. Une requête qui rejoue un bloc de réflexion de Claude Sonnet 5.5 après une modification de l’historique antérieur peut renvoyer une erreur 400. Consultez Les blocs de réflexion sont liés au modèle et à la conversation.
4. Si vous recourez à l’utilisation de l’ordinateur via computer_20251124, passez à l’ensemble d’outils. Sur Amazon Bedrock, computer_20251124 fonctionne également.
5. Si vous utilisez l’outil advisor avec un conseiller Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 ou Claude Haiku 5.5, passez à un conseiller que Claude Sonnet 5.5 accepte.
6. Si votre interface affiche le texte entre les appels d’outils, définissez thinking.display lorsque vous utilisez la réflexion adaptative. Avec between_tools, le texte est renvoyé sans ce paramètre. Consultez Le texte entre les appels d’outils est renvoyé dans des blocs de réflexion.

Le Guide de migration vers Claude Sonnet 5.5 contient des instructions étape par étape depuis Claude Sonnet 5 et les modèles antérieurs, ainsi que la liste de vérification complète.

Étapes suivantes