Configuration et proxy de Claude Code (2026) : utilisation en Chine, adresse API personnalisée, variables d’environnement, paramètres des modèles et du réseau

Utilisation en Chine : pointer vers la passerelle, sans VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Comme le SDK officiel, Claude Code lit ces deux variables. Les requêtes sont envoyées à la passerelle plutôt qu’à api.anthropic.com, ce qui permet une connexion directe depuis les réseaux chinois. Saisissez uniquement le nom de domaine, sans /v1. Après la configuration, rouvrez le terminal, puis utilisez /status dans la session pour vérifier. L’extension VS Code et l’application de bureau lisent l’environnement du shell depuis lequel elles sont lancées. Après avoir modifié la configuration, quittez complètement l’éditeur, puis relancez-le depuis un nouveau terminal.

Quand faut-il un proxy ?

Uniquement si la connexion de votre réseau à la passerelle elle-même est instable. La configuration est identique à celle des autres outils en ligne de commande :

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Si /login dépasse le délai de connexion OAuth (« timeout of 15000ms exceeded »), le problème vient généralement du proxy ou du DNS ; la connexion avec une clé API permet de contourner entièrement OAuth.

Configuration des modèles

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Code fonctionne par catégories (Sonnet / Opus / Haiku), et ces trois variables déterminent le modèle précis associé à chacune. La catégorie Haiku est plus importante qu’il n’y paraît : Claude Code l’utilise pour les petites tâches de chaque session, et l’associer à un modèle économique permet de réaliser des économies substantielles. La passerelle propose actuellement 33 identifiants de modèles Claude, tous sélectionnables dans/model .

Où se trouvent les fichiers de configuration ?

CLAUDE.md (à la racine du projet) — mémoire du projet : commandes de compilation et de test, conventions ;CLAUDE.local.md contient les notes personnelles et n’est pas ajouté au dépôt.
.claude/settings.json (projet) / ~/.claude/settings.json (global) — autorisations, hooks, variables d’environnement, statusLine.
.claude/agents/ — définitions des sous-agents ;.claude/skills/ et ~/.claude/skills/ — compétences.
.mcp.json — configuration des serveurs MCP partagée au sein du projet.

Diagnostic des erreurs de configuration

404 et présence dans les journaux de /v1/v1/messages → BASE_URL contient en trop /v1。
401 / clé invalide → la clé ne correspond pas à l’adresse : une adresse de passerelle doit être associée à une clé de cette passerelle.
Connexion à Max, mais facturation par token → ANTHROPIC_API_KEY est encore présent dans l’environnement ; la clé est prioritaire sur la connexion. Supprimez cette variable avec unset si vous ne souhaitez pas l’utiliser.
Modèle introuvable → cet identifiant ne figure pas dans la liste /v1/models du point de terminaison actuel.
Fermeture au démarrage après modification de settings.json → erreur de syntaxe JSON (virgule superflue) ; vérifiez avec un outil de validation.

Coût

Lorsque vous pointez vers la passerelle, la facturation change également : les crédits sont vendus à 7.69231 fois leur valeur nominale, et $13 donnent $100 de crédits ; pour un usage intensif, des forfaits illimités sont disponibles à partir de $0.80. Consultez la page des tarifs pour plus de détails.

Essayez gratuitement

Les nouveaux comptes qui utilisent le code promotionnel CLAUDECODE lors de l’inscription reçoivent $5 de solde API, sans carte bancaire à associer — de quoi utiliser Claude Code toute une soirée. Les mêmes modèles Claude, avec seulement deux lignes de variables d’environnement à modifier.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

S’inscrire avec le code promotionnel CLAUDECODE

Questions fréquentes

Peut-on utiliser Claude Code en Chine ?

Oui. Claude Code prend en charge une adresse API personnalisée (ANTHROPIC_BASE_URL). En la faisant pointer vers notre passerelle, vous pouvez vous connecter directement depuis les réseaux chinois, sans VPN, compte étranger ni carte bancaire étrangère.

Comment configurer un proxy pour Claude Code ?

Il suffit de définir les variables d’environnement HTTPS_PROXY / HTTP_PROXY. Toutefois, une fois l’adresse configurée pour pointer vers la passerelle, la plupart des utilisateurs n’ont pas besoin de proxy.

Faut-il ajouter /v1 à ANTHROPIC_BASE_URL ?

Non. Le SDK ajoute lui-même /v1/messages ; l’ajouter une seconde fois provoque 404.

Utiliser Claude Code avec la passerelle

Les mêmes modèles, deux lignes de variables d’environnement, des crédits rechargés à 7.69231 fois leur valeur nominale, ou un forfait illimité au choix. Les nouveaux comptes peuvent obtenir $5 de solde API avec le code promotionnel CLAUDECODE.

Obtenir une clé API Voir les forfaits

AI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.

Configuration de Claude Code : utilisation en Chine, proxy et adresse API, variables d’environnement courantes

Points clés