Premiers pas avec l'API Claude

Authentification, premier appel, choix du modèle — le minimum pour appeler Claude depuis du code.

Mis à jour le 18 avril 2026·Version: Claude Opus 4.7·

apidébutantsdk

L'API Claude s'appelle depuis n'importe quel langage via HTTP, mais Anthropic publie des SDK officiels pour Python, TypeScript/JavaScript, Java, Go et Ruby.

1. Obtenir une clé API

Rendez-vous sur console.anthropic.com, créez un compte et générez une clé API. Exposez-la via une variable d'environnement :

export ANTHROPIC_API_KEY="sk-ant-..."

Ne commitez jamais votre clé

Utilisez .env + .gitignore, un gestionnaire de secrets, ou les variables d'environnement de votre plateforme d'hébergement.

2. Installer le SDK

npm install @anthropic-ai/sdk

3. Premier appel

import Anthropic from '@anthropic-ai/sdk';
 
const client = new Anthropic();
 
const message = await client.messages.create({
  model: 'claude-opus-4-7',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'Explique-moi la photosynthèse en 2 phrases.' }
  ]
});
 
console.log(message.content);

Structure des messages

Un appel à l'API suit toujours cette structure :

model — l'ID du modèle (voir les modèles disponibles)
max_tokens — plafond de tokens pour la réponse
messages — l'historique de conversation (rôles user et assistant)
system (optionnel) — instructions de rôle qui persistent sur toute la conversation

System prompt ≠ premier message user

Mettez vos instructions de rôle dans system, pas dans un premier message user. C'est plus propre et bénéficie du prompt caching.

Et ensuite ?

Apprenez le prompt caching pour diviser vos coûts par 10 sur les prompts longs.
Explorez les outils (tool use) pour laisser Claude appeler vos fonctions.
Regardez l'API Batch pour les traitements massifs à -50 %.

Les Artifacts sur Claude.ai

Prompt Caching