Migrer vers Claude Opus 5.5

Pour les différences de comportement et les modèles de prompting propres au modèle, consultez Rédiger des prompts pour Claude Opus 5.5.

Claude Opus 5.5 coûte moins cher que Claude Opus 5 (4 $ / 20 $ USD par million de tokens d'entrée / de sortie, contre 5 $ / 25 $ ; consultez la tarification de Claude). Il conserve la « context window » (fenêtre de contexte) de 1M tokens de Claude Opus 5 ainsi que ses 128k tokens de sortie maximum. Le code qui fonctionne déjà sur Claude Opus 5 est concerné par quatre « breaking changes » (changements incompatibles), décrits dans la section Changements incompatibles. Pour la prise en charge des fonctionnalités, consultez Nouveautés de Claude Opus 5.5.

Migrer vers Claude Opus 5.5 depuis Claude Opus 5

Mettre à jour le nom de votre modèle

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

claude-opus-5-5 est un identifiant de modèle fixe, sans suffixe de date, selon le même schéma que claude-opus-5. Sur Amazon Bedrock, Claude Platform on AWS, Google Cloud et Microsoft Foundry, utilisez l'identifiant de modèle propre à la plateforme concernée ; consultez Disponibilité.

Changements incompatibles

Chaque changement est expliqué dans Nouveautés de Claude Opus 5.5. Cette section indique la modification de code à apporter pour chacun d'eux.

La réflexion ne peut pas être désactivée

thinking: {"type": "disabled"} et thinking: {"type": "enabled", "budget_tokens": N} renvoient tous deux une erreur 400 ("thinking.type.disabled" is not supported for this model. ou "thinking.type.enabled" is not supported for this model.). Supprimez le champ thinking et choisissez un niveau d'effort. Si vous désactiviez la réflexion pour économiser des tokens, choisissez un niveau plus bas. Les réponses commencent alors par des blocs thinking : sélectionnez donc les blocs de contenu selon leur type, et renvoyez les blocs thinking sans modification avec les résultats d'outils. Consultez La réflexion ne peut pas être désactivée.

Avant (accepté sur Claude Opus 5, rejeté sur Claude Opus 5.5) :

client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    thinking={"type": "disabled"},
    messages=[{"role": "user", "content": "..."}],
)

Après :

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    output_config={"effort": "low"},  # thinking is always on; effort is the control
    messages=[{"role": "user", "content": "..."}],
)

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

Les types tool_choice any et tool renvoient une erreur 400 (tool_choice: type "tool" and "any" are not supported for this model.), y compris sur le point de terminaison de comptage des tokens. Utilisez auto avec l'utilisation d'outils stricte ou les sorties structurées, et indiquez dans le prompt quand l'outil s'applique. Consultez L'utilisation forcée d'outils n'est pas prise en charge.

Avant :

client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "get_weather"},
    messages=[{"role": "user", "content": "What's the weather in Paris?"}],
)

Après :

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    # utilisation d'outils stricte : chaque appel respecte l'input_schema de l'outil.
    tools=[{**tool, "strict": True} for tool in tools],
    tool_choice={"type": "auto"},
    messages=[
        {
            "role": "user",
            "content": "What's the weather in Paris? Use the get_weather tool.",
        }
    ],
)

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

Sur l'API Claude, Claude Fable 5.1 et Claude Mythos 5.1 lisent les blocs de réflexion de Claude Opus 5.5 ; aucun autre modèle ne le fait. Un routeur ou un mécanisme de repli qui fait passer une conversation de Claude Opus 5.5 à un autre modèle exécute ces tours sans ces blocs. Dans l'autre sens, Claude Opus 5.5 lit les blocs de réflexion de Claude Opus 5 et des modèles Opus, Sonnet et Haiku antérieurs, mais pas ceux des modèles Claude Fable ou Claude Mythos. Conservez la conversation en ajout seul (aucune modification du prompt system, des tools ou des messages précédents en cours de conversation) afin que les blocs restent valides ; Claude Code, claude.ai, Claude Managed Agents et le Claude Agent SDK le font déjà. L'application de cette règle est identique à celle de Claude Fable 5.1 sur toutes les plateformes : pour les comptes créés le 31 août 2026 à 00:00 UTC ou après, la réutilisation d'un bloc de réflexion après une telle modification renvoie par défaut une erreur 400. Aucune modification de code n'est nécessaire pour les intégrations en ajout seul. Consultez Les blocs de réflexion sont liés au modèle et à la conversation et Réflexion préservée.

