Sinkkai

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·1 min de lecture·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, Ruby, C# et PHP — ainsi qu'un binaire CLI (ant) pour le scripting shell.

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 : les tokens relus depuis le cache coûtent ~90 % de moins que des tokens input standards.
  • Explorez les outils (tool use) pour laisser Claude appeler vos fonctions.
  • Regardez l'API Batch pour les traitements massifs à -50 %.