Effort

Le paramètre effort vous permet de contrôler l'empressement de Claude à dépenser des tokens lors de la réponse aux demandes. Cela vous donne la possibilité de trouver un équilibre entre la complétude de la réponse et l'efficacité des tokens, le tout avec un seul modèle. Le paramètre effort est généralement disponible sur tous les modèles pris en charge 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 d'excellents résultats. Vous pouvez augmenter le niveau d'effort à max pour la capacité absolue la plus élevée, ou le réduire pour être plus conservateur avec l'utilisation des tokens, en optimisant pour la vitesse et le coût tout en acceptant une certaine réduction de capacité.

Le paramètre effort affecte tous les tokens dans la réponse, y compris :

• Les réponses texte et les explications
• Les appels d'outils et les arguments de fonction
• La réflexion étendue (lorsqu'elle est activée)

Cette approche a deux avantages majeurs :

1. Elle ne nécessite pas que la réflexion soit activée pour l'utiliser.
2. Elle peut affecter toutes les dépenses de tokens, y compris les appels d'outils. Par exemple, un effort inférieur signifierait que Claude effectue moins d'appels d'outils. Cela donne un degré de contrôle beaucoup plus grand sur l'efficacité.

Niveaux d'effort

Niveaux d'effort recommandés pour Sonnet 4.6

Sonnet 4.6 utilise par défaut un effort high. Définissez explicitement l'effort lors de l'utilisation de Sonnet 4.6 pour éviter une latence inattendue :

• Effort moyen (par défaut recommandé) : Meilleur équilibre entre la vitesse, le coût et les performances pour la plupart des applications. Convient pour le codage agentique, les flux de travail lourds en outils et la génération de code.
• Effort faible : Pour les charges de travail à haut volume ou sensibles à la latence. Convient pour le chat et les cas d'usage non-codage où un délai d'exécution plus rapide est prioritaire.
• Effort élevé : Pour les tâches nécessitant l'intelligence maximale de Sonnet 4.6.
• Effort maximal : Pour les tâches nécessitant la capacité absolue la plus élevée sans contraintes sur la dépense de tokens.

Utilisation de base

Quand ajuster le paramètre effort

• Utilisez effort maximal quand vous avez besoin de la capacité absolue la plus élevée sans contraintes : le raisonnement le plus complet et l'analyse la plus profonde. Disponible sur Claude Mythos Preview, Claude Opus 4.6, et Claude Sonnet 4.6.
• Utilisez effort élevé (par défaut) quand vous avez besoin du meilleur travail de Claude : raisonnement complexe, analyse nuancée, problèmes de codage difficiles, ou toute tâche où la qualité est la priorité absolue.
• Utilisez effort moyen comme option équilibrée quand vous voulez des performances solides sans la dépense complète de tokens d'un effort élevé.
• Utilisez effort faible quand vous optimisez pour la vitesse (parce que Claude répond avec moins de tokens) ou le coût. Par exemple, tâches de classification simples, recherches rapides, ou 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 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érieur ont tendance à :

• Combiner plusieurs opérations en moins d'appels d'outils
• Faire moins d'appels d'outils
• Procéder directement à l'action sans préambule
• Utiliser des messages de confirmation brefs après la fin

Les niveaux d'effort supérieur peuvent :

• Faire plus d'appels d'outils
• Expliquer le plan avant de prendre des mesures
• 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 aux côtés de la réflexion étendue. Son comportement dépend du modèle :

• Claude Mythos Preview utilise adaptive thinking par défaut (aucune configuration thinking requise). thinking: {type: "disabled"} est rejeté. L'effort contrôle la profondeur de la réflexion de la même manière que sur Opus 4.6.
• Claude Opus 4.6 utilise adaptive thinking (thinking: {type: "adaptive"}), où l'effort est le contrôle recommandé pour la profondeur de la 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. À un effort high et max, Claude réfléchit presque toujours profondément. À des niveaux inférieur, il peut ignorer la réflexion pour les problèmes plus simples.
• Claude Sonnet 4.6 utilise adaptive thinking (où l'effort contrôle la profondeur de la réflexion). La réflexion manuelle avec mode entrelacé (thinking: {type: "enabled", budget_tokens: N}) est toujours fonctionnelle mais dépréciée.
• Claude Opus 4.5 et autres modèles Claude 4 utilisent la réflexion manuelle (), où l'effort fonctionne aux côtés du 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 réflexion étendue activée. Lorsqu'il est utilisé sans réflexion, il contrôle toujours la dépense globale de tokens pour les réponses texte et les appels d'outils.

Meilleures pratiques

1. Définissez l'effort explicitement : L'API utilise par défaut high, 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 : Quand 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 de déployer.
4. Considérez 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é.