Claude Agent SDK : pourquoi la limite de 5 heures diminue si vite

Si les applications Claude Agent SDK ou claude -p épuisent rapidement votre quota de cinq heures, comparez la même tâche avec Claude Code en mode interactif. Des tests communautaires signalent une consommation environ 1.6×–2.97× plus rapide, sans établir de multiplicateur universel. Pour les automatisations récurrentes, la facturation API fournit un solde distinct et des coûts mesurables par jeton.

Au 2026-10-27, l’issue Anthropic #97074 est toujours ouverte. Les rapports indiquent que la consommation du quota varie selon le point d’entrée du client. Ils ne permettent pas de déterminer si Anthropic a voulu cette différence ou s’il s’agit d’un défaut.

Ce que les tests contrôlés ont réellement mesuré

Plusieurs auteurs ont signalé une hausse plus rapide de la consommation du quota de cinq heures avec claude -p ou des applications Agent SDK, pour des tâches comparables. Les expériences diffèrent par les versions, les modèles, la répartition des jetons et les clients de comparaison.

Rapport	Conditions du test	Résultat rapporté
qvarker, 25 septembre	Max ; Claude Code 2.1.282 ; claude-opus-5 ; high effort	Environ 1.8× plus rapide en mode headless qu’avec le terminal interactif
kler, 17 octobre	Team ; Claude Code 2.1.300 ; claude-opus-5-5 ; high effort	sdk-ts : 2.97× ; sdk-cli : 2.83×, par rapport à un banc de test utilisant le label claude-vscode
Rapport de Theo sur T3 Code, 25 octobre	Un compte Max ; tâche identique ; terminal interactif, T3 Code et claude -p	Environ 1.6×–1.7× plus rapide via SDK/headless après comparaison du cache
frostfire575, 26 octobre	Windows 11 ; Claude Code 2.1.310 ; claude-opus-5-5 ; low effort	Environ 2.4× plus de quota consommé par jeton pondéré avec claude -p qu’avec le terminal interactif

Le résultat le plus élevé demande une précision. Le banc de test de kler imitait le label de l’extension VS Code. Il ne pilotait pas l’interface de l’extension réelle. Le résultat isole donc une différence liée au label dans cette expérience.

Les montants en dollars du rapport de qvarker sont des estimations équivalentes à la facturation API, utilisées pour normaliser le travail. Ce ne sont pas des frais supplémentaires d’abonnement. Un montant plus faible de « travail par 1% du quota » signifie que le quota a diminué plus vite.

Il faut examiner séparément le quota hebdomadaire. Theo a observé une hausse identique de deux points de pourcentage à chaque exécution. Le compteur hebdomadaire de frostfire575 n’est passé que de 0% à 1%, ce qui ne permet pas de conclure. Les données indiquent une consommation hebdomadaire inchangée dans l’expérience de Theo, pas une garantie pour tous les comptes.

Ce que prouvent réellement sdk-cli et sdk-ts

Le point d’entrée identifie le client appelant. Sa présence ne révèle pas la formule de calcul appliquée côté serveur par Anthropic.

Le paquet publié @anthropic-ai/claude-agent-sdk 0.3.311 contient la valeur par défaut suivante dans sdk.mjs :

if(!c.CLAUDE_CODE_ENTRYPOINT)c.CLAUDE_CODE_ENTRYPOINT="sdk-ts"

Le SDK définit donc sdk-ts lorsque cette variable d’environnement est absente. Les transcriptions communautaires indiquent sdk-cli pour les exécutions habituelles de claude -p et cli pour le terminal interactif.

Dans la comparaison réseau de qvarker, les requêtes différaient par la valeur cc_entrypoint dans le bloc système x-anthropic-billing-header. L’auteur a également relevé des différences dans le User-Agent et un indicateur bêta.

Il s’agit d’une observation communautaire du contenu des requêtes. Ce n’est ni une interface d’en-tête de facturation officiellement documentée ni la preuve qu’un seul champ explique toutes les différences.

