Accueil / L'API Claude pour ceux qui construisent

Passer à Opus 5.5 sans casser votre code

Passer de Claude Opus 5 à Claude Opus 5.5 ne se résume pas à changer l'identifiant : quatre réglages anciens renvoient désormais une erreur 400, et les notes écrites entre deux appels d'outils arrivent vides tant que le code ne règle pas thinking.display.

Claude Opus 5.5, annoncé le 22 septembre 2026, s'appelle claude-opus-5-5 dans l'API. La page officielle de ses nouveautés recense quatre changements cassants pour un code qui tourne déjà sur Claude Opus 5, et un cinquième changement qui ne fait échouer aucune requête mais modifie la forme de la réponse. Un code qui ne change que l'identifiant s'expose aux cinq.

Quatre requêtes que l'API refuse

• La réflexion ne se coupe plus. Un champ thinking de type disabled, comme un budget manuel de type enabled avec budget_tokens, renvoie une erreur 400. Le champ s'omet, ou prend le type adaptive, et la profondeur se règle par output_config.effort.
• Le forçage d'outil disparaît. Un tool_choice de type any ou tool renvoie une erreur 400, y compris sur le point d'accès qui compte les jetons. Restent auto, la valeur par défaut, et none.
• Un bloc de réflexion est lié à son modèle et à la conversation : sur les comptes créés à partir du 31 août 2026, le rejouer après une modification du prompt système, des outils ou d'un message antérieur renvoie une erreur 400.
• Sur l'API Claude et Google Cloud, l'outil computer_20251124 est refusé au profit du jeu d'outils computer_toolset_20260801.

Pour remplacer le forçage, la documentation conseille de garder auto et de poser strict: true sur l'outil. Ce réglage contraint les arguments : quand Claude appelle l'outil, son entrée respecte le schéma déclaré. Il ne décide pas que l'appel aura lieu. Pour cela, le message dit en toutes lettres quand l'outil s'applique. Le schéma doit être complet, et chaque objet y porte additionalProperties: false. Voici une requête acceptée par Claude Opus 5 et refusée par Claude Opus 5.5 :

{
  "model": "claude-opus-5",
  "max_tokens": 1024,
  "thinking": { "type": "disabled" },
  "tools": [{
    "name": "chercher_client",
    "description": "Retrouve la fiche d'un client à partir de son numéro",
    "input_schema": {
      "type": "object",
      "properties": {
        "numero": { "type": "string" }
      },
      "required": ["numero"],
      "additionalProperties": false
    }
  }],
  "tool_choice": { "type": "tool", "name": "chercher_client" },
  "messages": [{ "role": "user", "content": "Trouve la fiche du client 4021" }]
}

La même requête corrigée pour Claude Opus 5.5 :

{
  "model": "claude-opus-5-5",
  "max_tokens": 1024,
  "output_config": { "effort": "low" },
  "tools": [{
    "name": "chercher_client",
    "description": "Retrouve la fiche d'un client à partir de son numéro",
    "input_schema": {
      "type": "object",
      "properties": {
        "numero": { "type": "string" }
      },
      "required": ["numero"],
      "additionalProperties": false
    },
    "strict": true
  }],
  "tool_choice": { "type": "auto" },
  "messages": [{ "role": "user", "content": "Trouve la fiche du client 4021. Utilise l'outil chercher_client." }]
}

Le changement qui ne renvoie aucune erreur

Entre deux appels d'outils, Claude Opus 5 écrivait de courtes notes dans des blocs de type text. Claude Opus 5.5 les range dans des blocs de type thinking, et au réglage par défaut, display: "omitted", leur champ thinking arrive vide. Une interface qui affichait ces notes se tait, sans la moindre erreur. Trier les blocs par leur champ type évite de prendre un bloc de réflexion pour la réponse, mais ne rend pas le texte : il faut en plus régler thinking.display. La valeur "updates", en bêta sous l'en-tête thinking-display-updates-2026-08-18, renvoie les notes seules ; "summarized" y mêle le résumé complet du raisonnement, sans distinction possible entre les deux.

# requête : "thinking": {"type": "adaptive", "display": "updates"}, en-tête bêta thinking-display-updates-2026-08-18
for bloc in reponse.content:
    if bloc.type == "thinking" and bloc.thinking:
        afficher(bloc.thinking)  # note écrite entre deux appels d'outils
    elif bloc.type == "text":
        afficher(bloc.text)

Ce tri ne sert qu'à l'affichage. Dans une boucle d'outils, le message de l'assistant se renvoie tel quel, blocs de réflexion compris, même vides : l'API rejette un bloc modifié, déplacé ou retiré.

L'effort appliqué quand le champ manque descend d'un cran, comme le montre le tableau. Le tarif par jeton baisse, comme le chiffre la figure, mais la réflexion toujours active se facture en jetons de sortie même quand son texte n'est pas renvoyé : le compromis de la leçon sur le choix d'un modèle se recalcule à l'effort choisi. La déclaration d'outil de la leçon sur les outils est la première touchée, et une consigne écrite pour l'ancien comportement vieillit, comme le montre la leçon sur les consignes qui vieillissent.