OpenAI Codex 安装与配置教程

OpenAI Codex 安装与配置教程

OpenAI Codex 是 OpenAI 推出的 AI 编程 CLI 工具，基于 GPT 模型，专注于代码生成、补全和编程辅助。通过 RootFlow AI 中转服务，你可以低成本使用 Codex。

前提条件

• 已注册 RootFlow AI 并获取 API Key（获取方式）
• 确保网络环境正常

系统要求

• 操作系统：Windows 10+、macOS 10.14+、Linux Ubuntu 18.04+
• Node.js ≥ 18.0（npm 安装方式需要）
• 稳定的网络连接

安装 Codex CLI

方法一：npm 全局安装（推荐）

npm install -g @openai/codex

方法二：Homebrew 安装（macOS）

brew install codex

方法三：下载二进制文件

前往 GitHub Releases 下载对应平台的二进制文件：

• macOS（Apple Silicon / x86_64）
• Linux（x86_64 / arm64）

# 下载后赋予执行权限并移动到 PATH
chmod +x codex
sudo mv codex /usr/local/bin/

验证安装

codex --version

配置环境变量

Codex 使用 OPENAI_BASE_URL 和 OPENAI_API_KEY 两个环境变量连接 RootFlow AI。

macOS / Linux

临时设置（当前会话）

export OPENAI_BASE_URL="https://api.rootflowai.com/v1"
export OPENAI_API_KEY="你的API密钥"

永久设置（推荐）

Zsh 用户（macOS 默认）：

echo 'export OPENAI_BASE_URL="https://api.rootflowai.com/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export OPENAI_BASE_URL="https://api.rootflowai.com/v1"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

Windows

方法一：PowerShell 临时设置

$env:OPENAI_BASE_URL = "https://api.rootflowai.com/v1"
$env:OPENAI_API_KEY = "你的API密钥"

方法二：CMD 临时设置

set OPENAI_BASE_URL=https://api.rootflowai.com/v1
set OPENAI_API_KEY=你的API密钥

方法三：永久设置（推荐）

setx OPENAI_BASE_URL "https://api.rootflowai.com/v1"
setx OPENAI_API_KEY "你的API密钥"

使用 setx 永久设置后，需要重新打开命令行窗口才能生效。

方法四：图形界面设置

1. 右键"此电脑" → "属性" → "高级系统设置" 2. 点击"环境变量" 3. 在"用户变量"中新建：

| 变量名 | 变量值 | |--------|--------| | OPENAI_BASE_URL | https://api.rootflowai.com/v1 | | OPENAI_API_KEY | 你的 API 密钥 |

验证设置

PowerShell：

echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY

CMD：

echo %OPENAI_BASE_URL%
echo %OPENAI_API_KEY%

macOS / Linux：

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY

Codex 配置文件（可选）

除了环境变量，你也可以通过配置文件来管理 Codex 设置。

~/.codex/config.toml

model_provider = "rootflow"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.rootflow]
name = "rootflow"
base_url = "https://api.rootflowai.com/v1"
wire_api = "responses"

~/.codex/auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

可用模型

| 模型名称 | 说明 | 推荐分组 | |----------|------|---------| | gpt-5.4 | GPT 最新旗舰 | Codex Team / Codex Plus | | gpt-5.3-codex | 编程专用（推荐） | Codex Team / Codex Plus | | gpt-5.2 | 上一代旗舰 | Codex Team / Codex Plus |

• Codex Team（0.15x）：价格极低，适合日常编程辅助
• Codex Plus（0.2x）：更高稳定性

详见 服务定价。

开始使用

cd your-project-folder
codex

如果一切配置正确，Codex 将正常启动并可以开始对话。

遇到问题？查看 常见问题排查 或加入用户群获取帮助。