Из-за ограничений сетевой среды прямая загрузка пакетов из официального репозитория NPM может столкнуться с:
Настройка зеркальных источников в Китае может значительно повысить скорость установки и успешность.
Рекомендуется использовать следующие зеркальные источники в Китае:
| Зеркальный источник | URL | Поддерживается | Рекомендация |
|---|---|---|---|
| Зеркало Taobao | https://registry.npmmirror.com | Команда Taobao | ⭐⭐⭐⭐⭐ |
| Зеркало Tencent | https://mirrors.cloud.tencent.com/npm | Tencent Cloud | ⭐⭐⭐⭐ |
| Зеркало Huawei | https://mirrors.huaweicloud.com/repository/npm | Huawei Cloud | ⭐⭐⭐⭐ |
| Зеркало USTC | https://npmreg.proxy.ustclug.org | USTC LUG | ⭐⭐⭐ |
# Установка зеркала Taobao
npm config set registry https://registry.npmmirror.com
# Проверка конфигурации
npm config get registry
# Тестирование скорости установки
npm install -g @anthropic-ai/claude-code
# Установка зеркала Tencent
npm config set registry https://mirrors.cloud.tencent.com/npm
# Проверка конфигурации
npm config get registry
# Установка зеркала Huawei
npm config set registry https://mirrors.huaweicloud.com/repository/npm
# Проверка конфигурации
npm config get registry
Создайте файл .npmrc в домашнем каталоге пользователя или корневом каталоге проекта:
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
# Временное использование зеркала Taobao для установки пакета
npm install --registry=https://registry.npmmirror.com @anthropic-ai/claude-code
# Или использовать npx
npx --registry=https://registry.npmmirror.com @anthropic-ai/claude-code --version
CNPM - это клиент NPM, разработанный командой Taobao, по умолчанию использует зеркало в Китае:
# Установка CNPM
npm install -g cnpm --registry=https://registry.npmmirror.com
# Использование CNPM для установки пакета
cnpm install -g @anthropic-ai/claude-code
# Проверка версии
cnpm --version
Если вы используете менеджер пакетов Yarn:
# Установка зеркального источника Yarn
yarn config set registry https://registry.npmmirror.com
# Проверка конфигурации
yarn config get registry
# Установка Claude Code
yarn global add @anthropic-ai/claude-code
Если вы используете менеджер пакетов PNPM:
# Установка зеркального источника PNPM
pnpm config set registry https://registry.npmmirror.com
# Проверка конфигурации
pnpm config get registry
# Установка Claude Code
pnpm add -g @anthropic-ai/claude-code
Для корпоративной среды может потребоваться настройка прокси или частного зеркала:
# HTTP прокси
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# Прокси с аутентификацией
npm config set proxy http://username:[email protected]:8080
npm config set https-proxy http://username:[email protected]:8080
# SOCKS прокси
npm config set proxy socks://proxy.company.com:1080
# Установка частного зеркала
npm config set registry http://npm.company.com
# Конфигурация scoped пакетов
npm config set @company:registry http://npm.company.com
# Просмотр текущей конфигурации
npm config list
# Просмотр зеркального источника
npm config get registry
# Просмотр полной конфигурации
npm config ls -l | grep registry
# Очистка кэша
npm cache clean --force
# Тестирование времени установки
time npm install -g @anthropic-ai/claude-code
# Просмотр журнала установки
npm install -g @anthropic-ai/claude-code --verbose
Симптомы:
npm ERR! network request to https://registry.npmmirror.com failed
Решение:
# Переключение на другой зеркальный источник
npm config set registry https://mirrors.cloud.tencent.com/npm
# Или восстановление официального источника
npm config set registry https://registry.npmjs.org
Симптомы:
npm ERR! certificate verify failed
Решение:
# Временное игнорирование проверки SSL (не рекомендуется)
npm config set strict-ssl false
# Или установка файла сертификата
npm config set ca ""
npm config set cafile /path/to/certificate.pem
Симптомы: Неудачная установка или очень медленная
Решение:
# Удаление конфигурации прокси
npm config delete proxy
npm config delete https-proxy
# Повторная настройка зеркала
npm config set registry https://registry.npmmirror.com
Решение:
# Очистка кэша конфигурации
npm cache clean --force
# Удаление node_modules и переустановка
rm -rf node_modules package-lock.json
npm install
# Проверка расположения файла конфигурации
npm config get userconfig
npm config get globalconfig
Если нужно восстановить официальный зеркальный источник:
# Восстановление официального зеркала
npm config set registry https://registry.npmjs.org
# Удаление пользовательской конфигурации
npm config delete registry
# Или непосредственное редактирование файла конфигурации
npm config edit
После завершения конфигурации скорость установки и обновления Claude Code должна значительно повыситься!