SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Limite d’outils Claude atteinte pour ce tour : que faire ?

Le message indique que Claude a atteint la limite d’appels d’outils de ce tour, pas votre quota. Découvrez pourquoi et comment reprendre la tâche dans un nouveau tour.

Ce que signifie la limite d’utilisation des outils pour ce tour

Une limite d’utilisation des outils pour un tour signifie que Claude a interrompu sa réponse avant la fin parce qu’il avait atteint le nombre maximal d’appels d’outils autorisés pour cette réponse. Cela ne signifie pas que votre compte a épuisé son quota d’utilisation. Tout ce qu’il a trouvé avant l’interruption reste disponible dans la conversation. Envoyez un nouveau message pour lui demander de continuer. Un nouveau tour démarre alors avec un nouveau budget.

Dans l’Agent SDK, un tour correspond à un passage dans la boucle de l’agent. Claude génère une sortie contenant des appels d’outils, le client exécute ces outils, puis les résultats sont renvoyés à Claude pour la décision suivante. Ce cycle se répète sans vous redonner le contrôle. La boucle se termine lorsque Claude génère une réponse qui ne contient aucun appel d’outil. La limite de tours du SDK compte chaque passage, y compris la réponse finale qui ne contient aucun appel d’outil.

La limite d’utilisation de votre forfait est un contrôle distinct

La limite du forfait comptabilise ce que vous avez utilisé pendant une période donnée. La page du centre d’aide d’Anthropic consacrée aux messages d’erreur, consultée le 9 novembre 2026, indique Approaching session limit lorsque vous vous en approchez, puis 5-hour limit reached - resets [time] une fois que vous l’avez dépassée. La limite hebdomadaire utilise des messages similaires, qui indiquent un jour et une heure de réinitialisation. Dans les deux cas, un horaire est indiqué. Sans crédits d’utilisation, il suffit d’attendre cet horaire pour résoudre le problème. Rien de ce que vous saisissez entre-temps ne peut vous aider. Si les crédits d’utilisation sont activés pour un forfait payant, la page indique que votre travail continue en utilisant ces crédits et que le message devient 5-hour limit resets [time] - continuing with usage credits. Cette continuation s’arrête lorsque vous atteignez votre limite mensuelle de dépenses ou lorsque votre solde de crédits est épuisé avec le rechargement automatique désactivé. Les comptes Ultra vérifiés n’ont pas de limite de session de cinq heures, mais les limites hebdomadaires restent applicables.

Le message concernant l’utilisation d’outils se comporte à l’inverse. Il apparaît au milieu d’une tâche, et un seul message de suivi permet de continuer immédiatement. Les appels d’outils déjà effectués sont tout de même comptabilisés dans l’utilisation de votre forfait. Continuer ne réinitialise pas votre quota, et les crédits d’utilisation peuvent également permettre de poursuivre le travail après l’atteinte d’une limite du forfait. Pour le cas du quota, que faire lorsque Claude indique que la limite est atteinte présente les options disponibles, et comment les limites d’utilisation de Claude sont comptabilisées explique les périodes correspondantes.

Pourquoi un tour dispose d’un budget d’outils

Chaque appel d’outil consomme du contexte. L’appel est envoyé, l’outil s’exécute, puis l’intégralité du résultat revient dans la conversation. La lecture d’un fichier volumineux ou l’exécution d’une commande produisant une sortie longue peut consommer des milliers de tokens en une seule étape, et ce texte reste dans le contexte pour le reste de la session. La documentation de la boucle d’agent d’Anthropic l’indique clairement : le contexte s’accumule au fil des tours, si bien qu’une session comportant de nombreux appels d’outils contient beaucoup plus d’informations qu’une session courte.

Le budget du tour permet d’arrêter une boucle qui ne progresse plus. Un agent qui effectue une recherche, lit des fichiers, recommence la recherche et ne trouve toujours rien continuera ainsi jusqu’à une interruption. Le budget constitue cette interruption. Il vous rend le contrôle à un moment où vous pouvez réorienter le travail, ce qui coûte beaucoup moins cher que de laisser la boucle remplir toute la fenêtre de contexte.

