L’API de Claude Code expliquée

Claude Code est un agent en terminal, mais chaque action repose sur un appel à la même API Messages d’Anthropic que vous pouvez utiliser directement. Cela a une conséquence utile : vous contrôlez le point de terminaison auquel il se connecte, la clé à laquelle l’utilisation est facturée et, par conséquent, le coût d’une session. Cette page explique les différents éléments et fournit des liens vers les guides de configuration détaillés.

Ce que signifie réellement « API Claude Code »

Il n’existe pas de produit distinct appelé API Claude Code. Claude Code s’authentifie soit via un abonnement Claude (Pro/Max), soit via une clé API et, en mode API, il envoie des requêtes standard à l’API Messages — prompt système, conversation, définitions des outils et résultats des outils — au point de terminaison indiqué par son environnement.

Ce point de terminaison est configurable. Deux variables d’environnement contrôlent tout : ANTHROPIC_BASE_URL (la destination des requêtes) et ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY (le compte facturé). Configurez-les pour utiliser directement Anthropic ou une passerelle compatible avec Anthropic, et Claude Code se comportera de la même manière.

Utiliser votre propre clé API avec Claude Code

Définissez les deux variables dans le profil de votre shell ou dans ~/.claude/settings.json, puis lancez claude comme d’habitude. Vous trouverez la procédure complète, avec des exemples de settings.json, dans notre <a href="/fr/learn/claude-code-api-key-setup/">guide de configuration de la clé API Claude Code</a>.

Un point à connaître : si ANTHROPIC_API_KEY est défini dans votre shell, Claude Code facture aux tarifs API même si vous avez également un abonnement — la variable d’environnement est prioritaire. Supprimez-la si vous souhaitez utiliser votre forfait Pro/Max.

Combien coûte une session Claude Code

Les sessions avec un agent consomment beaucoup de tokens : chaque fichier lu, résultat d’outil et diff est ajouté au contexte. Une heure de travail concentré peut consommer des millions de tokens d’entrée, d’où l’importance de la mise en cache des prompts — sur les points de terminaison qui la prennent en charge, le contexte répété est relu depuis le cache pour une fraction du prix.

Nous détaillons les coûts réels par session, le fonctionnement du cache et les moyens de maintenir un coût abordable pour les longues sessions dans le <a href="/fr/learn/claude-code-api-costs/">guide des coûts de l’API Claude Code</a>.

Anthropic en direct ou une passerelle

L’accès direct à l’API Anthropic offre une facturation à l’usage et une assistance assurée par Anthropic — un choix par défaut adapté aux équipes disposant de budgets stables. Les passerelles indépendantes comme AI Prime Tech (sans affiliation avec Anthropic ni approbation de sa part) revendent l’accès à des tarifs fixes ou réduits et exposent le même format d’échange ; Claude Code fonctionne donc en modifiant uniquement l’URL de base et la clé.

Quelle que soit l’option choisie, vérifiez que le streaming fonctionne de bout en bout et que les modèles nécessaires sont disponibles sous les identifiants exacts demandés par Claude Code — consultez <a href="/fr/learn/use-claude-api-with-claude-code/">utiliser l’API Claude avec Claude Code</a> pour la liste complète des vérifications.

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Questions fréquentes

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.