J'ai monté 3 agents avec les 200 $ d'API inclus dans Claude Max

Depuis le 7 octobre, Max et Team embarquent 100 à 500 $ de crédits API par mois. Voici comment les réclamer, les cloisonner et les transformer en automatisations qui tournent seules.

Console Claude affichant des crédits promotionnels et trois agents planifiés

Le 15 juin 2026, Anthropic devait couper les vivres aux agents. Le plan annoncé : sortir l'usage de l'Agent SDK et des outils tiers du forfait, et le facturer sur un pot de crédits séparé. Zed avait chiffré le choc pour ses utilisateurs — les abonnements subventionnaient l'usage agentique « à hauteur de 15 à 30× le prix API ». Puis le 16 juin, message aux abonnés : on ne touche à rien, on reviendra avec autre chose.

« Autre chose » est arrivé le 7 octobre. Et c'est l'inverse d'une hausse : Max et Team reçoivent désormais des crédits API mensuels en plus de leur forfait. 100 $, 200 $, jusqu'à 500 $. Sans carte bancaire à ajouter. J'ai réclamé les miens le 8, j'ai mis trois agents en production dans les 48 heures qui ont suivi, et j'ai consommé 20 $ sur 200. Voici le mode d'emploi, les trois erreurs que j'ai commises, et la facture ligne par ligne.

Le 7 octobre, Anthropic a transformé une hausse de prix annoncée en budget d'expérimentation

La mécanique est simple, et c'est ce qui la rend intéressante. Vous liez votre abonnement Claude à une organisation Claude Console, et chaque cycle de facturation un montant arrive dans la section Promotional credits de la Console. La documentation officielle liste les montants : 100 $ pour Max 5x, 200 $ pour Max 20x, 20 $ par siège standard et 100 $ par siège premium sur Team, le tout mutualisé dans une cagnotte unique plafonnée à 500 $.

L'exemple de la doc mérite d'être retenu si vous gérez une équipe : trois sièges standard et deux premium donnent 260 $ par mois. Ajoutez un siège premium, le mois suivant passe à 360 $. Le calcul se fait sur l'état du plan au début du mois de facturation, pas au prorata.

Deux détails qui ne sont pas des détails. D'abord, aucun moyen de paiement n'est requis sur la plateforme : vous pouvez construire sans jamais exposer une CB, et quand les crédits sont épuisés les requêtes s'arrêtent net au lieu de glisser sur votre abonnement. Ensuite, Pro, Free et Enterprise sont exclus. Les abonnés Pro à 20 €, qui étaient visés par le plan de juin avec 20 $ de crédits, repartent avec zéro.

Simon Willison, qui a disséqué l'annonce le jour même, parle d'un dispositif « really generous » et relève le point qui compte : pour un abonné Max 20x, les crédits mensuels valent exactement le prix de l'abonnement. Il apprécie aussi l'absence d'auto-reload sur ces crédits — pas de facture surprise au réveil.

Le même 7 octobre, Anthropic a sorti Haiku 5.5 et divisé par deux le prix des lectures de cache de Sonnet 5.5. Ce n'est pas une coïncidence : les crédits n'ont de valeur que si le token coûte peu. On y revient dans la partie chiffrée.

Ce que les crédits couvrent, et les trois lignes où ils ne servent à rien

C'est là que la majorité des gens vont se planter, parce que l'intuition est fausse. On paie un abonnement Claude Code, on reçoit des crédits API, on suppose que les crédits alimentent Claude Code. Faux.

ProduitCouvert par les créditsCe que ça implique en pratique
Claude API (Messages, Batches, Files)OuiLe gros du jeu : vos scripts, vos pipelines, vos backends
Claude Managed AgentsOuiAgents hébergés, sessions planifiées, sandbox cloud ou self-hosted
Claude Agent SDK (clé API)OuiAgents embarqués dans vos applis Python / TypeScript
Playground ConsoleOuiTests de prompts facturés sur les crédits, pas sur le forfait
Claude Code interactifNonReste sur vos limites d'abonnement, point final
Usage supplémentaire dans les apps ClaudeNonLes dépassements dans claude.ai restent à votre charge
Bedrock, Vertex AI, Microsoft Foundry, Claude Platform on AWSNonCrédits utilisables uniquement sur l'API first-party

Le symptôme de l'erreur est documenté noir sur blanc : si votre organisation ne détient que ces crédits et que vous lancez une session Claude Code sur la clé de cette organisation, vous récoltez Credit balance too low · Add funds. Ce n'est pas un bug, c'est le design. Je l'ai eu deux fois le premier jour avant de comprendre que je mélangeais deux choses qui n'ont rien à voir.