Où cette limite est visible dans l’API

La documentation publique d’Anthropic sur les erreurs ne fournit aucun nombre d’appels d’outils par tour pour l’application Claude. Toute valeur exacte que vous lisez à ce sujet est donc une estimation de son auteur. Un type de limite similaire est documenté pour l’API (interface de programmation d’application). C’est dans cette documentation que le comportement réel est visible.

Le champ stop_reason d’une réponse de la Messages API indique pourquoi la génération s’est arrêtée. Les valeurs documentées sont end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal et model_context_window_exceeded. Deux d’entre elles décrivent la situation abordée dans ce guide.

pause_turn est renvoyé lorsque la boucle d’échantillonnage côté serveur atteint sa limite d’itérations pendant l’exécution d’outils côté serveur, comme la recherche web. Au 25 octobre 2026, la page consacrée aux raisons d’arrêt et aux solutions de repli indique une valeur par défaut de 10 itérations par requête. La solution documentée consiste à renvoyer la réponse sans modification en tant que message de l’assistant. Claude reprend ainsi à l’endroit où il s’était arrêté. Vous ne devez pas ajouter un nouveau message utilisateur lui demandant de continuer : l’exemple documenté envoie uniquement le message utilisateur d’origine, suivi du contenu de l’assistant mis en pause.

max_tokens signifie que la réponse a atteint la limite de tokens de sortie définie dans la requête. Si la troncature intervient au milieu d’un bloc d’utilisation d’outil incomplet, l’appel de l’outil ne peut pas être exécuté. La réponse documentée consiste à réessayer avec une valeur max_tokens supérieure.

Consultez les valeurs actuelles sur la page consacrée aux raisons d’arrêt et aux solutions de repli plutôt que de vous fier à celles indiquées ici. Les valeurs par défaut de cette page changent. Un nombre obsolète est pire que l’absence de nombre.

Pourquoi un chat épuise ses appels d’outils

  • Une question sans point d’arrêt naturel. « Trouve tout ce qui a été écrit sur X » ne donne au modèle aucune indication lui permettant de savoir que la recherche est terminée.
  • La lecture répétée des mêmes informations, parce que la réponse ne se trouve pas à l’endroit où le modèle s’attendait à la trouver.
  • De gros résultats d’outils. Une longue page web ou un fichier volumineux consomme l’espace nécessaire au reste du tour.
  • Plusieurs tâches indépendantes dans un même message. Chaque tâche nécessite ses propres appels d’outils, et tous consomment le même budget.
  • Les connecteurs et serveurs MCP (model context protocol) que vous n’utilisez pas pour cette tâche. Une fois chargés, ils occupent de l’espace dans la conversation et offrent au modèle davantage de possibilités de consommer le tour.

Comment obtenir une réponse complète

Répondez « continue », ou mieux, donnez une instruction courte qui indique ce qui manque encore. Cela ouvre un nouveau tour avec un nouveau budget. La conversation précédente reste dans le contexte, et Claude reprend donc le travail sans répéter les appels d’outils déjà effectués.

S’il s’arrête deux fois au même endroit, la tâche est trop large pour un seul tour. Découpez-la. Au lieu de demander un audit complet d’un dépôt, demandez d’abord la liste des fichiers, puis posez une question sur un fichier par message. Quatre petits tours permettent de terminer un travail qu’un seul grand tour ne peut pas achever.

Réduisez ce que le modèle doit rechercher. Indiquez le chemin exact du fichier ou la chaîne d’erreur exacte, et collez le journal si vous l’avez déjà. Un journal collé coûte un message. Demander au modèle de rechercher ce journal nécessite plusieurs appels d’outils, et il peut trouver le mauvais.

