Retour aux guides
Installation·3 octobre 2026·12 min de lecture

Tutoriel d’installation de Claude Code : commandes d’installation Windows et macOS, configuration avec une clé API sans connexion à un compte, recharge par Alipay ou WeChat Pay

L’installation de Claude Code ne nécessite qu’une seule commande officielle. Les difficultés apparaissent ensuite : version de Node requise par npm, terminal et PATH sous Windows, configuration de la clé API sans connexion à un compte et paiement depuis la Chine continentale.

Pour Claude Code, il est recommandé d’utiliser la commande officielle d’installation native d’Anthropic ; npm est la méthode officielle alternative et nécessite Node.js 22 ou une version ultérieure. Claude Code peut être utilisé sans se connecter à un compte Claude : définissez ANTHROPIC_BASE_URL (le domaine uniquement, sans /v1), ANTHROPIC_AUTH_TOKEN et les quatre lignes de configuration qui fixent les modèles pour utiliser une clé API facturée au token. Le solde API Kunavo peut être rechargé avec Alipay ou WeChat Pay, avec une recharge minimale de $10. Enfin, exécutez /status dans Claude Code pour confirmer la connexion.

终端
# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows 命令提示符(CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

命令和环境变量核对于 3 octobre 2026,依据 Documentation officielle d’installation de Claude Code和 Documentation officielle des variables d’environnement;价格和付款方式核对于 3 octobre 2026。先说明一个事实:Liste des pays et régions pris en charge par Anthropic(核对于 3 octobre 2026)中没有中国大陆、香港和澳门,Claude Code 安装文档的系统要求里也有一行「所在地区:Anthropic 支持的国家」。本页只讲官方文档写明的安装和配置方法,不提供任何绕过地区限制的办法。Kunavo 没有在中国大陆做过网络连通性测试,下面提到的下载地址、npm 源和 api.kunavo.com 能否在你的网络里访问,需要你自己确认。

Vérifications avant l’installation

ÉlémentPrérequis (documentation officielle d’installation, vérifiés le 3 octobre 2026)
Système d’exploitationmacOS 13.0 ou version ultérieure ; Windows 10 1809 ou version ultérieure, ou Windows Server 2019 ou version ultérieure ; Ubuntu 20.04 ou version ultérieure ; Debian 10 ou version ultérieure ; Alpine Linux 3.19 ou version ultérieure
MatérielAu moins 4 Go de mémoire, processeur x64 ou ARM64 (Windows 32 bits non pris en charge)
ShellBash, Zsh, PowerShell ou CMD
RéseauUne connexion Internet est requise
Région de résidencePays et régions pris en charge par Anthropic (la Chine continentale, Hong Kong et Macao ne figurent pas dans la liste)
CompteLa connexion nécessite un compte Pro, Max, Team, Enterprise ou Console ; l’offre gratuite de Claude.ai n’inclut pas Claude Code. Avec une clé API, aucun abonnement ni connexion n’est nécessaire
Node.jsNécessaire uniquement avec la méthode npm, version 22 ou ultérieure ; inutile avec l’installation native

Méthode 1 : installation native officielle (recommandée)

La documentation officielle d’installation indique que l’installation native est la méthode recommandée. Les commandes sont les trois blocs au début de cette page : macOS, Linux et WSL utilisent la ligne install.sh, Windows PowerShell utilise irm … | iex, et Windows CMD utilise la ligne install.cmd. L’installation native se met automatiquement à jour en arrière-plan ; la documentation officielle précise également que les installations via Homebrew et WinGet ne se mettent pas automatiquement à jour par défaut.

Après l’installation, ouvrez une nouvelle fenêtre de terminal (les fenêtres déjà ouvertes ne voient pas le nouveau PATH), puis vérifiez :

claude --version   # 正常会打印版本号,后面跟着 (Claude Code)
claude doctor      # 只读的安装与设置诊断,不会开启会话

claude doctor n’ouvre pas de session ; il affiche uniquement l’état de l’installation et les informations de diagnostic des fichiers de configuration. Il permet de distinguer un problème d’installation d’un problème de configuration.

En cas d’erreur de téléchargement

如果终端里出现 syntax error near unexpected token '<' 或 curl: (22) The requested URL returned error: 403,按 Documentation officielle de dépannage de l’installation(核对于 3 octobre 2026)的说法,这表示安装地址返回的是一个网页或错误状态码,而不是安装脚本。如果返回的网页写着 App unavailable in region,官方的解释是:Claude Code 在你所在的国家或地区不可用。不带网页内容的 403 也可能来自公司代理或防火墙拦截下载;官方建议,在支持地区内仍然遇到 403 时,先排查网络连接,再考虑其他安装方式。