Le cas de l'Agent SDK demande une lecture attentive. L'article d'aide d'Anthropic précise que l'Agent SDK, claude -p et les apps tierces continuent pour l'instant de tirer sur les limites de votre abonnement quand vous vous authentifiez avec votre compte Claude. Mais la doc du SDK est catégorique sur ce que vous pouvez livrer à des clients : « Anthropic n'autorise pas les développeurs tiers à proposer le login claude.ai ou leurs limites pour leurs produits, y compris les agents construits sur le Claude Agent SDK. » Traduction opérationnelle : expérimentation perso en login Claude, produit livré en clé API — donc sur les crédits.

Étape 1 — Réclamer les crédits sans verrouiller la mauvaise organisation

Cinq minutes de manipulation, et une décision irréversible au milieu. Lisez l'étape 2 avant de cliquer.

  1. Vérifiez l'éligibilité. Plan actif, à jour de paiement, et 7 jours d'ancienneté pour un nouvel abonné. Les abonnements achetés via l'App Store ou Google Play sont éligibles, mais la réclamation se fait sur claude.ai depuis un navigateur.
  2. Vérifiez vos rôles. Côté plan : le titulaire pour Max, Primary Owner ou Owner pour Team. Côté Console : Owner, Admin ou Billing. Si vous avez créé la Console avec une autre adresse que votre abonnement, c'est maintenant qu'il faut y penser.
  3. Ouvrez la facturation. Sur claude.ai : Settings > Billing en Max, Organization settings > Billing en Team. Section API credits.
  4. Choisissez l'organisation Console qui recevra les crédits, acceptez les conditions du programme, validez le lien.
  5. Vérifiez dans la Console. Settings > Billing > Promotional credits : montant et date d'expiration affichés. Créez ensuite une clé API et envoyez votre première requête.

L'avertissement de la doc est à encadrer : un plan se lie à une seule organisation Console, et une organisation ne peut recevoir des crédits que d'un seul plan. Vous ne pouvez pas changer le lien vous-même — il faut passer par le support. Les premiers retours de terrain insistent tous sur ce point, et pour une bonne raison : c'est exactement là que je me suis vautré.

J'ai lié par réflexe l'organisation que j'utilise depuis deux ans, celle qui porte encore la facturation d'une mission terminée en mars et trois clés API baladeuses. Mauvais choix : je voulais une organisation propre, dédiée aux agents, avec des workspaces cloisonnés. Résultat, un ticket support et quatre jours d'attente pour un geste qui aurait pris trente secondes si j'avais réfléchi avant. Prenez cinq minutes pour créer l'organisation que vous voulez vraiment, puis liez.

Étape 2 — Cloisonner avant d'écrire une ligne de code : un workspace et un plafond par agent

Toutes les clés API et tous les workspaces de l'organisation liée tirent sur le même solde. Un agent qui part en boucle vide le pot commun, et vous ne le voyez que le lendemain. La parade tient en deux réglages.

Un workspace par agent, avec son plafond de dépense

Dans la Console, créez un workspace par agent et fixez-lui un spend limit. C'est la recommandation explicite de la doc crédits : « pour plafonner la dépense d'un projet, donnez-lui son propre workspace et réglez le plafond de ce workspace. » Vous pouvez aussi y limiter les tokens par minute, ce qui évite qu'un batch mal dimensionné affame votre agent de production. Détail utile : le workspace par défaut n'accepte pas de limite, donc ne travaillez pas dedans.

Comprendre le double plafond, et le décalage de calendrier

Deuxième réglage, moins intuitif. Les limites de l'API fonctionnent indépendamment des crédits, et l'usage payé en crédits compte dans le plafond mensuel de dépense de votre organisation.

PalierPlafond de dépense mensuelSonnet 5.5 : RPM / ITPM / OTPMComment on y arrive
Start500 $1 000 / 2 M / 400 kAutomatique dès que le plan est lié
Build1 000 $5 000 / 5 M / 1 MAutomatique si vos crédits mensuels dépassent 200 $
Scale200 000 $10 000 / 10 M / 2 MHistorique d'usage payant, sur demande

