claude-api

Overview

À quoi sert claude-api

La skill claude-api est une référence pratique pour créer des applications propulsées par des LLM avec Claude, en s’appuyant sur la Claude API, les SDK officiels d’Anthropic et, lorsque disponibles, les ressources Agent SDK. Elle est organisée par langage afin de permettre aux développeurs de passer rapidement de la configuration initiale à des requêtes fonctionnelles, au streaming, à l’usage d’outils et aux modèles d’intégration backend.

Cette skill est particulièrement utile si vous savez déjà que vous souhaitez travailler avec Claude et que vous avez besoin de conseils d’implémentation plutôt que d’une présentation générale de l’IA. Le dépôt inclut une documentation spécifique à chaque langage pour C#, Go, Java, PHP, Ruby, Python et TypeScript, ainsi que des exemples HTTP bruts dans curl/.

À qui s’adresse cette skill

claude-api convient particulièrement à :

• des développeurs backend qui intègrent Claude dans des services, des workers et des outils internes
• des développeurs API qui hésitent entre des appels HTTP directs et les SDK officiels
• des équipes qui comparent la prise en charge des langages avant de standardiser sur Python, TypeScript, Go, Java, PHP, Ruby ou C#
• des développeurs qui ont besoin d’exemples pour le streaming, l’usage d’outils, le batching, l’utilisation de la Files API et la gestion des erreurs
• des concepteurs d’agents qui utilisent les ressources Agent SDK en Python ou TypeScript

Quels problèmes elle résout

Au lieu de vous obliger à assembler des exemples dispersés, claude-api fournit un point de départ structuré pour les décisions d’implémentation les plus courantes :

• quel SDK ou quelle surface API utiliser
• quel dossier de langage consulter en premier
• comment s’authentifier avec ANTHROPIC_API_KEY
• comment envoyer une première requête de message
• quand privilégier le streaming pour les sorties longues
• où trouver des informations sur l’usage d’outils, les batchs, la Files API, le prompt caching, les références de modèles et les codes d’erreur

La skill inclut également des fichiers de référence partagés comme shared/error-codes.md, shared/models.md, shared/prompt-caching.md, shared/live-sources.md et shared/tool-use-concepts.md, ce qui est utile lorsque vous avez besoin de recommandations sur le comportement backend au-delà d’un simple exemple hello world.

Surfaces de documentation prises en charge dans le dépôt

Le contenu du dépôt montre les principales sections suivantes :

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

Autrement dit, claude-api va bien au-delà d’une simple collection d’extraits pour un seul langage. Il s’agit plutôt d’une skill d’intégration backend multilingue pour l’écosystème Claude API.

Quand claude-api est un bon choix

Utilisez claude-api si :

• votre base de code importe anthropic, @anthropic-ai/sdk ou claude_agent_sdk
• vous recherchez des modèles d’usage des SDK officiels d’Anthropic
• vous avez besoin d’exemples concrets pour une intégration serveur de la Claude API
• vous voulez des indications d’installation propres à votre langage avant de commencer l’implémentation
• vous devez comprendre des fonctionnalités comme le streaming, l’usage d’outils, les batchs ou la prise en charge de la Files API

Quand claude-api n’est pas le bon choix

Cette skill n’est pas la plus adaptée si :

• votre projet utilise le SDK d’un autre fournisseur d’IA, comme openai
• vous avez besoin d’une aide de programmation générale sans lien avec l’intégration de Claude
• vous cherchez des modèles d’interface frontend plutôt que des workflows API et backend
• vous avez besoin d’un langage non couvert par le dépôt et ne souhaitez pas utiliser les exemples HTTP bruts de curl/

How to Use

Installer la skill

Ajoutez claude-api depuis le dépôt de skills Anthropic :

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

Après l’installation, commencez par SKILL.md, puis ouvrez le dossier correspondant au langage de votre base de code.

Choisir d’abord le bon dossier

La façon la plus rapide de bien exploiter claude-api consiste à sélectionner le chemin spécifique à votre langage avant de lire les détails d’implémentation.

Voici quelques bons points d’entrée dans le dépôt :

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

