Premiers pas avec le SDK Claude

Objectifs de la leçon

Dans cette première leçon, vous apprendrez à :

• Installer les packages nécessaires et vous authentifier auprès de l’API
• Envoyer votre première requête à Claude

Installation du SDK

Le SDK Python d’Anthropic encapsule les appels HTTP vers l’API, la construction des requêtes et le décodage des réponses. Concrètement, vous manipulerez des objets Python là où il faudrait autrement assembler du JSON et gérer soi-même les en-têtes d’authentification. Ce package réclame Python 3.7.1 ou supérieur, et la vérification n’est pas une formalité : sur beaucoup de postes, la commande python pointe encore vers une installation système ancienne pendant qu’une version récente cohabite sous le nom python3.

python --version

Une fois la version confirmée, l’installation tient en une ligne. Prenez l’habitude de la lancer dans un environnement virtuel propre au projet : le jour où vous devrez reproduire l’exécution sur un serveur ou sur le poste d’un collègue, vous saurez exactement quelles dépendances sont en jeu.

pip install anthropic

Obtenir une clé API

Le SDK installé ne sert à rien tant que vos requêtes ne sont pas authentifiées. Chaque appel doit porter une clé API : c’est elle qui identifie votre organisation et qui rattache la consommation à votre facturation. Vous la générez depuis la console web, en quatre étapes.

1. Créez un compte sur console.anthropic.com
2. Allez dans Settings > API Keys
3. Cliquez sur Create Key et donnez-lui un nom descriptif
4. Copiez la clé immédiatement (elle ne sera plus affichée)

Le nom descriptif compte davantage qu’il n’y paraît. Le jour où une clé fuite ou qu’un projet s’arrête, savoir qu’il s’agit de « prototype-support-client » plutôt que de « key-3 » vous permet de la révoquer sans interrompre tout le reste. Et puisque la valeur n’est affichée qu’une seule fois, rangez-la dans votre gestionnaire de mots de passe avant même de l’utiliser.

Traitez votre clé API comme un mot de passe : ne la partagez jamais publiquement et ne la committez jamais dans un système de versioning. Un dépôt privé aujourd’hui peut devenir public demain, et l’historique Git conserve la trace de tout ce qui y a transité, même après suppression du fichier fautif.

Stocker votre clé en sécurité

La bonne pratique consiste à sortir la clé du code et à la placer dans un fichier .env, que vous exclurez du versioning. La bibliothèque python-dotenv lit ce fichier au démarrage et injecte son contenu dans les variables d’environnement du processus.

pip install python-dotenv

Créez un fichier .env :

ANTHROPIC_API_KEY=votre-cle-api-ici

Chargez-la dans votre code :

from dotenv import load_dotenv
import os

load_dotenv()
my_api_key = os.getenv("ANTHROPIC_API_KEY")

Le gain est très concret : le même script tourne sur votre machine, sur celle d’un collègue et en production sans qu’une seule ligne de code change — seule la valeur du fichier .env diffère d’un environnement à l’autre.

Votre première requête

Tout part d’un client, qui porte l’authentification, puis d’un appel à messages.create(). Trois informations sont attendues : le modèle sollicité, le plafond de tokens que vous autorisez en sortie, et la liste des messages qui composent la conversation.

from anthropic import Anthropic

client = Anthropic(api_key=my_api_key)

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Bonjour ! Écris-moi un haiku sur un chat."}
    ]
)

print(response.content[0].text)

La réponse n’est pas une simple chaîne de caractères mais un objet structuré. Son attribut content est une liste de blocs, parce qu’un même message peut en contenir plusieurs : d’où le response.content[0].text, qui va chercher le texte du premier bloc. Cette structure vous suivra dans toutes les leçons suivantes, y compris lorsque vous travaillerez avec des images.

Un dernier raccourci vous évitera du code inutile. Le SDK cherche automatiquement une variable d’environnement ANTHROPIC_API_KEY, donc vous pouvez simplifier :

from anthropic import Anthropic

client = Anthropic()  # Pas besoin de passer la clé manuellement

À votre tour

Reprenez la chaîne complète sur un cas volontairement trivial, l’objectif étant de valider l’installation et l’authentification, pas la sophistication du prompt. Créez un nouveau script Python, importez les packages nécessaires, chargez votre clé API, puis demandez à Claude de vous raconter une blague et affichez le résultat. Si le script échoue, l’erreur vous dira presque toujours laquelle des deux briques manque : le package ou la clé.

from dotenv import load_dotenv
from anthropic import Anthropic

load_dotenv()
client = Anthropic()

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Raconte-moi une blague."}
    ]
)
print(response.content[0].text)