撩梦文档

Appearance

Codex App / CLI 接入教程 ​

Codex 可以在 ~/.codex/config.toml 中添加自定义模型提供商。本教程使用撩梦中转站的 deepseek-v4-flash。

必须支持 Responses API

Codex 自定义 Provider 使用 Responses API，也就是会请求 https://api.iruoke.top/v1/responses。能调用 /chat/completions 不代表一定兼容 Codex。

第 1 步：创建专用 API Key ​

在撩梦中转站「API 密钥」页面创建一个只给 Codex 使用的 Key。这样发生泄露时，可以单独停用，不影响其他软件。

已经公开过完整 Key？

如果完整 API Key 曾出现在聊天、截图或公开文件中，请立即到「API 密钥」停用或删除它，再创建一个新的 Key。不要继续使用已经泄露的 Key。

第 2 步：找到配置文件 ​

macOS 和 Linux 的用户级配置文件是：

text
~/.codex/config.toml

Windows 通常对应：

text
C:\Users\你的用户名\.codex\config.toml

如果文件不存在，可以在 .codex 文件夹中新建 config.toml。

第 3 步：填写 Codex 配置 ​

把下面内容写入配置文件。必须把 YOUR_API_KEY 换成你新创建的 Key，不要复制任何教程中的示例 Key。

toml
model = "deepseek-v4-flash"
model_provider = "iruoke"

[model_providers.iruoke]
name = "Iruoke API"
base_url = "https://api.iruoke.top/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "YOUR_API_KEY"

字段含义：

字段作用
model要使用的模型 ID
model_provider选择下面名为 iruoke 的自定义提供商
base_url撩梦中转站 API 基础地址
wire_apiCodex 当前使用 responses 协议
requires_openai_auth不使用 OpenAI 官方账号认证
experimental_bearer_token直接提供撩梦中转站 API Key

更安全的保存方式

Codex 官方配置参考明确说明，experimental_bearer_token 是不推荐的直接令牌方式，优先建议使用 env_key。上面的写法适合先验证连接，但不要把 config.toml 上传到 GitHub 或发给别人。

可选：改用环境变量保存 Key ​

希望避免把 Key 明文写进配置文件时，可以改成：

toml
model = "deepseek-v4-flash"
model_provider = "iruoke"

[model_providers.iruoke]
name = "Iruoke API"
base_url = "https://api.iruoke.top/v1"
wire_api = "responses"
env_key = "IRUOKE_API_KEY"

然后在系统中设置 IRUOKE_API_KEY。例如 macOS / Linux 当前终端：

bash
export IRUOKE_API_KEY="YOUR_API_KEY"

Windows PowerShell 当前窗口：

powershell
$env:IRUOKE_API_KEY="YOUR_API_KEY"

第 4 步：彻底重启 Codex ​

保存配置后，彻底退出 Codex App，再重新打开。只关闭当前对话或窗口可能不会重新加载配置。

如果使用 CLI，也应先关闭原来的 Codex 进程，再打开一个新终端。

第 5 步：运行最小测试 ​

在终端执行：

bash
codex exec "只回复OK"

如果输出 OK，说明 Codex 已经读取新配置，并且模型能够通过 Responses API 工作。

常见问题 ​

修改后仍然使用旧模型 ​

确认修改的是当前用户的 ~/.codex/config.toml，保存后彻底退出并重新打开 Codex App。

401 / Unauthorized ​

检查 API Key 是否完整、是否已经停用，以及配置中是否仍保留了 YOUR_API_KEY 占位符。

404、405 或 Responses 相关错误 ​

这通常说明当前渠道没有提供 Codex 需要的 /v1/responses 兼容接口。不要把 wire_api 改成 chat/completions；Codex 自定义 Provider 当前只支持 responses。

Chat Completions 能用，但 Codex 不能用 ​

这是两种不同接口。WorkBuddy、Cline 等软件能通过 /v1/chat/completions 对话，不代表同一个模型一定能通过 /v1/responses 运行 Codex。

参考 ​

撩梦中转站 · Simple API, More Possibilities.

© 2026 撩梦中转站