Que se passe-t-il quand le plafond mensuel est atteint ?

Au plafond du niveau d'usage, l'API suspend les appels jusqu'au premier jour du mois suivant à 00:00 UTC (temps universel) et renvoie une erreur HTTP 429 avec le code enforced_spend_limit_reached, sans en-tête retry-after. Au plafond que vous avez fixé vous-même, elle renvoie une erreur HTTP 400.

Peut-on limiter un seul projet sans bloquer les autres ?

Oui, avec les espaces de travail : chacun peut recevoir sa propre limite de dépense et ses propres limites de débit, sauf l'espace de travail par défaut, qui ne peut pas recevoir de limite de dépense.

Limite de dépenses de l'API Claude : la régler

Sur l'API Claude (l'interface de programmation d'Anthropic), la dépense est encadrée à deux niveaux : un plafond mensuel lié à votre niveau d'usage, que vous ne pouvez pas dépasser, et une limite personnalisée que vous fixez en dessous dans la console, pour toute l'organisation ou par espace de travail. Régler cette limite avant la mise en production évite qu'une boucle mal écrite ou un pic d'usage ne vide le budget du mois. Tout ce qui suit vient de la page des limites d'Anthropic lue le 15/11/2026.

Les plafonds par niveau d'usage

Une organisation est placée automatiquement sur un niveau selon son historique, et peut monter avec le temps. Chaque niveau porte un plafond mensuel, par mois civil :

Niveau d'usage	Plafond mensuel
Start	500 dollars américains
Build	1 000 dollars américains
Scale	200 000 dollars américains
Custom	pas de plafond, conditions fixées avec l'équipe commerciale

Les nouvelles organisations peuvent démarrer sur un niveau d'évaluation, aux limites plus basses, qui s'élèvent à mesure que l'historique se construit.

Fixer sa propre limite

Ouvrez la page Spend limits de la console Claude (platform.claude.com/settings/spend-limits).
À côté de Monthly spend limit, cliquez sur Adjust limit ou Set limit.
Saisissez la nouvelle valeur ; elle ne peut pas dépasser le plafond de votre niveau.

Une méthode pour choisir la valeur : partez du coût mensuel estimé (voir calculer le coût d'un appel), prenez une hypothèse haute de volume, et fixez la limite juste au-dessus. Vous serez prévenu par un arrêt plutôt que par une facture.

Ce que renvoie l'API à la limite

Le code HTTP est le code d'état que le serveur renvoie avec chaque réponse ; votre application doit le lire pour réagir correctement.

Situation	Code HTTP	Type d'erreur	Reprise
Plafond du niveau atteint	429	`rate_limit_error`, code `enforced_spend_limit_reached`	le 1er du mois suivant à 00:00 UTC (temps universel), ou plus tôt en montant de niveau
Votre limite d'organisation atteinte	400	`invalid_request_error`, message commençant par « You have reached your specified API usage limits »	en relevant ou retirant la limite
Votre limite d'espace de travail atteinte	400	`invalid_request_error`, message « You have reached your specified workspace API usage limits »	en relevant ou retirant la limite

Point important pour le code : au plafond du niveau, la réponse 429 n'a pas d'en-tête retry-after, et les nouvelles tentatives, y compris automatiques, échouent jusqu'à la reprise. Distinguez donc ce cas d'une simple limite de débit, en lisant error.details.error_code, pour ne pas relancer en boucle.

Limiter par espace de travail

Les espaces de travail permettent de séparer les projets (un assistant interne, un traitement par lots, un environnement de test) et de leur donner chacun une limite de dépense et des limites de débit. La documentation précise :

l'espace de travail par défaut ne peut pas recevoir de limite de dépense ;
sans réglage, un espace de travail a les limites de l'organisation ;
les limites de l'organisation s'appliquent toujours, même si la somme des limites des espaces les dépasse.

Mettez donc chaque projet en production dans son propre espace de travail, avec sa propre limite, et gardez l'espace par défaut pour rien d'important.

Les limites de débit, l'autre garde-fou

Indépendamment de la dépense, l'API limite le nombre de requêtes par minute et de jetons d'entrée et de sortie par minute, par modèle. Au niveau Start, par exemple, Claude Sonnet 5.5 est limité à 4 000 requêtes par minute et 2 000 000 de jetons d'entrée par minute. Les jetons relus depuis le cache de prompt ne comptent pas dans cette limite d'entrée. Les en-têtes de réponse anthropic-ratelimit-* indiquent à chaque appel ce qui reste disponible.

Surveiller avant d'atteindre la limite

La page Usage de la console affiche la consommation de jetons et de requêtes, ainsi que la part des jetons d'entrée lus en cache.
L'export de cette page donne un fichier détaillé par clé d'API et par modèle.
Côté application, journalisez l'objet usage de chaque réponse et calculez une dépense cumulée du mois : vous pourrez alerter avant l'arrêt.

Pour un agent qui enchaîne des appels sans intervention humaine, ces garde-fous sont indispensables : la page sur le coût d'un agent IA explique pourquoi sa consommation grimpe vite.