Premiers pas avec le SDK Claude

Cette leçon vous mène de zéro à une première réponse de Claude obtenue par programme : un compte sur la Claude Console, une clé d’API rangée hors du code, le SDK Python installé, et un premier appel à messages.create. Vous en sortez avec un script d’une quinzaine de lignes, et le bon réflexe pour lire une réponse : une liste de blocs dont on garde ceux de type text.

Mise à jour du 5 novembre 2026. Ce cours adapte les six carnets « Anthropic API fundamentals » du dépôt anthropics/courses, écrits en 2024 pour Claude 3 et archivés depuis le 15 septembre 2026. Le code a été relu contre la documentation actuelle et le cours « Claude Platform 101 » de Claude Academy : la Console vit sur platform.claude.com, le SDK Python 2.x exige Python 3.10 ou plus et envoie la version d’API 2026-10-21, les exemples utilisent la famille Claude 5.5, qui réfléchit avant de répondre, d’où une lecture des réponses par type de bloc. Les paramètres retirés depuis 2024 (préremplissage, temperature) sont traités aux leçons 2 et 4.

Installer le SDK

Le SDK Python officiel s’appelle anthropic. Sa version actuelle (2.5.0 au 5 novembre 2026) demande Python 3.10 ou plus récent ; vérifiez votre version avant d’installer.

python --version          # 3.10 ou plus
pip install anthropic

Le carnet de 2024 annonçait Python 3.7.1 : c’était le minimum du SDK de l’époque, plus celui d’aujourd’hui. Des SDK officiels existent aussi pour TypeScript, Java, Go, C#, PHP et Ruby ; ce cours s’en tient à Python.

Obtenir une clé d’API

Toute requête à l’API Claude est authentifiée. Créez un compte, ou connectez-vous, sur la Claude Console (platform.claude.com), puis créez une clé dans la page API keys des réglages : donnez-lui un nom qui dit à quoi elle sert, copiez-la aussitôt, elle ne sera plus jamais affichée. Vous pouvez créer autant de clés que de projets ; les limites de débit et de dépense s’appliquent à l’organisation et à ses espaces de travail, pas à la clé.

Une clé d’API donne accès à votre compte et à votre facture : traitez-la comme un mot de passe, ne la partagez pas, ne la versionnez jamais dans Git. La documentation propose aussi, pour le développement local, de se connecter avec la ligne de commande ant (ant auth login) : les SDK récupèrent alors vos identifiants sans clé à manipuler.

Ranger la clé hors du code

Le SDK lit la clé dans la variable d’environnement ANTHROPIC_API_KEY. La façon la plus simple de la définir pour un projet est un fichier .env, chargé par le paquet python-dotenv, et exclu du dépôt par votre .gitignore.

# .env (à ajouter au .gitignore)
ANTHROPIC_API_KEY=collez-votre-cle-ici

pip install python-dotenv

from dotenv import load_dotenv

load_dotenv()  # copie le contenu de .env dans les variables d'environnement

Votre premier appel

Le client est le point d’entrée de toutes les requêtes. Créé sans argument, il cherche lui-même la clé dans l’environnement ; passer api_key= explicitement n’est utile que pour injecter une clé précise.

from anthropic import Anthropic
from dotenv import load_dotenv

load_dotenv()
client = Anthropic()  # lit ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=2048,
    messages=[
        {"role": "user", "content": "Écris-moi un haïku sur une poule de compagnie."}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)

Trois paramètres sont obligatoires, détaillés aux leçons suivantes : model, le modèle qui traite la requête (leçon 3) ; max_tokens, le plafond de longueur de la réponse (leçon 4) ; messages, la conversation (leçon 2). La réponse n’est pas une chaîne mais un objet, dont l’attribut content est une liste de blocs. Pour une réponse simple, on y trouve un bloc text ; mais les modèles actuels réfléchissent avant de répondre, et un bloc thinking peut précéder le texte. Le carnet de 2024 lisait response.content[0].text ; avec un modèle qui réfléchit, ce premier bloc peut être la réflexion, et le code plante. On parcourt donc les blocs et on garde ceux de type text, comme le fait aussi le cours « Claude Platform 101 ».

Le modèle choisi ici, Claude Opus 5.5, est celui que la documentation conseille par défaut quand on ne sait pas encore lequel prendre. Pour des essais en grand nombre, Claude Haiku 5.5 coûte quarante fois moins cher en entrée ; la leçon 3 compare les modèles.

À vous de jouer

Votre script. Dans un nouveau dossier, créez un fichier .env avec votre clé, un .gitignore qui l’exclut, et un script qui demande à Claude une blague et l’affiche. Vérifiez avec git status que .env n’apparaît pas.

Lire la réponse entière. Affichez response tout entier, puis response.content, response.stop_reason et response.usage. Repérez le ou les blocs, leur type, et le nombre de jetons d’entrée et de sortie que vous avez payés.

Sources officielles : 01_getting_started.ipynb (anthropics/courses, archivé) · Get started with Claude (documentation Claude) · Your first API call (Claude Academy, Claude Platform 101)

Points clés à retenir

• Le SDK Python s’installe par pip install anthropic et demande aujourd’hui Python 3.10 ou plus.
• La clé se crée sur la Claude Console, se range dans ANTHROPIC_API_KEY (fichier .env hors du dépôt) et ne se partage jamais.
• Anthropic() lit la clé dans l’environnement ; messages.create exige model, max_tokens et messages.
• La réponse est une liste de blocs : on lit ceux de type text, jamais content[0] à l’aveugle.