Clé API Claude : Console, recharge, appels et passerelle (2026)

L'API Claude est l'interface de modèles fournie par Anthropic, souvent utilisée pour les textes longs, le code, les agents et le raisonnement complexe. Lors d'une première configuration, beaucoup de développeurs confondent trois choses : l'abonnement web Claude, Claude Code et l'API Claude.

Cet article explique comment obtenir une clé API Claude, comment l'appeler, comment la connecter à Claude Code, ainsi que deux solutions d'accès depuis la Chine.

Remarque : Claude et Anthropic sont des marques de leurs détenteurs respectifs. Cet article décrit les versions courantes d'octobre 2026 ; les interfaces et prix applicables sont ceux de la documentation officielle et du site.

1. Distinguer d'abord trois éléments

Nom	Nature	Utilisation
Claude web/App	Produit de chat	Abonnement
Claude Code	Outil de programmation en ligne de commande	Appelle les modèles via l'API
API Claude	Interface de modèles	Appel de `/v1/messages` avec une clé

Cet article traite de la clé API Claude. Elle n'est pas un compte d'abonnement web et un abonnement web ne peut pas servir directement d'API.

2. Option A : clé officielle via Anthropic Console

Ouvrez Anthropic Console.
Créez un compte ou connectez-vous.
Accédez à la page API Keys.
Créez une clé, nommez-la et conservez-la.
Associez un moyen de paiement et confirmez le quota.
Copiez la clé dans un gestionnaire de mots de passe.

L'adresse d'appel d'une clé officielle est généralement :

https://api.anthropic.com

Les en-têtes de requête nécessitent x-api-key et anthropic-version. La documentation officielle fait foi.

3. Option B : clé via ZSQH AI Gateway

Si l'accès aux interfaces officielles est instable depuis la Chine, ou si vous avez besoin d'une facturation unifiée et de plusieurs modèles :

Ouvrez ZSQH AI Gateway et inscrivez-vous.
Accédez à « Clés API » et créez une clé.
Définissez un plafond de quota et une date d'expiration.
Rechargez votre portefeuille.
Copiez la clé.

La passerelle propose deux usages courants :

Compatibilité Anthropic : pour Claude Code et les outils utilisant le protocole Anthropic.
Compatibilité OpenAI : pour le SDK OpenAI, Cursor, Chatbox, Dify et outils similaires, avec l'URL de base https://ai.zhongshangqihang.com/v1.

4. Appeler l'interface native Anthropic avec curl

export ANTHROPIC_API_KEY="sk-votre-cle"

curl "https://ai.zhongshangqihang.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Explique en trois phrases ce qu'est une passerelle API"}
    ]
  }'

Le nom du modèle applicable est celui de la page Tarifs des modèles. Si le chemin de l'entrée compatible Anthropic diffère sur la passerelle, référez-vous aux instructions d'accès du site.

5. Appeler Claude avec le SDK OpenAI

De nombreux outils ne prennent en charge que le protocole OpenAI. Utilisez alors l'entrée compatible OpenAI de la passerelle :

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Réponds seulement OK"}],
)
print(resp.choices[0].message.content)

Attention : l'interface native Anthropic et l'interface compatible OpenAI utilisent des formats de requête différents ; ne les mélangez pas.

6. Connecter Claude Code

Claude Code utilise le protocole Anthropic. Configuration courante :

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-votre-cle"
claude

Si le client demande ANTHROPIC_AUTH_TOKEN, remplacez la variable selon sa documentation. Pour les étapes détaillées, consultez Tarifs de Claude Code : abonnement ou API.

7. Erreurs fréquentes

Erreur	Cause	Traitement
`401`	Clé erronée, expirée ou en-tête incorrect	Vérifier `x-api-key` ou le Bearer
`404`	URL de base ou chemin incorrect	`/v1/messages` en natif ; `/v1` en compatible OpenAI
`model not found`	Nom de modèle incorrect	Copier le nom depuis la page tarifs
`429`	Limitation ou quota	Réduire la concurrence, réessayer, augmenter le quota
`insufficient quota`	Solde insuffisant	Recharger
Erreur `anthropic-version`	En-tête de version absent	Ajouter `anthropic-version: 2023-06-01`

8. Recommandations de sécurité

N'exposez jamais la clé dans le front-end.
Une clé par personne, avec des quotas par projet.
Définissez une date d'expiration et renouvelez régulièrement.
Ne validez jamais une clé dans Git.
En production, utilisez des variables d'environnement ou un service de gestion des secrets.

9. Accès direct officiel ou passerelle

Dimension	Accès direct officiel	ZSQH AI Gateway
Accès	Dépend de l'environnement réseau	Optimisé pour la Chine
Paiement	Moyens pris en charge par Anthropic	Recharge sur le site
Modèles	Claude uniquement	GPT, Gemini et DeepSeek également
Facturation	Back-office officiel	Console unifiée
Changement	Changer de fournisseur impose de modifier le code	Changer le nom du modèle suffit

Si vous n'utilisez que Claude et que l'accès officiel est normal, l'accès direct convient ; si vous avez besoin d'un accès stable depuis la Chine et d'une gestion multi-modèles unifiée, la passerelle est plus adaptée.

Questions fréquentes

La clé API Claude et la clé de Claude Code sont-elles identiques ?

Claude Code utilise une clé API Claude, ou une clé de passerelle compatible. Un abonnement web n'est pas une clé API.

Une clé peut-elle appeler plusieurs modèles Claude ?

Oui, le modèle est indiqué dans les paramètres de la requête. Les modèles disponibles figurent sur la page tarifs.

Pourquoi le code de la documentation officielle ne fonctionne-t-il pas ?

Les causes courantes sont une inadéquation entre URL de base, en-têtes et nom de modèle. L'interface native et l'interface compatible OpenAI doivent être configurées séparément.

Pour aller plus loin

Si vous avez besoin d'un accès stable depuis la Chine ou d'un point d'entrée multi-modèles, vous pouvez créer un compte ZSQH AI Gateway, créer une clé de test et exécuter une première requête selon cet article. Les modèles et prix applicables sont ceux de la page Tarifs des modèles.