Skill Claude API

Le skill claude-api est un Agent Skill open source qui fournit à Claude des documents de référence détaillés et à jour pour créer des applications sur deux surfaces Anthropic :

• Messages API : la surface principale pour les requêtes uniques, le chat en streaming, le « tool use » (utilisation d'outils), le traitement par lots, le « prompt caching » (mise en cache des prompts), les sorties structurées et les boucles d'agent personnalisées.
• Claude Managed Agents (bêta) : une surface hébergée par Anthropic pour des agents avec état gérés côté serveur, avec exécution d'outils hébergée par Anthropic, des configurations d'agent persistantes et des sandboxes par session.

Il couvre huit langages de programmation, tant pour la Messages API que pour Managed Agents : Python, TypeScript, C#, Go, Java, PHP, Ruby et cURL.

Le skill est fourni avec Claude Code et est également disponible dans le dépôt de skills Anthropic open source, d'où vous pouvez l'installer dans tout environnement prenant en charge les Agent Skills.

Le skill utilise la « progressive disclosure » (divulgation progressive) pour préserver l'efficacité du contexte : Claude ne charge que la documentation pertinente pour le langage de votre projet, la surface (Messages API ou Managed Agents) et la tâche spécifique en cours (utilisation d'outils, streaming, lots, etc.), plutôt que de tout charger d'un coup.

Ce que fournit le skill

Lorsqu'il est déclenché, le skill dote Claude des éléments suivants :

Pour la Messages API :

• Documentation SDK spécifique au langage : installation, démarrage rapide, modèles courants et gestion des erreurs pour le langage de votre projet
• Conseils sur l'utilisation d'outils : exemples spécifiques au langage et fondements conceptuels pour l'appel de fonctions, y compris le tool runner bêta lorsqu'il est disponible
• Modèles de streaming : détails d'implémentation pour créer des interfaces de chat et gérer l'affichage incrémental
• Traitement par lots : traitement par lots hors ligne à 50 % du coût
• Mise en cache des prompts : conception axée sur la stabilité des préfixes, placement des points de rupture et audit des invalidateurs silencieux
• Migration de modèle : conseils étape par étape pour migrer vers des modèles Claude plus récents (y compris les changements incompatibles et les évolutions de comportement sur Claude Opus 5 et Claude Fable 5.1)
• Informations sur les modèles actuels : identifiants de modèles, tailles de « context window » (fenêtre de contexte) et tarification
• Pièges courants : conseils détaillés pour éviter les erreurs fréquentes lors de l'intégration avec l'API

Pour Managed Agents (bêta) :

• Parcours d'intégration : un guide pas à pas sous forme d'entretien pour configurer un nouveau Managed Agent à partir de zéro, disponible via la sous-commande /claude-api managed-agents-onboard
• Documentation Managed Agents spécifique au langage : création d'agents persistants, démarrage de sessions, streaming d'événements et gestion des confirmations d'outils pour Python, TypeScript, C#, Go, Java, PHP, Ruby et cURL
• Modèles côté client : reconnexion de flux sans perte, porte queued/processed basée sur processed_at, gestion des interruptions, pièges liés au montage de fichiers et gestion des identifiants
• Contraintes de déploiement : Managed Agents est disponible uniquement sur la Claude API et Claude Platform on AWS (pas sur Amazon Bedrock, Google Cloud ni Microsoft Foundry). Le skill redirige les autres déploiements vers la Messages API et l'utilisation d'outils à la place.

Quand le skill s'active

Le skill s'active de deux manières :

L'activation automatique se produit lorsque :