Conséquence directe pour une équipe : un Team qui touche 500 $ de crédits et reste au palier Start a un plafond de dépense calendaire de 500 $. Les crédits et le plafond se superposent presque exactement — aucune marge pour un dépassement ponctuel. Et les deux horloges ne sont pas synchronisées : les crédits se rechargent sur votre cycle de facturation, le plafond de dépense se remet à zéro le 1er du mois calendaire à 00:00 UTC. Si votre cycle démarre le 20, vos crédits frais du 20 novembre peuvent se heurter à un plafond déjà consommé. Le code d'erreur à surveiller est enforced_spend_limit_reached, renvoyé en 429 sans en-tête retry-after — vos retries automatiques vont tourner dans le vide.

Dernier point technique qui change tout sur le débit : seuls les tokens d'entrée non mis en cache comptent dans l'ITPM. Avec 80 % de hit de cache et une limite à 2 M, vous passez en réalité 10 M de tokens d'entrée par minute. Le prompt caching n'est pas qu'une optimisation de coût, c'est un multiplicateur de capacité. Nous l'avions déjà mesuré en détail dans notre migration vers Fable 5.1.

Étape 3 — Agent n°1 : 8 800 tickets triés pour 2 $ avec Haiku 5.5 et le Batch API

Premier agent, le moins glamour et le plus rentable : le tri de la boîte support. Classification en 11 catégories, détection d'urgence, extraction du numéro de commande, brouillon de réponse. Volume réel sur le mois : 8 800 tickets, soit 400 par jour ouvré.

Haiku 5.5 rend ce genre de tâche presque gratuit. Anthropic annonce 0,10 $ / MTok en entrée et 0,50 $ en sortie sous 100 000 tokens de prompt, avec un coût moyen inférieur de 75 % à Haiku 4.5. Les gains de capacité ne sont pas cosmétiques : 72,4 % sur OSWorld 2.1 contre 15,7 % pour Haiku 4.5, 45,9 % sur Humanity's Last Exam contre 10,2 %. Box rapporte « 11 points de plus que Haiku 4.5 pour environ la moitié de la latence », HubSpot 92,8 % sur son éval de tâches CRM.

from anthropic import Anthropic
client = Anthropic()  # lit ANTHROPIC_API_KEY

requests = [
  {
    'custom_id': f'ticket-{t.id}',
    'params': {
      'model': 'claude-haiku-5-5',
      'max_tokens': 600,
      'system': [{'type': 'text', 'text': GRILLE_DE_TRI,
                  'cache_control': {'type': 'ephemeral'}}],
      'messages': [{'role': 'user', 'content': t.body}]
    }
  } for t in tickets
]

batch = client.messages.batches.create(requests=requests)
print(batch.id, batch.processing_status)

Trois réglages font la différence sur la facture. Le Batch API retire 50 % sur l'entrée comme sur la sortie, et un tri de tickets n'a aucun besoin d'être synchrone. La grille de tri mise en cache (2 400 tokens de consignes) tombe à 0,01 $ / MTok en lecture. Enfin, surveillez le seuil des 100 000 tokens : Haiku 5.5 est facturé selon la longueur du prompt, et une requête qui dépasse ce seuil paie 5× plus cher — 0,50 $ / 2,50 $ — même si l'essentiel du prompt est un hit de cache. Un agent qui empile l'historique conversationnel franchit ce seuil sans prévenir.

Le piège suivant est invisible dans les tableaux de prix : le nouveau tokenizer. Les modèles Claude 4.7 et suivants produisent environ 30 % de tokens de plus pour le même texte, et Simon Willison mesure 1,25× sur Haiku 5.5 par rapport à son prédécesseur. Mon calcul final intègre ce coefficient, sinon il est faux de 25 %.

Comptons. 2 063 tokens d'entrée et 550 de sortie par ticket après coefficient, sur 8 800 tickets : 18,2 M en entrée à 0,05 $ / MTok, soit 0,91 $, et 4,8 M en sortie à 0,25 $ / MTok, soit 1,21 $. 2,12 $ pour le mois. En synchrone sans batch, on double à 4,24 $. Pour mémoire, le même travail en Sonnet 5.5 coûterait environ 42 $ — toujours dans le crédit, mais vingt fois plus cher pour une tâche qui ne demande aucun raisonnement. Le principe est le même que dans notre tuto batch sur les boîtes mail : la classification à haut volume est le terrain du petit modèle, pas du gros.

Étape 4 — Agent n°2 : une veille concurrentielle qui se déclenche seule le lundi à 7 h

Deuxième agent, et là on sort du script : Claude Managed Agents fournit le harnais complet — boucle d'agent, bash, lecture-écriture de fichiers, recherche web, serveurs MCP, compaction de contexte — dans une sandbox hébergée. Vous ne codez pas la boucle, vous décrivez l'agent. C'est en bêta, avec l'en-tête managed-agents-2026-04-01 sur toutes les requêtes.