Si vous évaluez la prise en charge des SDK avant de choisir une stack, parcourez plusieurs dossiers de langage côte à côte. Le dépôt distingue clairement l’usage direct de la Claude API des guides Agent SDK en Python et TypeScript.

Choisir la bonne surface selon votre cas d’usage

D’après la structure du dépôt, claude-api prend en charge plusieurs approches concrètes :

• utiliser curl/examples.md pour les requêtes HTTP brutes ou les langages non pris en charge
• utiliser des dossiers comme go/, java/, php/, ruby/ ou csharp/ pour les modèles basés sur les SDK officiels
• utiliser python/claude-api/ ou typescript/claude-api/ pour une couverture plus poussée de sujets comme le streaming, l’usage d’outils, les batchs et la Files API
• utiliser python/agent-sdk/ ou typescript/agent-sdk/ si votre projet repose avant tout sur des workflows d’agents plutôt que sur de simples appels de messages directs

Cette structure est utile pour prendre une décision d’installation, car tous les langages ne proposent pas les mêmes fonctionnalités de plus haut niveau. Par exemple, le dépôt inclut explicitement une documentation Agent SDK pour Python et TypeScript, tandis que les autres langages se concentrent sur l’usage des SDK Claude API.

Configurer l’authentification en toute sécurité

Dans l’ensemble des exemples du dépôt, le schéma standard consiste à utiliser la variable d’environnement ANTHROPIC_API_KEY plutôt que de coder les secrets en dur. Cela fait de claude-api un bon choix pour des workflows backend orientés production et pour les environnements CI.

Avant de tester les exemples, vérifiez que votre environnement d’exécution peut bien lire ANTHROPIC_API_KEY.

Parcours d’installation typiques selon le langage

Le dépôt contient les exemples d’installation suivants :

• C# : dotnet add package Anthropic
• Go : go get github.com/anthropics/anthropic-sdk-go
• PHP : composer require "anthropic-ai/sdk"
• Ruby : gem install anthropic
• Java : configuration de dépendance avec com.anthropic:anthropic-java
• HTTP brut : utiliser curl avec https://api.anthropic.com/v1/messages

Si vous hésitez entre SDK et HTTP, commencez par le SDK lorsque votre langage est pris en charge, puis basculez vers les exemples de curl/ si vous avez besoin d’un contrôle fin sur les requêtes ou si vous travaillez dans un autre langage.

Commencer par une requête de message simple

La plupart des guides de langage dans claude-api suivent le même déroulé pratique :

1. initialiser un client
2. lire la clé API depuis l’environnement
3. envoyer une requête de message avec un modèle Claude
4. lire les blocs de texte de la réponse

Cette cohérence est utile lorsque les équipes travaillent sur plusieurs langages backend. Vous pouvez standardiser le schéma de requête même si la syntaxe du code change.

Utiliser le streaming pour les réponses longues

Le SKILL.md du dépôt recommande explicitement d’utiliser le streaming par défaut pour les requêtes susceptibles d’impliquer une entrée longue, une sortie longue ou un max_tokens élevé, car le streaming aide à éviter les timeouts de requête. C’est l’un des enseignements opérationnels les plus importants de claude-api.

Si votre application génère de longues réponses, des résumés, des boucles d’outils ou des raisonnements étendus, consultez d’abord la documentation sur le streaming :

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• les sections consacrées au streaming dans des fichiers spécifiques à certains langages comme go/claude-api.md, java/claude-api.md, ruby/claude-api.md et csharp/claude-api.md

Explorer les fonctionnalités backend avancées

L’une des raisons d’installer claude-api plutôt que de se limiter à un quickstart est la couverture plus approfondie des sujets dans le dépôt. Parmi les fichiers utiles :

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

Ces ressources sont particulièrement précieuses pour des workflows backend en production, lorsque vous avez besoin de plus qu’un simple exemple requête-réponse.

Utiliser les références partagées pour le dépannage

Si votre première intégration échoue, claude-api inclut des ressources utiles pour le débogage et la planification :