L'outil d'utilisation de l'ordinateur computer_20251124 n'est pas pris en charge sur l'API Claude et Google Cloud

Sur l'API Claude et Google Cloud, une entrée tools de type computer_20251124 renvoie une erreur 400 ('claude-opus-5-5' does not support tool types: computer_20251124., suivi des types d'outils acceptés par le modèle). Déclarez plutôt l'ensemble d'outils computer_toolset_20260801 : supprimez l'en-tête bêta et envoyez l'entrée sans name ni dimensions d'affichage. Dans votre boucle d'agent, traitez les blocs tool_use membres (l'action correspond au name du bloc, et non à input.action), dont plusieurs peuvent apparaître par tour, et renvoyez toolset_name dans chaque résultat. La modification de la requête est présentée ci-dessous ; les modifications de la boucle d'agent sont répertoriées dans Migrer depuis computer_20251124. Sur Amazon Bedrock, l'ancien outil computer_20251124 continue de fonctionner sur Claude Opus 5.5 comme sur Claude Opus 5 : aucune modification n'y est donc nécessaire. Pour les autres plateformes, consultez la section Compatibilité de l'outil d'utilisation de l'ordinateur. Consultez L'outil d'utilisation de l'ordinateur computer_20251124 n'est pas pris en charge sur l'API Claude et Google Cloud.

Avant :

client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    betas=["computer-use-2025-11-24"],
    tools=[
        {
            "type": "computer_20251124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
        }
    ],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

Après :

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    # pas d'en-tête bêta ; l'entrée du toolset ne prend ni nom ni taille d'affichage.
    tools=[{"type": "computer_toolset_20260801"}],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

Le texte entre les appels d'outils est renvoyé dans des blocs de réflexion

Sur Claude Opus 5, le texte que le modèle écrit entre les appels d'outils est renvoyé sous forme de blocs text. Sur Claude Opus 5.5, comme sur Claude Fable 5.1, cette narration est renvoyée sous forme de blocs thinking de mise à jour de progression, à raison d'un bloc au plus avant chaque appel d'outil. Avec la valeur par défaut "omitted" de thinking.display, leur champ thinking est vide. Aucune requête n'échoue, mais une application qui transmet ce texte en streaming à ses utilisateurs sous forme de mises à jour de progression devient silencieuse entre les appels d'outils. Pour rétablir ces mises à jour, lisez-les dans les blocs thinking et définissez une valeur display qui renvoie leur texte : "updates" (bêta, en-tête thinking-display-updates-2026-08-18) renvoie les mises à jour de progression tout en gardant le raisonnement masqué, et "summarized" renvoie les deux, mélangés. Affichez ensuite chaque bloc thinking non vide avant le bloc tool_use qu'il précède, et renvoyez les blocs sans modification avec le reste du tour de l'assistant. Consultez Mises à jour de progression destinées à l'utilisateur.

Classificateurs de sécurité et repli

Claude Opus 5.5 peut renvoyer stop_reason: "refusal" avec une catégorie stop_details. Ses classificateurs couvrent un ensemble de catégories plus large que ceux de Claude Opus 5 : attendez-vous donc à des valeurs stop_details.category telles que "bio" et "reasoning_extraction" en plus de "cyber" ; consultez le tableau des catégories de refus. Gérez les refus et configurez le repli côté serveur ou votre propre mécanisme de nouvelle tentative (le repli côté serveur ne relance pas les requêtes refusées avec "reasoning_extraction" ; ce refus vous est renvoyé) ; consultez Refus et repli et Refus des mesures de protection.

Modifications recommandées

1. Relancez votre balayage des niveaux d'effort. L'effort est le seul contrôle de la réflexion sur Claude Opus 5.5, et sa valeur par défaut est medium, alors que celle de Claude Opus 5 est high : une requête qui omet effort s'exécute donc désormais en medium. Baissez le niveau là où la qualité se maintient, et augmentez-le pour les tâches les plus exigeantes. Consultez Effort.
2. Réévaluez les instructions de prompt propres au modèle. Les instructions ajustées au comportement de Claude Opus 5 ne sont peut-être plus nécessaires ; consultez Rédiger des prompts pour Claude Opus 5.5. Si vous utilisiez le modèle avec la réflexion désactivée, consultez également Prompts rédigés pour la réflexion désactivée.
3. Testez dans un environnement de développement avant de basculer le trafic de production.

Liste de contrôle de migration

• Mettez à jour l'identifiant de modèle vers claude-opus-5-5.
• Supprimez thinking: {"type": "disabled"} et thinking: {"type": "enabled", ...} ; choisissez plutôt un niveau d'effort.
• Définissez effort explicitement : la valeur par défaut est medium, alors que celle de Claude Opus 5 est high.
• Remplacez les types tool_choice any et tool par auto associé à l'utilisation d'outils stricte ou aux sorties structurées.
• Si vous utilisez l'utilisation de l'ordinateur sur l'API Claude ou Google Cloud, déclarez computer_toolset_20260801 (sans en-tête bêta) au lieu de computer_20251124 et adaptez votre boucle d'agent à l'ensemble d'outils. Sur Amazon Bedrock, conservez computer_20251124 ; pour les autres plateformes, consultez la section Compatibilité de l'outil d'utilisation de l'ordinateur.
• Si un routeur ou un mécanisme de repli peut faire passer une conversation de Claude Opus 5.5 à un autre modèle, attendez-vous à ce que ce modèle s'exécute sans les blocs de réflexion de Claude Opus 5.5 (Claude Fable 5.1 et Claude Mythos 5.1 sur l'API Claude font exception et les conservent). Claude Opus 5.5 lui-même lit la réflexion de Claude Opus 5 et des modèles Opus, Sonnet et Haiku antérieurs, mais pas celle des modèles Claude Fable ou Claude Mythos.
• Lisez les blocs de contenu selon leur type, et renvoyez les blocs thinking sans modification dans les boucles d'utilisation d'outils.
• Si votre interface affiche le texte entre les appels d'outils, définissez display: "updates" (bêta) ou "summarized" et affichez les blocs thinking non vides.
• Si votre code modifie des tours précédents, le prompt system ou les tools en cours de conversation, suivez Réflexion préservée.
• Gérez stop_reason: "refusal" et configurez le repli.
• Réétablissez vos références de coût et de latence au niveau d'effort choisi.