• Votre code importe un SDK Anthropic (anthropic pour Python, @anthropic-ai/sdk pour TypeScript/JavaScript)
• Vous demandez à Claude de vous aider à créer, déboguer ou optimiser quelque chose avec la Claude API, un SDK Anthropic ou Managed Agents
• Vous ajoutez, modifiez ou ajustez une fonctionnalité Claude dans un fichier (mise en cache des prompts, réflexion adaptative, compaction, utilisation d'outils, lots, fichiers, citations, mémoire) ou une référence de modèle

L'invocation manuelle en tapant /claude-api (avec une sous-commande ou du texte libre facultatifs) dans tout environnement où le skill est installé.

Le skill ne s'active pas pour les tâches de programmation générales, les travaux de ML/science des données, ni pour le code qui importe d'autres SDK d'IA (comme OpenAI).

Langages pris en charge

Le skill détecte automatiquement le langage de votre projet en examinant les fichiers du projet (par exemple, requirements.txt pour Python, tsconfig.json pour TypeScript, go.mod pour Go) et charge la documentation appropriée.

Si votre projet utilise plusieurs langages, Claude vous demande lequel s'applique. Pour les langages non pris en charge (Rust, Swift, C++), le skill fournit des exemples cURL/HTTP brut.

Comment utiliser le skill

Dans Claude Code (intégré)

Le skill est livré avec Claude Code et ne nécessite aucune installation. Lorsque vous demandez à Claude de vous aider à créer quelque chose avec la Claude API, ou lorsque votre projet importe déjà un SDK Anthropic, le skill s'active automatiquement.

Vous pouvez également l'invoquer directement :

/claude-api

Pour en savoir plus sur le fonctionnement des skills intégrés dans Claude Code, consultez la documentation des skills Claude Code.

Depuis le dépôt de skills

Le code source du skill est disponible dans le dépôt de skills Anthropic. Vous pouvez l'installer à l'aide de la commande npx :

npx skills add https://github.com/anthropics/skills --skill claude-api

Ou l'installer en tant que plugin Claude Code :

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

Migrer vers un modèle Claude plus récent

Le skill Claude API peut effectuer des migrations de modèles Claude sur l'ensemble d'une base de code. Invoquez-le directement avec /claude-api migrate :

/claude-api migrate this project to claude-opus-5

Vous pouvez également indiquer d'emblée une portée spécifique pour passer la question de confirmation de la portée :

/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

Lorsque la portée est ambiguë (par exemple, un simple /claude-api migrate to claude-opus-5), le skill vous demande de choisir entre l'ensemble du répertoire de travail, un sous-répertoire spécifique ou une liste explicite de fichiers avant de modifier le moindre fichier. Cela s'applique aussi bien aux appelants de la Messages API qu'à ceux de Managed Agents.

Le skill gère :

• Les remplacements d'identifiants de modèles, y compris les constantes typées des SDK (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5) dans tous les langages pris en charge, et classe chaque fichier comme appelant, définisseur de modèle ou référence de chaîne opaque avant toute modification
• La détection de la plateforme cloud, en préservant les formats d'identifiants de modèles propres à chaque plateforme (par exemple, le préfixe anthropic. sur Amazon Bedrock) et en ignorant les modifications pour les fonctionnalités indisponibles sur les plateformes exploitées par des partenaires
• Les changements de paramètres incompatibles, comme la suppression de temperature, top_p et top_k pour Claude Opus 4.8 et Claude Opus 4.7, et la conversion de thinking: {type: "enabled", budget_tokens: N} en thinking: {type: "adaptive"}
• Le remplacement du préremplissage, en convertissant les modèles de préremplissage de messages assistant en sorties structurées le cas échéant
• Le nettoyage des en-têtes bêta, en supprimant les en-têtes bêta dont le modèle cible n'a pas besoin (par exemple, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) et en revenant de client.beta.messages.create à client.messages.create
• Le calibrage de l'effort, en recommandant un point de départ output_config.effort pour le modèle cible (par exemple, la valeur par défaut high sur Claude Opus 5, et xhigh pour les cas d'usage de codage et agentiques sur Claude Opus 4.8 et Claude Opus 4.7)
• L'ajustement du comportement des prompts, en signalant les prompts de contrôle de longueur, de déclenchement d'outils, de sous-agents et de suivi d'instructions susceptibles de se comporter différemment sur le modèle cible
• La gestion des valeurs par défaut silencieuses, en réactivant la synthèse de la réflexion (thinking.display: "summarized") lorsque le raisonnement est présenté aux utilisateurs sur Claude Opus 4.8 et Claude Opus 4.7
• La configuration du repli en cas de refus, en ajoutant la gestion de stop_reason: "refusal" avant la lecture du contenu de la réponse et en mettant en place un chemin de nouvelle tentative de repli lorsque la cible est Claude Fable 5.1, Claude Fable 5 ou Claude Opus 5 (le paramètre fallbacks côté serveur, généralement dans son mode "default", le middleware de repli en cas de refus du SDK, ou une nouvelle tentative avec crédit de repli), et en mettant à jour le code de repli écrit pour des formes de préversion antérieures

Au fil de ses modifications, le skill explique chaque changement et sa motivation directement dans le contexte. Une fois terminé, il produit une liste de contrôle des éléments nécessitant une vérification manuelle (généralement les tests d'intégration, l'ajustement des prompts de contrôle de longueur et le recalibrage des coûts et des « rate limits » (limites de débit)).

Pour la liste complète des changements propres à chaque modèle appliqués par le skill, consultez Migrer vers Claude Opus 5 depuis Claude Opus 4.8 et Migrer vers Claude Fable 5.1.

Configurer un Managed Agent

Pour générer la structure d'un nouveau Managed Agent à partir de zéro, invoquez la sous-commande managed-agents-onboard :

/claude-api managed-agents-onboard

Le skill mène un entretien qui vous guide à travers le modèle mental de Managed Agents (configurations d'Agent versus Sessions), crée un modèle de configuration d'agent, configure les environnements et les outils, met en place la boucle de session et produit du code exécutable pour votre langage. Le skill couvre également le flux obligatoire Agent (une fois) → Session (à chaque exécution) : model, system et tools résident sur l'agent, jamais sur la session, et les agents doivent être créés une seule fois puis référencés par leur identifiant.

Managed Agents nécessite l'en-tête bêta managed-agents-2026-04-01, que le SDK définit automatiquement pour tous les appels client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* et client.beta.vaults.*.

Exemples d'utilisation

Voici des exemples de tâches que le skill aide Claude à accomplir :

Créer une application de chat :

Build a streaming chat UI with the Claude API in TypeScript

Migrer un projet existant :

/claude-api migrate this codebase to claude-opus-5 and re-tune effort

Intégrer un nouveau Managed Agent :

/claude-api managed-agents-onboard

Dans chaque cas, le skill charge la documentation spécifique au langage pertinente et guide Claude tout au long de l'implémentation en utilisant les modèles d'API et les bonnes pratiques actuels.

Étapes suivantes