Qu'est-ce que la réflexion étendue ?

Certaines tâches nécessitent plus qu'une réponse rapide. Claude peut travailler sur un problème avant de répondre — une fonctionnalité appelée réflexion étendue. Dans cette leçon, nous allons examiner ce qu'est la réflexion, comment l'activer et quand elle est vraiment utile.

Voici le mode d'échec que nous essayons d'éviter. Posez à un modèle une question multi-étapes et faites-le répondre immédiatement, et il peut se tromper avec confiance :

Diagramme d'une application envoyant une question multi-étapes sur les pommes à un modèle, qui répond immédiatement avec la mauvaise réponse : vous auriez 6,5 pommes

Qu'est-ce que la réflexion étendue ?

La réflexion étendue permet à Claude de raisonner étape par étape avant de produire une réponse finale. Lorsqu'elle est activée, Claude génère des tokens de raisonnement interne — souvent appelés une chaîne de pensée — puis fournit la réponse. Le raisonnement n'est pas caché : vous pouvez le voir dans la réponse aux côtés du texte final.

Réflexion adaptative sur Opus 4.7

Avec Opus 4. 7, la réflexion est adaptative. Vous ne choisissez pas un budget de tokens. Vous l'activez simplement, et Claude décide dynamiquement quand réfléchir et combien.

Pour contrôler la profondeur de la réflexion de Claude, utilisez le paramètre effort. Un piège : il va à l'intérieur de output_config, pas à côté du bloc thinking. Les niveaux sont :

• low
• medium
• high (par défaut)
• xhigh (très élevé)
• max

Quand l'utiliser (et quand la sauter)

La réflexion étendue aide pour :

• Les mathématiques et la logique multi-étapes
• Le débogage de code
• L'analyse réglementaire
• Tout ce qui implique des compromis ou la comparaison d'options

Diapositive montrant les cas d'usage de la réflexion étendue : mathématiques, logique multi-étapes, débogage de code, analyse réglementaire et comparaisons complexes

Évitez-la pour la classification simple, l'extraction ou le boilerplate. Pour ces tâches, elle ajoute simplement de la latence et des coûts sans améliorer réellement les résultats.

La réflexion en action

Voyons-la fonctionner. Voici une boucle d'agent avec un outil météo, et nous allons demander à Claude de planifier un road trip depuis San Francisco — deux arrêts, en pesant la météo et le temps de trajet. C'est un vrai compromis, le type de question où la réflexion justifie son utilité.

import anthropic

client = anthropic. Anthropic()

weather_tool = { "name": "get_weather", "description": "Get the current weather for a city. ", "input_schema": { "type": "object", "properties": { "city": {"type": "string", "description": "City name"} }, "required": ["city"], }, }

response = client. messages. create( model="claude-opus-4-7", max_tokens=16000, thinking={"type": "adaptive"}, output_config={"effort": "high"}, # low | medium | high | xhigh | max tools=[weather_tool], messages=[ { "role": "user", "content": "Plan a road trip out of San Francisco with two stops, " "weighing weather and drive time. ", } ], )

Quand vous exécutez cela, la sortie est plus intéressante que d'habitude. Vous verrez des blocs de réflexion où Claude travaille sur les compromis, suivis d'appels d'outils pour vérifier chaque ville, et finalement un bloc de texte avec la recommandation réelle.

Le raisonnement est visible — c'est tout l'intérêt.

Pourquoi cela compte en production

Dans une application de production, c'est la différence entre un agent qui trouve les problèmes un à la fois et un agent qui les relie. Prenez une application d'examen de conformité : activer la réflexion adaptative sur l'appel d'examen automatique permet à l'agent de raisonner à travers les sections du rapport — en détectant des choses comme une spécification de charge de vent dans la section trois qui entre en conflit avec la spécification de matériau ailleurs dans le document.

Interface d'application d'examen de conformité avec une case à cocher Examen approfondi activée, exécutant un examen automatique qui fait des références croisées entre les sections du rapport

Résumé

• La réflexion étendue donne à Claude l'espace pour raisonner avant de répondre, et le raisonnement est visible dans la réponse.
• Avec Opus 4. 7, activez-la avec thinking: {"type": "adaptive"} — aucun budget de tokens nécessaire ; Claude décide quand et combien réfléchir.
• Réglez la profondeur avec le paramètre effort à l'intérieur de output_config : low, medium, high (par défaut), xhigh, ou max.
• Utilisez-la pour les problèmes difficiles et lourds de compromis. Évitez-la pour les problèmes simples — là elle coûte juste de la latence et des tokens.