Comment utiliser le SDK Agent Claude avec votre forfait Claude ?

Anthropic vous permet d'exécuter le SDK Agent Claude avec votre abonnement Claude existant à partir du 15 juin 2026. Avant cette date, tout projet basé sur le SDK Agent nécessitait une clé API distincte et une facturation à l'usage, en plus de Claude Pro ou Max. Désormais, votre forfait mensuel Claude inclut un solde de crédits dédié à l'utilisation du SDK Agent. Aucune clé API n'est requise.

Essayez Apidog aujourd’hui

Si vous vouliez créer un agent personnalisé — bot de déploiement, assistant de recherche, outil de triage — sans ajouter une carte de facturation Anthropic juste pour prototyper, ce changement simplifie le démarrage. Claude Pro inclut maintenant 20 $/mois d'utilisation du SDK Agent. Max 20x inclut 200 $. Les sièges Team Premium incluent 100 $.

Ce qui a changé le 15 juin 2026

L'utilisation du SDK Agent est maintenant déduite d'un crédit mensuel lié à votre forfait Claude. Avant, elle passait par la facturation API Anthropic et un solde de console séparé.

Crédit mensuel par forfait :

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 $

Règles à vérifier avant de démarrer :

• Les sièges Enterprise Standard ne reçoivent pas de crédit. Ils doivent utiliser une clé API ou passer à un siège Premium.
• Les crédits sont par utilisateur et non transférables. Vous ne pouvez pas mutualiser votre crédit avec celui d'un coéquipier.
• Les crédits non utilisés ne sont pas reportés. Le solde restant est remis à zéro à la fin du cycle de facturation.
• Une activation unique est requise. Le crédit ne s'active pas tant que vous ne l'avez pas réclamé une première fois.
• Les utilisateurs authentifiés par clé API ne consomment pas ce crédit. Si vous utilisez ANTHROPIC_API_KEY, vous restez sur l'ancien modèle de facturation API.

Ce que le crédit couvre

Le crédit SDK Agent s'applique aux charges de travail programmatiques, automatisées ou non interactives.

Couvert par le crédit SDK Agent :

• Appels du SDK Agent Claude depuis vos projets Python ou TypeScript
• Commande claude -p dans Claude Code, en mode non interactif
• Intégration Claude Code GitHub Actions
• Applications tierces qui s'authentifient via le SDK Agent

Non couvert :

• Sessions interactives Claude Code
• Conversations dans l'application web ou mobile Claude
• Sessions Claude Cowork

Votre usage normal de Claude Code reste donc soumis aux limites de votre forfait Claude. Anthropic les a par ailleurs récemment augmentées de 50 % jusqu'au 13 juillet.

En pratique, vous disposez de deux budgets distincts :

1. votre budget Claude habituel pour l'usage interactif ;
2. votre crédit SDK Agent pour les agents, scripts et automatisations.

Que se passe-t-il quand le crédit est épuisé ?

Le comportement dépend du paramètre d'utilisation supplémentaire :

• Utilisation supplémentaire activée : les dépassements sont facturés à l'usage aux tarifs API standard sur le moyen de paiement de votre forfait.
• Utilisation supplémentaire désactivée : les requêtes s'arrêtent au plafond de crédit jusqu'au prochain cycle.

Recommandation simple :

• pour un prototype : laissez l'utilisation supplémentaire désactivée ;
• pour une automatisation de production : activez-la si l'agent doit continuer à fonctionner.

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

Comment activer le crédit SDK Agent

L'activation est unique, mais obligatoire.

1. Connectez-vous au compte Claude qui possède l'abonnement.
   • Pro/Max : compte utilisateur.
   • Team/Enterprise : compte du siège concerné.
2. Ouvrez les paramètres du forfait SDK Agent Claude depuis l'article de support officiel.
3. Réclamez le crédit.

Après activation, le crédit se renouvelle automatiquement chaque mois.

Sur un forfait Team, chaque utilisateur doit réclamer son propre crédit. Un administrateur ne peut pas l'activer à la place des membres.

Configurer le SDK Agent en Python

Installez le package :

pip install claude-agent-sdk

Authentifiez-vous avec Claude Code :

claude login

Cette commande stocke localement les identifiants liés à votre forfait Claude. Pour une utilisation basée sur le forfait, ne définissez pas ANTHROPIC_API_KEY.

Exemple minimal :

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)

Cet appel est déduit du crédit de votre forfait, au lieu d'utiliser une clé API avec facturation séparée.

Configurer le SDK Agent en TypeScript

Installez le package :

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

Authentifiez-vous avec Claude Code :

claude login

Exemple minimal :

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);

Dans certains environnements — CI, Docker, machine distante — le SDK peut ne pas trouver automatiquement les identifiants Claude Code. Dans ce cas, configurez les variables d'environnement indiquées dans la documentation du SDK Agent.

Si claude login échoue à cause d'une configuration d'entreprise, consultez la correction de la configuration custom3p invalide.

Utiliser claude -p pour les workflows automatisés

Le crédit SDK Agent couvre aussi la commande non interactive :

claude -p "Votre instruction ici"

Le mode -p exécute une instruction sur votre dépôt, puis se termine. Il est adapté aux pipelines CI, tâches cron, hooks Git et scripts locaux.

Exemple de hook pre-commit :

#!/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 est déduite du crédit SDK Agent, pas de votre budget Claude Code interactif.

Ce mode se combine bien avec la commande /goal pour les boucles autonomes et avec les fichiers AGENTS.md pour fournir un contexte stable à l'agent.

Intégrer Claude Code à GitHub Actions

