Node.js / npm 国内镜像配置教程

本文档适用于中国大陆网络环境，用于解决 npm 包下载缓慢、连接超时、安装卡死等问题，可在安装 Codex、Claude Code 等 CLI 工具前执行镜像切换操作。当执行 npm 安装命令长时间转圈、无响应时，优先按照本文流程配置国内镜像，配置完成后重新执行安装指令即可。

适用范围：涉及账户、Key、模型、计费或接口的内容，请以 GPT88 当前控制台和对应 API 文档为准。

GPT88 使用说明 配置界面、客户端字段和连通性检查以 GPT88 当前接入文档为准。

快速开始 · 模型导航 · GPT88 API Key 管理

文档概述

出现以下任意一种情况，建议配置 npm 国内镜像：

在终端执行镜像配置命令：

npm config set registry https://registry.npmmirror.com

执行完成后，通过校验命令确认配置生效：

npm config get registry

校验成功标准输出：

https://registry.npmmirror.com/

输出匹配即代表国内镜像配置完成。

镜像配置完成后，回到对应产品安装文档重新执行安装指令。示例1：全局安装 Codex

npm i -g @openai/codex

示例2：全局安装 Claude Code

npm install -g @anthropic-ai/claude-code

补充说明：macOS / Linux 系统安装命令带有 sudo 前缀的，执行时保留 sudo。

若切换镜像后下载速度仍不理想，可先强制清理 npm 缓存，再重新执行安装：

npm cache clean --force

如需切回 npm 海外官方仓库，执行恢复命令：

npm config set registry https://registry.npmjs.org/

再次校验当前源地址：

npm config get registry

恢复成功标准输出：

https://registry.npmjs.org/

npm 国内镜像仅优化包文件下载速度，不会修改 GPT88 的 Base URL、API Key、Codex / Claude Code 模型相关配置参数，不会影响接口鉴权与模型调用逻辑。