即梦AI生成
459 字
2 分钟
Codex 和 Claude Code 安装指南(含国内镜像切换)
更新时间:2026-03-08
适用:macOS / Linux / Windows(建议 WSL)
这篇文章给你一套可直接复制执行的流程,目标是:
- 安装 OpenAI 的 Codex CLI
- 安装 Anthropic 的 Claude Code
- 在中国网络环境下切换到国内 npm 镜像,加速安装
- 安装完成后可随时切回官方源
1. 前置检查
先确认 Node.js 和 npm:
node -vnpm -v如果 Node 版本低于 18,先升级到 Node 18+(建议 LTS)。
2. 切换到国内 npm 镜像(关键)
先看当前 npm 源:
npm config get registry切换到 npmmirror:
npm config set registry https://registry.npmmirror.comnpm config get registry如果你也用 pnpm,建议一起切换:
pnpm config set registry https://registry.npmmirror.compnpm config get registry3. 安装 Codex(OpenAI)
官方 npm 安装命令:
npm install -g @openai/codex验证安装:
codex --version首次登录:
codex按提示在浏览器完成账号授权即可。
4. 安装 Claude Code(Anthropic)
Claude Code 官方现在推荐原生安装器(native installer):
curl -fsSL https://claude.ai/install.sh | bashclaude --version首次登录:
claude4.1 国内网络备用方案:用 npm 安装 Claude Code
如果原生安装器网络不稳定,可临时用 npm 方式(已在官方文档中标记为 deprecated,仅作兼容方案):
npm install -g @anthropic-ai/claude-codeclaude --version后续网络稳定后,可迁移回原生安装器。
5. 常用验证命令
codex --versionclaude --versionclaude doctor6. 用完后切回官方源
npm config set registry https://registry.npmjs.orgnpm config get registry如果你改过 pnpm,也切回去:
pnpm config set registry https://registry.npmjs.orgpnpm config get registry7. 常见问题
7.1 command not found
新开一个终端后再试;或检查全局 bin 是否在 PATH 中。
7.2 全局安装权限报错
不要使用 sudo npm install -g。优先修正 npm 全局目录权限,或使用 nvm 管理 Node。
7.3 WSL 环境安装 Claude Code 异常
优先使用 Linux 内的 Node/npm,不要混用 Windows 的 Node 路径。
8. 官方参考
- OpenAI Codex CLI(GitHub):https://github.com/openai/codex
- Claude Code 安装文档:https://code.claude.com/docs/en/getting-started
Codex 和 Claude Code 安装指南(含国内镜像切换)
https://blog.124602.xyz/posts/codex-claude-code-install-cn-mirror/