Compétence Claude API

La compétence claude-api est une compétence d'agent open-source qui fournit à Claude du matériel de référence détaillé et à jour pour construire 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 invites, les sorties structurées et les boucles d'agent personnalisées.
• Claude Managed Agents (bêta) — une surface propriétaire pour les agents avec état gérés par le serveur avec exécution d'outils hébergée par Anthropic, des configurations d'agent persistantes et des conteneurs par session.

Elle couvre 8 langages de programmation pour l'API Messages (Python, TypeScript, Java, Go, Ruby, C#, PHP et cURL) et 7 langages pour Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP et cURL — C# n'est pas actuellement supporté).

La compétence est fournie en bundle avec Claude Code et est également disponible dans le référentiel de compétences Anthropic open-source, où vous pouvez l'installer dans n'importe quel environnement qui supporte les compétences d'agent.

La compétence utilise la divulgation progressive pour maintenir le contexte efficace : Claude charge uniquement la documentation pertinente pour le langage de votre projet, la surface (API Messages ou Managed Agents) et la tâche spécifique à accomplir (utilisation d'outils, streaming, lots, etc.), plutôt que de tout charger à la fois.

Ce que la compétence fournit

Lorsqu'elle est déclenchée, la compétence équipe Claude avec :

Pour l'API Messages :

• Documentation SDK spécifique au langage : Installation, démarrage rapide, modèles courants et gestion des erreurs pour le langage de votre projet
• Guidance sur l'utilisation d'outils : Exemples spécifiques au langage et fondations conceptuelles pour l'appel de fonction, y compris le lanceur d'outils bêta où disponible
• Modèles de streaming : Détails d'implémentation pour construire des interfaces de chat et gérer l'affichage incrémental
• Traitement par lots : Traitement par lots hors ligne à 50% de réduction
• Mise en cache des invites : Conception de stabilité des préfixes, placement des points d'arrêt et audit du validateur silencieux
• Migration de modèle : Guidance étape par étape pour migrer vers des modèles Claude plus récents (y compris les changements de rupture et les décalages de comportement sur Claude Opus 4.7)
• Informations sur le modèle actuel : ID de modèle, tailles de fenêtre de contexte et tarification
• Guidance détaillée pour éviter les erreurs fréquentes lors de l'intégration avec l'API

Pour Managed Agents (bêta) :

• Flux d'intégration : Une procédure pas à pas guidée par entrevue pour configurer un nouvel agent géré à 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, Java, Go, Ruby, PHP et cURL
• Modèles de client : Reconnexion de flux sans perte, portail processed_at en attente/traité, gestion des interruptions, pièges de montage de fichiers et gestion des identifiants
• Contraintes de déploiement : Managed Agents est propriétaire uniquement (non disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry) — la compétence achemine les déploiements tiers vers l'API Messages + utilisation d'outils à la place

Quand la compétence s'active

La compétence s'active de deux façons :

L'activation automatique se produit quand :

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

L'invocation manuelle en tapant /claude-api (avec sous-commande optionnelle ou prose) dans n'importe quel environnement où la compétence est installée.

La compétence ne s'active pas pour les tâches de programmation générale, le travail ML/science des données ou le code qui importe d'autres SDK IA (comme OpenAI).

Langages supportés

La compétence 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 supportés (Rust, Swift, C++), la compétence fournit des exemples cURL/HTTP bruts.

Comment utiliser la compétence

Dans Claude Code (fourni en bundle)

La compétence est fournie avec Claude Code et ne nécessite aucune installation. Quand vous demandez à Claude d'aider à construire quelque chose avec l'API Claude, ou quand votre projet importe déjà un SDK Anthropic, la compétence s'active automatiquement.

Vous pouvez également l'invoquer directement :

/claude-api

Pour plus d'informations sur le fonctionnement des compétences fournies en bundle dans Claude Code, consultez la documentation des compétences Claude Code.

À partir du référentiel de compétences

La source de la compétence est disponible dans le référentiel de compétences Anthropic. Vous pouvez l'installer en utilisant la commande npx :

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

Ou installez-la en tant que plugin Claude Code :

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

Migration vers un modèle Claude plus récent

La compétence Claude API peut effectuer des migrations de modèles Claude dans une base de code. Invoquez-la directement avec /claude-api migrate :

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

Vous pouvez également passer une portée spécifique à l'avance pour ignorer la question de confirmation de portée :

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

Quand la portée est ambiguë (par exemple, un simple /claude-api migrate to claude-opus-4-7), la compétence vous demande de choisir entre le répertoire de travail entier, un sous-répertoire spécifique ou une liste de fichiers explicite avant de modifier des fichiers. Cela s'applique aux appelants de l'API Messages et de Managed Agents.

La compétence gère :

• Échanges d'ID de modèle, y compris les constantes SDK typées (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) dans tous les langages supportés, et classe chaque fichier comme un appelant, un définisseur de modèle ou une référence de chaîne opaque avant de modifier
• Changements de paramètres de rupture, comme la suppression de temperature, top_p et top_k pour Claude Opus 4.7, et la conversion de thinking: {type: "enabled", budget_tokens: N} en thinking: {type: "adaptive"}
• Remplacement de préfixe, conversion des modèles de préfixe de message d'assistant en sorties structurées le cas échéant
• Nettoyage d'en-tête bêta, suppression des en-têtes qui sont GA sur le modèle cible (par exemple, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) et retour de à

Au fur et à mesure qu'elle modifie, la compétence explique chaque changement et sa motivation en ligne. À la fin, elle produit une liste de contrôle des éléments qui nécessitent une vérification manuelle (généralement les tests d'intégration, l'ajustement des invites de contrôle de longueur et la réinitialisation des coûts/limites de débit).

Pour la liste complète des changements spécifiques au modèle que la compétence applique, consultez Migration vers Claude Opus 4.7.

Configuration d'un agent géré

Pour générer un nouvel agent géré à partir de zéro, invoquez la sous-commande managed-agents-onboard :

/claude-api managed-agents-onboard

La compétence exécute une entrevue qui vous guide à travers le modèle mental de Managed Agents (configurations d'agent par rapport aux sessions), crée un modèle de configuration d'agent, configure les environnements et les outils, configure la boucle de session et émet du code exécutable pour votre langage. La compétence couvre également le flux obligatoire Agent (une fois) → Session (à chaque exécution) — model, system et tools vivent sur l'agent, jamais sur la session, et les agents doivent être créés une fois et référencés par ID.

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.*.

Exemple d'utilisation

Voici des exemples de tâches que la compétence aide Claude à gérer :

Construire une application de chat :

Build a streaming chat UI with the Claude API in TypeScript

Migration d'un projet existant :

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

Intégration d'un nouvel agent géré :

/claude-api managed-agents-onboard

Dans chaque cas, la compétence charge la documentation spécifique au langage pertinente et guide Claude à travers l'implémentation en utilisant les modèles API actuels et les bonnes pratiques.

Étapes suivantes