Désactivez les connecteurs dont vous n’avez pas besoin pour le moment. Le centre d’aide d’Anthropic indique que chaque connecteur occupe de l’espace dans une conversation. Avec le réglage Auto par défaut, Claude décide quels connecteurs charger. Avec Always available, tous sont chargés au début, et chaque connecteur chargé consomme du contexte et élargit l’ensemble des actions que le modèle peut choisir. Si vous conservez un grand nombre de connecteurs, le réglage On demand ne les charge qu’après que Claude a recherché celui qui convient. Le même raisonnement s’applique à une longue session de coding : garder le contexte d’une session Claude Code à une taille réduite fait la différence entre un agent qui termine son travail et un agent qui s’arrête à mi-chemin.

Définissez vous-même le budget de tours lors de l’exécution d’un agent

Si vous pilotez Claude depuis votre propre code, vous contrôlez le budget de tours de la boucle. Le Claude Agent SDK (kit de développement logiciel) expose max_turns en Python et maxTurns en TypeScript. Ces paramètres comptent les tours avec appels d’outils ainsi que la réponse finale contenant uniquement du texte. Par défaut, la documentation indique qu’il n’y a aucune limite.

Lorsque cette limite est atteinte, le SDK renvoie un résultat dont subtype vaut error_max_turns. Un appel query() single shot lève alors une erreur contenant le texte Reached maximum number of turns. La page de la documentation de l’Agent SDK consacrée à la boucle de l’agent indique également que le processus Claude Code sous-jacent se termine avec un code différent de zéro dans ce cas single shot. Le résultat contient toujours num_turns et session_id. Vous pouvez donc reprendre la même session avec une limite plus élevée au lieu de relancer la tâche.

Depuis la CLI (interface de ligne de commande), le même réglage prend la forme d’une option, qui s’applique uniquement au print mode :

claude -p --max-turns 3 "summarise the failing tests"

La documentation des options indique qu’il n’y a aucune limite par défaut. Avec --input-format stream-json, un message encore en attente lorsque la limite met fin à un tour reste en attente et démarre un nouveau tour avec sa propre limite. Il existe une variante fondée sur le coût : max_budget_usd en Python et maxBudgetUsd en TypeScript arrêtent la boucle lorsqu’un seuil de dépenses est atteint, plutôt qu’après un nombre donné de tours. Les dépenses des sous-agents sont incluses dans ce total. Le budget est vérifié après la réception des réponses du modèle. Les dépenses peuvent donc dépasser la limite à cause de la réponse qui l’atteint et des sous-agents en arrière-plan qui terminent leur travail avant de s’arrêter. Si vous exécutez des agents sur un serveur facturé au mois, il est utile de mettre en place le contrôle du coût d’un agent IA sur un VPS avant la première exécution longue.

Une pause en attente d’une approbation est un cas différent. Si votre agent s’arrête alors qu’aucune dépense n’est engagée, consultez permission_mode plutôt que le nombre de tours, car un outil attend une réponse humaine qui n’arrive jamais. Le mode automatique et les réglages d’autorisations de Claude Code précise quels modes demandent une confirmation et lesquels s’exécutent sans en demander.

Comment vérifier vous-même le comportement actuel

Le comportement évolue sans annonce. Considérez donc chaque nombre de ce guide comme une valeur datée, et non comme une valeur fixe. Deux sources indiquent ce qui est vrai aujourd’hui.

  • La documentation de l’API consacrée aux raisons d’arrêt indique la valeur par défaut d’itération de l’outil serveur et la méthode pour la dépasser.
  • La page du centre d’aide d’Anthropic consacrée aux messages d’erreur indique le texte utilisé pour la limite d’utilisation. Vérifiée le 9 novembre 2026, cette page documente les messages liés aux limites de cinq heures et hebdomadaire, y compris les versions affichées lorsque les crédits d’utilisation prennent le relais. Elle ne mentionne aucune limite d’outils par tour. C’est pourquoi aucun chiffre officiel pour l’application de chat n’est cité ici.