L'intégration Claude Code GitHub Actions est également couverte par le crédit SDK Agent.

Cas typiques :

• revue automatique de pull requests ;
• triage d'issues ;
• génération de notes de version ;
• vérification de diffs ;
• automatisations de maintenance.

Ces exécutions sont déduites du crédit SDK Agent de l'utilisateur qui a installé l'application GitHub.

C'est utile pour des projets comme Clawsweeper, le bot de triage GitHub basé sur Claude Code, où l'automatisation tourne régulièrement et où la facturation passait auparavant par la clé API associée à l'application.

Construire des agents fiables avec Apidog

Le SDK Agent est surtout utile lorsque l'agent agit sur des systèmes réels : API, bases de données, déploiements, outils internes.

Pour éviter que l'agent n'invente des formats de requête ou des payloads invalides, donnez-lui un contrat API explicite.

Workflow recommandé avec Apidog :

1. Définissez le contrat API dans Apidog.
   
   Documentez les endpoints, schémas de requête/réponse et exemples de payloads.

2. Exportez le contrat OpenAPI.
   
   Utilisez-le comme contexte pour votre agent.

3. Connectez l'agent aux endpoints réels avec le SDK.
   
   L'agent appelle votre API en s'appuyant sur les schémas définis.

4. Validez les réponses avec la CLI Apidog.
   
   Chaque exécution peut vérifier que l'API respecte toujours le contrat.

Pour les agents qui orchestrent des outils via des serveurs MCP, consultez le workflow de test de serveur MCP avec Apidog.

La logique complète est décrite dans le guide du workflow API axé sur la conception : plus votre contrat est précis, moins vous passez de temps à corriger des erreurs de schéma générées par l'agent.

Vous pouvez aussi télécharger Apidog gratuitement pour ajouter une couche de contrat à vos projets SDK Agent.

Quand utiliser encore une clé API séparée ?

Le crédit lié au forfait est le meilleur choix par défaut pour prototyper et automatiser à petite échelle.

Une clé API séparée reste utile dans ces cas :

• Agents de production avec budgets prévisibles
  
  Les crédits de forfait sont plafonnés. Pour un agent à forte charge, une clé API donne une ligne de facturation plus claire.

• Accès partagé entre plusieurs organisations ou équipes
  
  Une clé API n'est pas liée à un seul utilisateur. Elle convient mieux à une source de facturation commune.

• Sièges Enterprise Standard
  
  Ces sièges ne reçoivent pas de crédit SDK Agent. Pour utiliser le SDK, il faut une clé API ou un siège compatible.

Le guide d'accès gratuit à l'API Claude couvre d'autres options d'accès à Claude sans forfait Pro ni clé API payante.

Checklist avant de lancer votre premier agent

• [ ] Confirmer que votre forfait est éligible : Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise basé sur l'utilisation ou siège Enterprise Premium.
• [ ] Activer le crédit SDK Agent une première fois.
• [ ] Choisir le comportement en cas de dépassement : désactivé pour le prototype, activé pour la production.
• [ ] Exécuter claude login.
• [ ] Installer le SDK Python ou TypeScript.
• [ ] Créer un agent minimal.
• [ ] Vérifier qu'il s'exécute sans ANTHROPIC_API_KEY.
• [ ] Contrôler le solde de crédits après les premières exécutions.

FAQ

Dois-je supprimer mon ancienne variable ANTHROPIC_API_KEY ?

Pas nécessairement. Le SDK utilise les identifiants locaux de Claude Code lorsqu'ils sont présents. claude login suffit donc pour utiliser la facturation basée sur le forfait.

Si ANTHROPIC_API_KEY est utilisée par d'autres outils, vous pouvez la conserver.

Qu'est-ce qui compte comme une requête ?

Le crédit est exprimé en dollars, pas en nombre de requêtes. Chaque appel SDK est facturé selon les tarifs API publiés par Anthropic. Le coût dépend notamment du modèle, des tokens de contexte, de la sortie et de l'utilisation d'outils.

Puis-je partager mon crédit avec un coéquipier ?

Non. Les crédits sont par utilisateur et non transférables. Chaque siège Team ou Enterprise dispose de son propre crédit.

Que devient mon ancien solde API Anthropic ?

Il reste disponible. Le crédit de forfait est un mécanisme séparé. Votre solde de console API continue de s'appliquer aux charges de travail qui utilisent une clé API.

Le SDK Agent est-il identique à Claude Code ?

Non.

Claude Code est la CLI officielle et l'environnement interactif fourni par Anthropic. Le SDK Agent est une bibliothèque Python ou TypeScript pour créer des agents personnalisés.

Le crédit couvre :

• le SDK Agent ;
• claude -p ;
• GitHub Actions ;
• les applications tierces utilisant le SDK Agent.

L'utilisation interactive de Claude Code reste sur les limites normales de votre forfait.

Ma facturation GitHub Actions va-t-elle changer ?

Oui, si votre workflow utilise l'intégration officielle Claude Code GitHub Actions et que le crédit a été réclamé sur le compte de l'utilisateur installateur. Dans ce cas, les exécutions sont déduites du crédit SDK Agent au lieu de la facturation par clé API.

Le crédit fonctionne-t-il en dehors du SDK Agent et de claude -p ?

Non, sauf pour les surfaces explicitement couvertes :

• SDK Agent Python/TypeScript ;
• claude -p ;
• Claude Code GitHub Actions ;
• applications tierces utilisant le SDK Agent.

Les autres usages de Claude relèvent des limites normales de votre forfait ou de votre clé API, selon le mode d'authentification.