« Je veux mettre Claude dans mon produit, je commence par quoi ? » Réponse ici : API, Agent SDK ou Managed Agents, et ce que chacun coûte.
Pour qui c'est
Les devs, les équipes tech et les solo builders qui veulent mettre Claude dans leur propre produit. Tu te sers seulement de l'app Claude ou de Claude Code ? Tu peux sauter ce chapitre.
Avec un repo, un backend ou un produit en prod, tu es au bon endroit. Tu vas exposer Claude à tes utilisateurs, ou le faire bosser en arrière-plan à ta place.
Les trois briques
Claude API. Les appels directs au modèle : tu envoies un prompt, tu récupères une réponse. C'est le socle du reste. Tu y trouves les structured outputs (réponse dans un format JSON imposé), le streaming (la réponse s'affiche au fil de l'eau), les tools (Claude appelle tes fonctions) et le prompt caching (on y revient plus bas). Depuis le 19 août 2026, la Files API (tu envoies un fichier une fois et tu le réutilises dans plusieurs appels) et la Skills API sont en disponibilité générale.
Claude Agent SDK (TypeScript et Python). La boucle de Claude Code, dans ton propre code : planification, appels d'outils, sous-agents, hooks, skills, MCP. Tu construis tes agents avec ton périmètre et tes outils, sur ton infra.
npm install @anthropic-ai/claude-agent-sdk
pip install claude-agent-sdk
L'option maxBudgetUsd plafonne ce qu'une exécution peut dépenser. Le champ total_cost_usd renvoyé à la fin est une estimation calculée côté client : la facture Anthropic fait foi.
Claude Managed Agents. La version hébergée par Anthropic, en beta publique depuis le 8 avril 2026. Depuis avril, la plateforme a ajouté des espaces mémoire, le multi-agent, les sandboxes auto-hébergées, les déploiements planifiés, des coffres pour les secrets (vaults) et un réglage d'effort par agent.
Les deux font tourner la même chose : un agent qui réfléchit, appelle des outils et revient avec un résultat. Avec l'Agent SDK, c'est une librairie dans ton code, sur ta machine ou ton serveur : tu gères l'hébergement, les reprises sur erreur et la montée en charge. Avec les Managed Agents, Anthropic fournit la sandbox (l'environnement isolé où l'agent exécute son code) et fait tourner la machine, contre 0,08 $ par heure de session active.
Les prix
Tout se paie au token, un morceau de mot (le chapitre 11 explique ce que ça représente). L'input, c'est ce que tu envoies. L'output, ce que Claude écrit. La lecture cache, c'est de l'input déjà envoyé que Claude relit pour beaucoup moins cher.
Prix par million de tokens, en octobre 2026 :
| Modèle | Input | Output | Lecture cache |
|---|---|---|---|
| Fable 5.1 | 10 $ | 50 $ | 0,25 $ |
| Opus 5.5 | 4 $ | 20 $ | 0,20 $ |
| Sonnet 5.5 | 2 $ | 10 $ | 0,10 $ |
| Haiku 5.5 | 0,10 $ | 0,50 $ | 0,01 $ |
Les quatre modèles acceptent 1 million de tokens de contexte et 128 000 tokens de sortie. Le prix Haiku 5.5 vaut pour un prompt de 100 000 tokens maximum. Au-delà, il passe à 0,50 $ en input, 2,50 $ en output et 0,05 $ en lecture cache.
Quelques règles qui changent la facture :
- Le batch divise par deux. Tu envoies tes requêtes en lot, Anthropic les traite en différé (la plupart en moins d'une heure, 24 h maximum). Cumulable avec le cache.
- L'écriture en cache coûte un peu plus que l'input normal : 1,25 fois le prix pour un cache de 5 minutes, 2 fois pour un cache d'une heure.
- Le raisonnement compte comme de l'output. L'effort (le niveau de réflexion avant de répondre, de
lowàmax) pèse donc directement sur la facture. Par défaut sur l'API, il est surhighpour Fable 5.1 et Sonnet 5.5, surmediumpour Opus 5.5 et Haiku 5.5. - Fast mode (même modèle, réponses plus rapides) : 8 $ en input et 40 $ en output sur Opus 5.5.
- Recherche web : 10 $ les 1 000 recherches, en plus des tokens.
Depuis Opus 4.7, Anthropic utilise un nouveau tokenizer (l'outil qui découpe le texte en tokens). Le même texte donne environ 30 % de tokens en plus qu'avant. Si tu compares avec une facture de 2025, regarde surtout le coût par tâche.
Combien coûte un Managed Agent
Les tokens au tarif standard, plus 0,08 $ par heure de session active. Seul le temps où l'agent est en cours d'exécution est compté. Un agent qui travaille 2 h par jour pendant 30 jours, c'est 60 h, soit 4,80 $ d'hébergement, plus ses tokens. Le batch ne s'applique pas aux Managed Agents.
Depuis août 2026, tu peux fixer un budget en dollars par session pour plafonner la dépense. Mets-en un dès le premier déploiement.
Les crédits API inclus dans Max et Team
Depuis le 7 octobre 2026, certains abonnements donnent des crédits API chaque mois :
| Plan | Crédits API par mois |
|---|---|
| Max 5x | 100 $ |
| Max 20x | 200 $ |
| Team | 20 $ par siège Standard, 100 $ par siège Premium, mutualisés, plafonnés à 500 $ |
Ils couvrent l'API, les Managed Agents, l'Agent SDK et le playground. Ils ne couvrent pas Claude Code. Les crédits non utilisés ne sont pas reportés au mois suivant. Free, Pro et Enterprise n'y ont pas droit.
Pour un abonné Max, ça suffit pour prototyper une intégration sans sortir la carte bancaire.
Quand utiliser quoi
| Outil | Tu veux... |
|---|---|
| API directe | Envoyer un prompt depuis ton app et afficher la réponse. |
| Agent SDK | La boucle complète (planification, outils, sous-agents, hooks) dans ton code. |
| Managed Agents | Un agent qui tourne sans toi et sans serveur à gérer (veille, tâches longues). |
Règle simple : un seul appel suffit, reste sur l'API. Dès qu'il te faut un agent qui réfléchit, appelle des outils et revient avec un résultat, passe à l'Agent SDK, ou aux Managed Agents si cet agent doit tourner sans toi.
Exemple sur un site comme le mien (Next.js) :
- Un bouton "résume ce chapitre" : un appel API direct. Haiku 5.5 suffit largement pour ce genre de tâche.
- Un script qui, chaque lundi, relit les messages du formulaire de contact, les trie et prépare des brouillons de réponse : Agent SDK, lancé par ton propre cron.
- Le même agent, sans serveur à toi : Managed Agents avec un déploiement planifié et un budget de session.
Le cache, premier levier en prod
Le prompt caching garde en mémoire le début de ton prompt (instructions système, docs, définitions d'outils) quand il ne change pas d'un appel à l'autre. Les appels suivants relisent ce début au prix de la lecture cache : 10 fois moins cher que l'input sur la plupart des modèles, 20 fois sur Opus 5.5 et Sonnet 5.5, 40 fois sur Fable 5.1.
Trois conditions pour que ça marche :
- Mets ce qui ne bouge pas en tête (outils, puis instructions système, puis messages) et ce qui change à la fin.
- Ne touche pas aux définitions d'outils en cours de route : ça invalide tout le cache.
- Vise au moins 512 tokens dans la partie à cacher sur les modèles récents. En dessous, rien n'est mis en cache, et l'API ne te le signale pas.
Le cache dure 5 minutes par défaut, 1 heure en option, et chaque lecture remet le compteur à zéro. Le mécanisme est expliqué sans jargon au chapitre 11.
Question
Abonné Max 5x, tu reçois 100 $ de crédits API par mois depuis le 7 octobre 2026. Ces crédits paient-ils ta consommation dans Claude Code ?
Choisis une réponse pour voir l'explication.
À retenir
- L'API pour un appel unique, l'Agent SDK dès qu'il faut une boucle d'agent dans ton code, les Managed Agents si tu ne veux pas d'infra.
- Le million de tokens (input / output) : 4 $ / 20 $ sur Opus 5.5, 0,10 $ / 0,50 $ sur Haiku 5.5.
- Depuis Opus 4.7, le même texte fait environ 30 % de tokens en plus.
- Max et Team incluent des crédits API depuis le 7 octobre 2026, hors Claude Code.
- Avant de chercher d'autres économies, active le cache et le batch.