Codex 安装和中转 API 配置教程

先说明：新手建议优先看 App 版教程

如果你不想折腾命令行，或者只是想先把 Codex 用起来，建议优先使用 Codex Desktop App。本站已经把桌面版拆成两篇教程：

如果你已经确定要用终端版，继续看下面的 Codex CLI 安装教程。

1. 一键安装（推荐）

1.1 先选对应系统命令

Linux / macOS：

curl -fsSL https://codexapikey.com/scripts/install-codex-cli.sh | bash

Windows PowerShell：

irm https://codexapikey.com/scripts/install-codex-cli.ps1 | iex

上面的脚本已下载并保存到本站本地域名：install-codex-cli.sh、install-codex-cli.ps1。

1.2 一键安装具体使用方法

1. 打开终端：Windows 请以管理员权限运行 PowerShell；macOS 用 Terminal；Linux 用 bash / zsh。
2. 复制并粘贴你系统对应的安装命令，回车执行。
3. 等待脚本自动完成 Node.js 检查与 Codex CLI 安装。
4. 安装完成后执行下面命令，看到版本号即表示安装成功。

codex --version

Windows 常见安装问题处理

若 Windows 提示“此系统上禁止运行脚本”或 ExecutionPolicy 相关报错，先在当前会话临时放开策略（关闭窗口即失效）：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
irm https://codexapikey.com/scripts/install-codex-cli.ps1 | iex

若 Windows 下执行安装命令后长时间无反应，可先切换 npm 源再重新安装：

# 切换为国内 npm 镜像
npm config set registry https://registry.npmmirror.com
npm config get registry

# 重新执行安装
irm https://codexapikey.com/scripts/install-codex-cli.ps1 | iex

安装完成后如需恢复官方源，可执行：

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

安装后必做：先配置 Key，CLI 才能真正使用

一键安装只负责把程序装好，不会自动帮你写入 OPENAI_API_KEY。 安装完成后请先配置 Key，再执行验证命令。

国内网络建议（推荐）

由于网络原因，部分国内用户可能无法稳定连接官网地址，建议使用中转 API Key：

https://codex.dakeai.cc/register?promo=DKAI

注册登录 DKAI 后，在 API 密钥页面创建 Codex 分组密钥，再进入“使用密钥”页面复制覆盖配置脚本。更完整的截图步骤请看 Codex 国内中转站图文配置教程。

OPENAI_API_KEY=你的中转站API_KEY
OPENAI_BASE_URL=https://codex.dakeai.cc/v1

请以 DKAI 控制台实时展示的 Base URL、模型和脚本为准；示例只用于帮助理解 Key 与 Base URL 的关系。

2. 手动安装（分步）

手动安装建议按 2.1 → 2.2 → 配置 Key 的顺序执行。

2.1 安装 Node.js 环境

Codex 需要 Node.js 环境才能运行。

Windows 安装方法

方法一：官网下载（推荐）

1. 打开浏览器访问 https://nodejs.org/
2. 点击 LTS 版本下载（推荐长期支持版本）
3. 下载完成后双击 .msi 文件
4. 按安装向导完成安装，保持默认设置即可

Windows 注意事项

• 建议使用 PowerShell，而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入：

node --version
npm --version

如果显示版本号，说明安装成功。

macOS 安装方法

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，执行：

# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载

1. 访问 https://nodejs.org/
2. 下载适合 macOS 的 LTS 版本
3. 打开下载的 .pkg 文件
4. 按安装程序指引完成安装

macOS 注意事项

• 如果遇到权限问题，可能需要使用 sudo
• 首次运行可能需要在系统偏好设置中允许
• 建议使用 Terminal 或 iTerm2

验证安装是否成功

安装完成后，打开 Terminal，输入：

node --version
npm --version

如果显示版本号，说明安装成功。

2.2 安装 Codex CLI

Node.js 安装成功后，执行：

npm install -g @openai/codex
codex --version

若 codex --version 能输出版本号，说明 Codex CLI 已安装成功。

3. 安装完成后的最小验证

CLI 安装成功并配置好 Key 后，可以在终端输入 codex 启动。第一次进入可能会有提示，按提示确认即可。

建议先问一个很小的问题，例如：

请用中文解释一下当前目录是什么项目，并告诉我下一步可以怎么开始。

如果能正常返回内容，说明安装、Key 和接口配置都已经跑通。