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
| Obstacle | Symptôme | Solution |
|---|---|---|
| Réseau | Impossible de se connecter à l'endpoint Anthropic ; les requêtes expirent | Définissez ANTHROPIC_BASE_URL sur un endpoint directement accessible depuis la Chine |
| Paiement | L'abonnement Claude et l'API Anthropic nécessitent tous deux une carte de crédit étrangère | Utilisez un service API qui accepte les moyens de paiement en Chine et propose un solde prépayé |
| Compte | Enregistrement d'un compte Claude et restrictions régionales | Utilisez l'accès par clé API ; aucune connexion à un compte Claude n'est nécessaire |
Installation (npm et registre en Chine)
1. Installez Node.js 22 ou supérieur
Exécutez node -v pour vérifier votre version.
2. (Facultatif) Passez à un registre npm en Chine
Si les téléchargements npm sont lents, vous pouvez changer de registre d'abord.
Terminalnpm config set registry https://registry.npmmirror.com3. Installez Claude Code
Après une installation globale, exécutez claude --version pour vérifier.
Terminalnpm 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.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
}
}Dépannage : quand ça ne fonctionne pas
- Exécutez /status et confirmez que l'endpoint est api.aicodewith.ai, pas l'endpoint par défaut d'Anthropic.
- 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.
- Si le premier lancement reste bloqué sur l'écran de connexion : ajoutez "hasCompletedOnboarding": true à ~/.claude.json.
- 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.
- 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) | |
|---|---|---|
| Paiement | Carte de crédit étrangère, prix mensuel fixe | Moyens de paiement en Chine ; solde prépayé, paiement à l'usage |
| Réseau | Vous devez gérer cela vous-même | Directement accessible depuis la Chine |
| Compte | Nécessite un compte Claude | Seule une clé API est nécessaire |
| Quota | Limites de 5 heures et hebdomadaires | Facturé sur votre solde prépayé ; des limites de débit et de simultanéité s'appliquent |
| Idéal pour | Usage quotidien intensif sans problèmes de réseau ou de paiement | Réseaux en Chine, utilisation fluctuante, équipes gérant des clés API séparées |
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.