Mon cas d'usage : comparer chaque lundi les pages tarifs de six concurrents, détecter les changements, produire un brief Markdown dans un dépôt. Les scheduled deployments font tourner ça sans serveur chez moi.

---
name: Veille tarifs concurrents
agent: agent_011CYm1BLqPXpQRk5khsSXrs
environment_id: env_01595EKxaaTTGwwY3kyXdtbs
schedule:
  type: cron
  expression: '0 7 * * 1'
  timezone: Europe/Paris
budget:
  type: limit
  max_list_cost: { amount: '150', currency: USD }
---

Compare les pages tarifs des concurrents listes dans concurrents.md
avec le snapshot de la semaine derniere. Ecris brief.md.

Un ant apply deployment.md crée le déploiement, enregistre son ID dans claude-lock.json et renvoie les upcoming_runs_at — vérifiez-les, c'est la seule confirmation que votre cron dit bien ce que vous croyez. Puis ant beta:deployments run --deployment-id ... pour un run manuel avant de faire confiance au planning.

Le budget par run, l'arme anti-dérapage

L'objet budget est le réglage le plus important de ce fichier. Le plafond est recopié sur chaque session démarrée par le déploiement, pas en cumul. Attention à l'unité : la doc indique qu'un plafond de 2000 autorise environ 20 $ par run — c'est donc en centimes. Mon 150 vaut 1,50 $. Une session qui atteint son plafond se met en pause avec le statut budget_reached au lieu de continuer à brûler.

Trois comportements de planification à connaître

  • Le jitter. L'exécution réelle décale de 15 % de l'intervalle, plafonné à 9 minutes. Un run « 7 h 00 » hebdomadaire peut tomber à 7 h 09. Ne branchez pas un SLA à la minute dessus.
  • L'heure d'été. Le cron matche l'heure murale littérale. Une heure qui n'existe pas au passage à l'heure d'été ne se déclenche pas ; une heure qui existe deux fois à l'automne se déclenche deux fois. Évitez la fenêtre 1 h – 3 h locale, ou passez en UTC.
  • Les échecs. Chaque tentative crée un deployment run traçable. Un environnement archivé ou un sous-agent archivé met le déploiement en pause automatique ; un agent supprimé l'archive définitivement. Filtrez avec --has-error et branchez les webhooks, sinon vous découvrirez la panne en constatant l'absence de brief.

Côté facture : 4,3 runs par mois, 25 minutes de running chacun. Les prix officiels fixent le runtime à 0,08 $ par session-heure, facturé à la milliseconde et seulement en statut running — l'idle ne compte pas. Par run : 0,28 $ d'entrée non cachée, 0,02 $ de lectures de cache, 0,25 $ de sortie, 0,12 $ de recherches web (12 recherches à 10 $ les 1 000), 0,03 $ de runtime. 0,70 $ le run, 3 $ le mois. Notez que le Batch API ne s'applique pas aux Managed Agents — les sessions sont interactives par nature. Nous avions déjà posé les bases de ce service dans notre analyse du pricing Managed Agents.

Étape 5 — Agent n°3 : l'Agent SDK sur votre serveur, et le piège d'authentification

Troisième agent, celui qui tourne chez moi : un job nocturne qui relit les logs applicatifs, croise avec les tickets de la veille, ouvre une issue GitHub par anomalie et pousse un résumé dans Slack. L'Agent SDK embarque la boucle d'agent de Claude Code comme bibliothèque, en Python et TypeScript, avec les outils intégrés, les hooks, les sous-agents, les permissions, les sessions, les skills et le MCP.

import { query } from '@anthropic-ai/claude-agent-sdk';

for await (const msg of query({
  prompt: 'Lis rapport-nuit.md, resume les anomalies, ouvre une issue par anomalie.',
  options: {
    model: 'claude-sonnet-5-5',
    allowedTools: ['Read', 'Grep', 'Bash'],
    permissionMode: 'acceptEdits',
    mcpServers: { github: { command: 'npx', args: ['-y', 'mcp-github'] } }
  }
})) {
  if (msg.type === 'result') console.log(msg.usage);
}

