Effort

Le paramètre « effort » (effort) vous permet de contrôler le nombre de tokens que Claude consacre à répondre aux requêtes. Vous pouvez arbitrer entre l'exhaustivité des réponses et l'efficacité en tokens avec un seul modèle. Le paramètre effort est disponible sur tous les modèles pris en charge sans nécessiter d'en-tête bêta.



Fonctionnement de l'effort

Par défaut, Claude utilise un effort élevé, consacrant autant de tokens que nécessaire pour obtenir d'excellents résultats. Vous pouvez augmenter le niveau d'effort à max pour obtenir la capacité absolue la plus élevée, ou le réduire pour être plus économe en tokens, en optimisant la vitesse et le coût tout en acceptant une certaine réduction de capacité.

Le paramètre effort affecte tous les tokens de la réponse, notamment :

• Les réponses textuelles et les explications
• Les appels d'outils et les arguments de fonction
• La réflexion (lorsqu'elle est active)

Cette approche présente deux avantages majeurs :

1. Elle ne nécessite pas que la réflexion soit activée.
2. Elle peut affecter toute la consommation de tokens, y compris les appels d'outils. Par exemple, un effort plus faible signifierait que Claude effectue moins d'appels d'outils. Cela offre un degré de contrôle bien plus important sur l'efficacité.



Niveaux d'effort

xhigh est un niveau plus récent ; certains modèles qui prennent en charge max ne prennent pas en charge xhigh.



Niveaux d'effort recommandés pour Claude Sonnet 5

Claude Sonnet 5 utilise par défaut l'effort high sur l'API Claude et Claude Code.

• Effort high (par défaut) : Adapté au raisonnement complexe, à la programmation et aux tâches agentiques où la qualité prime sur la vitesse ou le coût.
• Effort xhigh : Pour les tâches de programmation et agentiques les plus difficiles. Consultez Rédiger des prompts pour Claude Sonnet 5.
• Effort medium : Réduction économique par rapport au niveau par défaut. Comparable à Claude Sonnet 4.6 avec un effort high.
• Effort low : Pour les charges de travail à volume élevé ou sensibles à la latence. Adapté aux cas d'usage de chat et hors programmation où un délai de réponse plus rapide est prioritaire.
• Effort max : Pour les tâches nécessitant la capacité absolue la plus élevée sans aucune contrainte sur la consommation de tokens.



Niveaux d'effort recommandés pour Claude Sonnet 4.6

Sonnet 4.6 utilise par défaut l'effort high. Définissez explicitement l'effort lorsque vous utilisez Sonnet 4.6 pour éviter une latence inattendue :

• Effort medium (valeur par défaut recommandée) : Meilleur équilibre entre vitesse, coût et performance pour la plupart des applications. Adapté à la programmation agentique, aux flux de travail intensifs en outils et à la génération de code.
• Effort low : Pour les charges de travail à volume élevé ou sensibles à la latence. Adapté aux cas d'usage de chat et hors programmation où un délai de réponse plus rapide est prioritaire.
• Effort high : Pour le raisonnement complexe et les tâches où la qualité prime sur la vitesse ou le coût.
• Effort max : Pour les tâches nécessitant la capacité absolue la plus élevée sans aucune contrainte sur la consommation de tokens.



Niveaux d'effort recommandés pour Claude Opus 4.7

Commencez par xhigh pour les cas d'usage de programmation et agentiques, et utilisez high comme minimum pour la plupart des charges de travail sensibles à l'intelligence. Descendez à medium pour les charges de travail sensibles au coût, ou montez à max uniquement lorsque vos évaluations montrent une marge de progression mesurable à xhigh.

La valeur par défaut de l'API est high. Pour utiliser xhigh, définissez effort explicitement ; la valeur que vous transmettez remplace la valeur par défaut.

Claude Opus 4.7 respecte également les niveaux d'effort plus strictement que Claude Opus 4.6, en particulier à low et medium. À des niveaux d'effort plus faibles, le modèle limite son travail à ce qui a été demandé plutôt que d'en faire plus que nécessaire. Si vous observez un raisonnement superficiel sur des problèmes complexes avec Claude Opus 4.7, augmentez l'effort plutôt que de contourner le problème par le prompt. Si vous devez maintenir un effort faible pour des raisons de latence, ajoutez des indications ciblées comme « Cette tâche implique un raisonnement en plusieurs étapes. Réfléchissez attentivement avant de répondre. »

Lorsque vous exécutez Claude Opus 4.7 avec un effort xhigh ou max, définissez un max_tokens élevé afin que le modèle dispose de suffisamment d'espace pour réfléchir et agir à travers les sous-agents et les appels d'outils. Commencer à 64k tokens et ajuster à partir de là constitue une valeur par défaut raisonnable.



Niveaux d'effort recommandés pour Claude Opus 4.8

Les recommandations pour Claude Opus 4.7 s'appliquent également à Claude Opus 4.8. Commencez par xhigh pour les cas d'usage de programmation et agentiques, utilisez high pour la plupart des autres charges de travail sensibles à l'intelligence, et descendez à medium ou low uniquement lorsque vous avez mesuré que le niveau inférieur maintient la qualité sur vos évaluations.

La valeur par défaut de l'API est high. Définissez effort explicitement pour utiliser un niveau différent ; la valeur que vous transmettez remplace la valeur par défaut.

Lorsque vous exécutez Claude Opus 4.8 avec un effort xhigh ou max, définissez un max_tokens élevé afin que le modèle dispose de suffisamment d'espace pour réfléchir et agir à travers les sous-agents et les appels d'outils. Commencer à 64k tokens et ajuster à partir de là constitue une valeur par défaut raisonnable.



Niveaux d'effort recommandés pour Claude Opus 5

Claude Opus 5 prend en charge les cinq niveaux d'effort. Commencez par high, la valeur par défaut, et ajustez en fonction de vos évaluations : montez à xhigh pour les travaux de programmation et agentiques exigeants, ou à max lorsqu'une tâche justifie une consommation de tokens sans contrainte, et utilisez low et medium généreusement comme contrôle principal du coût en tokens et du temps de réponse partout où vos évaluations montrent que la qualité se maintient. Si vous avez repris des paramètres d'effort d'un modèle antérieur, effectuez un nouveau balayage des niveaux d'effort sur vos évaluations plutôt que de les réutiliser.

L'effort contrôle le volume de réflexion, pas la longueur visible de la réponse : sur Claude Opus 5, modifier l'effort ne raccourcit pas de manière fiable les réponses, donc utilisez le prompt pour contrôler la longueur à la place.

La valeur par défaut de l'API est high. Définissez effort explicitement pour utiliser un niveau différent ; la valeur que vous transmettez remplace la valeur par défaut.

Sur Claude Opus 5, la réflexion ne peut pas être désactivée avec un effort xhigh ou max : les requêtes qui définissent thinking: {"type": "disabled"} à ces niveaux renvoient une erreur 400. Consultez Effort avec réflexion.

Lorsque vous exécutez Claude Opus 5 avec un effort xhigh ou max, définissez un max_tokens élevé afin que le modèle dispose de suffisamment d'espace pour réfléchir et agir à travers les sous-agents et les appels d'outils. Commencer à 64k tokens et ajuster à partir de là constitue une valeur par défaut raisonnable.



Niveaux d'effort recommandés pour Claude Fable 5

L'effort est le contrôle principal pour arbitrer entre intelligence, latence et coût sur Claude Fable 5. Commencez par high, la valeur par défaut, pour la plupart des tâches, utilisez xhigh pour les charges de travail les plus sensibles à la capacité, et descendez à medium ou low pour le travail de routine. Les paramètres d'effort plus faibles sur Claude Fable 5 donnent tout de même de bons résultats et dépassent souvent les performances de xhigh sur les modèles précédents. À high et xhigh, définissez un max_tokens élevé : il s'agit d'une limite stricte sur la sortie totale, réflexion plus texte de réponse. Consultez Contrôle des coûts.

Réduisez l'effort si une tâche se termine mais prend plus de temps que nécessaire, ou si vous souhaitez un style de travail plus rapide et plus interactif. Les mêmes recommandations s'appliquent à Claude Mythos 5. Pour des conseils plus complets, consultez Rédiger des prompts pour Claude Fable 5.



Utilisation de base

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)



