Claude Agent SDK

Définition

Bibliothèque (@anthropic-ai/claude-agent-sdk en TypeScript, claude-agent-sdk en Python) qui expose le moteur de Claude Code : boucle agentique, outils intégrés (lecture, écriture, édition, Bash, recherche web), permissions, sessions, hooks, sous-agents, MCP. À distinguer du SDK client Anthropic (appel direct de l'API, boucle à écrire soi-même) et des Managed Agents (hébergés par Anthropic).

Analogie

Louer le moteur complet de la voiture de course plutôt que d'assembler les pièces une à une.

Exemple de code

import { query } from '@anthropic-ai/claude-agent-sdk';

for await (const message of query({
  prompt: 'Trouve pourquoi /export renvoie 500 et corrige-le, avec un test.',
  options: {
    cwd: '/srv/app',
    allowedTools: ['Read', 'Grep', 'Glob', 'Edit', 'Bash(pnpm test*)'],
    permissionMode: 'acceptEdits',      // édite sans demander, Bash reste contrôlé
    maxTurns: 25,
  },
})) {
  if (message.type === 'assistant') console.log(message.message.content);
  if (message.type === 'result') console.log('coût $', message.total_cost_usd);
}

Cas d'usage

Agents de code sur mesure (bot de PR, migration automatisée) qui doivent tourner sur votre infrastructure.

Anti-pattern

Termes liés

Sources

• code.claude.com/docs/en/agent-sdk/overview