Le point décisif tient en une variable d'environnement. Avec ANTHROPIC_API_KEY pointant sur une clé de l'organisation liée, la consommation sort des crédits. Sans elle, en login Claude, elle sort de vos limites d'abonnement. Les deux marchent, mais ils ne puisent pas au même endroit — et seul le premier mode est autorisé si vous livrez l'agent à des clients. Dans un cron système, c'est le mode clé API qu'il faut, tout simplement parce qu'un login interactif n'a rien à faire dans un job nocturne.

Si vous travaillez dans un langage non supporté, lancez le CLI en sous-processus avec claude -p et --output-format json. C'est moins élégant, mais le usage renvoyé dans le JSON est précieux : c'est votre compteur de coût par run, à logger systématiquement.

Deux garde-fous que je n'ai mis qu'après m'être fait mal. Un hook qui refuse tout Bash contenant rm ou git push --force, parce que permissionMode: 'acceptEdits' sur un agent non surveillé est une invitation. Et une borne de boucle explicite côté appelant : le SDK gère la compaction de contexte, pas votre budget. Nous avions détaillé d'autres leviers de réduction de tokens dans notre tuto sur le programmatic tool calling.

Facture de cet agent : 22 runs, Sonnet 5.5, 60 k de tokens non cachés, 60 k d'écriture de cache, 240 k de lectures et 40 k de sortie par run. 0,69 $ le run, 15 $ le mois. C'est le plus cher des trois, et de loin le plus utile.

Combien coûte un agent IA par mois en France : ma facture réelle sur 30 jours

Le marché français vend ce genre de dispositif entre 3 000 € et 25 000 € d'intégration, plus quelques centaines d'euros de maintenance mensuelle selon les grilles tarifaires des intégrateurs spécialisés TPE-PME. Voici ce que coûtent les tokens, hors temps de développement.

AgentModèleVolume mensuelCoût tokens + runtimePart du crédit Max 20x
Tri de la boîte supportHaiku 5.5 + Batch8 800 tickets2,12 $1,1 %
Veille tarifs hebdoSonnet 5.5 (Managed Agent)4,3 runs3,01 $1,5 %
Job nocturne logs + issuesSonnet 5.5 (Agent SDK)22 runs15,27 $7,6 %
Total——20,40 $10,2 %

Dix pour cent. Le constat est brutal : la contrainte n'est plus le budget, c'est le nombre d'automatisations que vous êtes capable de concevoir et de maintenir. Ça ne devient faux que si vous changez de modèle. Même agent n°3, même charge, quatre modèles :

ModèlePrix entrée / sortieCoût par runCoût mensuel (22 runs)
Haiku 5.5 (prompt < 100 k)0,10 $ / 0,50 $0,04 $0,80 $
Haiku 5.5 (prompt > 100 k)0,50 $ / 2,50 $0,18 $3,95 $
Sonnet 5.52 $ / 10 $0,69 $15,27 $
Opus 5.54 $ / 20 $1,39 $30,60 $
Fable 5.110 $ / 50 $3,41 $75,00 $

De 0,80 $ à 75 $ pour un travail identique, soit un facteur 94. Aucune optimisation de prompt ne rattrape une erreur de casting de modèle. Les ordres de grandeur de la première analyse indépendante parue le 8 octobre confirment l'échelle : 100 $ de crédits achètent environ 220 000 requêtes Haiku 5.5, 11 000 en Sonnet 5.5, 5 500 en Opus 5.5.

À mettre en face des chiffres d'adoption : France Num mesure 40 % de TPE-PME déclarant un usage de l'IA, mais seulement 11 % qui automatisent réellement des tâches. L'écart ne s'explique plus par le coût des tokens. Nous avions décortiqué ces chiffres dans notre lecture du baromètre France Num.

Les trois trucs qui ont cassé chez moi

Un tuto sans échec est un tuto qui n'a pas été exécuté. Voici les miens, dans l'ordre chronologique.

47 $ évaporés en une nuit, faute de plafond

Premier soir, euphorie. Je branche Fable 5.1 sur une boucle de résumé documentaire pour « voir », sans budget de session ni plafond de workspace. L'agent tombe sur un PDF de 600 pages, le découpe, se relit, recommence. Au réveil : 47 $ partis, un quart du crédit du mois, zéro livrable exploitable. Le pire est que tout était évitable en deux clics — le plafond de workspace et l'objet budget existent exactement pour ça. Depuis, aucun agent ne démarre chez moi sans les deux. Le mécanisme est le même que celui décrit dans notre dossier sur les coûts cachés des agents en production.

Claude Code qui réclame des fonds alors que le solde est plein

