Effort

Le paramètre effort vous permet de contrôler la propension de Claude à dépenser des tokens 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 tous les modèles pris en charge sans nécessiter d'en-tête bêta.



Fonctionnement du paramètre 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 obtenir la capacité maximale absolue, 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 étendue (lorsqu'elle est activée)

Cette approche présente deux avantages majeurs :

1. Elle ne nécessite pas l'activation de la réflexion.
2. Elle peut affecter toute la dépense 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 beaucoup plus important sur l'efficacité.



Niveaux d'effort



Niveaux d'effort recommandés pour Claude Sonnet 5

Claude Sonnet 5 utilise par défaut l'effort high.

• 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é maximale absolue sans contrainte sur la dépense de tokens.



Niveaux d'effort recommandés pour 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é maximale absolue sans contrainte sur la dépense 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 passez 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'aller au-delà. 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 passez 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 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 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é : 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-4-8",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

print(response.content[0].text)



Quand ajuster le paramètre effort

• Utilisez l'effort max lorsque vous avez besoin de la capacité maximale absolue sans contrainte : le raisonnement le plus exhaustif et l'analyse la plus approfondie. Disponible sur Claude Fable 5, Claude Mythos 5, Claude Opus 4.8, Claude Mythos Preview, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 et Claude Sonnet 4.6.
• 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 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 dépense 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 une dépense supplémentaire.



Effort avec l'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 de passer à l'action
• Fournir des résumés détaillés des modifications
• Inclure des commentaires de code plus complets



Effort avec la réflexion étendue

Le paramètre effort fonctionne conjointement avec la réflexion étendue. Son comportement dépend du modèle :

• Claude Fable 5 et Claude Mythos 5 utilisent la réflexion adaptative, qui est toujours activée (aucune configuration thinking requise). thinking: {type: "disabled"} est rejeté. L'effort contrôle la profondeur de réflexion de la même manière que sur Opus 4.8 et Opus 4.7.
• Claude Opus 4.8 utilise la réflexion adaptative (thinking: {type: "adaptive"}), où l'effort est le contrôle recommandé pour la profondeur de réflexion. La réflexion étendue manuelle (thinking: {type: "enabled", budget_tokens: N}) n'est pas prise en charge et renvoie une erreur 400. Le modèle décide quand et combien réfléchir en fonction de chaque requête, il ne déclenche donc la réflexion que lorsque nécessaire. Aux niveaux d'effort high, xhigh et max, Claude réfléchit presque toujours en profondeur. Aux niveaux inférieurs, il peut ignorer la réflexion pour les problèmes plus simples. Définissez thinking: {type: "adaptive"} pour activer la réflexion ; sans cela, les requêtes s'exécutent sans réflexion.
• Claude Mythos Preview utilise la réflexion adaptative par défaut (aucune configuration thinking requise). thinking: {type: "disabled"} est rejeté. L'effort contrôle la profondeur de réflexion de la même manière que sur Opus 4.7 et Opus 4.6.
• Claude Opus 4.7 utilise la réflexion adaptative (thinking: {type: "adaptive"}), où l'effort est le contrôle recommandé pour la profondeur de réflexion. La réflexion étendue manuelle (thinking: {type: "enabled", budget_tokens: N}) n'est plus prise en charge sur Opus 4.7 ; utilisez plutôt la réflexion adaptative avec effort. Aux niveaux d'effort high, xhigh et max, Claude réfléchit presque toujours en profondeur. Aux niveaux inférieurs, il peut ignorer la réflexion pour les problèmes plus simples.
• Claude Opus 4.6 utilise la réflexion adaptative (thinking: {type: "adaptive"}), où l'effort est le contrôle recommandé pour la profondeur de réflexion. Bien que budget_tokens soit toujours accepté sur Opus 4.6, il est déprécié et sera supprimé dans une future version. Aux niveaux d'effort high et max, Claude réfléchit presque toujours en profondeur. Aux niveaux inférieurs, il peut ignorer la réflexion pour les problèmes plus simples.
• Claude Sonnet 5 utilise la réflexion adaptative, qui est activée par défaut (aucune configuration thinking requise), et l'effort est le contrôle recommandé pour la profondeur de réflexion. La réflexion étendue manuelle (thinking: {type: "enabled", budget_tokens: N}) n'est pas prise en charge et renvoie une erreur 400. Passez thinking: {type: "disabled"} pour désactiver la réflexion. Aux niveaux d'effort high (par défaut), xhigh et max, Claude réfléchit presque toujours en profondeur. Aux niveaux inférieurs, il peut ignorer la réflexion pour les problèmes plus simples.
• Claude Sonnet 4.6 utilise la réflexion adaptative (où l'effort contrôle la profondeur de réflexion). La réflexion manuelle avec le mode entrelacé (thinking: {type: "enabled", budget_tokens: N}) est toujours fonctionnelle mais dépréciée.
• Claude Opus 4.5 utilise la réflexion manuelle (thinking: {type: "enabled", budget_tokens: N}), où l'effort fonctionne conjointement avec le budget de tokens de réflexion. Définissez le niveau d'effort pour votre tâche, puis définissez le budget de tokens de réflexion en fonction de la complexité de la tâche.

Le paramètre effort peut être utilisé avec ou sans la réflexion étendue activée. Lorsqu'il est utilisé sans réflexion, il contrôle tout de même la dépense globale de tokens pour les réponses textuelles et les appels d'outils.



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é.



Étapes suivantes