Due to network environment restrictions, downloading packages directly from the official NPM repository may encounter:
Configuring domestic mirror sources can significantly improve installation speed and success rate.
Recommended domestic mirror sources:
| Mirror Source | URL | Maintainer | Recommendation |
|---|---|---|---|
| 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 | ⭐⭐⭐ |
# Set Taobao mirror
npm config set registry https://registry.npmmirror.com
# Verify configuration
npm config get registry
# Test installation speed
npm install -g @anthropic-ai/claude-code
# Set Tencent mirror
npm config set registry https://mirrors.cloud.tencent.com/npm
# Verify configuration
npm config get registry
# Set Huawei mirror
npm config set registry https://mirrors.huaweicloud.com/repository/npm
# Verify configuration
npm config get registry
Create .npmrc file in user home directory or project root directory:
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
# Temporarily use Taobao mirror to install packages
npm install --registry=https://registry.npmmirror.com @anthropic-ai/claude-code
# Or use npx
npx --registry=https://registry.npmmirror.com @anthropic-ai/claude-code --version
CNPM is an NPM client developed by Taobao team, using domestic mirror by default:
# Install CNPM
npm install -g cnpm --registry=https://registry.npmmirror.com
# Use CNPM to install packages
cnpm install -g @anthropic-ai/claude-code
# Verify version
cnpm --version
If you use Yarn package manager:
# Set Yarn mirror source
yarn config set registry https://registry.npmmirror.com
# Verify configuration
yarn config get registry
# Install Claude Code
yarn global add @anthropic-ai/claude-code
If you use PNPM package manager:
# Set PNPM mirror source
pnpm config set registry https://registry.npmmirror.com
# Verify configuration
pnpm config get registry
# Install Claude Code
pnpm add -g @anthropic-ai/claude-code
For enterprise environments, you may need to configure proxy or private mirror:
# HTTP proxy
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# Authentication proxy
npm config set proxy http://username:[email protected]:8080
npm config set https-proxy http://username:[email protected]:8080
# SOCKS proxy
npm config set proxy socks://proxy.company.com:1080
# Set private mirror
npm config set registry http://npm.company.com
# Configure scoped packages
npm config set @company:registry http://npm.company.com
# View current configuration
npm config list
# View mirror source
npm config get registry
# View complete configuration
npm config ls -l | grep registry
# Clear cache
npm cache clean --force
# Test installation time
time npm install -g @anthropic-ai/claude-code
# View installation log
npm install -g @anthropic-ai/claude-code --verbose
Symptom:
npm ERR! network request to https://registry.npmmirror.com failed
Solution:
# Switch to other mirror source
npm config set registry https://mirrors.cloud.tencent.com/npm
# Or restore official source
npm config set registry https://registry.npmjs.org
Symptom:
npm ERR! certificate verify failed
Solution:
# Temporarily ignore SSL verification (not recommended)
npm config set strict-ssl false
# Or set certificate file
npm config set ca ""
npm config set cafile /path/to/certificate.pem
Symptom: Installation failure or extremely slow speed
Solution:
# Clear proxy configuration
npm config delete proxy
npm config delete https-proxy
# Reset mirror
npm config set registry https://registry.npmmirror.com
Solution:
# Clear configuration cache
npm cache clean --force
# Delete node_modules and reinstall
rm -rf node_modules package-lock.json
npm install
# Check configuration file location
npm config get userconfig
npm config get globalconfig
If you need to restore to official mirror source:
# Restore official mirror
npm config set registry https://registry.npmjs.org
# Delete custom configuration
npm config delete registry
# Or directly edit configuration file
npm config edit
After configuration is complete, the installation and update speed of Claude Code should be significantly improved!