A causa delle limitazioni dell'ambiente di rete, il download diretto dei pacchetti dal repository ufficiale NPM potrebbe incontrare:
La configurazione dei mirror cinesi può migliorare significativamente la velocità di installazione e il tasso di successo.
Si consiglia di utilizzare i seguenti mirror cinesi:
| Mirror | URL | Mantenitore | Raccomandazione |
|---|---|---|---|
| Taobao Mirror | https://registry.npmmirror.com | Taobao Team | ⭐⭐⭐⭐⭐ |
| Tencent Mirror | https://mirrors.cloud.tencent.com/npm | Tencent Cloud | ⭐⭐⭐⭐ |
| Huawei Mirror | https://mirrors.huaweicloud.com/repository/npm | Huawei Cloud | ⭐⭐⭐⭐ |
| USTC Mirror | https://npmreg.proxy.ustclug.org | USTC LUG | ⭐⭐⭐ |
# Imposta Taobao mirror
npm config set registry https://registry.npmmirror.com
# Verifica configurazione
npm config get registry
# Testa velocità di installazione
npm install -g @anthropic-ai/claude-code
# Imposta Tencent mirror
npm config set registry https://mirrors.cloud.tencent.com/npm
# Verifica configurazione
npm config get registry
# Imposta Huawei mirror
npm config set registry https://mirrors.huaweicloud.com/repository/npm
# Verifica configurazione
npm config get registry
Crea un file .npmrc nella directory home dell'utente o nella directory radice del progetto:
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
# Usa temporaneamente Taobao mirror per installare i pacchetti
npm install --registry=https://registry.npmmirror.com @anthropic-ai/claude-code
# Oppure usa npx
npx --registry=https://registry.npmmirror.com @anthropic-ai/claude-code --version
CNPM è un client NPM sviluppato dal team Taobao, che utilizza di default i mirror cinesi:
# Installa CNPM
npm install -g cnpm --registry=https://registry.npmmirror.com
# Usa CNPM per installare i pacchetti
cnpm install -g @anthropic-ai/claude-code
# Verifica versione
cnpm --version
Se utilizzi il gestore di pacchetti Yarn:
# Imposta mirror Yarn
yarn config set registry https://registry.npmmirror.com
# Verifica configurazione
yarn config get registry
# Installa Claude Code
yarn global add @anthropic-ai/claude-code
Se utilizzi il gestore di pacchetti PNPM:
# Imposta mirror PNPM
pnpm config set registry https://registry.npmmirror.com
# Verifica configurazione
pnpm config get registry
# Installa Claude Code
pnpm add -g @anthropic-ai/claude-code
Per ambienti aziendali, potrebbe essere necessario configurare proxy o mirror privati:
# Proxy HTTP
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# Proxy con autenticazione
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
# Imposta mirror privato
npm config set registry http://npm.company.com
# Configura pacchetti con scope
npm config set @company:registry http://npm.company.com
# Visualizza configurazione corrente
npm config list
# Visualizza mirror
npm config get registry
# Visualizza configurazione completa
npm config ls -l | grep registry
# Pulisci cache
npm cache clean --force
# Testa tempo di installazione
time npm install -g @anthropic-ai/claude-code
# Visualizza log di installazione
npm install -g @anthropic-ai/claude-code --verbose
Sintomi:
npm ERR! network request to https://registry.npmmirror.com failed
Soluzione:
# Passa ad altro mirror
npm config set registry https://mirrors.cloud.tencent.com/npm
# Oppure ripristina mirror ufficiale
npm config set registry https://registry.npmjs.org
Sintomi:
npm ERR! certificate verify failed
Soluzione:
# Ignora temporaneamente verifica SSL (non consigliato)
npm config set strict-ssl false
# Oppure imposta file certificato
npm config set ca ""
npm config set cafile /path/to/certificate.pem
Sintomi: Installazione fallita o estremamente lenta
Soluzione:
# Rimuovi configurazione proxy
npm config delete proxy
npm config delete https-proxy
# Reimposta mirror
npm config set registry https://registry.npmmirror.com
Soluzione:
# Pulisci cache configurazione
npm cache clean --force
# Rimuovi node_modules e reinstalla
rm -rf node_modules package-lock.json
npm install
# Verifica posizione file di configurazione
npm config get userconfig
npm config get globalconfig
Se è necessario ripristinare il mirror ufficiale:
# Ripristina mirror ufficiale
npm config set registry https://registry.npmjs.org
# Elimina configurazione personalizzata
npm config delete registry
# Oppure modifica direttamente il file di configurazione
npm config edit
Dopo aver completato la configurazione, la velocità di installazione e aggiornamento di Claude Code dovrebbe migliorare significativamente!