Deuxième jour, je bascule un projet sur la clé API de l'organisation liée et je lance Claude Code dessus. Credit balance too low · Add funds, alors que la Console affiche 153 $ de crédits promotionnels. Vingt minutes perdues à chercher un bug qui n'existe pas : Claude Code n'est pas couvert, et il ne le sera pas. La presse spécialisée a d'ailleurs titré sur cette exclusion le jour de l'annonce. Pour l'usage interactif en terminal, restez sur vos limites d'abonnement — c'est le sujet de notre comparatif Claude Code / Codex CLI.

Le brief de veille livré deux fois

Troisième incident, plus subtil. J'avais planifié le run à 2 h 30 Europe/Paris, par réflexe de ne rien faire tourner en heures ouvrées. La doc prévient : les heures murales qui se produisent deux fois lors du retour à l'heure d'hiver se déclenchent deux fois. Deux sessions concurrentes sur le même dépôt, deux commits, un conflit, et un brief dupliqué dans Slack. Le déploiement est repassé à 7 h 00. Si une fenêtre nocturne est indispensable, planifiez en UTC.

Claude Max vs ChatGPT Pro vs Google AI Pro : qui inclut des crédits API

C'est la comparaison qui donne sa vraie valeur à l'annonce du 7 octobre. Personne d'autre ne fait ça.

AbonnementPrix mensuelCrédits API inclusCe que vous obtenez côté développeur
Claude Max 5x100 $100 $ / moisAPI, Agent SDK, Managed Agents, playground
Claude Max 20x200 $200 $ / moisIdem, plus palier Build automatique
Claude TeamPar siège20 à 500 $ mutualisésCagnotte partagée, plafonnée à 500 $
Claude Pro20 $0 $Non éligible
ChatGPT Plus / Pro / Business20 à 500 $0 $Facturation API strictement séparée
Google AI Pro~22 €0 $Free tier Gemini à quotas, trafic loggé

Chez OpenAI, la séparation est totale : un abonnement Plus, Pro ou Business n'ouvre aucun crédit API, et un solde API ne relève aucune limite ChatGPT. Les nouveaux comptes API reçoivent 5 à 18 $ de crédits d'essai, une fois, sans lien avec l'abonnement. Chez Google, le modèle est différent mais pas plus généreux pour qui veut mettre un agent en production : le free tier de l'API Gemini plafonne à quelques dizaines de requêtes par minute et 1 000 à 1 500 par jour selon le modèle, avec du trafic journalisé pour l'amélioration produit — rédhibitoire sur des données clients. Et le tour de vis du 9 octobre côté grand public, que nous avons couvert dans notre article sur la réduction du Gemini gratuit, ne va pas dans le sens de la générosité.

Il reste un angle mort : la souveraineté. Ces crédits ne sont utilisables que sur l'API first-party d'Anthropic, pas sur Bedrock, Vertex ou Microsoft Foundry. Si votre contrainte est l'hébergement européen, le cadeau ne vous concerne pas — regardez plutôt du côté des API IA souveraines.

Notre verdict détaillé : qui doit réclamer ces crédits, qui peut les ignorer

Si vous êtes déjà en Max 20x et que vous écrivez du code, la question ne se pose pas : réclamez dans l'heure, créez une organisation propre, et traitez les 200 $ mensuels comme un budget de R&D qui expire. C'est la différence entre « j'aimerais tester un agent de veille » et « il tourne depuis lundi ». Pour un freelance ou une petite équipe tech, l'effet psychologique compte autant que l'économique : on arrête de peser chaque appel API.

Si vous êtes en Team, nommez un responsable de la cagnotte. Une cagnotte mutualisée sans propriétaire, c'est un compte commun sans relevé : quatre développeurs, quatre clés dans le workspace par défaut, et personne pour expliquer où sont passés 300 $ le 28 du mois. Un workspace par projet, un plafond par workspace, une revue mensuelle sur la page Cost.

Si vous êtes en Pro, ce n'est pas pour vous, et passer à Max uniquement pour les crédits n'a de sens que si vous consommez déjà plus de 60 à 80 $ d'API par mois. Si vous êtes en Enterprise, vous êtes exclu — ce qui est cohérent, votre facturation est négociée, mais mérite d'être signalé à votre interlocuteur commercial.

Ce que je reproche au dispositif ? L'expiration mensuelle sans report. Elle pousse à la dépense de fin de cycle, c'est-à-dire exactement au type d'agent mal cadré qui m'a coûté 47 $ la première nuit. Et l'irréversibilité du lien d'organisation est une rigidité gratuite : un simple avertissement « confirmez, ce choix nécessitera un ticket support » suffirait à éviter des centaines de tickets.

