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, l'utilisation d'outils, le traitement par lots, la 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, configurations d'agent persistantes et bacs à sable par session.

Il couvre huit langages de programmation pour la Messages API et les 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, où vous pouvez l'installer dans n'importe quel environnement prenant en charge les Agent Skills.

Le skill utilise la divulgation progressive pour maintenir 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 en une seule fois.



Ce que le skill fournit

Lorsqu'il est déclenché, le skill équipe Claude avec :

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 à stabilité de préfixe, 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 changements de comportement sur Claude Opus 5)
• Informations sur les modèles actuels : identifiants de modèle, tailles de 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 les Managed Agents (bêta) :

• Flux d'intégration : un parcours guidé par 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, barrière queued/processed 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 l'API Claude et Claude Platform on AWS (pas sur Amazon Bedrock, Google Cloud ou 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 l'API Claude, un SDK Anthropic ou les 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 en option) dans n'importe quel environnement où le skill est installé.

Le skill ne s'active pas pour les tâches de programmation générales, le travail de ML/science des données, ou 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 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 l'API Claude, 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 de 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 à travers une base de code. Invoquez-le directement avec /claude-api migrate :

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

Vous pouvez également passer une portée spécifique dès le départ pour ignorer la question de confirmation de 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 le répertoire de travail entier, un sous-répertoire spécifique ou une liste explicite de fichiers avant de modifier quoi que ce soit. Cela s'applique aux appelants de la Messages API comme des Managed Agents.

Le skill gère :

• Les remplacements d'identifiants de modèle, y compris les constantes SDK typées (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 de le modifier
• La détection de plateforme cloud, en préservant les formats d'identifiants de modèle spécifiques à la 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 prefill, en convertissant les modèles de prefill 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 qui sont en disponibilité générale sur le modèle cible (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 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 qui peuvent 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 ou Claude Opus 5 (le paramètre côté serveur fallbacks, généralement dans son mode "default", le middleware SDK de repli en cas de refus, 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 fur et à mesure de ses modifications, le skill explique chaque changement et sa motivation en ligne. À la fin, 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 réétalonnage des coûts et des limites de débit).

Pour la liste complète des changements spécifiques au modèle que le skill applique, consultez Migrer vers Claude Opus 5 depuis Claude Opus 4.8.



Configurer un Managed Agent

Pour créer 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 des 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 génère 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 et référencés par 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 à gérer :

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 pertinente spécifique au langage et guide Claude tout au long de l'implémentation en utilisant les modèles d'API actuels et les bonnes pratiques.



Prochaines étapes