Le journal des modifications de Claude Code 2.1.311 n’annonce pas de correction de cet écart de consommation. Cette absence ne permet pas de conclure que le comportement du serveur n’a pas changé.

Comment vérifier votre propre flux de travail

Mesurez le client réel, le mode d’authentification et la charge de travail avant de modifier la configuration.

Vérifier l’authentification et les conditions de comparaison

Examinez l’environnement du processus Claude lancé par l’application. Selon la documentation d’authentification, une clé API peut prendre le pas sur l’authentification par abonnement en mode -p.

Notez l’exécutable, la version du CLI, la version du paquet SDK, le forfait du compte, l’identifiant exact du modèle et le réglage d’effort. Une interface peut lancer un binaire différent de celui de votre terminal.

Pour comparer les résultats :

• Utilisez le même compte, le même instantané du projet, la même liste de prompts, les mêmes outils et les mêmes réglages de cache.
• Suspendez les autres activités sur ce compte.
• Démarrez des sessions neuves et effectuez les deux exécutions dans la même fenêtre de cinq heures.
• Arrêtez la comparaison si la fenêtre se réinitialise ou si l’utilisation passe en supplément payant.

Choisissez une tâche représentative, par exemple résumer les mêmes fichiers source. Séparez les totaux des jetons d’entrée, de sortie, de lecture du cache et d’écriture du cache. Une longueur de sortie identique ne garantit pas une charge de travail identique.

Capturer le compteur et le point d’entrée enregistré

Conservez le contenu complet de l’événement de limitation, car les champs disponibles varient selon les versions.

Le test Bash suivant nécessite jq et une session d’abonnement déjà authentifiée. Il consomme du quota. Il vérifie les données de télémétrie et l’authentification ; une réponse d’un seul mot ne permet pas de mesurer un multiplicateur.

set -o pipefail
claude --version
claude auth status | jq '{authMethod}'
claude -p "Reply with exactly OK." \
  --model claude-sonnet-5-5 \
  --max-turns 1 \
  --disallowedTools "*" \
  --output-format stream-json --verbose |
jq -c '
  if .type == "rate_limit_event" then
    {type, session_id, rate_limit_info}
  elif .type == "result" then
    {type, subtype, is_error, session_id,
     usage, modelUsage, total_cost_usd, result}
  else empty end
'

La référence du CLI documente ces options et la commande de vérification de l’authentification. Une réponse réussie doit inclure un enregistrement result avec subtype: "success" et is_error: false.

Les versions instrumentées utilisées dans l’issue exploitaient ce chemin :

rate_limit_event.rate_limit_info.unifiedWindows.five_hour.utilization

Cependant, le type public des événements du SDK 0.3.311 ne contient pas unifiedWindows. Il déclare notamment les champs rateLimitType et utilization. N’interprétez pas l’absence d’un champ ou d’un événement comme une consommation nulle. Consultez la page Usage du compte si le flux ne fournit aucune mesure exploitable.

Comparez des mesures provenant de la même interface et utilisant la même échelle. Les événements d’utilisation et la réponse distincte de contrôle d’utilisation du SDK suivent des schémas différents. Leurs valeurs ne sont pas interchangeables.

Utilisez le session_id renvoyé pour retrouver la transcription. La documentation des sessions situe les transcriptions sous ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl. Une valeur personnalisée de CLAUDE_CONFIG_DIR modifie ce répertoire racine.

Pour examiner uniquement le point d’entrée enregistré, utilisez Bash :

read -r -p "Transcript path: " CLAUDE_TRANSCRIPT
jq -r 'select(.entrypoint? | type == "string") | .entrypoint' \
  "$CLAUDE_TRANSCRIPT" | sort -u

Un résultat vide signifie que le champ n’était pas disponible. Il ne prouve pas que la session était interactive.

Pour la comparaison avec le terminal, lancez le véritable Claude Code interactif depuis un shell propre. qvarker a signalé qu’un serveur tmux avait hérité de CLAUDE_CODE_ENTRYPOINT, puis transmis cette variable aux sessions suivantes. Vérifiez la transcription obtenue au lieu de supposer que l’interface détermine le label.

