安装 Codex

本页只讲如何手动安装 Codex CLI。新手建议先使用 Codex 安装向导，让页面按你的系统生成命令。

适合谁看

• 只想安装 Codex，不安装 Claude Code。
• 不想使用一键安装器。
• 已经熟悉命令行，只需要确认安装和验证步骤。

开始前准备

Codex CLI 可以通过官方安装方式或 npm 安装。先检查你的终端：

node -v
npm -v

如果能看到版本号，可以使用 npm 方案。如果没有 Node.js，也可以在安装向导里选择官方脚本或系统安装方式。

系统	建议
Windows	优先试 winget install OpenAI.Codex，失败后再用 npm
macOS	优先使用官方脚本或 Homebrew，备用 npm
Linux	优先使用官方脚本，备用 npm

安装命令

npm 方案：

npm install -g @openai/codex

macOS 或 Linux 如果遇到权限问题，先确认 Node.js 安装方式；确实需要系统权限时再使用：

sudo npm install -g @openai/codex

Windows 如果提示权限不足，请右键 PowerShell 或 Windows Terminal，选择“以管理员身份运行”后重试。

验证安装

codex --version

能显示版本号，就说明 Codex CLI 安装成功。

下一步配置中转

安装成功后，还需要写入 Elucid Relay 的 API Key 和 Base URL。

推荐使用 Codex 安装向导按系统生成安装、配置、验证命令。备用手动配置 Codex直接修改 config.toml、环境变量或 auth.json。

常见问题

现象	处理方式
npm 不存在	重新安装 Node.js LTS，并重新打开终端
安装很慢	换网络环境后重试
权限不足	Windows 用管理员终端；macOS / Linux 先检查 Node 安装方式
codex --version 不存在	关闭终端重开，或检查安装目录是否在 PATH