Source: https://aiprimetech.io/fr/claude-code/sdk/

[Accueil](/fr/) › [Claude Code](/fr/claude-code/) › Agent SDK

[Vue d’ensemble](/fr/claude-code/)[Installation](/fr/claude-code/install/)[référence de la CLI](/fr/claude-code/cli/)[Tarifs et limites](/fr/claude-code/pricing/)[Agent SDK](/fr/claude-code/sdk/)[Compétences et plugins](/fr/claude-code/skills/)[GitHub](/fr/claude-code/github/)[Web, bureau et IDE](/fr/claude-code/web-and-desktop/)[Modèles](/fr/claude-code/models/)[Erreurs](/fr/claude-code/errors/)[Open source ?](/fr/claude-code/open-source/)[Tutoriel](/fr/claude-code/tutorial/)[Pour les étudiants](/fr/claude-code/for-students/)[Automatisation de l’assurance qualité](/fr/claude-code/qa-automation/)[Comparaison avec Cursor](/fr/claude-code/vs-cursor/)[Comparaison avec Codex et OpenCode](/fr/claude-code/vs-codex/)[Sous-agents](/fr/claude-code/subagents/)[Hooks](/fr/claude-code/hooks/)[MCP](/fr/claude-code/mcp/)[Écosystème](/fr/claude-code/ecosystem/)[VS Code](/fr/claude-code/vscode/)[OpenRouter](/fr/claude-code/openrouter/)[Limites de débit](/fr/claude-code/rate-limits/)[Guide en chinois](/claude-code/zh/)

Dernière mise à jour : 11 octobre 2026

# Le SDK Claude Code, désormais Claude Agent SDK

La même boucle d’agent que celle qui s’exécute dans votre terminal est disponible sous forme de bibliothèque. Anthropic a renommé le Claude Code SDK en Claude Agent SDK lorsqu’il est devenu évident que les utilisateurs s’en servaient pour créer bien plus que des outils de programmation.

## TLDR
- Python : pip install claude-agent-sdk; TypeScript : npm install @anthropic-ai/claude-agent-sdk.
- Vous disposez de l’agent complet — outils de fichiers, bash, sous-agents, MCP — piloté depuis votre code, avec des fonctions de rappel pour les autorisations.
- Le SDK lit ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY comme le fait la CLI ; la facturation de la passerelle s’applique donc.

## Deux façons d’automatiser Claude Code 

La solution légère consiste à utiliser le mode print de la CLI — claude -p depuis n’importe quel langage, avec une sortie JSON. L’approche complète passe par l’Agent SDK, qui expose la boucle, l’ensemble des outils, les hooks et les autorisations sous forme d’objets que vous contrôlez. 

## Python 

```
import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)
```

## TypeScript 

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

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}
```

## Exécution via la passerelle 

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py
```

Le SDK lance le même environnement d’exécution Claude Code ; les variables d’environnement sont donc tout ce dont il a besoin. C’est pour les agents exécutés sur de longues périodes que la tarification de la passerelle compte le plus : une boucle autonome peut effectuer des centaines d’appels par heure, et un forfait transforme cette estimation de coût en un montant fixe. 

## Ce que le SDK apporte par rapport au mode d’affichage 
- Fonctions de rappel d’autorisation — approuvez ou refusez chaque appel d’outil depuis votre propre code.
- Outils personnalisés via des serveurs MCP intégrés au processus, pour que l’agent puisse appeler vos fonctions.
- Hooks sur les événements des outils, le cycle de vie des sessions et les erreurs.
- Sous-agents et sortie structurée, sans lancer de commandes shell ni analyser du texte.

## Essayez gratuitement pour commencer

Les nouveaux comptes reçoivent 5 $ de crédit API offert avec le code CLAUDECODE — de quoi passer une soirée à utiliser Claude Code avec Sonnet — puis des crédits valant 7.69231× leur valeur nominale.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Créer un compte avec le code CLAUDECODE](/register?promo=CLAUDECODE)

## Questions fréquentes

Le Claude Code SDK est-il identique au SDK Anthropic ?

Non. Le SDK Anthropic appelle directement l’API Messages. Le Claude Agent SDK (anciennement Claude Code SDK) exécute l’agent complet — outils, fichiers, bash, sous-agents — en s’appuyant sur cette API.Quels langages l’Agent SDK prend-il en charge ?

Python et TypeScript officiellement ; tout autre langage peut piloter le mode d’affichage de la CLI avec une sortie JSON.Le SDK fonctionne-t-il avec une URL de base personnalisée ?

Oui. Il hérite de ANTHROPIC_BASE_URL et de ANTHROPIC_API_KEY depuis l’environnement, exactement comme la CLI.

## Utilisez Claude Code sur la passerelle

Les mêmes modèles, deux variables d’environnement, des crédits valant 7.69231× leur valeur nominale — ou une offre illimitée à tarif forfaitaire. Nouveaux comptes : 5 $ de crédit API offert avec le code CLAUDECODE.[Obtenir une clé API](/register?promo=CLAUDECODE) [Voir les offres illimitées](/fr/plans/)

AI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.

## Autres guides Claude Code

[Claude Code : le guide complet](/fr/claude-code/)[Comment installer Claude Code](/fr/claude-code/install/)[Documentation de la CLI Claude Code : commandes et options](/fr/claude-code/cli/)[Les tarifs et limites de Claude Code expliqués](/fr/claude-code/pricing/)[Compétences et plugins Claude Code](/fr/claude-code/skills/)[Claude Code dans GitHub : l’App, l’Action et @claude](/fr/claude-code/github/)[Claude Code dispose-t-il d’une interface web ? Le web, le bureau et l’IDE expliqués](/fr/claude-code/web-and-desktop/)[Quel modèle Claude Code utilise et comment en changer](/fr/claude-code/models/)[Les erreurs de Claude Code et comment les résoudre](/fr/claude-code/errors/)[Claude Code est-il open source ?](/fr/claude-code/open-source/)[Tutoriel Claude Code : votre première vraie session](/fr/claude-code/tutorial/)[Claude pour les étudiants : Claude Code, l’API et ce que le statut étudiant vous apporte réellement](/fr/claude-code/for-students/)[Comment utiliser Claude Code pour automatiser l’assurance qualité](/fr/claude-code/qa-automation/)[Claude Code ou Cursor : lequel choisir, quand — et comment utiliser les deux](/fr/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode : comparaison des agents de terminal](/fr/claude-code/vs-codex/)[Sous-agents de Claude Code : fonctionnement, définition et équipes d’agents](/fr/claude-code/subagents/)[Hooks de Claude Code : un contrôle déterministe des actions de l’agent](/fr/claude-code/hooks/)[MCP dans Claude Code : connexion de serveurs, portées, MCP distant et exemples concrets](/fr/claude-code/mcp/)[L’écosystème Claude Code : routeurs, frameworks, plugins et listes qui les recensent](/fr/claude-code/ecosystem/)[Claude Code dans VS Code : l’extension, l’utilisation via le terminal et les erreurs](/fr/claude-code/vscode/)[Comment utiliser OpenRouter dans Claude Code (et quand s’en passer)](/fr/claude-code/openrouter/)[Erreur de limite de débit de Claude : ce que signifie « API error: rate limit reached » et comment la résoudre](/fr/claude-code/rate-limits/)[Comment utiliser Claude Code : de l’installation à l’utilisation quotidienne](/claude-code/zh/)