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 des SDK propre à chaque 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 propres à chaque 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 d'arrêt 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.5, Claude Sonnet 5.5, Claude Haiku 5.5 et Claude Fable 5.1)
• Migration vers la réflexion préservée : identification, mesure et correction des modifications de l'historique qui invalident les blocs thinking, disponibles via la sous-commande /claude-api preserved-thinking-migration
• Informations sur les modèles actuels : identifiants de modèle, tailles de la « context window » (fenêtre de contexte) et tarifs.
• 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 :

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 demandez à Claude Code de 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 :

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

Lorsque la portée est ambiguë (par exemple, un simple /claude-api migrate to claude-opus-5-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 :

• Le remplacement des identifiants de modèle, y compris les constantes typées des SDK (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5_5) dans tous les langages pris en charge, en classant 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'identifiant de modèle 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 opéré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 message 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 repassant de client.beta.messages.create() à client.messages.create()
• Le calibrage de l'effort, en recommandant un point de départ pour output_config.effort adapté au 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 le résumé 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, Claude Opus 5.5, Claude Opus 5 ou Claude Sonnet 5.5 (le paramètre côté serveur fallbacks, 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 modifications spécifiques aux modèles appliquées par le skill, consultez Migrer vers Claude Opus 5.5 depuis Claude Opus 5, Migrer vers Claude Opus 5.5 depuis Claude Opus 4.8, Migrer vers Claude Sonnet 5.5 depuis Claude Sonnet 5, Guide de migration vers Claude Haiku 5.5 et Guide de migration vers Claude Fable 5.1 et Claude Mythos 5.1.

Vérifier une intégration pour la réflexion préservée

La réflexion préservée ne maintient un bloc thinking valide que tant que le prompt system, les tools et les messages qui le précèdent restent inchangés. Pour trouver et corriger les endroits où votre code modifie cet historique, ouvrez le dépôt qui construit vos requêtes et invoquez la sous-commande preserved-thinking-migration :

Le skill procède en cinq étapes :

1. Portée : vérifie si votre intégration est concernée, puis envoie trois requêtes de test pour confirmer que l'API signale une modification délibérée.
2. Recherche : capture quelques-unes de vos propres sessions multi-tours, compare les requêtes consécutives et liste chaque endroit où votre code modifie le préfixe.
3. Mesure : rejoue les sessions avec "drop_block" et indique quelles conversations perdent des blocs thinking, à quel tour et pourquoi.
4. Correction : remplace une modification à la fois par le modèle correspondant dans Effectuer des changements sans modifier le préfixe, et mesure à nouveau après chaque changement.
5. Rapport : résume chaque cause, le changement effectué pour y remédier et les décomptes avant et après.

Si votre projet dispose d'une évaluation, le skill compare également les scores et l'utilisation des tokens avec et sans blocs thinking supprimés.

Les requêtes de test et les rejeux sont de véritables requêtes à la Messages API, facturées aux tarifs normaux du modèle. Chaque rejeu ne demande que quelques tokens de sortie et définit tool_choice sur none, de sorte qu'aucun outil ne s'exécute. Le skill indique le coût et demande votre approbation avant de les envoyer.

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 :

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 :

Migrer un projet existant :

Intégrer un nouveau Managed Agent :

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