Obtenir une clé API

Pour communiquer avec l’API Claude, il vous faut une clé d’API : c’est elle qui authentifie chaque requête et la rattache à votre compte, et donc à votre facture. Cette leçon suit les étapes du cours officiel pour la créer sur la Claude Console, puis montre comment la ranger hors du code, les règles de sécurité qui vont avec, et l’alternative que la documentation propose pour le développement local.

Étape par étape

1. Ouvrir la Console. Rendez-vous sur platform.claude.com et connectez-vous à votre compte, ou créez-en un. La Claude Console est votre tableau de bord : clés, consommation, limites, playground.
2. Aller aux clés. Cliquez sur Get API Keys, en haut à droite du tableau de bord, ou ouvrez la page API keys des réglages.
3. Créer une clé. Cliquez sur Create Key, en haut à droite de la page.
4. Choisir l’espace de travail et nommer la clé. Le cours officiel la crée dans l’espace de travail Default et l’appelle « Anthropic Course ». Choisissez un nom qui dit à quoi elle sert : dans six mois, quand la Console listera cinq clés, c’est lui qui vous dira laquelle révoquer sans risque.
5. Copier la clé. Elle s’affiche dans une fenêtre, une seule fois. Copiez-la aussitôt. Si vous fermez la fenêtre trop vite, supprimez la clé et créez-en une autre.

Ranger la clé hors du code

La clé vit dans un fichier .env local, jamais dans le code source : le code reste partageable, le secret reste chez vous.

# .env
ANTHROPIC_API_KEY="collez-votre-cle-ici"

# .gitignore
.env

L’ajout au .gitignore est indispensable : un dépôt peut devenir public, être cloné ou fuiter, et une clé versionnée reste dans l’historique même après suppression du fichier.

from dotenv import load_dotenv
from anthropic import Anthropic

load_dotenv()        # copie le contenu de .env dans l'environnement
client = Anthropic() # le SDK lit ANTHROPIC_API_KEY tout seul

Votre code ne manipule jamais le secret : load_dotenv() le place dans l’environnement, et le SDK le trouve par son nom standard.

Sans clé, en local : ant auth login

La documentation propose une autre voie pour le développement sur votre poste : la ligne de commande ant. Une fois installée, ant auth login vous connecte avec votre compte, et le SDK et la ligne de commande récupèrent vos identifiants automatiquement, sans clé à copier. Pour un serveur ou un déploiement, la clé d’API reste la règle.

Règles de sécurité

• Jamais dans Git, ni dans un message, un courriel ou un chat.
• Jamais dans du code côté client (JavaScript d’une page, application mobile) : tout ce qui est envoyé au navigateur est lisible, une clé dans le front est une clé publique. Les appels passent toujours par votre serveur (leçon 3).
• Une clé compromise se révoque aussitôt dans la Console, et se remplace.
• Des clés séparées pour le développement et la production, idéalement dans des espaces de travail distincts.

Facturation et limites

L’API est facturée à l’usage, au token. La Console détaille la consommation et permet de fixer des limites de dépense, pour l’organisation comme pour chaque espace de travail : une requête qui dépasse une limite fixée renvoie une erreur plutôt qu’une facture surprise. Les limites de débit, elles, s’appliquent à l’organisation, pas à chaque clé. Pour ce cours, l’usage reste modeste ; le réflexe de surveillance, lui, vaut pour toujours.

À vous de jouer

Créer et ranger votre clé. Créez une clé nommée d’après ce cours, placez-la dans un .env, ajoutez .env au .gitignore, initialisez un dépôt Git et vérifiez avec git status que .env n’apparaît pas.

Poser un garde-fou. Dans la Console, repérez la page des limites et fixez une limite de dépense mensuelle modeste pour l’espace de travail du cours.

Sources officielles : Getting an API key (Claude Academy) · Get started with Claude et Rate limits (documentation Claude)

Points clés à retenir

• La clé se crée sur la Claude Console (platform.claude.com) : Get API Keys, Create Key, espace de travail, nom ; elle ne s’affiche qu’une fois.
• Montage standard : .env + .gitignore + load_dotenv() ; le code ne contient jamais le secret.
• En local, ant auth login évite de manipuler une clé ; sur un serveur, la clé reste la règle.
• Jamais de clé dans Git ni dans du code côté client ; une clé compromise se révoque aussitôt.
• Facturation au token ; limites de dépense par organisation et par espace de travail.