Mesurez plutôt vos propres exécutions. Dans Claude Code, /context affiche l’utilisation actuelle du contexte sous forme de grille colorée et indique les outils qui en consomment le plus. /compact résume la conversation jusque-là afin de libérer de l’espace. Dans l’Agent SDK, chaque résultat contient num_turns. Vous pouvez ainsi voir combien de tours une tâche courante nécessite réellement avant de définir une limite. Une valeur issue de votre propre charge de travail est plus utile qu’un nombre publié dans un message de forum.

FAQ

La limite d’utilisation des outils est-elle la même que ma limite d’utilisation de Claude ?

Non. La limite d’utilisation comptabilise ce que vous avez consommé pendant une période donnée et indique quand elle est réinitialisée. Il suffit donc d’attendre. Le message concernant l’utilisation des outils interrompt une réponse parce que celle-ci a épuisé le nombre d’appels d’outils autorisés. L’envoi d’un nouveau message démarre immédiatement un nouveau tour avec un nouveau budget. L’utilisation des outils est tout de même comptabilisée dans votre quota. comment les limites d’utilisation de Claude sont comptabilisées explique en détail le fonctionnement du quota.

Comment faire pour que Claude termine une tâche qu’il a interrompue ?

Envoyez un message supplémentaire. « Continue » fonctionne, mais une instruction indiquant ce qui manque encore donne de meilleurs résultats, car elle évite au modèle de reconstruire le contexte qu’il possède déjà. S’il s’arrête une deuxième fois au même endroit, divisez la tâche en éléments plus petits et envoyez-en un par message. Indiquer les chemins complets des fichiers, ou coller directement leur contenu, évite les recherches qui ont épuisé le budget initial.

Que signifie « límite de uso de herramientas » ou « limite de uso de ferramentas » ?

Il s’agit des formulations espagnole et portugaise du même message. Elles apparaissent généralement sous la forme « límite de uso de herramientas en este turno » ou « limite de uso de ferramentas neste turno ». Le sens est identique dans toutes les langues : Claude a épuisé les appels d’outils autorisés pendant une seule réponse, sans que votre quota de forfait soit concerné. La solution est également la même : demandez-lui de continuer ou divisez la demande en plusieurs étapes. La limite de facturation fait l’objet d’un autre message, qui indique une heure de réinitialisation.

La mise à niveau de mon forfait augmente-t-elle la limite d’utilisation des outils pour un tour ?

Le niveau du forfait et le budget d’outils par tour sont deux paramètres différents. La mise à niveau augmente la quantité que vous pouvez utiliser pendant une période donnée. Il s’agit de la limite qui indique une heure de réinitialisation. Le nombre d’appels d’outils qu’une réponse peut effectuer dépend de la boucle qui exécute le modèle. Anthropic ne publie pas cette valeur pour l’application de chat. Diviser la tâche en plusieurs tours est la solution qui aide réellement, quel que soit le forfait.

Pourquoi mon propre agent s’arrête-t-il après seulement quelques appels d’outils ?

Vérifiez si vous avez défini une limite. Le Claude Agent SDK utilise max_turns en Python et maxTurns en TypeScript. L’interface de ligne de commande utilise --max-turns en mode print. Lorsqu’une de ces limites est atteinte, le SDK renvoie un résultat dont subtype vaut error_max_turns. Un appel query() exécuté en mode single shot lève alors une erreur contenant le texte Reached maximum number of turns. Par défaut, aucune limite n’est définie dans les deux cas. Si aucune limite n’est configurée et que l’exécution s’arrête tout de même, consultez stop_reason dans le résultat. La valeur max_tokens signifie que la limite de sortie a été atteinte. La valeur pause_turn signifie que la boucle d’outils du serveur a atteint sa limite d’itérations et demande que la réponse lui soit renvoyée pour pouvoir continuer.

Cet article vous a-t-il été utile ?