Claude Code est l'outil de programmation en ligne de commande lancé par Anthropic, conçu pour lire le code, le modifier, exécuter des tests et refactoriser depuis un terminal. Il appelle par défaut l'API Anthropic ; les développeurs en Chine rencontrent donc souvent trois problèmes : accès instable à l'interface officielle, moyens de paiement limités, et gestion difficile des quotas et coûts d'équipe.
ZSQH AI Gateway fournit un point d'entrée API unifié : une seule clé API suffit pour appeler Claude et d'autres modèles courants via l'interface compatible. Cet article parcourt l'ensemble du processus, de l'inscription à la création de clé, à la configuration de la Base URL et à la première exécution.
Remarque : les versions de Claude Code évoluent vite ; les variables d'environnement et libellés de menus peuvent changer. Cet article se réfère aux versions courantes d'octobre 2026 ;
claude --helpet la documentation officielle font foi.
1. Comprendre d'abord quel type d'interface utilise Claude Code
Claude Code utilise par défaut l'API Anthropic Messages, et non l'API Chat Completions d'OpenAI. Pour l'intégrer à une passerelle tierce, trois éléments sont nécessaires :
- Base URL : l'adresse de l'interface, par exemple
https://ai.zhongshangqihang.com. - Clé API : le jeton créé dans la console ZSQH, généralement préfixé par
sk-. - Nom du modèle : par exemple
claude-sonnet-4-5ouclaude-opus-4-1, selon les noms affichés sur la page de tarifs du site.
Avec le SDK OpenAI ou un autre outil compatible OpenAI, la Base URL s'écrit généralement https://ai.zhongshangqihang.com/v1 ; avec le protocole Anthropic utilisé par Claude Code, on indique en principe l'adresse racine, le client ajoutant lui-même /v1/messages.
2. Préparer le compte et la clé API
1. S'inscrire et se connecter
Ouvrez ZSQH AI Gateway, créez un compte et connectez-vous à la console.
2. Créer une clé API
Accédez à la page « Clés API » de la console et créez une clé. Recommandations :
- Donnez un nom explicite, par exemple
claude-code-pc-travail. - Fixez un plafond de quota pour éviter une consommation massive en cas de fuite.
- Définissez une date d'expiration pour invalider automatiquement une clé inutilisée.
- Copiez et conservez la clé immédiatement : elle n'est généralement affichée en entier qu'une fois.
3. Vérifier le solde
Consultez le solde sur la page « Portefeuille » ou « Recharge ». Les modèles n'ont pas tous le même mode de facturation ; les prix unitaires exacts figurent sur la page Tarifs des modèles.
3. Configurer Claude Code
Option A : variables d'environnement macOS / Linux
Dans le terminal :
export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-votre-clé"
claude
Pour que cela s'applique à chaque ouverture du terminal, ajoutez les deux lignes dans ~/.zshrc ou ~/.bashrc, puis exécutez source ~/.zshrc.
Option B : Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
$env:ANTHROPIC_API_KEY="sk-votre-clé"
claude
Option C : cas où le client exige AUTH_TOKEN
Certains clients tiers ou configurations de proxy utilisent ANTHROPIC_AUTH_TOKEN au lieu de ANTHROPIC_API_KEY :
export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_AUTH_TOKEN="sk-votre-clé"
Si les deux variables existent en même temps, conservez-en une seule selon la documentation du client pour éviter un conflit d'en-tête d'authentification. Les versions de Claude Code ne prennent pas toutes en charge les mêmes noms de variables ; en cas de 401, vérifiez ce point en premier.
Option D : configuration au niveau du projet
Pour ne pas modifier l'environnement global, injectez les variables via un fichier .env ou un script de démarrage dans le répertoire du projet. Ne commitez pas .env dans Git :
# .env.local (ne pas committer)
ANTHROPIC_BASE_URL=https://ai.zhongshangqihang.com
ANTHROPIC_API_KEY=sk-votre-clé
Chargez ensuite ce fichier avant de lancer Claude Code. La méthode diffère selon le shell ; suivez les conventions de votre projet.
4. Choisir le modèle
La famille Claude se répartit généralement en trois niveaux, Opus, Sonnet et Haiku :
| Niveau | Scénarios adaptés | Caractéristiques |
|---|---|---|
| Opus | Refactorisation complexe, agents à long parcours, raisonnement difficile | Capacité la plus élevée, prix unitaire généralement le plus haut |
| Sonnet | Écriture quotidienne de code, correction de bugs, revue de code | Bon équilibre entre capacité et coût |
| Haiku | Complétion simple, tâches par lots, appels à faible coût | Rapide, prix unitaire généralement plus bas |
Dans Claude Code, le modèle peut être précisé par paramètre ou variable d'environnement. Les noms réellement disponibles sont ceux de la page Tarifs des modèles ; un nom inexistant renvoie généralement model not found.
5. Premier appel et diagnostic
Une fois la configuration faite, lancez dans le répertoire du projet :
claude
Puis saisissez une tâche simple, par exemple « explique la structure des répertoires de ce projet ». Si une réponse normale apparaît, la Base URL, la clé et le modèle fonctionnent.
Erreurs courantes :
| Erreur | Cause possible | Traitement |
|---|---|---|
401 Unauthorized |
Clé erronée, expirée ou mauvais nom de variable | Recopier la clé ; vérifier ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN |
404 Not Found |
Base URL avec /v1 en trop ou manquant |
Claude Code utilise l'adresse racine ; le SDK OpenAI utilise /v1 |
model not found |
Nom de modèle inexistant ou non ouvert | Copier le nom actuel depuis la page de tarifs |
429 Too Many Requests |
Concurrence ou fréquence dépassée | Réduire la concurrence, réessayer plus tard ; vérifier le quota de la clé |
insufficient quota |
Solde insuffisant | Recharger puis réessayer |
| Blocage ou timeout | Problème réseau ou proxy | Vérifier réseau, DNS et paramètres de proxy |
6. Maîtriser les coûts et les quotas
Le coût de Claude Code provient principalement des tokens d'entrée, des tokens de sortie, du contexte long et du cache. Pour le maîtriser :
- Créez une clé par projet, avec quota et date d'expiration.
- Utilisez Sonnet ou Haiku pour les tâches simples, et Opus pour les tâches complexes.
- Évitez d'injecter tout un gros dépôt dans le contexte ; laissez d'abord Claude Code lire les fichiers pertinents.
- Consultez régulièrement les journaux d'usage pour identifier les projets et modèles les plus consommateurs.
- En équipe, utilisez une passerelle unifiée pour séparer membres, clés, quotas et facturation.
Les prix unitaires et règles de facturation exacts sont ceux de la page Tarifs des modèles. Les prix évoluent avec les versions de modèles et les politiques amont ; cet article ne fige aucun chiffre pour éviter l'obsolescence.
7. Recommandations de sécurité
- N'écrivez pas la clé API dans le code, des captures d'écran, un dépôt Git ou une documentation publique.
- Fixez un plafond de quota et une date d'expiration pour chaque clé.
- En cas de suspicion de fuite, supprimez immédiatement l'ancienne clé et créez-en une nouvelle.
- En équipe, une clé par personne facilite l'audit et la désactivation.
- Utilisez des clés distinctes pour la production et le test.
Questions fréquentes
Claude Code et l'API Claude sont-ils la même chose ?
Non. Claude Code est un outil de programmation, l'API Claude est l'interface de modèle. Claude Code appelle le modèle via l'API ; vous pouvez aussi écrire votre propre application avec l'API Claude.
La clé ZSQH peut-elle s'utiliser directement dans Claude Code ?
Oui, à condition que le client utilise le protocole compatible Anthropic et que la Base URL, la clé et le nom du modèle soient correctement configurés. La documentation d'intégration du site et la version actuelle du client font foi.
Pourquoi recommander une passerelle plutôt qu'une connexion officielle directe ?
La valeur d'une passerelle réside dans le point d'entrée unifié, la facturation unifiée, la gestion des quotas, la traçabilité de l'usage et le basculement entre modèles. Pour les équipes et l'accès depuis la Chine, elle est généralement plus simple à administrer que des comptes officiels individuels.
Faut-il installer Node.js ?
Claude Code s'installe généralement via npm et nécessite un environnement Node.js. Le mode d'installation est celui de la documentation officielle.
Pour aller plus loin
Si vous n'avez pas encore de compte, inscrivez-vous sur ZSQH AI Gateway, créez une clé de test, puis suivez cet article pour exécuter une première tâche. En cas de problème de nom de modèle ou de facturation, consultez la page Tarifs des modèles, puis les journaux d'usage de la console.
Articles liés :
