Codex/ChatGPT

适合Codex CLI终端, Codex桌面版，以及VSCode,Cursor等编辑器插件

# 准备工作

开始前请确认你已获取：

• API 密钥：在 API 密钥 页面创建一把 sk-rf-... 形式的密钥

# 方案 A：已安装RelayFlows客户端

直接点击客户端里面的“启用”按钮，全自动配置完成。首次启动需要填写API密钥，填写您自己生成的密钥即可

# 方案 B：手动配置（如习惯自己修改配置文件）

# macOS / Linux / WSL

Codex CLI 需要两个配置文件：

# macOS / Linux / WSL

# 配置 ~/.codex/config.toml

model_provider = "relayflows"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"

[model_providers.relayflows]
name = "RelayFlows"
base_url = "https://api.relayflows.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "sk-rf-你的密钥"

# 配置 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-rf-你的密钥"
}

# 提示

• 配置目录不存在时先创建：mkdir -p ~/.codex
• wire_api = "responses" 走的是 OpenAI 新的 Responses API，RelayFlows 完全兼容
• experimental_bearer_token 和 auth.json 里填同一把密钥。前者优先级更高，也是防呆的关键：如果你以前用 codex login 登录过 OpenAI 官方账号，auth.json 里留着的是 ChatGPT 凭据，没有这一行的话 Codex 会把那份凭据当成 RelayFlows 密钥发出去
• model 可改成其他你已开通的模型，见文末「切换模型」

# Windows

# 配置 %USERPROFILE%\.codex\config.toml

内容同 macOS。

# 配置 %USERPROFILE%\.codex\auth.json

{
  "OPENAI_API_KEY": "sk-rf-你的密钥"
}

配置目录可通过 Win + R → 输入 %USERPROFILE%\.codex 打开。如果目录不存在请先手动创建。

# 验证

新开终端：

codex "用 Python 写一个 fibonacci"

进 用量统计 确认请求计入。

# 切换模型

config.toml 顶部的 model = "..." 改成你想用的 ID，例如：

• gpt-5.6-sol — 旗舰，默认值
• gpt-5.6-terra — 中档，长上下文任务性价比更高
• gpt-5.6-luna — 轻量，适合简单改动和批量任务

review_model 是 /review 单独用的模型，默认给的是 gpt-5.6-terra —— 代码审查大多是长上下文通读，降一档更划算。

具体能用哪些以你所在分组开通的为准，在 API 密钥 页面可以看到。