Gaëtan Wittebolle.
UmamiContactEN
EN
← guides
L'écosystème Claude, le panorama
Chapitre 10 / 10
  • 07Cowork et desktop
  • 08Chrome et mobile
  • 09Routines, automatiser tes workflows
  • 10API, Agent SDK et agents managés

Partie 3 · Pour automatiser et déployer partout

API, Agent SDK et agents managés

Chapitre 10 · 3 min de lecture

La couche builder de Claude, pour intégrer l'IA dans ton produit ou ton workflow programmatique.

Pour qui c'est

Les devs, les équipes tech et les solobuilders qui veulent construire AVEC Claude plutôt que juste L'UTILISER. Si ton quotidien c'est d'ouvrir claude.ai ou Claude Code, saute ce chapitre.

Si ton quotidien c'est un repo, un backend, un pipeline ou un produit qui tourne en prod, bienvenue. Tu vas exposer Claude à tes utilisateurs, ou le faire bosser en arrière-plan à ta place.

Ce que tu peux faire, 3 outils distincts

Claude API (platform). Les appels directs au modèle. Tu envoies un prompt, tu récupères une réponse. Le socle de tout le reste. Tu as les structured outputs en GA, le prompt caching pour économiser sur les gros prompts récurrents, le streaming pour afficher la réponse token par token, les tools pour laisser Claude appeler tes fonctions. C'est ce que tu utilises pour intégrer Claude dans TON app.

Claude Agent SDK (Python + TypeScript). Reproduit la boucle Claude Code dans ton propre environnement. Hooks, sub-agents, skills, MCP, tout le harness qui fait que Claude Code sait planifier, lancer des outils, déléguer et vérifier son travail. Si tu veux construire tes propres agents, avec ton propre scope et tes propres outils, c'est la brique à prendre. Tu gardes le contrôle total de l'infra.

Claude Managed Agents (beta). La version hébergée par Anthropic. Sandbox d'exécution, streaming via SSE, infra qui tourne 24/7. Tu écris la logique de l'agent, Anthropic fait tourner la machine. Pour déployer des agents sans gérer les serveurs, les reprises sur erreur, le scaling.

Combien ça coûte

Pay as you go basé sur les tokens, input et output. Les prix varient selon le modèle (Haiku, Sonnet, Opus) et suivent la logique classique : plus le modèle est capable, plus le token coûte.

Le prompt caching change vraiment l'équation. Sur un gros system prompt récurrent (instructions projet, docs, contexte client), tu peux descendre jusqu'à 90% d'économie sur la partie cachée. C'est le premier levier à activer quand tu pars en prod.

L'Agent SDK et les Managed Agents consomment les mêmes tokens que l'API. Les Managed Agents ajoutent un coût d'hébergement pour l'infra gérée. Prix exacts sur platform.claude.com.

Quand utiliser quoi

OutilTu veux...
API directeTaper un prompt dans ton app et afficher la réponse.
Agent SDKLa boucle complète (planning, tool use, sub-agents, hooks) dans ton propre code.
Managed AgentsUn agent qui tourne 24/7 sans gérer l'infra (watchers, monitoring, tâches longues).

Règle simple : tant que tu peux répondre en un seul appel, tu restes sur l'API. Quand il te faut un agent qui réfléchit, appelle des outils et revient avec un résultat, tu passes sur l'Agent SDK. Et si cet agent doit vivre sans toi, tu bascules sur les Managed Agents.

Exemple parlant : le site gaetanwittebolle.com utilise Resend + Next.js côté produit. Une feature comme "résumer un chapitre à la demande" passerait par l'API Claude directe. Un "agent carrière" qui veille sur LinkedIn tous les jours passerait par Managed Agents.

Liens utiles

  • Docs platform
  • Agent SDK overview
  • Managed Agents
← Chapitre 9

Routines, automatiser tes workflows