Codex 配置​

Codex 可以通过 Responses API 接入 yuyuflow。配置前请先完成 快速开始，准备好 Node.js、Git、API Key 和控制台中可用的模型名。

推荐使用 CC-Switch

推荐先阅读 CC-Switch 配置，使用 CC-Switch 管理 Codex provider、API Key 和模型切换。这样可以减少手动编辑配置文件的次数；如果你不使用 CC-Switch，也可以按下面的步骤手动配置。

前置条件​

确认 Node.js 和 Git 已安装，并在终端执行：

powershell
node --version
npm --version
git --version

在 控制台 创建一个专用 API Key，并确认目标模型支持 Responses API。不要把真实密钥写入代码仓库。

安装 Codex​

powershell
npm install -g @openai/codex

安装完成后，Windows 默认配置目录为：

text
C:\Users\<你的用户名>\.codex\config.toml
C:\Users\<你的用户名>\.codex\auth.json

手动配置 Codex​

config.toml​

将下面内容写入 config.toml。其中 https://art-api.yuyuflow.com 会在构建时替换为当前文档品牌对应的 API 地址；platform 只是本地 provider 标识，不代表固定品牌：

toml
model = "YOUR_MODEL"
model_provider = "platform"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.platform]
name = "codex"
base_url = "https://art-api.yuyuflow.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json​

将 API Key 写入 auth.json：

json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

API Key 安全要求

auth.json 包含高敏感凭证。不要把它提交到 Git，不要通过聊天、Issue 或截图分享；建议限制文件权限，并为生产环境使用专用令牌。

验证 Codex​

在项目目录运行：

powershell
codex

进入 Codex 后发送一个简单请求，确认模型能够正常返回结果。如果使用 CC-Switch，请先切换到对应 provider，再执行同样的验证。

常见问题​

模型不可用

确认 model 与控制台中的完整模型 ID 一致，并检查 API Key 所属令牌分组是否有权限。model_provider 和 [model_providers.*] 中的 platform 是本地配置名，可以按团队习惯修改，但两处必须保持一致。

鉴权失败

确认 auth.json 中的字段名为 OPENAI_API_KEY，密钥未过期，且没有把 Bearer 前缀重复写入密钥值。

连接超时或接口路径错误

确认 base_url 使用当前平台地址，并检查是否重复添加 /v1。先回到快速开始用 cURL 验证，再排查 Codex 配置。

下一步可阅读 LLM 配置 或 Claude Code 配置。