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é, en 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 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 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é beaucoup plus grand de contrôle sur l'efficacité.

Niveaux d'effort

Utilisation de base

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-6",
    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 dois-je ajuster le paramètre effort ?

• Utilisez l'effort maximal lorsque vous avez besoin de la capacité absolue la plus élevée sans contraintes — le raisonnement le plus approfondi et l'analyse la plus profonde. Disponible uniquement sur Opus 4.6 ; les demandes utilisant max sur d'autres modèles retourneront une erreur.
• Utilisez l'effort élevé (par défaut) lorsque 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 l'effort moyen comme option équilibrée lorsque vous voulez une performance solide sans la dépense complète de tokens de l'effort élevé.
• Utilisez l'effort faible lorsque vous optimisez pour la vitesse (parce que Claude répond avec moins de tokens) ou le coût — par exemple, des tâches de classification simples, des recherches rapides, ou des cas d'usage à haut volume où les améliorations de qualité marginales 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
• Effectuer moins d'appels d'outils
• Procéder directement à l'action sans préambule
• Utiliser des messages de confirmation brefs après l'achèvement

Les niveaux d'effort supérieur 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 aux côtés de la réflexion étendue. Son comportement dépend du modèle :

• Claude Opus 4.6 utilise la réflexion adaptative (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 pense presque toujours profondément. À des niveaux inférieur, il peut ignorer la réflexion pour les problèmes plus simples.
• Claude Opus 4.5 utilise la réflexion manuelle (thinking: {type: "enabled", budget_tokens: N}), 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 textuelles et les appels d'outils.

Meilleures pratiques

1. Commencez par high : Utilisez des niveaux d'effort inférieur pour troquer la performance contre l'efficacité des tokens.
2. Utilisez low pour les tâches sensibles à la vitesse ou simples : Lorsque la latence est importante ou que les tâches sont simples, l'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. 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é.