Le SDK Claude Code

Le SDK Claude Code

Le SDK Claude Code vous permet d’executer Claude Code de facon programmatique depuis vos propres applications et scripts. Il est disponible pour TypeScript, Python et via le CLI, vous donnant les memes fonctionnalites que le terminal mais integrees dans des workflows plus larges.

Le SDK execute exactement le meme Claude Code que celui que vous utilisez deja. Il a acces a tous les memes outils et les utilisera pour completer la tache que vous lui donnez.

Caracteristiques cles

• Execute Claude Code de facon programmatique
• Memes fonctionnalites que la version terminal
• Herite de tous les parametres des instances Claude Code dans le meme repertoire
• Permissions en lecture seule par defaut
• Particulierement utile comme partie de pipelines ou outils plus larges

Utilisation basique

Voici un exemple simple en TypeScript qui demande a Claude d’analyser du code :

import { query } from "@anthropic-ai/claude-code";

const prompt =
  "Cherche des requetes en doublon dans le dossier ./src/queries";

for await (const message of query({ prompt })) {
  console.log(JSON.stringify(message, null, 2));
}

Quand vous executez ce code, vous verrez la conversation brute entre votre Claude Code local et le modele Claude, message par message.

Permissions et outils

Par defaut, le SDK n’a que des permissions de lecture seule. Il peut lire des fichiers, parcourir des repertoires et effectuer des recherches grep, mais il ne peut pas ecrire, editer ou creer de fichiers.

Pour activer les permissions d’ecriture, ajoutez l’option allowedTools :

for await (const message of query({
  prompt,
  options: {
    allowedTools: ["Edit", "Write"]
  }
})) {
  console.log(JSON.stringify(message, null, 2));
}

Applications pratiques

Le SDK vous permet d’ajouter de l’intelligence IA a n’importe quelle partie de votre processus de developpement ou un acces programmatique serait utile.