Blog

Comment utiliser le SDK Agent Claude avec votre forfait Claude ?

Ashley Innocent

Ashley Innocent

14 May 2026

Comment utiliser le SDK Agent Claude avec votre forfait Claude ?

Apidog pour les entreprises

Déploiement sur site

SSO & RBAC

Conforme SOC 2

Explorer Apidog Enterprise

Anthropic vous permet d'exécuter le SDK Agent Claude sur votre abonnement Claude existant à partir du 15 juin 2026. Avant cette date, créer quoi que ce soit avec le SDK Agent nécessitait une clé API distincte avec une facturation à l'usage mesurée, en plus de ce que vous payez déjà pour Claude Pro ou Max. À partir du 15 juin, votre forfait mensuel Claude inclut un solde de crédits spécifiquement pour l'utilisation du SDK Agent. Aucune clé API n'est requise.

Si vous avez toujours voulu créer un agent personnalisé (un bot de déploiement, un assistant de recherche, un outil de triage) mais que vous ne vouliez pas enregistrer une carte de facturation séparée auprès d'Anthropic juste pour prototyper, ce changement est important. Votre abonnement Pro inclut désormais 20 $/mois d'utilisation du SDK Agent. Max 20x inclut 200 $. Les sièges Team Premium incluent 100 $.

bouton

Ce qui a changé le 15 juin 2026

En bref : l'utilisation du SDK Agent est désormais déduite d'un crédit mensuel lié à votre forfait Claude. Auparavant, elle était facturée via l'API Anthropic avec un solde de console distinct.

Voici le crédit par forfait, tiré directement de l'annonce d'Anthropic :

Forfait Crédit mensuel SDK Agent
Pro 20 $
Max 5x 100 $
Max 20x 200 $
Team Standard (par siège) 20 $
Team Premium (par siège) 100 $
Enterprise (basé sur l'utilisation) 20 $
Siège Enterprise Premium 200 $

Quelques règles importantes :

Ce que le crédit couvre et ce qu'il ne couvre pas

Anthropic a fait cette distinction avec soin. Lisez attentivement ; la distinction entre ce qui est « couvert » et ce qui ne l'est pas est ce qui détermine si votre facture change réellement.

Couvert par le crédit SDK Agent :

Non couvert (ceux-ci sont toujours déduits de votre forfait Claude habituel, ou restent séparés) :

En d'autres termes, le crédit SDK Agent est spécifiquement destiné aux charges de travail programmatiques, automatisées ou non interactives. Votre travail normal avec Claude Code repose sur les limites d'utilisation existantes du forfait, qu'Anthropic a récemment augmentées de 50 % jusqu'au 13 juillet. Deux budgets distincts, deux objectifs distincts.

C'est un choix de conception significatif. Cela signifie que vous pouvez expérimenter avec un agent personnalisé basé sur le SDK sans entamer le budget que vous utilisez pour le codage quotidien via Claude Code.

Lorsque vous épuisez vos crédits

Le crédit couvre un montant fixe en dollars par mois. Ce qui se passe lorsque vous le dépassez dépend d'un paramètre :

Pour le travail de prototypage, laissez l'utilisation supplémentaire désactivée. Vous obtiendrez un signal d'arrêt clair et éviterez les factures surprises. Pour les automatisations de niveau production qui doivent continuer à fonctionner, activez-la.

Le crédit est toujours utilisé en premier. Vous ne payez pas de frais de dépassement tant que votre allocation mensuelle n'est pas épuisée.

Comment s'inscrire

Le crédit n'est pas activé par défaut. L'activation est unique et perdure d'un cycle de facturation à l'autre, mais vous devez le faire une seule fois.

  1. Connectez-vous au compte Claude qui possède l'abonnement (le compte utilisateur sur Pro/Max, ou le compte de siège sur Team/Enterprise).
  2. Visitez les paramètres du forfait SDK Agent Claude (liés à l'article de support officiel d'Anthropic).
  3. Réclamez le crédit. Après cela, le crédit se renouvelle automatiquement chaque mois.

Si vous avez plusieurs sièges sur un forfait Team, chaque utilisateur doit le réclamer indépendamment. Les administrateurs ne peuvent pas le réclamer au nom des membres des sièges.

Configuration du SDK en Python ou TypeScript

Le SDK Agent est disponible en Python et TypeScript. Les deux s'authentifient de la même manière auprès de votre forfait : via l'interface en ligne de commande (CLI) de Claude Code plutôt qu'une clé API brute.

Python

Installer :

pip install claude-agent-sdk

Authentifiez-vous en vous connectant d'abord à Claude Code :

claude login

Cela stocke les identifiants liés au forfait localement. Le SDK Python les récupère automatiquement ; vous ne définissez pas ANTHROPIC_API_KEY pour une utilisation basée sur le forfait.

Un agent minimal ressemble à ceci :

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="Vous êtes un assistant de révision de code.",
)

response = agent.run("Examinez le diff dans /tmp/patch.diff et signalez les problèmes.")
print(response.text)