Méthode 2 : installation npm (Node.js 22 ou version ultérieure requis)

npm 仍是官方文档列出的安装方式。官方文档写明 npm 包需要 Node.js 22 或更高版本;版本较旧时 npm 会打印 EBADENGINE 警告但不会失败,安装照样完成,因为这个包下载的是一个运行时不依赖 Node.js 的原生程序。没有 Node.js 的话,从 Site officiel de Node.js安装 22 或更高版本。

终端
node -v                                    # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code   # 不要加 sudo

La documentation officielle demande explicitement de ne pas utiliser sudo npm install -g, car cela entraîne des problèmes d’autorisations et des risques de sécurité. Pour mettre à niveau, utilisez npm install -g @anthropic-ai/claude-code@latest, et non npm update -g.

Si le téléchargement depuis le registre par défaut échoue ou est très lent : npmmirror

如果从 npm 默认源下载失败或很慢,可以改用 npmmirror。Page d’accueil de npmmirror(核对于 3 octobre 2026)说明它是「完整 npmjs.com 镜像」,只读,会「尽量与官方服务实时同步」,并给出了 registry 地址和设置命令。首页没有写明具体同步频率。

终端
# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者把 npmmirror 设为 npm 的默认源(之后所有 npm 安装都会走它)
npm config set registry https://registry.npmmirror.com

# 以后升级用 @latest,不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

L’installation de Claude Code via un miroir comporte deux conditions faciles à oublier, toutes deux issues de la documentation officielle de dépannage :

  • Le miroir doit fournir simultanément les 8 paquets de plateforme. Le paquet npm lui-même n’est qu’une enveloppe ; le véritable programme est téléchargé comme dépendance facultative sous la forme de paquets de plateforme @anthropic-ai/claude-code-*. Si le miroir ne contient pas ces paquets, l’exécution de claude après l’installation sur macOS ou Linux affiche claude native binary not installed (sous Windows, PowerShell ou CMD indique que ce fichier ne peut pas être exécuté). Le 3 octobre 2026, depuis un réseau situé hors de Chine continentale, Kunavo a vérifié que le paquet principal ainsi que les paquets Windows x64, macOS ARM64 et Linux x64 de npmmirror correspondent aux dernières versions de npmjs ; les autres paquets de plateforme (Windows ARM64, Mac Intel, Linux ARM64 et les deux versions musl) n’ont pas été vérifiés.
  • Les dépendances facultatives ne peuvent pas être ignorées. N’ajoutez pas --omit=optional à la commande d’installation et vérifiez également que optional=false n’est pas défini dans .npmrc.

Section consacrée à Windows

Windows propose deux commandes d’installation différentes ; la seule différence est le type de terminal ouvert. L’invite PS C:\Users\你的用户名> correspond à PowerShell ; celle qui ne contient pas PS et affiche uniquement C:\Users\你的用户名> correspond à l’invite de commandes (CMD). La documentation officielle précise que l’installation ne nécessite pas de l’exécuter en tant qu’administrateur.

Une erreur fréquente sous Windows consiste à coller la mauvaise commande dans le mauvais terminal : dans PowerShell, l’exécution de la ligne CMD affiche The token '&&' is not a valid statement separator ; dans CMD, l’exécution de la ligne PowerShell affiche 'irm' is not recognized as an internal or external command. Dans les deux cas, utilisez simplement la ligne correspondant au terminal. Par ailleurs, le menu Démarrer contient « Windows PowerShell » et « Windows PowerShell (x86) » ; le second est un processus 32 bits et affiche Claude Code does not support 32-bit Windows. Ouvrez celui qui ne comporte pas (x86).

Git for Windows 是可选的:装了以后 Claude Code 用它附带的 Git Bash 执行命令;没装时改用 PowerShell 工具执行。装了却找不到 Git Bash 时,在 ~/.claude/settings.json 的 env 里设置 CLAUDE_CODE_GIT_BASH_PATH,指向 bash.exe,官方示例路径是 C:\Program Files\Git\bin\bash.exe。

MéthodeDe quoi avez-vous besoin ?Exécution en bac à sableAdapté si
Windows natifNon requis ; Git for Windows est facultatifNon pris en chargeLe projet et les outils sont déjà sous Windows
WSL 2Activer WSL 2Prise en chargeVous avez besoin de la chaîne d’outils Linux ou souhaitez exécuter les commandes dans un bac à sable
WSL 1Activer WSL 1Non pris en chargeLorsque WSL 2 est inutilisable

Si vous choisissez WSL, exécutez la ligne macOS/Linux dans le terminal WSL et lancez également claude dans WSL, et non dans PowerShell ou CMD.

