Skill Claude API

Le skill claude-api est un Agent Skill open source qui fournit à Claude une documentation de référence détaillée 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 8 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 un contexte efficace : Claude charge uniquement 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 fournit le skill

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 de stabilité de préfixe, 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 modifications de comportement sur Claude Opus 4.8)
• Informations actuelles sur les modèles : 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 guide pas à pas basé sur un 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 client : Reconnexion de flux sans perte, porte de file d'attente/traitement 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 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 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 facultatif) 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 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 fourni 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 Claude Code.



Depuis le dépôt de skills

La 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èle Claude sur l'ensemble d'une base de code. Invoquez-le directement avec /claude-api migrate :

/claude-api migrate this project to claude-opus-4-8

Vous pouvez également passer un périmètre spécifique dès le départ pour ignorer la question de confirmation du périmètre :

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

Lorsque le périmètre est ambigu (par exemple, un simple /claude-api migrate to claude-opus-4-8), 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 à ceux 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_7 → Model.CLAUDE_OPUS_4_8) 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 préremplissage, en convertissant les modèles de préremplissage de message assistant en sorties structurées lorsque cela est applicable
• 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 revenant de client.beta.messages.create à client.messages.create
• La calibration de l'effort, en recommandant un point de départ output_config.effort pour le modèle cible (par exemple, 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-agent 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 exposé 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 configurant un chemin de nouvelle tentative de repli lorsque la cible est Claude Fable 5 (le paramètre fallbacks côté serveur, 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 fur et à mesure des 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 la réévaluation des coûts et limites de débit).

Pour la liste complète des modifications spécifiques au modèle appliquées par le skill, consultez Migration de Claude Opus 4.7 vers 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 exécute 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 puis 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-4-8 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 dans l'implémentation en utilisant les modèles d'API actuels et les meilleures pratiques.



Étapes suivantes