前置条件
- 已安装 Codex 桌面端
- 已在桌面应用中完成至少一次官方 ChatGPT 或 Codex 登录
- Flatkey API 密钥——在 Flatkey 控制台中创建
- Flatkey 模型目录中的受支持模型 ID
- 如果使用 CC Switch 配置，需要 CC Switch v3.16.1 或更高版本，建议使用最新版
手工配置
1. 设置 API 密钥
将密钥保存在用户环境变量中，不要写入配置文件。2. 更新 config.toml
打开用户级 Codex 配置文件：
更新顶层的
model 和 model_provider 设置。如果其中任一键已存在，请替换它的值，不要追加重复键。保留所有无关设置。然后添加下方供应商配置表；如果 [model_providers.flatkey] 已存在，请更新该表，不要重复创建：
gpt-5.4 已在 Flatkey 模型目录中提供。切换到其他模型 ID 前，请先查阅模型目录。
3. 重启并验证
完全退出 Codex 桌面端，重新打开并发送一条简单提示。打开 Flatkey 用量日志，确认模型、token 数量、延迟和费用。使用 CC Switch 配置
CC Switch 是第三方桌面配置管理器，也可以从其官方 GitHub 仓库下载。- 打开 Codex 桌面端，并至少完成一次官方 ChatGPT 或 Codex 登录。
- 在 CC Switch 中启用设置 → 通用 → Codex App 增强 → 直连切换时保持官方登录。在 v3.16.1–v3.16.x 中，该选项名为切换第三方供应商时保持官方登录。
- 打开 Codex 面板，添加名为
Flatkey的自定义供应商。 - 将 Base URL 设为
https://router.flatkey.ai/v1。 - 选择 OpenAI Responses 协议。
- 输入 Flatkey API 密钥，并选择受支持的模型，例如
gpt-5.4。 - 启用该供应商，完全退出 Codex 桌面端后重新打开。
- 发送一条简单提示，并在 Flatkey 用量日志中验证请求。
Flatkey 直接支持 Responses 路由。除非未来的供应商变更明确要求协议转换，否则不要启用 CC Switch 本地路由。
如果模型不可见
Codex 桌面端的模型选择器可能依赖官方登录状态和应用当前的模型目录。选择器中缺少自定义模型，并不能证明供应商配置失败。- 确认官方 ChatGPT 或 Codex 登录仍然有效。
- 在 CC Switch 中确认已启用直连切换时保持官方登录。在 v3.16.1–v3.16.x 中，请确认旧版的切换第三方供应商时保持官方登录选项。
- 确认
config.toml中的model_provider = "flatkey"和目标模型 ID。 - 完全退出并重新打开 Codex 桌面端。
- 使用 Flatkey 用量日志验证实际请求由哪个供应商处理。
config.toml 或 CC Switch 中的当前供应商决定请求路由。
切回官方供应商
在 CC Switch 中启用官方 Codex 供应商，然后重启 Codex 桌面端。手工配置时，请在config.toml 中恢复原来的 model_provider 和模型值。保持 auth.json 不变，以便继续使用官方登录。