Erreur de stratégie d’exécution avec la méthode npm

Dans PowerShell, lors de l’installation ou de l’exécution avec npm, si npm.ps1 cannot be loaded because running scripts is disabled on this system s’affiche, la stratégie d’exécution de PowerShell bloque le script de démarrage .ps1 généré par npm. La documentation officielle propose trois solutions : autoriser l’exécution des scripts locaux pour l’utilisateur actuel (ligne ci-dessous) ; utiliser npm.cmd ou claude.cmd ; ou utiliser la commande d’installation native PowerShell.

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Après l’installation, claude est introuvable

L’apparition de command not found: claude ou 'claude' is not recognized signifie que le répertoire d’installation ne se trouve pas dans PATH. L’installation native place le programme dans ~/.local/bin/claude sous macOS/Linux et dans %USERPROFILE%\.local\bin\claude.exe sous Windows. Ouvrez d’abord un nouveau terminal et réessayez ; si cela échoue encore sous Windows, utilisez PowerShell conformément à la documentation officielle de dépannage pour vérifier et ajouter le chemin utilisateur à PATH :

PowerShell
# 1. 检查安装目录是否已在 PATH 里
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 没有任何输出时,把它加进「用户」PATH,然后关掉终端重新打开
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 重新打开终端后确认
claude --version

Configurer la clé API : sans se connecter à un compte Claude

ANTHROPIC_BASE_URL est une variable d’environnement fournie par Claude Code. La documentation officielle la décrit comme permettant de remplacer le point de terminaison API afin que les requêtes passent par un proxy ou une passerelle. Diriger Claude Code vers un point de terminaison qui fournit l’API Anthropic Messages est donc une configuration officiellement prise en charge, sans plugin ni programme modifié. Sous macOS/Linux, écrivez-la dans le fichier de configuration du shell :

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # 只写到域名,不要加 /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Pour tester d’abord dans une fenêtre PowerShell sous Windows :

PowerShell
# 只对当前 PowerShell 窗口有效,关掉窗口就失效
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Pour une utilisation à long terme, il est recommandé d’écrire dans ~/.claude/settings.json, le fichier de configuration utilisateur, la clé env (sous Windows : %USERPROFILE%\.claude\settings.json). Ainsi, chaque terminal et chaque tâche en arrière-plan peut la lire. Si le fichier contient déjà d’autres paramètres, fusionnez-y env :

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Ces six lignes comportent chacune un point facile à configurer incorrectement :

  • ANTHROPIC_BASE_URL doit contenir uniquement le domaine. Claude Code ajoutera lui-même /v1/messages ; si vous ajoutez également /v1, cela devient /v1/v1/messages et renvoie 404.
  • Utilisez ANTHROPIC_AUTH_TOKEN, pas ANTHROPIC_API_KEY. La documentation officielle indique que la valeur de ANTHROPIC_AUTH_TOKEN est envoyée dans l’en-tête Authorization et reçoit automatiquement le préfixe Bearer ; elle prend effet immédiatement. En revanche, ANTHROPIC_API_KEY doit d’abord être confirmé une fois en mode interactif ; si vous refusez, cette clé est ensuite ignorée silencieusement (réactivez-la dans Use custom API key de /config).
  • ANTHROPIC_MODEL détermine le modèle principal. Il est fixé ici à Claude Sonnet 5 (claude-sonnet-5). Le nom du modèle doit correspondre exactement à la liste des modèles de Kunavo ; les anciens noms comportant un suffixe de date ne sont pas associés automatiquement.
  • ANTHROPIC_DEFAULT_OPUS_MODEL détermine l’alias opus.按 Documentation officielle sur la configuration des modèles(核对于 3 octobre 2026),API 用户的默认模型和 opus 别名指向最新的 Opus(目前是 Opus 5.5),sonnet 别名指向 Sonnet 5.5,而且别名会跟着 Anthropic 的新版本移动。官方文档写明别名「会随时间更新」,要固定版本,就写完整模型名或设置 ANTHROPIC_DEFAULT_OPUS_MODEL 这类变量。Kunavo 目前没有提供 Sonnet 5.5,Anthropic 以后发布新 Opus 时 Kunavo 也不一定已经上架,没上架的模型会返回 404。这就是要把主模型、opus 和 sonnet 别名都固定下来的原因。这里 opus 别名固定为 Claude Opus 5.5(claude-opus-5-5),需要 Claude Code v2.1.280 或更高版本,旧版本先运行 claude update 升级。
  • ANTHROPIC_DEFAULT_SONNET_MODEL détermine l’alias sonnet. La documentation officielle indique que cette variable détermine vers quel modèle pointe l’alias sonnet et quel modèle opusplan utilise en dehors du mode planification, pendant la phase d’exécution. Par défaut, l’alias sonnet demande Sonnet 5.5, que Kunavo ne fournit pas actuellement ; sans cette ligne, /model sonnet, la phase d’exécution de opusplan et les sous-agents qui spécifient model: sonnet renvoient 404. Ici aussi, il est fixé à Claude Sonnet 5 (claude-sonnet-5).
  • ANTHROPIC_DEFAULT_HAIKU_MODEL gère également les tâches en arrière-plan. La documentation officielle indique que cette variable détermine l’alias haiku et est également utilisée par les fonctions en arrière-plan. Claude Haiku 4.5 coûte chez Kunavo, par million de tokens, $0.70 en entrée et $3.50 en sortie ; le modèle principal Claude Sonnet 5 coûte $1.40 / $7.00 (tarifs officiels d’Anthropic : $2.00 / $10.00) ; le modèle Claude Opus 5.5 associé à l’alias opus coûte $2.80 / $14.00.

