Claude Code · En Chine

Comment utiliser Claude Code en Chine

Utiliser Claude Code en Chine, la difficulté n'est pas l'installation mais le réseau, le paiement et les comptes. Cette page explique, dans l'ordre : comment l'installer, comment vous connecter à une API directement accessible depuis la Chine, comment résoudre les problèmes quand il est installé mais ne fonctionne pas, et comment choisir entre un abonnement Claude (Pro / Max) et un relais API.

Dernière vérification

3 obstacles à l'utilisation de Claude Code en Chine

ObstacleSymptômeSolution
RéseauImpossible de se connecter à l'endpoint Anthropic ; les requêtes expirentDéfinissez ANTHROPIC_BASE_URL sur un endpoint directement accessible depuis la Chine
PaiementL'abonnement Claude et l'API Anthropic nécessitent tous deux une carte de crédit étrangèreUtilisez un service API qui accepte les moyens de paiement en Chine et propose un solde prépayé
CompteEnregistrement d'un compte Claude et restrictions régionalesUtilisez l'accès par clé API ; aucune connexion à un compte Claude n'est nécessaire

Installation (npm et registre en Chine)

  1. 1. Installez Node.js 22 ou supérieur

    Exécutez node -v pour vérifier votre version.

  2. 2. (Facultatif) Passez à un registre npm en Chine

    Si les téléchargements npm sont lents, vous pouvez changer de registre d'abord.

    Terminal
    npm config set registry https://registry.npmmirror.com
  3. 3. Installez Claude Code

    Après une installation globale, exécutez claude --version pour vérifier.

    Terminal
    npm install -g @anthropic-ai/claude-code

Si vous voyez command not found, le répertoire global npm n'est probablement pas dans votre PATH. Exécutez npm config get prefix, ajoutez le répertoire bin sous le chemin affiché à votre PATH, puis rouvrez votre terminal.

Se connecter à une API disponible en Chine

Créez une clé API dans la console AICodeWith, puis ajoutez-la à ~/.claude/settings.json. Rouvrez votre terminal, exécutez claude, puis tapez /status pour confirmer que l'endpoint API est api.aicodewith.ai.

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

Guide du relais Claude CodeObtenir une clé API

Dépannage : quand ça ne fonctionne pas

  1. Exécutez /status et confirmez que l'endpoint est api.aicodewith.ai, pas l'endpoint par défaut d'Anthropic.
  2. Dans un nouveau terminal, exécutez echo $ANTHROPIC_API_KEY. S'il y a une ancienne valeur, retirez-la de ~/.zshrc ou ~/.bashrc ; ANTHROPIC_API_KEY doit rester vide.
  3. Si le premier lancement reste bloqué sur l'écran de connexion : ajoutez "hasCompletedOnboarding": true à ~/.claude.json.
  4. Délai de requête dépassé : désactivez temporairement votre proxy local ou VPN et réessayez. Le réseau en Chine peut se connecter directement.
  5. Si vous obtenez 401 / 429 / overloaded : consultez le guide des erreurs.

Erreurs courantes de Claude Code et solutionsRégions prises en charge

Comparaison des formules (abonnement Claude vs relais API)

Abonnement Claude (Pro / Max)Relais API (AICodeWith)
PaiementCarte de crédit étrangère, prix mensuel fixeMoyens de paiement en Chine ; solde prépayé, paiement à l'usage
RéseauVous devez gérer cela vous-mêmeDirectement accessible depuis la Chine
CompteNécessite un compte ClaudeSeule une clé API est nécessaire
QuotaLimites de 5 heures et hebdomadairesFacturé sur votre solde prépayé ; des limites de débit et de simultanéité s'appliquent
Idéal pourUsage quotidien intensif sans problèmes de réseau ou de paiementRéseaux en Chine, utilisation fluctuante, équipes gérant des clés API séparées

Limites d'utilisation de Claude CodeRecharge et formules

FAQ

Claude Code peut-il être utilisé directement en Chine ?

Oui. L'installation en elle-même n'a aucune restriction. Une fois que vous basculez l'endpoint vers une API directement accessible depuis la Chine (par exemple, api.aicodewith.ai), vous pouvez l'utiliser directement.

Ai-je besoin d'un proxy ?

Aucun proxy n'est nécessaire après vous être connecté à AICodeWith. Si un proxy local est actif et que les requêtes expirent, désactivez-le et réessayez.

Que faire si je n'ai pas de carte de crédit étrangère ?

AICodeWith accepte les moyens de paiement en Chine pour les recharges. Le solde prépayé est débité à l'usage, reste valable 12 mois et n'est pas remis à zéro chaque mois.

Que faire si l'installation échoue ou si vous obtenez command not found ?

Assurez-vous d'abord que votre version de Node.js est 22 ou supérieure. Si les téléchargements npm sont lents, passez à un registre en Chine. command not found signifie que le répertoire bin global npm n'est pas dans votre PATH ; ajoutez-le, puis rouvrez votre terminal.

Prêt à essayer ?

La facturation est par token, à partir d'un solde prépayé. Des limites de débit et de concurrence s'appliquent, et vous pouvez définir des plafonds de dépenses quotidiens, mensuels ou totaux pour chaque clé API.

Rubriques connexes

AICodeWith est un service API tiers indépendant, sans affiliation avec Anthropic ou OpenAI. Claude, Claude Code, Codex et les autres noms appartiennent à leurs propriétaires respectifs. Les prix sont basés sur les données en temps réel de la page du modèle ; des limites de débit et de simultanéité s'appliquent ; les remboursements sont soumis à des frais de traitement de 10 %. Consultez la politique de remboursement pour plus de détails.