Effort

Le paramètre effort vous permet de contrôler le nombre de tokens que Claude dépense lorsqu'il répond 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 les modèles suivants sans en-tête bêta requis.



Comment fonctionne l'effort

Par défaut, Claude utilise un effort élevé, dépensant autant de tokens que nécessaire pour obtenir d'excellents résultats. Vous pouvez augmenter le niveau d'effort à max pour la capacité la plus élevée possible, ou le réduire pour être plus économe dans l'utilisation des 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, y compris :

• Les réponses textuelles et les explications
• Les appels d'outils et les arguments de fonctions
• 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 dépense en tokens, y compris les appels d'outils. Par exemple, un effort plus faible signifie 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, au codage et aux tâches agentiques où la qualité compte plus que la vitesse ou le coût.
• Effort xhigh : Pour les tâches de codage et agentiques les plus difficiles. Consultez Prompting Claude Sonnet 5.
• Effort medium : Réduction économique par rapport à la valeur par défaut. Comparable à Claude Sonnet 4.6 à effort high.
• Effort low : Pour les charges de travail à haut volume ou sensibles à la latence. Adapté au chat et aux cas d'usage hors codage où un délai de réponse plus rapide est prioritaire.
• Effort max : Pour les tâches nécessitant la capacité la plus élevée possible sans contrainte sur la dépense en 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é au codage agentique, aux flux de travail intensifs en outils et à la génération de code.
• Effort low : Pour les charges de travail à haut volume ou sensibles à la latence. Adapté au chat et aux cas d'usage hors codage où un délai de réponse plus rapide est prioritaire.
• Effort high : Pour le raisonnement complexe et les tâches où la qualité compte plus que la vitesse ou le coût.
• Effort max : Pour les tâches nécessitant la capacité la plus élevée possible sans contrainte sur la dépense en tokens.



Niveaux d'effort recommandés pour Claude Opus 4.7

Commencez avec xhigh pour les cas d'usage de codage 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 aux coûts, 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. Aux niveaux d'effort inférieurs, 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 la 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 à l'effort xhigh ou max, définissez un max_tokens élevé afin que le modèle ait la place de réfléchir et d'agir à travers les sous-agents et les appels d'outils. Commencer à 64k tokens et ajuster à partir de là est 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 avec xhigh pour les cas d'usage de codage 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 à l'effort xhigh ou max, définissez un max_tokens élevé afin que le modèle ait la place de réfléchir et d'agir à travers les sous-agents et les appels d'outils. Commencer à 64k tokens et ajuster à partir de là est 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 avec high, la valeur par défaut, et ajustez en fonction de vos évaluations : montez à xhigh pour le travail de codage et agentique exigeant, ou à max lorsqu'une tâche justifie une dépense en tokens sans contrainte, et utilisez low et medium librement 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 réglages d'effort d'un modèle antérieur, effectuez un nouveau balayage 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 les réponses de manière fiable, 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 à l'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 à l'effort xhigh ou max, définissez un max_tokens élevé afin que le modèle ait la place de réfléchir et d'agir à travers les sous-agents et les appels d'outils. Commencer à 64k tokens et ajuster à partir de là est 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 avec 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 réglages d'effort inférieurs sur Claude Fable 5 restent performants et dépassent souvent les performances de xhigh sur les modèles précédents. À high et xhigh, définissez un max_tokens élevé : c'est 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 recommandations plus complètes, consultez Prompting 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é la plus élevée possible sans contrainte : le raisonnement le plus approfondi et l'analyse la plus profonde. Disponible sur Claude 4.6 et les modèles ultérieurs ainsi que Claude Mythos Preview.
• Utilisez l'effort xhigh pour le codage avancé 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 codage difficiles, ou toute tâche où la qualité compte plus que la vitesse ou le coût.
• Utilisez l'effort medium comme option équilibrée lorsque vous souhaitez des performances solides sans la dépense complète en 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, les tâches de classification simples, les recherches rapides, ou les cas d'usage à haut volume où les améliorations marginales de qualité ne justifient pas une latence ou une dépense supplémentaire.



Effort avec utilisation d'outils

Lors de l'utilisation d'outils, le paramètre effort affecte à la fois les explications autour des appels d'outils et les appels d'outils eux-mêmes. Les niveaux d'effort inférieurs 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 supérieurs peuvent :

• Effectuer plus d'appels d'outils
• Expliquer le plan avant d'agir
• 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.

Aux niveaux d'effort supérieurs, Claude réfléchit sur la plupart des requêtes et plus longuement ; aux niveaux inférieurs, il peut ignorer complètement la réflexion pour les problèmes plus simples. Consultez Réflexion et effort pour des recommandations complètes sur la manière 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 dont la tâche a besoin.

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 Comment fonctionne 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 sur une longue session, choisissez un niveau d'effort au début et gardez-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 compte 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 le codage 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 repose sur les correspondances de cache. Consultez Réflexion et mise en cache des prompts.



Prochaines étapes