Comment passer Claude Code à Opus 5.5 et conserver ce modèle
Passez Claude Code à Opus 5.5 avec l’ID complet ou l’alias opus, corrigez l’erreur 400 d’un ancien client et vérifiez l’effort medium ainsi que le fallback.
Sommaire
Vous lancez /model, choisissez Opus, mais Claude Code semble continuer avec un autre modèle, ou renvoie une erreur 400 avant la première réponse. Pour passer à Opus 5.5 de façon fiable, séparez trois vérifications : la commande de modèle, la version de Claude Code et un éventuel fallback déclenché par un refus de sécurité.
Utilisez l’ID complet lorsque la configuration doit être reproductible. N’employez l’alias opus qu’après avoir vérifié vers quel modèle il est résolu. Gardez aussi en tête qu’Opus 5.5 utilise medium comme effort par défaut, et non le niveau high d’Opus 5.
Utilisez l’ID complet pour fixer Opus 5.5
La commande la plus explicite est :
/model claude-opus-5-5Anthropic documente claude-opus-5-5 comme un ID fixe, sans suffixe de date. C’est le meilleur choix pour les consignes d’équipe, la documentation d’un projet et les fournisseurs personnalisés, car le modèle demandé reste parfaitement identifiable.
La variante courte est :
/model opusUtilisez cet alias uniquement lorsque Claude Code, ou le service derrière votre Base URL, indique qu’il correspond bien à Opus 5.5. L’alias est pratique en usage interactif, mais l’ID complet est plus simple à auditer lorsqu’une session ou une passerelle se comporte de façon inattendue.
| Objectif | Choix conseillé | Pourquoi |
|---|---|---|
| Fixer le modèle exact | /model claude-opus-5-5 | L’ID demandé est explicite et reproductible |
| Choisir rapidement l’Opus courant | /model opus | La commande est plus courte, mais le résultat doit être vérifié |
| Diagnostiquer un fournisseur tiers | Commencer par l’ID complet | Cela distingue un problème d’alias d’une indisponibilité du modèle |
Si vous utilisez Claude Code via une Base URL compatible Anthropic, par exemple BetterToken, la procédure /model reste identique ; vérifiez toutefois que le fournisseur expose réellement claude-opus-5-5 avant de vous fier à un alias.
Mettez Claude Code à jour avant le changement
Un client antérieur à la sortie du modèle peut refuser la sélection même si votre compte ou votre fournisseur la prend déjà en charge. Commencez par :
claude updateRedémarrez ensuite la session Claude Code active. Si vous utilisez l’application Claude pour ordinateur, mettez-la également à jour, puis relancez la commande avec l’ID complet.
Une issue communautaire a documenté un cas précis le 22 septembre 2026 : Claude Code 2.1.257 a été refusé avec claude_code_version_too_old, et la réponse exigeait 2.1.280 ou une version plus récente. Ce cas illustre le contrôle de version, mais ne définit pas un minimum universel et permanent. Suivez le minimum indiqué par l’erreur que vous recevez réellement, car une version ultérieure peut relever ce seuil.
Changez de modèle, puis vérifiez le résultat
Suivez cet ordre pour éviter qu’un problème en masque un autre :
- Exécutez
claude update, puis redémarrez Claude Code. - Saisissez
/model claude-opus-5-5dans la session de travail. - Vérifiez la sélection affichée par Claude Code après la commande. L’acceptation de la commande ne suffit pas à prouver que le changement a réussi.
- Avant une tâche longue ou coûteuse, rouvrez
/modelet contrôlez une nouvelle fois la sélection active.
Si l’ID complet fonctionne, mais que /model opus choisit un autre modèle, conservez l’ID complet. Le problème vient alors probablement de la résolution de l’alias, pas d’une impossibilité générale d’utiliser Opus 5.5.
Si aucune option ne fonctionne avec un endpoint tiers, vérifiez la disponibilité et le mapping du modèle chez ce fournisseur. L’API Claude officielle peut accepter l’ID standard alors qu’une passerelle compatible utilise un autre catalogue ou n’a pas encore activé le modèle.
L’effort par défaut est medium
Claude Opus 5.5 utilise en permanence adaptive thinking, avec un effort documenté par défaut à medium. Opus 5 utilisait high. Le changement peut donc modifier la latence, la consommation de tokens et la profondeur du raisonnement, même sans autre réglage visible dans Claude Code.
Dans un usage normal de Claude Code, inutile d’inventer un niveau d’effort uniquement pour terminer la sélection. Confirmez d’abord le modèle, puis évaluez le comportement par défaut sur la tâche réelle. Si votre client ou votre passerelle expose ce réglage, choisissez-le explicitement au lieu de supposer que l’ancien défaut s’applique encore.
Les intégrations personnalisées doivent aussi respecter les règles de requête d’Opus 5.5. Le modèle refuse la désactivation de thinking et les thinking budgets manuels. Si la sélection réussit, mais que la première requête renvoie 400, inspectez les transformations du payload en amont plutôt que de répéter /model.
Un message signalé peut emprunter un fallback
Un refus de sécurité est distinct de la sélection normale du modèle. Au niveau de l’API, Opus 5.5 peut répondre en HTTP 200 avec stop_reason: "refusal" et un objet stop_details. Si le client ou le fournisseur a activé un fallback, cette requête précise peut être réessayée sur un autre modèle.
Considérez cet événement comme un fallback au niveau de la requête, et non comme la preuve que votre choix /model enregistré a changé durablement. Avant de poursuivre un travail important, rouvrez /model et vérifiez le modèle actif. Anthropic précise aussi qu’en passant d’Opus 5.5 à la plupart des autres modèles, les tours suivants s’exécutent sans les thinking blocks précédents d’Opus 5.5 ; répétez les contraintes essentielles au lieu de supposer que tout le raisonnement a été conservé.
Procédez ainsi :
- Lisez le message de refus ou de signalement ; ne renvoyez pas la même requête sans modification.
- Si la demande est légitime, supprimez ou reformulez la partie ayant déclenché le classificateur.
- Vérifiez si le client ou le fournisseur a utilisé un modèle de fallback.
- Confirmez de nouveau Opus 5.5 avant de reprendre une tâche qui dépend d’un modèle fixe.
Résolvez les problèmes les plus fréquents
| Symptôme | Première vérification | Action suivante |
|---|---|---|
400 avec claude_code_version_too_old | Version de Claude Code ou de l’application | Exécuter claude update, redémarrer et réessayer l’ID complet |
| Opus 5.5 n’apparaît pas dans la liste | Catalogue du client ou du fournisseur obsolète | Mettre le client à jour, puis vérifier la disponibilité chez le fournisseur |
/model opus choisit un modèle inattendu | Résolution de l’alias | Utiliser /model claude-opus-5-5 et contrôler la sélection affichée |
| L’ID est accepté, mais la première requête renvoie 400 | Payload amont incompatible | Chercher un thinking désactivé/manuel ou une réécriture de passerelle |
| Un message est signalé et un autre modèle répond | Fallback après refus | Lire le refus, vérifier le modèle et répéter les contraintes clés |
| Le changement en cours de session manque de continuité | Les thinking blocks peuvent ne pas être transférés | Confirmer le modèle et fournir le contexte nécessaire au nouveau tour |
Vérification finale avant de commencer
- Claude Code est à jour et a été redémarré.
/model claude-opus-5-5est accepté sans erreur de version.- La sélection affichée correspond réellement à Opus 5.5.
- Vous prévoyez un effort
medium, sauf réglage explicite différent. - Après un message signalé ou refusé, vous avez vérifié si un fallback a été utilisé.
Une fois ces cinq points validés, l’ID complet est le moyen le plus sûr de garder une session reproductible. L’alias opus reste utile pour changer rapidement, mais son résultat doit être contrôlé plutôt que supposé.