Les questions qu'on continue de se poser

Trois inconnues, que personne ne peut trancher aujourd'hui.

Combien de temps ça dure ? Le plan de juin a été annulé en vingt-quatre heures. Rien ne garantit que ces montants tiennent six mois, surtout si Anthropic avance vers son introduction en Bourse. Construisez en gardant une sortie : un agent qui ne tourne que parce qu'il est gratuit n'est pas un agent, c'est une démo.

Les Managed Agents en bêta sont-ils déployables sur des données clients ? Non, pas partout. Le service est stateful par conception, et à ce titre il n'est éligible ni au Zero Data Retention ni à un BAA HIPAA. Vous pouvez supprimer sessions et fichiers par API, mais si votre DPO exige du ZDR, vous restez sur la Messages API. Même logique que le trou RGPD des agents à mémoire pointé par la CNIL.

Le login d'abonnement dans l'Agent SDK va-t-il survivre ? L'article d'aide dit « pour l'instant ». La prudence consiste à écrire vos agents en clé API dès maintenant : le jour où la bascule tombe, vous n'avez rien à migrer.

Ce qu'il faut faire cette semaine

Trois actions, par ordre de priorité.

Un. Si vous êtes Max ou Team, décidez d'abord quelle organisation Console recevra les crédits, créez-la si elle n'existe pas, et seulement ensuite liez. Ce choix se paie en jours d'attente si vous le ratez.

Deux. Avant le premier appel API, créez un workspace par agent avec son plafond de dépense, et ajoutez un objet budget à toute session planifiée. Les deux réglages prennent cinq minutes et évitent le scénario des 47 $.

Trois. Choisissez votre modèle par tâche avant d'optimiser quoi que ce soit. Haiku 5.5 pour la classification et l'extraction à haut volume, Sonnet 5.5 pour les agents outillés, Opus 5.5 pour le raisonnement long, Fable 5.1 uniquement quand vous savez pourquoi. Entre le premier et le dernier, le même travail varie d'un facteur 94 — c'est la seule décision d'architecture qui pèse vraiment sur votre facture.

Le reste est du métier d'ingénieur : logger le usage de chaque run, filtrer les deployment runs en erreur, et accepter que le crédit du mois soit perdu plutôt que de le dépenser mal.

FAQ

