En raison des limitations de l'environnement réseau, le téléchargement direct de paquets depuis le dépôt officiel NPM peut rencontrer :
La configuration de miroirs chinois peut considérablement améliorer la vitesse d'installation et le taux de réussite.
Il est recommandé d'utiliser les miroirs chinois suivants :
| Miroir | URL | Mainteneur | Recommandation |
|---|---|---|---|
| Miroir Taobao | https://registry.npmmirror.com | Taobao Team | ⭐⭐⭐⭐⭐ |
| Miroir Tencent | https://mirrors.cloud.tencent.com/npm | Tencent Cloud | ⭐⭐⭐⭐ |
| Miroir Huawei | https://mirrors.huaweicloud.com/repository/npm | Huawei Cloud | ⭐⭐⭐⭐ |
| Miroir USTC | https://npmreg.proxy.ustclug.org | USTC LUG | ⭐⭐⭐ |
# Configurer le miroir Taobao
npm config set registry https://registry.npmmirror.com
# Vérifier la configuration
npm config get registry
# Tester la vitesse d'installation
npm install -g @anthropic-ai/claude-code
# Configurer le miroir Tencent
npm config set registry https://mirrors.cloud.tencent.com/npm
# Vérifier la configuration
npm config get registry
# Configurer le miroir Huawei
npm config set registry https://mirrors.huaweicloud.com/repository/npm
# Vérifier la configuration
npm config get registry
Créez un fichier .npmrc dans le répertoire personnel ou le répertoire racine du projet :
registry=https://registry.npmmirror.com
disturl=https://npmmirror.com/dist
chromedriver_cdnurl=https://npmmirror.com/mirrors/chromedriver
couchbase_binary_host_mirror=https://npmmirror.com/mirrors/couchbase/v{version}
debug_binary_host_mirror=https://npmmirror.com/mirrors/node-inspector
electron_mirror=https://npmmirror.com/mirrors/electron/
flow_binary_host_mirror=https://npmmirror.com/mirrors/flow/v
fse_binary_host_mirror=https://npmmirror.com/mirrors/fsevents
fuse_bindings_binary_host_mirror=https://npmmirror.com/mirrors/fuse-bindings/v{version}
git4win_mirror=https://npmmirror.com/mirrors/git-for-windows
gl_binary_host_mirror=https://npmmirror.com/mirrors/gl/v{version}
grpc_node_binary_host_mirror=https://npmmirror.com/mirrors
hadoop_js_binary_host_mirror=https://npmmirror.com/mirrors/hadoop-js/v{version}
leveldown_binary_host_mirror=https://npmmirror.com/mirrors/leveldown/v{version}
leveldown_hyper_binary_host_mirror=https://npmmirror.com/mirrors/leveldown-hyper/v{version}
mknod_binary_host_mirror=https://npmmirror.com/mirrors/mknod/v{version}
node_sqlite3_binary_host_mirror=https://npmmirror.com/mirrors
nodegit_binary_host_mirror=https://npmmirror.com/mirrors/nodegit/v{version}/
operadriver_cdnurl=https://npmmirror.com/mirrors/operadriver
phantomjs_cdnurl=https://npmmirror.com/mirrors/phantomjs
profiler_binary_host_mirror=https://npmmirror.com/mirrors/node-inspector/
puppeteer_download_host=https://npmmirror.com/mirrors
python_mirror=https://npmmirror.com/mirrors/python
rabin_binary_host_mirror=https://npmmirror.com/mirrors/rabin/v{version}
sass_binary_site=https://npmmirror.com/mirrors/node-sass
sodium_prebuilt_binary_host_mirror=https://npmmirror.com/mirrors/sodium-prebuilt/v{version}
sqlite3_binary_site=https://npmmirror.com/mirrors/sqlite3
utf_8_validate_binary_host_mirror=https://npmmirror.com/mirrors/utf-8-validate/v{version}
uws_binary_host_mirror=https://npmmirror.com/mirrors/uws/v{version}
zmq_prebuilt_binary_host_mirror=https://npmmirror.com/mirrors/zmq-prebuilt/v{version}
registry=https://registry.npmmirror.com
# Utiliser temporairement le miroir Taobao pour installer un paquet
npm install --registry=https://registry.npmmirror.com @anthropic-ai/claude-code
# Ou utiliser npx
npx --registry=https://registry.npmmirror.com @anthropic-ai/claude-code --version
CNPM est un client NPM développé par l'équipe Taobao, utilisant par défaut les miroirs chinois :
# Installer CNPM
npm install -g cnpm --registry=https://registry.npmmirror.com
# Utiliser CNPM pour installer des paquets
cnpm install -g @anthropic-ai/claude-code
# Vérifier la version
cnpm --version
Si vous utilisez le gestionnaire de paquets Yarn :
# Configurer le miroir Yarn
yarn config set registry https://registry.npmmirror.com
# Vérifier la configuration
yarn config get registry
# Installer Claude Code
yarn global add @anthropic-ai/claude-code
Si vous utilisez le gestionnaire de paquets PNPM :
# Configurer le miroir PNPM
pnpm config set registry https://registry.npmmirror.com
# Vérifier la configuration
pnpm config get registry
# Installer Claude Code
pnpm add -g @anthropic-ai/claude-code
Pour les environnements d'entreprise, il peut être nécessaire de configurer un proxy ou des miroirs privés :
# Proxy HTTP
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# Proxy avec authentification
npm config set proxy http://username:[email protected]:8080
npm config set https-proxy http://username:[email protected]:8080
# Proxy SOCKS
npm config set proxy socks://proxy.company.com:1080
# Configurer un miroir privé
npm config set registry http://npm.company.com
# Configurer les paquets avec scope
npm config set @company:registry http://npm.company.com
# Voir la configuration actuelle
npm config list
# Voir le miroir
npm config get registry
# Voir la configuration complète
npm config ls -l | grep registry
# Nettoyer le cache
npm cache clean --force
# Tester le temps d'installation
time npm install -g @anthropic-ai/claude-code
# Voir le journal d'installation
npm install -g @anthropic-ai/claude-code --verbose
Symptômes :
npm ERR! network request to https://registry.npmmirror.com failed
Solution :
# Passer à un autre miroir
npm config set registry https://mirrors.cloud.tencent.com/npm
# Ou restaurer le miroir officiel
npm config set registry https://registry.npmjs.org
Symptômes :
npm ERR! certificate verify failed
Solution :
# Ignorer temporairement la vérification SSL (non recommandé)
npm config set strict-ssl false
# Ou configurer le fichier de certificat
npm config set ca ""
npm config set cafile /path/to/certificate.pem
Symptômes : Installation échouée ou extrêmement lente
Solution :
# Supprimer la configuration du proxy
npm config delete proxy
npm config delete https-proxy
# Reconfigurer le miroir
npm config set registry https://registry.npmmirror.com
Solution :
# Nettoyer le cache de configuration
npm cache clean --force
# Supprimer node_modules et réinstaller
rm -rf node_modules package-lock.json
npm install
# Vérifier l'emplacement du fichier de configuration
npm config get userconfig
npm config get globalconfig
Si vous devez restaurer le miroir officiel :
# Restaurer le miroir officiel
npm config set registry https://registry.npmjs.org
# Supprimer la configuration personnalisée
npm config delete registry
# Ou éditer directement le fichier de configuration
npm config edit
Après avoir terminé la configuration, la vitesse d'installation et de mise à jour de Claude Code devrait être considérablement améliorée !