Ne placez pas la clé dans le .claude/settings.json du projet : la documentation officielle rappelle que ce fichier sera soumis et partagé avec toutes les personnes qui clonent le dépôt. Retenez également cette priorité : si une même variable est définie dans le shell et dans le fichier settings, la valeur du fichier settings est prioritaire. Si une variable du shell modifiée ne prend pas effet, vérifiez d’abord le fichier settings.

Que se passe-t-il au premier lancement ?

按官方的 Documentation de connexion à la passerelle(核对于 3 octobre 2026),设置了 ANTHROPIC_AUTH_TOKEN 后运行 claude,会直接进入会话,Aucune page de connexion ne s’affiche;这个变量立即生效,不像 ANTHROPIC_API_KEY 那样要先确认一次。如果打开后看到的是登录页,说明 Claude Code 没有读到凭据。

Les identifiants doivent être placés là où Claude Code les lira avant la première configuration : export dans le shell ou env dans ~/.claude/settings.json. La documentation officielle précise qu’en mode interactif, env de .claude/settings.json ou .claude/settings.local.json dans le projet ne prend effet qu’après l’assistant de première configuration et l’invite de confiance envers le dossier ; si la clé est placée dans les paramètres du projet, la page de connexion s’affichera donc encore au premier lancement.

Une fois dans la session, exécutez /status et consultez deux lignes de la page Status :

  • Anthropic base URL : cette ligne n’apparaît que si l’adresse de la passerelle est définie et doit afficher https://api.kunavo.com. Si elle n’apparaît pas, ANTHROPIC_BASE_URL n’a pas été transmise à cette session.
  • Auth token : la valeur ANTHROPIC_AUTH_TOKEN indique l’utilisation d’une clé API et non d’une connexion claude.ai enregistrée. Si vous voyez Login method ainsi qu’un compte claude.ai, la variable n’a pas pris effet.