Quand ajuster le paramètre effort

• Utilisez l'effort max lorsque vous avez besoin de la capacité absolue la plus élevée sans aucune contrainte : le raisonnement le plus exhaustif et l'analyse la plus approfondie. Disponible sur les modèles Claude 4.6 et ultérieurs ainsi que Claude Mythos Preview.
• Utilisez l'effort xhigh pour la programmation avancée et le travail agentique complexe nécessitant une exploration étendue, comme les appels d'outils répétés et la recherche détaillée. Disponible sur Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7 et Claude Sonnet 5.
• Utilisez l'effort high (la valeur par défaut) pour le raisonnement complexe, l'analyse nuancée, les problèmes de programmation difficiles ou toute tâche où la qualité prime sur la vitesse ou le coût.
• Utilisez l'effort medium comme option équilibrée lorsque vous souhaitez une performance solide sans la consommation complète de tokens de l'effort high.
• Utilisez l'effort low lorsque vous optimisez la vitesse (car Claude répond avec moins de tokens) ou le coût. Par exemple, pour des tâches de classification simples, des recherches rapides ou des cas d'usage à volume élevé où les améliorations marginales de qualité ne justifient pas une latence ou des dépenses supplémentaires.



Effort avec l'utilisation d'outils

Lors de l'utilisation d'outils, le paramètre effort affecte à la fois les explications entourant les appels d'outils et les appels d'outils eux-mêmes. Les niveaux d'effort plus faibles ont tendance à :

