Réflexion adaptative : la fin du paramètre thinking explicite

De tous les changements de cette génération, c’est celui qui casse le plus de code existant. Il mérite donc d’être compris avec précision, d’autant qu’il fait cohabiter deux mécanismes aux noms trompeusement proches : la réflexion étendue, que vous connaissez peut-être déjà, et la réflexion adaptative, qui la remplace sur les modèles actuels. Confondre les deux conduit droit à des requêtes rejetées ou à des paramètres silencieusement ignorés.

Deux mécanismes, deux philosophies

Reprenons d’abord l’ancien fonctionnement. Avec la réflexion étendue, c’était vous qui décidiez : vous activiez explicitement la réflexion en passant thinking.type dans la requête, et vous accordiez au modèle un budget de tokens qu’il pouvait consacrer à raisonner avant de répondre. Le contrôle était total, mais il reposait entièrement sur vous — c’était à vous d’estimer, tâche par tâche, combien de réflexion serait nécessaire, et de maintenir ces réglages dans le temps. Parmi les modèles actuels, seul Haiku 4.5 prend encore en charge ce mécanisme.

La réflexion adaptative inverse la logique. Le modèle décide lui-même quand réfléchir et combien : face à une question simple, il répond directement ; face à un problème qui le justifie, il prend le temps de raisonner. Ce mécanisme est disponible sur Opus 5 et Sonnet 5, et il est toujours actif sur Fable 5 — sur ce dernier modèle, il n’y a rien à activer ni à désactiver, la réflexion adaptative fait partie de son fonctionnement de base.

Voici la situation résumée pour les quatre modèles actuels :

La conséquence directe pour votre code : si une application activait la réflexion étendue et qu’elle migre vers Opus 5 ou Sonnet 5, cette activation doit être retirée, purement et simplement. Il ne s’agit pas d’adapter le paramètre, il s’agit de le supprimer.

Alors, comment piloter la profondeur de réflexion ?

C’est la question que se posent immédiatement les équipes qui avaient soigneusement calibré leurs budgets de réflexion. La réponse tient en un mot : effort. Ce paramètre, objet de la leçon suivante, est désormais le levier de contrôle, et la documentation est explicite sur ce point : là où la réflexion adaptative est disponible, effort est le moyen recommandé de contrôler la profondeur de réflexion. Vous ne dites plus au modèle « réfléchis avec tel budget » ; vous lui dites « travaille à tel niveau d’intensité », et il en déduit lui-même la part de réflexion nécessaire.

Un contresens circule à ce sujet, et il vaut la peine d’être désamorcé tout de suite : adaptive est le nom d’un mode de réflexion, pas une valeur d’effort. Ne passez jamais adaptive comme valeur du paramètre effort — les deux notions appartiennent à des registres différents, même si le vocabulaire de la documentation peut donner l’impression du contraire.

La contrainte propre à Opus 5

Il reste un piège, spécifique à Opus 5, qui touche les équipes ayant pris l’habitude inverse : non pas activer la réflexion, mais la désactiver systématiquement pour gagner en latence. Sur Claude Opus 5, la réflexion ne peut pas être désactivée aux niveaux d’effort xhigh et max. Une requête qui envoie thinking: {"type": "disabled"} à ces niveaux ne sera pas simplement ignorée : elle renvoie une erreur 400, et votre appel échoue.

En pratique, cela produit un scénario de panne sournois. Une application migre vers Opus 5, tout fonctionne aux niveaux d’effort courants, puis un développeur monte l’effort à xhigh pour une tâche exigeante — et la requête explose, parce qu’un thinking: disabled hérité de l’ancienne génération traînait encore dans la configuration. Lors d’une migration, cherchez donc les deux directions : le code qui activait la réflexion, et celui qui la désactivait. Les deux doivent disparaître.

Points clés à retenir

• Réflexion étendue : ancien mécanisme, conservé uniquement sur Haiku 4.5
• Réflexion adaptative : le modèle décide seul, toujours active sur Fable 5
• Sur les modèles actuels, pilotez la profondeur avec effort, pas avec thinking
• adaptive n’est pas une valeur d’effort
• Sur Opus 5, désactiver la réflexion à xhigh ou max renvoie une erreur 400