Pour tester séparément l’adresse et la clé avant d’ouvrir Claude Code, vous pouvez, comme dans la documentation officielle, envoyer une requête ne demandant qu’un seul token de sortie (un montant minime sera déduit selon le nombre de tokens). Cette commande lit les variables du shell ; même si vous avez écrit la clé dans le fichier settings, vous devez donc d’abord exécuter export dans le terminal actuel. Un JSON commençant par {"id":"msg_ indique que l’adresse et la clé sont correctes ; 401 indique que la clé n’a pas été reconnue.

终端
curl -sS -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Qu’est-ce qui change avec une clé API ?

  • Remote Control et la saisie vocale sont indisponibles. La documentation officielle indique que ces deux fonctions dépendent de l’identité claude.ai et sont indisponibles lorsque ANTHROPIC_AUTH_TOKEN est défini ; si ANTHROPIC_BASE_URL pointe vers une adresse autre qu’Anthropic, Remote Control est également désactivé.
  • /fast indiquera que le mode fast est désactivé. La documentation officielle précise qu’avec un bearer token uniquement, Claude Code considère directement le mode fast comme désactivé et n’envoie pas de vérification de disponibilité.
  • La recherche d’outils MCP est désactivée par défaut. La documentation officielle indique que lorsque ANTHROPIC_BASE_URL pointe vers une adresse autre qu’Anthropic, la recherche d’outils MCP est désactivée par défaut.
  • Les chiffres affichés par /context sont des estimations locales.Kunavo 目前不提供 /v1/messages/count_tokens。按 Documentation officielle de compatibilité des passerelles(核对于 3 octobre 2026),网关没有这个端点时,Claude Code 改用按字符估算,/context 显示的是近似值。

Consultez les instructions complètes d’intégration dans la documentation d’intégration de Claude Code (en anglais).

Que désactive exactement CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ?

按 Documentation officielle des variables d’environnement(核对于 3 octobre 2026),它的作用是关闭 Claude Code 的非必要网络流量,官方列出的内容是:

  • Mises à jour automatiques, télémétrie et rapports d’erreurs ;
  • Commande /feedback et commentaires rédigés par Claude ;
  • Notes de version et vérification des badges d’état PR/MR ;
  • Vérifications de disponibilité telles que le mode fast ;
  • Récupération des indicateurs de fonctionnalité (feature flags), ce qui rend Remote Control et les autres fonctions qui en dépendent indisponibles ;
  • Relance en arrière-plan depuis la source du plugin command (il s’agit d’une commande locale et non de trafic réseau, car elle peut déclencher l’installation de dépendances).

Quelques précisions indiquées par la documentation officielle : définir 0 ou false est également considéré comme une activation ; contrairement à la plupart des variables d’activation, seule la suppression de cette variable rétablit le comportement ; l’installation automatique depuis le marché officiel des plugins n’est pas concernée ; la découverte des modèles de la passerelle n’est pas affectée. La documentation officielle des passerelles ajoute que la vérification de sécurité des domaines de l’outil WebFetch n’est pas affectée : elle continue d’accéder à api.anthropic.com. Pour la désactiver, ajoutez séparément skipWebFetchPreflight: true aux paramètres. La documentation officielle ne décrit pas cette variable comme un réglage lié au contrôle des comptes.

Kunavo 不要求设置它,它也不影响发往 Kunavo 的模型请求。什么时候值得开启,官方 Documentation de connexion à la passerelle(核对于 3 octobre 2026)给了一个场景:即使 ANTHROPIC_BASE_URL 指向网关,Claude Code 仍会向 Anthropic 和 GitHub 等第三方发送版本检查、遥测、发布说明之类的后台请求;如果你的网络只允许访问网关地址,这些请求会失败,并可能在出站监控里显示为被拦截的连接,官方的做法就是和网关变量一起设置这个变量。

Le coût de l’activation est de ne plus bénéficier des mises à jour automatiques ; la documentation officielle recommande de prévoir une autre méthode de mise à jour. Avec une installation npm, mettez manuellement à niveau avec @latest (voir la dernière ligne de la section npmmirror ci-dessus).

~/.zshrc
# 可选:关闭 Claude Code 的非必要网络流量(会同时关闭自动更新)
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# 想恢复时删掉这个变量;设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Recharger le compte avec Alipay ou WeChat Pay et obtenir une clé

Anthropic 官方的网页订阅只收信用卡或借记卡(FAQ sur la facturation des offres payantes de Claude,核对于 3 octobre 2026)。在 Kunavo 充值可以用支付宝或微信支付,步骤概要如下,完整步骤见 Guide de recharge de l’API Claude avec Alipay et WeChat Pay:

  1. Créez un compte Kunavo avec une adresse e-mail ou un compte Google ; aucune carte bancaire n’est requise à l’inscription.
  2. Dans Facturation, choisissez le montant de la recharge, au minimum $10, sans frais mensuels. Les recharges importantes donnent droit à un bonus : 充 $100 到账 $110、充 $1000 到账 $1200、充 $5000 到账 $6250.
  3. Sur la page de paiement Stripe, choisissez Alipay ou WeChat Pay et payez en scannant le code. Depuis la Chine continentale, le montant est affiché en RMB ; fiez-vous au chiffre indiqué sur la page de paiement.
  4. Accédez à /app/keys pour créer une clé commençant par sk-kn- (elle ne sera affichée qu’une seule fois ; enregistrez-la immédiatement), puis renseignez-la dans le ANTHROPIC_AUTH_TOKEN ci-dessus.

Alipay et WeChat Pay permettent uniquement les recharges manuelles ; le rechargement automatique nécessite une carte bancaire ou Link. Kunavo n’émet pas de facture de TVA chinoise ; l’historique des recharges est consultable dans la page Billing.

Combien cela coûte approximativement (algorithme illustratif)

Claude Code est facturé au token ; chaque requête renvoie à nouveau l’intégralité du contexte de conversation, dont le préfixe identique à la requête précédente peut être facturé au tarif de lecture du cache. Ce qui suit est uniquement un calcul illustratif de tokens, et non une facture mesurée ni un plafond de coût. Toutes les hypothèses sont indiquées :

  • À chaque requête, 40,000 tokens en entrée, dont 36,000 (90 %) sont facturés comme lecture du cache ; les 4,000 restants sont facturés comme écriture du cache ;
  • 1,000 tokens en sortie à chaque requête ;
  • 50 requêtes de ce type pendant une période de travail ; les appels en arrière-plan de Claude Haiku 4.5 ne sont pas comptabilisés ;
  • Tarifs Kunavo : la lecture du cache représente 10% du tarif d’entrée ; l’écriture du cache représente 1.25 fois le tarif d’entrée (ratio de Claude Sonnet 5 ; chaque modèle du tableau est calculé selon son propre ratio).
ModèlePar requêteTotal pour 50 requêtesTotal pour 50 requêtes si le cache n’est jamais utilisé
Claude Sonnet 5$0.019$0.95$3.15
Claude Opus 5.5$0.033$1.65$6.30

Le coût réel dépend de la longueur du contexte, du nombre de correspondances dans le cache, de la longueur de la sortie et du fait que vous utilisiez ou non /clear pour effacer la conversation entre les tâches. Pour choisir entre l’abonnement Claude Code et l’API et estimer le coût mensuel, consultez les tarifs de Claude Code ; pour les tarifs complets de chaque modèle, consultez les tarifs de l’API Claude et la page des tarifs ; pour estimer selon votre propre utilisation, utilisez le calculateur de coût en tokens de Claude (en anglais).

Tableau des erreurs fréquentes

Message affichéCause et solution
The token '&&' is not a valid statement separatorVous avez exécuté la ligne CMD dans PowerShell ; utilisez plutôt irm … | iex.
'irm' is not recognized as an internal or external commandVous avez exécuté la ligne PowerShell dans CMD ; utilisez plutôt la ligne install.cmd.
syntax error near unexpected token '<'、403L’adresse d’installation a renvoyé une page Web ou un code d’état d’erreur. Lorsque la page affiche App unavailable in region, l’explication officielle est que Claude Code n’est pas disponible dans votre pays ou région ; dans les autres cas, vérifiez le réseau à l’aide de la documentation officielle de dépannage.
command not found: claude、'claude' is not recognizedLe répertoire d’installation ne se trouve pas dans PATH. Ouvrez d’abord un nouveau terminal ; sous Windows, utilisez l’extrait PowerShell ci-dessus pour ajouter le chemin utilisateur à PATH.
Avertissement EBADENGINENode.js est antérieur à 22. La documentation officielle précise que l’installation s’achèvera malgré tout ; il est recommandé de passer à la version 22 ou ultérieure.
claude native binary not installed (macOS, Linux)npm a ignoré les dépendances facultatives (--omit=optional ou optional=false), les scripts d’installation (--ignore-scripts) ou le miroir utilisé ne contient pas les paquets de plateforme. Supprimez les paramètres concernés, puis réinstallez.
npm.ps1 cannot be loadedLa stratégie d’exécution de PowerShell a bloqué le script de démarrage de npm. Exécutez la ligne Set-ExecutionPolicy ou utilisez l’installation native.
Claude Code does not support 32-bit WindowsVous avez ouvert Windows PowerShell (x86) ; ouvrez celui qui ne comporte pas x86.
Après avoir défini la clé, la page de connexion s’affiche encore lors de l’exécution de claudeClaude Code n’a pas lu les identifiants. Écrivez les variables dans la configuration du shell ou dans ~/.claude/settings.json, et non uniquement dans les paramètres du projet ; ouvrez un nouveau terminal après la modification.
401Clé non reconnue : vérifiez que vous avez copié intégralement la clé commençant par sk-kn-, qu’elle ne contient pas d’espaces superflus, qu’elle n’a pas été supprimée dans /app/keys et que vous utilisez ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL contient également /v1, ou le nom du modèle demandé ne figure pas dans la liste des modèles de Kunavo (par exemple, si les quatre variables de fixation des modèles n’ont pas été définies).

Limites à connaître

  • Kunavo n’émet pas de facture de TVA chinoise.
  • Alipay et WeChat Pay permettent uniquement les recharges manuelles ; le rechargement automatique nécessite une carte bancaire ou Link.
  • Il s’agit d’une API facturée au token, et non d’un abonnement Claude Pro/Max ; avec une clé API, Remote Control et la saisie vocale sont indisponibles. Pour choisir entre les deux, consultez les tarifs de Claude Code.
  • Kunavo n’a pas effectué de test de connectivité réseau depuis la Chine continentale. Vous devez vérifier vous-même si l’adresse d’installation de claude.ai, les registres npm, npmmirror et api.kunavo.com sont accessibles depuis votre réseau et à quelle vitesse.
  • La liste des pays et régions pris en charge par Anthropic (vérifiée le 3 octobre 2026) ne comprend pas la Chine continentale, Hong Kong ni Macao ; la documentation officielle d’installation de Claude Code classe la région où vous vous trouvez parmi les prérequis système.

Questions fréquentes

Comment installer Claude Code en Chine ? Faut-il utiliser le script d’installation officiel ou npm ?

La documentation officielle d’Anthropic indique l’installation native comme méthode recommandée : sur macOS, Linux et WSL, exécutez curl -fsSL https://claude.ai/install.sh | bash ; sous Windows, exécutez irm https://claude.ai/install.ps1 | iex dans PowerShell, ou curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd dans CMD. L’installation native se met automatiquement à jour en arrière-plan. npm (npm install -g @anthropic-ai/claude-code) reste une méthode d’installation répertoriée dans la documentation officielle et nécessite Node.js 22 ou une version ultérieure. Il faut préciser que la Chine continentale ne figure pas dans la liste des régions prises en charge par Anthropic (vérifiée le 3 octobre 2026) ; la documentation officielle d’installation indique que la région où vous vous trouvez fait partie des exigences système. Kunavo n’a pas testé l’accessibilité de ces adresses de téléchargement depuis la Chine continentale.

Quelle version de Node.js faut-il pour installer Claude Code avec npm ? Le miroir chinois (npmmirror) fonctionne-t-il ?

La documentation officielle exige Node.js 22 ou une version ultérieure, et le champ engines du paquet npm indique également >=22.0.0 ; avec une version plus ancienne de Node.js, npm affiche uniquement un avertissement EBADENGINE et l’installation se termine, car le paquet npm télécharge un programme natif qui ne dépend pas de Node.js pour s’exécuter. Si le téléchargement depuis la source par défaut échoue ou est très lent, vous pouvez ajouter --registry=https://registry.npmmirror.com à la commande d’installation, ou exécuter npm config set registry https://registry.npmmirror.com pour définir npmmirror comme source par défaut. La page d’accueil de npmmirror indique qu’il s’agit d’un miroir npmjs.com complet en lecture seule, qui s’efforce de rester synchronisé en temps réel avec la source officielle. La documentation officielle de dépannage de Claude Code rappelle que le miroir doit également fournir les 8 paquets de plateforme @anthropic-ai/claude-code-*, et que npm ne doit pas ignorer les dépendances facultatives, sinon le programme natif sera introuvable après l’installation. Le 3 octobre 2026, depuis un réseau situé hors de la Chine continentale, Kunavo a vérifié que le paquet principal ainsi que les paquets Windows x64, macOS ARM64 et Linux x64 sur npmmirror correspondent aux versions de npmjs ; les autres paquets de plateforme n’ont pas été vérifiés.

Comment installer Claude Code sous Windows ? Faut-il absolument installer WSL et Git ?

Pas nécessairement. Sous Windows natif, exécutez directement la commande d’installation correspondante dans PowerShell ou CMD ; les droits administrateur ne sont pas nécessaires. Git for Windows est facultatif : une fois installé, Claude Code utilise le Git Bash fourni avec celui-ci pour exécuter les commandes ; sinon, il utilise les outils PowerShell. Windows natif ne prend pas en charge l’exécution en sandbox ; si vous avez besoin d’une sandbox ou d’une chaîne d’outils Linux, choisissez WSL 2 et installez et lancez claude depuis le terminal WSL, et non depuis PowerShell ou CMD. N’ouvrez pas non plus PowerShell 32 bits portant la mention (x86) : Claude Code ne prend pas en charge Windows 32 bits.

Sans abonnement Claude Pro/Max et sans se connecter à un compte, peut-on utiliser directement Claude Code avec une clé API ?

Oui. La connexion à un compte Claude est nécessaire pour Pro, Max, Team, Enterprise ou un compte Console ; la version gratuite de Claude.ai n’inclut pas Claude Code. Avec une clé API, aucune connexion n’est nécessaire : définissez ANTHROPIC_BASE_URL=https://api.kunavo.com et ANTHROPIC_AUTH_TOKEN dans la configuration du shell ou dans ~/.claude/settings.json. Au démarrage, Claude Code ouvre directement une session, sans afficher de page de connexion ni demander de confirmation supplémentaire ; les tokens réellement utilisés sont déduits du solde Kunavo. Remote Control et la saisie vocale nécessitent une identité claude.ai et ne sont pas disponibles avec une clé API.

Faut-il ajouter /v1 à ANTHROPIC_BASE_URL ? Où faut-il définir la variable d’environnement pour qu’elle soit prise en compte ?

N’ajoutez rien. Claude Code ajoutera lui-même /v1/messages à la fin ; ANTHROPIC_BASE_URL doit donc contenir uniquement le domaine : https://api.kunavo.com. Si vous le faites se terminer par /v1, les requêtes seront envoyées vers /v1/v1/messages et renverront 404. Écrivez la variable dans la configuration du shell (~/.zshrc, ~/.bashrc ou $PROFILE de PowerShell) ou dans env du fichier utilisateur ~/.claude/settings.json (sous Windows : %USERPROFILE%\.claude\settings.json). Ne l’écrivez pas dans le .claude/settings.json du projet : ce fichier sera transmis à toutes les personnes qui clonent le dépôt, et en mode interactif, env au niveau du projet ne prend effet qu’après l’assistant de première configuration et l’invite de confiance envers le dossier. Si la même variable est définie à la fois dans le shell et dans le fichier settings, le fichier settings est prioritaire.

Pourquoi faut-il définir ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL et ANTHROPIC_DEFAULT_SONNET_MODEL ? Que se passe-t-il si on ne les définit pas ?

Lorsque le modèle n’est pas fixé, Claude Code utilise des alias qui évoluent avec les nouvelles versions d’Anthropic. Selon la documentation officielle de Claude Code sur la configuration des modèles (vérifiée le 3 octobre 2026), le modèle par défaut des utilisateurs de l’API et l’alias opus pointent vers Opus 5.5, tandis que l’alias sonnet pointe vers Sonnet 5.5, et ces alias sont mis à jour au fil du temps ; la méthode officielle pour les fixer consiste à écrire le nom complet du modèle ou à définir des variables telles que ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo ne fournit actuellement pas Sonnet 5.5 : sans ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la phase d’exécution d’opusplan et les sous-agents qui spécifient model: sonnet demanderont Sonnet 5.5 et renverront 404. Lorsqu’Anthropic publiera un nouvel Opus, Kunavo ne l’aura pas nécessairement encore référencé, ce qui renverra également 404. Une fois les modèles fixés, le modèle principal et l’alias sonnet sont claude-sonnet-5, l’alias opus est claude-opus-5-5 (Opus 5.5 nécessite Claude Code v2.1.280 ou une version ultérieure ; avec une ancienne version, exécutez d’abord claude update), et l’alias haiku ainsi que les tâches en arrière-plan utilisent claude-haiku-4-5. Le modèle utilisé et le tarif appliqué sont alors déterminés.

Faut-il activer CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ? Que désactive-t-il ?

Selon la documentation officielle de Claude Code sur les variables d’environnement (vérifiée le 3 octobre 2026), cette variable désactive le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d’erreurs, commande /feedback, commentaires rédigés par Claude, notes de version, vérification des badges d’état PR/MR et vérifications de disponibilité telles que le mode fast ; elle arrête également la récupération des indicateurs de fonctionnalité, ce qui rend indisponibles Remote Control et les autres fonctions qui en dépendent. La valeur 0 ou false est également considérée comme activée ; seule la suppression de la variable la désactive. Elle n’affecte pas la vérification de sécurité du domaine api.anthropic.com par l’outil WebFetch. La documentation officielle ne la décrit pas comme un paramètre lié au contrôle des comptes. Une fois activée, les mises à jour automatiques cessent ; vous devez donc effectuer régulièrement les mises à niveau vous-même. Pour une installation npm, utilisez npm install -g @anthropic-ai/claude-code@latest. Kunavo n’exige pas cette variable et elle n’affecte pas les requêtes de modèles envoyées à Kunavo. La documentation officielle des passerelles précise également que, même si ANTHROPIC_BASE_URL pointe vers une passerelle, Claude Code envoie toujours à Anthropic, GitHub et d’autres services tiers des requêtes en arrière-plan pour vérifier la version, la télémétrie et les notes de version ; si votre réseau n’autorise que l’adresse de la passerelle, ces requêtes échoueront. La méthode officielle consiste alors à définir cette variable en même temps.

Peut-on recharger le compte avec Alipay ou WeChat Pay ? Le renouvellement automatique et les factures sont-ils pris en charge ?

Vous pouvez recharger avec Alipay ou WeChat Pay : les recharges Kunavo passent par la page de paiement Stripe, où Alipay et WeChat Pay figurent parmi les modes de paiement disponibles. Depuis la Chine continentale, le montant est affiché en RMB ; la recharge minimale est de $10, sans frais mensuels. Alipay et WeChat Pay permettent uniquement les recharges manuelles ; le rechargement automatique nécessite une carte bancaire ou Link. Kunavo n’émet pas de facture de TVA chinoise ; l’historique des recharges est consultable dans la page Billing.