Les crédits API de Claude Max sont-ils vraiment gratuits ?
Ils sont inclus dans un abonnement déjà payé, ce qui n'est pas tout à fait la même chose. Un Max 20x coûte 200 $ par mois et donne 200 $ de crédits API : vous ne payez rien de plus, mais vous ne récupérez pas l'abonnement non plus. Aucun moyen de paiement n'est requis sur la plateforme, et l'usage ne peut jamais être facturé à votre plan Claude : quand les crédits sont épuisés, les requêtes s'arrêtent avec un message d'erreur explicite. Les crédits expirent à la fin de chaque cycle de facturation sans report, et l'auto-reload ne s'applique qu'au solde acheté, pas aux crédits inclus. Concrètement, c'est un budget d'expérimentation mensuel à consommer ou à perdre.
Est-ce que ces crédits fonctionnent dans Claude Code ?
Non, et c'est la confusion numéro un depuis l'annonce. La documentation d'Anthropic exclut explicitement Claude Code et les dépassements d'usage dans les applications Claude. Si votre organisation Console ne détient que ces crédits et que vous lancez une session Claude Code sur une clé de cette organisation, vous obtenez le message « Credit balance too low · Add funds ». Claude Code continue de fonctionner sur les limites de votre abonnement Max ou Team, qui ne changent pas. Les crédits servent à l'API Messages, au Batch API, à l'Agent SDK avec clé API, aux Claude Managed Agents et au playground de la Console. Pour du développement interactif en terminal, rien ne change.
Claude Pro à 20 € donne-t-il droit à des crédits API ?
Non. Free, Pro et Enterprise sont exclus du programme. Seuls Max 5x (100 $), Max 20x (200 $) et Team (20 $ par siège standard, 100 $ par siège premium, plafonné à 500 $ mutualisés) sont éligibles, y compris les Team à tarif réduit pour associations et chercheurs. Le plan initialement annoncé en juin 2026 prévoyait 20 $ pour Pro, mais il a été annulé et la version livrée le 7 octobre laisse Pro de côté. Si vous êtes en Pro et que vous développez des agents, le calcul est simple : passer à Max ne se justifie que si votre consommation API réelle dépasse déjà 60 à 80 $ par mois, sinon payez l'API à l'usage.
Combien de requêtes peut-on faire avec 100 $ de crédits ?
Tout dépend du modèle, et l'écart est énorme. Les premiers ordres de grandeur publiés indiquent environ 220 000 requêtes avec Haiku 5.5, 11 000 avec Sonnet 5.5 et 5 500 avec Opus 5.5 pour 100 $. Sur mes propres agents, le tri de 8 800 tickets support en Haiku 5.5 via le Batch API a coûté 2,12 $ sur le mois, et un job nocturne outillé en Sonnet 5.5 lancé 22 fois a coûté 15,27 $. Deux leviers changent tout : le Batch API retire 50 % sur l'entrée et la sortie, et le prompt caching fait tomber les lectures de contexte répété à 5 ou 10 % du prix d'entrée selon le modèle.
Que se passe-t-il quand les crédits sont épuisés ?
Si votre organisation détient d'autres crédits achetés, les requêtes continuent dessus, et l'auto-reload se déclenche uniquement sur ce solde acheté. Si elle n'a plus rien, les appels API s'arrêtent jusqu'à l'arrivée des crédits du mois suivant, avec le message « Your credit balance is too low to access the Anthropic API ». L'usage n'est jamais basculé sur votre abonnement Claude. Les organisations facturées par le service commercial d'Anthropic, elles, voient leur dépassement facturé normalement. Attention aussi au plafond de dépense mensuel, distinct : l'usage payé en crédits y compte, et l'erreur correspondante est un 429 avec le code enforced_spend_limit_reached, sans en-tête retry-after.
Peut-on changer l'organisation Console liée à son abonnement ?
Pas soi-même. Un plan se lie à une seule organisation Console, et une organisation ne peut recevoir des crédits que d'un seul plan. Pour modifier le lien, il faut ouvrir un ticket au support Anthropic et attendre. C'est l'erreur la plus coûteuse en temps de toute la procédure : prenez la décision avant de cliquer, et si vous voulez une organisation dédiée aux agents, avec des workspaces cloisonnés et des plafonds par projet, créez-la d'abord sur platform.claude.com, puis liez-la. Vérifiez aussi que l'adresse e-mail de votre abonnement vous donne bien un rôle Owner, Admin ou Billing sur l'organisation visée, sinon le lien est impossible.
Les crédits non consommés se reportent-ils au mois suivant ?
Non. Les crédits inclus expirent à la fin de chaque cycle de facturation, ou mensuellement sur les abonnements annuels, et ne se reportent jamais. Ils sont aussi dépensés en priorité, avant tout crédit que vous auriez acheté. La date d'expiration s'affiche dans la Console sous Settings puis Billing, section Promotional credits. Cette règle a un effet pervers à connaître : elle pousse à la dépense de fin de cycle, donc au lancement d'agents mal cadrés pour « ne pas perdre » le solde. Mieux vaut un crédit perdu qu'un agent sans plafond de session lancé la veille de l'expiration.
Les crédits marchent-ils sur Bedrock, Vertex AI ou Microsoft Foundry ?
Non. Ils sont utilisables exclusivement sur l'API first-party d'Anthropic, dans la Claude Console. Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry et Claude Platform on AWS sont tous exclus, parce que c'est le fournisseur cloud qui vous facture dans ces cas. Si votre contrainte est l'hébergement européen ou une facturation consolidée sur votre compte cloud existant, ces crédits ne vous servent à rien et il faut regarder ailleurs. À noter : sur l'API first-party, forcer l'inférence aux États-Unis avec le paramètre inference_geo applique un multiplicateur de 1,1 sur tous les prix de tokens, crédits compris.
Claude Max vaut-il le coup pour un freelance qui développe des agents ?
À 200 $ par mois pour Max 20x, l'arbitrage se fait sur deux usages cumulés. Vous payez d'abord un accès Claude Code et Claude confortable, avec des limites élevées, et vous recevez en plus 200 $ de crédits API mensuels, soit l'équivalent d'environ 11 000 requêtes Sonnet 5.5 ou 220 000 requêtes Haiku 5.5. Pour trois agents en production comme les miens, la consommation réelle a été de 20 $ sur 30 jours : les crédits couvrent très largement le besoin. Le plan est donc intéressant si vous codez quotidiennement avec un agent CLI et que vous industrialisez des automatisations. Si vous ne faites que du chat, Pro à 20 € reste le bon choix.
Partager
Résumé vidéoen cours…