Comparer le quota consommé par unité de travail

Comparez les points de pourcentage consommés pour une même unité de travail, plutôt que la durée ou le nombre de prompts.

Frostfire575 a rapporté 1.43 million de jetons pondérés pour une hausse de cinq points dans le terminal. L’exécution headless a utilisé 1.32 million de jetons pondérés pour une hausse de onze points. À partir de ces chiffres :

Headless / terminal = (11 / 1.32) / (5 / 1.43) = 2.38

Ce calcul explique le résultat rapporté de 2.4×. Il utilise la mesure de jetons pondérés définie par l’auteur et ne vaut que pour cette comparaison.

Des variations d’un seul point sont trop grossières pour comparer utilement de petites exécutions. Au besoin, répétez des tâches ordinaires dans l’ordre inverse. Évitez toute réinitialisation de la fenêtre ou activité simultanée sur le compte.

Pour estimer les coûts, utilisez les résultats finaux de sessions neuves. N’additionnez pas les enregistrements cumulatifs de sessions reprises. La documentation du suivi des coûts distingue le comptage des jetons de la facturation réelle. Ni total_cost_usd ni modelUsage ne mesure le quota d’abonnement.

Si l’écart disparaît après harmonisation du cache ou suppression des activités simultanées, examinez d’abord ces causes.

Faut-il modifier CLAUDE_CODE_ENTRYPOINT ?

Considérez le changement de label du client comme une expérience non prise en charge officiellement.

Le 26 octobre, qvarker et oviano ont rapporté une consommation inférieure avec le nom de leur propre outil. Selon leurs comparaisons, la consommation avec le label par défaut sdk-cli était environ 1.9×–2.4× plus élevée.

Ces rapports ne démontrent pas qu’il s’agit d’une méthode approuvée pour obtenir un traitement différent du quota. Un label personnalisé modifie l’identification du client, qui semble intervenir dans le calcul de consommation. Son traitement pourrait changer, et son statut au regard des règles reste indéterminé.

N’attribuez pas les labels cli ou claude-vscode à votre application pour obtenir le traitement d’un autre client. Ces noms identifient des clients distincts.

La pull request T3 Code #25597 associée était ouverte et non fusionnée lors de la vérification du 2026-10-27. Son existence ne prouve ni la publication d’un correctif T3 Code ni l’approbation d’Anthropic.

Pour un travail interactif, testez le véritable client terminal. Pour une automatisation qui doit conserver des entrées et sorties structurées, évaluez la facturation API.

Quel solde finance les automatisations Agent SDK ?

L’authentification détermine si une tâche consomme le quota d’abonnement ou des crédits API.

La mise à jour de facturation du 7 octobre d’Anthropic maintient l’utilisation de l’abonnement pour Agent SDK, claude -p et les applications tierces. Elle autorise aussi les crédits API Max et Team éligibles pour les tâches SDK et claude -p exécutées directement. Ces tâches doivent utiliser une clé API de l’organisation Console liée.

Distinguez ces soldes :

Mode de facturation	Ce que la tâche consomme
Connexion à l’abonnement Claude	Quotas d’abonnement, dont la fenêtre de cinq heures
Utilisation supplémentaire activée, aussi appelée usage credits	Utilisation payante distincte après épuisement du quota inclus
Clé API Anthropic	Crédits API éligibles ou solde API payé de l’organisation Console
Passerelle API indépendante	Solde et règles de facturation de ce fournisseur

Avec la facturation API, la tâche ne dépend plus du quota de cinq heures de l’abonnement. Les limites de débit API, les plafonds de dépenses et les fonds disponibles continuent de s’appliquer.

Au 2026-10-27, le programme de crédits API mensuels indique :

Forfait éligible	Crédit API mensuel
Max 5x	$100 USD
Max 20x	$200 USD
Team Standard	$20 USD par siège
Team Premium	$100 USD par siège