• Combiner plusieurs opérations en moins d'appels d'outils
• Effectuer moins d'appels d'outils
• Passer directement à l'action sans préambule
• Utiliser des messages de confirmation concis après l'achèvement

Les niveaux d'effort plus élevés peuvent :

• Effectuer plus d'appels d'outils
• Expliquer le plan avant de passer à l'action
• Fournir des résumés détaillés des modifications
• Inclure des commentaires de code plus complets



Effort avec réflexion

Le paramètre thinking contrôle si Claude réfléchit dans des blocs de réflexion avant de répondre ; le paramètre effort contrôle la quantité de travail que Claude consacre à l'ensemble de la réponse, ce qui, en mode adaptatif, inclut la fréquence et la profondeur de sa réflexion. Ne passez pas adaptive comme valeur d'effort : adaptive est un mode de réflexion, pas un niveau d'effort.

À des niveaux d'effort plus élevés, Claude réfléchit sur la plupart des requêtes et plus longuement ; à des niveaux plus faibles, il peut ignorer entièrement la réflexion pour les problèmes plus simples. Consultez Réflexion et effort pour des conseils complets sur la façon dont les deux contrôles fonctionnent ensemble.

Sur Claude Opus 4.5, le seul modèle à réflexion étendue uniquement qui prend en charge l'effort, celui-ci fonctionne conjointement avec budget_tokens : définissez le niveau d'effort pour votre tâche, puis définissez le budget de tokens de réflexion en fonction de la profondeur de raisonnement requise par la tâche.

Pour la disponibilité de la réflexion par modèle, consultez le tableau de configuration par modèle. L'effort fonctionne avec ou sans réflexion ; consultez Fonctionnement de l'effort.



Modifier l'effort en cours de conversation

output_config.effort est un paramètre au niveau de la requête : chaque requête porte sa propre valeur, donc pour exécuter une partie ultérieure d'une conversation à un niveau d'effort différent, définissez la nouvelle valeur sur la requête suivante. Le niveau d'effort s'applique à l'ensemble de la requête. Comme l'effort façonne le prompt rendu, le modifier entre les requêtes ne préserve pas les préfixes mis en cache des tours précédents ; si vous comptez sur la mise en cache des prompts au cours d'une longue session, choisissez un niveau d'effort au début et maintenez-le constant.



Bonnes pratiques

1. Définissez l'effort explicitement : L'API utilise high par défaut, mais le bon point de départ dépend de votre modèle et de votre charge de travail.
2. Utilisez low pour les tâches sensibles à la vitesse ou simples : Lorsque la latence est importante ou que les tâches sont simples, un effort faible peut réduire considérablement les temps de réponse et les coûts.
3. Testez votre cas d'usage : L'impact des niveaux d'effort varie selon le type de tâche. Évaluez les performances sur vos cas d'usage spécifiques avant le déploiement.
4. Envisagez un effort dynamique : Ajustez l'effort en fonction de la complexité de la tâche. Les requêtes simples peuvent justifier un effort faible tandis que la programmation agentique et le raisonnement complexe bénéficient d'un effort élevé. Consultez le point suivant avant de le faire varier au sein d'une même conversation.
5. Maintenez l'effort constant dans les conversations mises en cache : Modifier la valeur de l'effort entre les requêtes invalide la mise en cache des prompts, donc faites varier l'effort entre les charges de travail plutôt qu'au sein d'une conversation qui dépend des correspondances de cache. Consultez Réflexion et mise en cache des prompts.



Prochaines étapes