• shared/error-codes.md pour la signification des erreurs HTTP, leur caractère réessayable et les causes fréquentes
• shared/models.md pour les références liées aux modèles
• shared/live-sources.md pour les recommandations liées aux sources

La référence sur les codes d’erreur est particulièrement utile, car elle distingue les situations réessayables comme 429, 500 et 529, des problèmes de requête non réessayables comme 400 ou des problèmes d’authentification comme 401.

Checklist pratique avant d’adopter claude-api

Avant de retenir cette skill pour un projet, posez-vous les questions suivantes :

• avons-nous besoin d’exemples officiels de SDK dans l’un des langages pris en charge ?
• attendons-nous des sorties longues et avons-nous donc besoin d’un guide sur le streaming ?
• avons-nous besoin d’exemples d’usage d’outils, de Files API ou de traitement par batch ?
• construisons-nous des workflows d’agents en Python ou TypeScript ?
• souhaitons-nous une solution de repli en HTTP brut avec curl ?

Si la réponse à plusieurs de ces questions est oui, claude-api a de fortes chances d’être un bon choix.

FAQ

Qu’est-ce que claude-api dans ce dépôt ?

claude-api est une skill de anthropics/skills qui aide les développeurs à créer des applications avec la Claude API, les SDK Anthropic et les ressources Agent SDK. Elle est organisée par langage et complétée par des documents de référence partagés.

Comment installer claude-api ?

Utilisez :

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

Ensuite, ouvrez SKILL.md et le dossier de langage correspondant à votre stack.

Quels langages sont couverts par claude-api ?

Le dépôt montre une documentation pour C#, Go, Java, PHP, Ruby, Python, TypeScript, ainsi que des exemples HTTP bruts avec curl.

Est-ce que claude-api inclut un guide Agent SDK ?

Oui, mais d’après la structure du dépôt, les ressources Agent SDK se trouvent spécifiquement dans python/agent-sdk/ et typescript/agent-sdk/. Si vous cherchez des exemples de workflows d’agents, ce sont les premiers dossiers à consulter.

Est-ce que claude-api aide pour le streaming et l’usage d’outils ?

Oui. Le dépôt inclut une documentation sur le streaming et l’usage d’outils, en particulier dans les dossiers Claude API pour Python et TypeScript, et plusieurs guides spécifiques à certains langages comportent aussi des sections sur le streaming.

Est-ce que claude-api sert uniquement pour les appels API directs ?

Non. Il couvre à la fois l’usage direct de la Claude API et les modèles d’intégration basés sur les SDK. Il inclut aussi des exemples HTTP bruts dans curl/examples.md pour les développeurs qui ne souhaitent pas utiliser de SDK ou qui travaillent dans un autre langage.

Quand faut-il utiliser curl plutôt qu’un SDK ?

Utilisez curl si vous avez besoin d’exemples HTTP bruts, si votre langage n’est pas couvert par un SDK officiel dans cette skill, ou si vous voulez examiner directement la structure des requêtes et des réponses avant d’adopter une bibliothèque cliente.

Est-ce que claude-api inclut des conseils sur la gestion des erreurs ?

Oui. shared/error-codes.md documente les codes d’erreur HTTP, les causes fréquentes et les cas qui peuvent faire l’objet d’une nouvelle tentative. Cela rend claude-api utile pour planifier une intégration en production, pas seulement pour la configuration initiale.

Est-ce que claude-api est adapté à de l’aide générale en programmation ?

Non. La description du dépôt est centrée sur l’utilisation de la Claude API et des SDK Anthropic. Si votre tâche n’a aucun lien avec l’intégration de Claude, cette skill est trop spécialisée.

Que faut-il lire en premier après avoir installé claude-api ?

Commencez par SKILL.md, puis passez au fichier correspondant à votre langage et à votre cas d’usage. Pour beaucoup d’équipes, le meilleur ordre est :

1. SKILL.md
2. votre guide de langage, par exemple go/claude-api.md ou php/claude-api.md
3. des documents thématiques comme streaming.md, tool-use.md, batches.md ou files-api.md
4. des références partagées comme shared/error-codes.md