Les crédits Team alimentent une réserve commune plafonnée à $500 USD. Pro n’est pas éligible. Les nouveaux abonnés doivent conserver un forfait éligible pendant sept jours.

Pour activer les crédits, ouvrez Settings > Billing avec Max ou Organization settings > Billing avec Team. Sélectionnez Link organization dans la rubrique des crédits API. Vous devez disposer du rôle d’abonné ou de propriétaire requis, ainsi que des autorisations de facturation Console. Créez la clé API dans cette organisation liée.

Le programme exclut Claude Code interactif, l’utilisation supplémentaire et les exécutions lancées par Claude Code GitHub Action, les extensions IDE ou l’application Claude pour ordinateur. Ajouter -p ne supprime pas ces exclusions.

La documentation Platform sur les crédits précise que les crédits inutilisés expirent sans report. Les crédits inclus sont consommés avant les crédits achetés. Après épuisement, les fonds achetés ou la facturation sur facture applicable peuvent maintenir le service. Sinon, les requêtes s’arrêtent. Elles ne basculent pas vers le quota d’abonnement.

Vérifier la facturation API avant de migrer les tâches récurrentes

Vérifiez une exécution directe avec une clé API et son utilisation dans la Console avant de migrer une file de tâches.

Utilisez un terminal Bash configuré pour accéder directement à Anthropic. Vérifiez d’abord les valeurs existantes de ANTHROPIC_BASE_URL, de ANTHROPIC_AUTH_TOKEN et les paramètres du fournisseur cloud. Ils peuvent sélectionner un autre endpoint ou une autre source d’identifiants.

Créez une clé API dans l’organisation Console prévue. Saisissez-la sans l’afficher :

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
claude --bare -p \
  --model claude-sonnet-5-5 \
  --tools "" \
  --max-turns 1 \
  --max-budget-usd 1.00 \
  --output-format json \
  "Reply with exactly OK."

La documentation de l’utilisation programmatique précise que --bare ignore les identifiants OAuth de l’abonnement et les personnalisations découvertes. Ce mode convient donc à cette vérification API. Dans une comparaison de consommation d’abonnement, il modifierait le mode d’authentification.

Vous devez obtenir un résultat JSON réussi contenant la réponse. Vérifiez ensuite l’utilisation et le solde de la bonne organisation dans la Console. L’estimation de coût du CLI ne suffit pas à prouver que des crédits promotionnels ont payé la requête.

Si l’authentification échoue, vérifiez la clé et le fournisseur actif. Si le solde est épuisé, examinez la facturation Console. Les erreurs de limite de débit API ou de plafond de dépenses exigent de vérifier ces limites, même si le quota d’abonnement n’est pas épuisé.

Le budget CLI de $1.00 est un seuil d’arrêt estimé. Une requête peut le dépasser. Définissez aussi un plafond de dépenses adapté dans la Console.

Pour illustrer le budget, les tarifs actuels d’Anthropic indiquent $2 par million de jetons d’entrée non mis en cache pour claude-sonnet-5-5. Le tarif de sortie est de $10 par million de jetons. Au 2026-10-27, un million de jetons d’entrée et 100,000 jetons de sortie donnent donc cette estimation :

(1 × $2) + (0.1 × $10) = $3

Ce calcul suppose un routage global synchrone standard, sans cache ni outils serveur facturés séparément. Il exclut les taxes applicables. Pour un contexte répété, calculez séparément les écritures et les lectures du cache à leurs tarifs respectifs.

Une passerelle indépendante constitue une autre possibilité. Le catalogue en ligne de BetterToken répertoriait claude-sonnet-5-5 et claude-opus-5-5 le 2026-10-27. Son guide Claude Code utilise votre propre clé BetterToken et l’URL de base https://bettertoken.ai, sans /v1. Comparez ses tarifs actuels et la compatibilité requise avec vos outils en fonction de votre charge de travail. Les crédits API inclus d’Anthropic ne sont pas transférables vers ce mode de facturation distinct.