Migrer vers Claude Opus 5.5 depuis Claude Opus 4.8

Suivez d'abord Migrer vers Claude Opus 5 depuis Claude Opus 4.8 : ce guide couvre la réflexion activée par défaut et les changements de forme des réponses qui l'accompagnent. Appliquez ensuite Migrer depuis Claude Opus 5. Le deuxième changement incompatible de Claude Opus 5 qui y est décrit (la réflexion ne peut être désactivée qu'avec un effort high ou inférieur) ne s'applique pas : sur Claude Opus 5.5, la réflexion ne peut pas du tout être désactivée.

Liste de contrôle de migration

• Tous les éléments de la liste de contrôle Claude Opus 4.8 → Claude Opus 5, à ceci près que thinking: {"type": "disabled"} n'est pas une option.
• Tous les éléments de la liste de contrôle Claude Opus 5 → Claude Opus 5.5.

Migrer vers Claude Opus 5.5 depuis Claude Opus 4.7 et les modèles Opus antérieurs

Le guide de migration vers Claude Opus 5 couvre les changements incompatibles entre votre modèle actuel et Claude Opus 5 : paramètres d'échantillonnage rejetés, réflexion étendue manuelle rejetée, préremplissage supprimé et nouveau tokenizer. Suivez la section correspondant à votre modèle dans ce guide, en ciblant claude-opus-5-5 au lieu de claude-opus-5, puis appliquez Migrer depuis Claude Opus 5. Là où ce guide indique que la réflexion peut être désactivée avec un effort high ou inférieur, ce n'est pas possible sur Claude Opus 5.5. De même, là où il indique que les intégrations computer_20251124 existantes continuent de fonctionner, ce n'est pas le cas sur Claude Opus 5.5 avec l'API Claude et Google Cloud, où ce modèle n'accepte l'utilisation de l'ordinateur que sous la forme de l'ensemble d'outils computer_toolset_20260801 (consultez le changement incompatible) ; sur Amazon Bedrock, elles continuent de fonctionner.

Migrer vers Claude Opus 5.5 depuis Claude Sonnet 5

Consultez Migration vers Claude Opus 5 depuis Claude Sonnet 5 pour savoir ce qui change lorsque vous passez à une classe de modèle supérieure, puis appliquez Migrer depuis Claude Opus 5.