Choisir un modèle Claude
Le compromis Opus/Sonnet/Haiku et comment choisir — sans deviner.
Tokens, contexte et tarification
Comptez correctement les tokens, max_tokens vs fenêtre de contexte, et l'estimation du coût.
Votre premier appel à l'API
Installez le SDK, authentifiez-vous et effectuez un véritable appel à Claude en Python, TypeScript ou cURL.
API Version 2026-10-21 — The First Breaking Version in Three Years
Claude's anthropic-version header moved for the first time since 2023. What breaks, why your package manager decides when you adopt it, and the exact upgrade order.
Streaming et conversations multi-tours
Diffusez les réponses en streaming et gérez l'historique sur une API sans état.
Utilisation des outils / appel de fonctions
Définissez des outils, exécutez la boucle agentique et traitez les résultats — y compris les trois règles de forme de message qui provoquent des 400, et pourquoi tool_choice "any" et "tool" renvoient désormais une erreur sur les modèles Claude les plus récents.
Outil d'exécution de code — Bash, fichiers et Python en bac à sable
Le bac à sable côté serveur d'Anthropic permet à Claude d'exécuter du Bash, de modifier des fichiers et d'exécuter du Python — avec 5 Gio de RAM, une réutilisation de conteneur sur 30 jours et un palier gratuit de 1 550 heures par mois. Les trois versions de l'outil, ce que chacune apporte, quand c'est gratuit, et le piège de capture de fichiers que personne ne documente.
Vision, PDF et fichiers en entrée
Envoyez des images et des documents, et réutilisez les téléversements grâce à file_id.
Sortie structurée
Obtenez du JSON conforme à un schéma sur lequel vous pouvez compter — pas du « prie pour que ça marche ».
Réflexion étendue et effort
Le raisonnement adaptatif et le contrôle de l'effort — choisir la profondeur selon la charge de travail.
Régler l'effort : 5 niveaux, valeurs par défaut par modèle et le piège du cache
Le paramètre effort de juillet 2026 comporte cinq niveaux — low, medium, high, xhigh, max — et se place dans output_config, pas au premier niveau. Il agit sur les appels d'outils (pas seulement sur la réflexion), invalide le cache de prompt s'il change en cours de conversation, et chaque modèle a un point de départ recommandé différent. Le guide pratique de réglage.
L'outil advisor : Sonnet fait le travail, Fable fait la réflexion
L'outil serveur advisor (beta advisor-tool-2026-03-01) permet à un modèle exécuteur rapide de consulter un modèle plus fort en milieu de tour. Référence complète des champs, le piège de comptabilité de tokens que la plupart des intégrateurs manquent, la matrice d'appariement de modèles, et les prompts exacts qu'Anthropic livre en production.
Task Budgets — des plafonds de tokens consultatifs qui font terminer les agents avec élégance
La bêta de l'API Messages de mars 2026 donne à Claude un budget de tokens pour toute la boucle agentique — réflexion, appels d'outils, résultats d'outils, sortie — pour que les agents longs s'autorégulent et concluent proprement au lieu de partir en dérive. Comment fonctionne le décompte, pourquoi il est consultatif et non imposé, et comment le dimensionner pour qu'il ne provoque pas de comportement proche du refus.
Mise en cache des prompts et optimisation des coûts
Réutilisez un préfixe de prompt stable pour réduire le coût et la latence — et le piège qui casse tout.
Diagnostics de cache — découvrez exactement pourquoi votre cache a manqué
Arrêtez de deviner pourquoi cache_read_input_tokens vaut zéro. L'API vous dira quelle partie de votre prompt a divergé, et de combien de tokens.
Message Batches — des tâches asynchrones à -50 %
Divisez votre coût par deux et augmentez le débit en déplaçant le travail de masse vers l'API Batches asynchrone — avec les pièges qui font trébucher tout le monde.
Messages système en cours de conversation
Piloter une longue session d'agent sans faire exploser le cache de prompt — le nouveau rôle système que vous pouvez ajouter après n'importe quel tour utilisateur.
Changements d'outils en cours de conversation
Ajouter et retirer des outils entre les tours sans invalider le cache de prompt — la beta Opus 5 qui corrige la plus grosse taxe cachée sur les longues sessions d'agent.
Construire des agents sur l'API
Appel unique vs workflow vs agent personnalisé — le test de décision et la conception de la boucle.
Agents gérés
Boucle d'agent hébergée par Anthropic : agents vs sessions, environnements, mémoire, vaults et déploiements planifiés (cron).
Managed Agents Memory Stores
La bêta de juillet 2026 — mémoire persistante côté serveur qui se monte dans un sandbox Managed Agents, avec versioning, piste d'audit et rédaction.
Budgets de session Managed Agents
La bêta d'août 2026 — plafonds fermes en dollars sur une session Managed Agents, appliqués aux tarifs publics affichés, avec le stop reason budget_reached, le dépassement d'une requête et le modèle pause-and-resume.
Restrictions de domaine des Managed Agents
La bêta du 26 août 2026 — allowed_domains, blocked_domains, max_content_tokens et user_location sur web_search et web_fetch dans les Managed Agents. Règles de format, sémantique multiagent, mises à jour en cours de session et l'erreur url_not_allowed.
Cowork et équipes d'agents
L'espace de travail bureautique agentique et la collaboration multi-agents en tant que produits.
MCP et connexion aux outils
Appelez des serveurs MCP distants directement depuis la Messages API — la forme de la requête, allowlists et denylists, chargement différé, et les limites qui piquent en production.
MCP 2026-07-28 : la spec stateless
La plus grosse révision MCP depuis le lancement : la session a disparu, chaque requête s'auto-décrit, et n'importe quelle instance de serveur peut répondre à n'importe quel appel. Ce qui a réellement changé le 28 juillet 2026, et comment migrer sans casser les serveurs d'aujourd'hui.
MCP Apps : UIs interactives dans un appel d'outil
MCP Apps (SEP-1865) permet à un serveur MCP de livrer une UI HTML que le client rend dans une iframe sandboxée — chaque action passant toujours par le chemin d'audit standard JSON-RPC. Ce que dit vraiment la spec, ce qu'il faut construire avec, et ce qu'il faut refuser de construire.
MCP Tasks : travail long sans la session
La spec MCP sans état 2026-07-28 a tué la session — alors comment modéliser un job CI de 20 minutes, un import batch, ou une porte d'approbation humaine ? Avec l'extension officielle Tasks (SEP-2663). Cycle de vie complet, protocole wire, migration depuis l'ancienne API Tasks expérimentale, et les patterns de polling/notification qui marchent vraiment en production.
Playwright MCP : le guide pratique approfondi (2026)
Le Playwright MCP de Microsoft est maintenant le serveur MCP n°1 au monde — devant GitHub et Figma. Le bit que presque personne n'enseigne : le mode snapshot d'accessibilité par défaut n'est pas juste plus rapide que la vision, c'est un paradigme d'automatisation complètement différent. Profils, caps opt-in, mode extension navigateur qui s'attache à votre vrai Chrome, la bataille du coût en tokens contre Playwright-comme-Skill, et la ligne de sécurité à ne pas franchir.
Sécurité, refus et solutions de repli
Gérez les refus avec élégance et distinguez-les des blocages du classifieur.
Fallbacks côté serveur & Fallback Credit
La bêta Opus 5 qui transforme un refus Fable 5 / Opus 5 en réponse normale à l'intérieur d'un seul appel API — plus le token de crédit qui vous empêche de payer le cache de prompt deux fois sur le retry.
Erreurs, limites de débit et fiabilité
La carte des erreurs, les nouvelles tentatives avec backoff, les paliers de limite de débit et la migration de modèle.
Mémoire et édition du contexte
Donnez aux agents une mémoire persistante et un contexte auto-élagué — l'outil memory côté client plus l'édition du contexte qui efface les résultats d'outils périmés pour survivre aux exécutions longues.
Compaction de conversation — résumer l'historique côté serveur et poursuivre
L'API Messages peut résumer une conversation en un unique bloc signé que vous renvoyez à la place des messages qu'il remplace. Les quatre variantes (à la demande, keep-tail, en arrière-plan, par seuil), les règles de substitution, les deux erreurs qui échouent silencieusement avec un HTTP 200, et ce qu'un résumé ne peut jamais transporter.
Tool Search & Deferred Loading
Scale to thousands of tools without context bloat: how defer_loading and the tool search tool actually work, the five 400s they produce, and why your request body does not get smaller.
Message Threads — Send Only the New Turn
The Messages API can keep your conversation on the server and let each turn send only the new messages. What it actually saves (bytes and latency, not tokens), the replay path you must build before you ship, the three field groups, and the 4-breakpoint cache limit.
Appel d'outils par programme
Laissez Claude appeler vos outils depuis du Python exécuté dans le bac à sable d'exécution de code — moins d'allers-retours, et les résultats intermédiaires restent hors du contexte.
L'Admin API : automatisez votre org Claude
Le guide de l'opérateur pour l'Admin API d'Anthropic — lister les membres, inviter des utilisateurs, gérer les groupes RBAC, offboarder proprement. Console + Claude Enterprise, avec les pièges seat-pool et SSO qui font trébucher les vraies équipes.
Agent Observability: Tracing an Agent You Can't Reproduce
An agent run is a non-deterministic distributed trace, so you cannot debug it by re-running it — you have to have recorded it. This page covers what to record: the OpenTelemetry GenAI span shapes (and why every gen_ai.* attribute is still 'Development'), Claude Code's exact metric and event names, the request-id that links your trace to Anthropic support, and the three privacy traps in agent telemetry.
First-Party OpenTelemetry Tracing: Two Paths, One Trace
Since October 2026 the Claude API and the Claude SDK emit OpenTelemetry spans themselves — no hand-rolled instrumentation. But the two paths overlap, and summing both will double your token numbers. This page covers the setup for each, the one rule that keeps token counts honest, the traceparent flag that silently deletes your traces, and the delivery rules that disable a destination after 24 hours.
The Usage & Cost Analytics API: Attribute Every Dollar
The practical guide to Claude's Usage and Cost Analytics API — the beta that replaced the legacy usage_report and cost_report endpoints. Row shape, the five-dimension limit, actor semantics, the 100x cents footgun, data-freshness rules that break naive dashboards, and the legacy migration table.
Inference Hooks : DLP inline pour Claude Enterprise
Le guide de l'opérateur pour les Inference Hooks de Claude Enterprise — le webhook HTTPS qui permet à votre serveur DLP d'autoriser ou refuser chaque prompt sur le chat, Claude Code et Cowork, avant que le modèle ne le voie. Spécification complète, schéma des verdicts, signature, playbook de déploiement.
User Profiles & Enforcement: Don't Let One Customer Ban Your Whole Org
The operator's guide to Claude API user profiles — attribute every request to an end customer so a safety restriction or ban lands on one profile instead of your entire organization. Full field reference, the four enforcement_status values, the enac_ action schema, organization webhooks, and the polling loop you need because event delivery isn't live yet.