Le même appel aurait auparavant nécessité ANTHROPIC_API_KEY et une facturation API mesurée. Maintenant, il est déduit de votre crédit de forfait à la place.

TypeScript

Installer :

npm install @anthropic-ai/claude-agent-sdk

Authentifiez-vous via la même connexion Claude Code :

claude login

Un agent minimal en TypeScript :

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

const agent = new Agent({
  systemPrompt: "Vous êtes un assistant de révision de code.",
});

const response = await agent.run(
  "Examinez le diff dans /tmp/patch.diff et signalez les problèmes."
);
console.log(response.text);

Pour les environnements où le SDK ne peut pas trouver automatiquement les identifiants Claude Code (exécuteurs CI, conteneurs Docker, machines de développement à distance), vous pouvez les définir comme variables d'environnement. Anthropic publie les noms exacts des variables dans la documentation du SDK Agent.

Si votre connexion Claude Code génère des erreurs de configuration avant même que vous n'arriviez à la configuration du SDK, la correction de la configuration d'entreprise custom3p invalide couvre la cause la plus courante.

Le workflow claude -p

Il existe une deuxième façon d'utiliser le crédit SDK Agent qui n'implique pas l'écriture de code : la commande claude -p dans Claude Code.

-p place Claude Code en mode non-interactif. Vous lui donnez une invite, il l'exécute sur votre dépôt et se termine. Pas de session interactive. C'est ainsi que vous intégrez Claude Code dans les pipelines CI, les tâches cron et les hooks Git.

Un exemple simple : un hook de pré-commit qui demande à Claude de signaler les changements risqués.

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)
claude -p "Vérifiez ce diff pour les problèmes de sécurité, les fuites de secrets et les changements cassants. Retournez PASS ou FAIL avec une justification :\n\n$DIFF"

Chaque invocation de claude -p après le 15 juin est déduite de votre crédit SDK Agent, et non de votre budget interactif Claude Code. Ce qui signifie que vous pouvez l'intégrer à des workflows automatisés sans vous soucier d'épuiser les limites dont vous avez besoin pour le codage quotidien.

Ceci se combine bien avec la commande /goal pour les boucles autonomes, et avec les fichiers de contexte AGENTS.md pour diriger l'agent de manière fiable sur plusieurs exécutions.

Intégration GitHub Actions

L'intégration Claude Code GitHub Actions est la troisième charge de travail couverte par le crédit SDK. Si vous avez intégré Claude dans les révisions de PR, le triage des problèmes ou la génération de notes de version, ces exécutions de workflow sont désormais facturées sur le crédit SDK Agent de l'utilisateur qui a installé l'application GitHub.

Ceci est utile pour des projets comme Clawsweeper, le bot de triage GitHub basé sur Claude Code, où l'automatisation fonctionne constamment et où la facture était auparavant imputée à la clé API attachée à l'application.

Construire de vrais agents : associer le SDK à Apidog

La vraie valeur du SDK Agent est pour les agents qui font plus que répondre à du texte ; des agents qui interrogent de vraies API, des bases de données, déploient du code. Pour que cela fonctionne de manière fiable, l'agent a besoin d'un contrat défini pour chaque API externe qu'il touche. Sans cela, l'agent devine les formats de requête et vous passez votre temps de débogage à corriger des payloads hallucinés.

C'est là qu'Apidog s'intègre au workflow :

  1. Définissez d'abord le contrat API dans Apidog. Spécifiez les points d'accès, les schémas de requête/réponse et les exemples de payloads. Cela devient la source de vérité.
  2. Exportez OpenAPI et transmettez-le à votre agent comme contexte.
  3. Utilisez le SDK pour connecter l'agent aux points d'accès réels. L'agent appelle votre API en utilisant les schémas qu'il sait être corrects.
  4. Validez avec l'interface en ligne de commande (CLI) Apidog. Chaque exécution d'agent peut vérifier que l'API renvoie toujours ce que le contrat promet.

Pour les agents qui orchestrent d'autres outils via des serveurs MCP, le workflow de test de serveur MCP avec Apidog est le guide correspondant. Vous obtenez une couverture de test de bout en bout sur les outils que votre agent appelle.

La vue d'ensemble se trouve dans le guide du workflow API axé sur la conception : lorsque l'agent a un contrat à valider, votre temps en tant que développeur est consacré à rédiger de meilleurs contrats et contraintes, plutôt qu'à chasser les bugs de schéma JSON dans la sortie de l'agent.

Téléchargez Apidog gratuitement si vous souhaitez que la couche de contrat soutienne vos projets SDK Agent.

Quand vous souhaitez toujours une clé API distincte

Le crédit basé sur le forfait est le bon choix par défaut pour la plupart des développeurs. Il existe encore des cas où une clé API autonome a du sens :

Le guide d'accès gratuit à l'API Claude couvre les voies d'utilisation de Claude qui ne nécessitent ni un forfait Pro ni une clé API payante.

Une liste de contrôle claire avant de commencer

FAQ

bouton

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API

S'inscrire gratuitementTélécharger