Codex CLI

先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置；支持 CC Switch 的 CLI 优先使用 CC Switch。

先选择模型，再选择或创建匹配密钥。配置和含密钥的代码复制在门户完成。

准备条件

选择支持 Responses API、流式输出及工具调用 的模型。Chat Completions 成功并不表示同一模型能用于 Codex CLI。

配置服务商

在用户目录的 ~/.codex/config.toml 中合并以下配置，保留已有无关设置。将 YOUR_MODEL_ID 替换为 Toodoo AI 提供的完整模型 ID。

model = "YOUR_MODEL_ID"
model_provider = "toodooai"

[model_providers.toodooai]
name = "Toodoo AI"
base_url = "https://toodooai.com/v1"
env_key = "TODOOAI_API_KEY"
wire_api = "responses"

自定义服务商通过 model_provider 选中，env_key 指向密钥环境变量。Codex 官方高级配置

启动验证

按快速开始在当前终端设置 TODOOAI_API_KEY，然后运行：

codex

在测试目录中发出简单请求，核对 Toodoo AI 日志。若提示不支持 Responses，先确认目标模型和渠道的协议支持，不要只反复更换密钥。

配置前的检查

API 密钥所属分组需要允许目标模型，并有可用额度。
模型必须支持 Responses、流式输出和 Codex 所需的工具调用；Chat Completions 成功不能替代这项检查。
base_url 使用 https://toodooai.com/v1，wire_api 使用 responses，不要改成 chat_completions 来“绕过”协议错误。

合并配置而不是覆盖

~/.codex/config.toml 可能已经包含其他项目的模型、审批或沙箱设置。只添加或更新 [model_providers.toodooai] 及顶部的模型选择，保留无关配置。示例中的 YOUR_MODEL_ID 必须替换为从当前密钥查询到的完整模型 ID。

在 PowerShell 中可以这样准备密钥：

$secret = Read-Host "输入 Toodoo AI API 密钥" -AsSecureString
$env:TODOOAI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password
codex

如果你同时配置了多个 provider，确认顶部的 model_provider = "toodooai" 与 provider 区块名称一致。名称大小写和拼写不一致时，Codex 可能回退到其他配置。

验证与排障

在不包含敏感资料的测试目录启动 codex。
先发送一句短消息，确认 Responses 请求能返回。
再尝试查看文件或执行一个低风险工具操作。
在 Toodoo AI 日志中核对模型、时间和状态。

现象	优先检查
配置文件解析失败	TOML 引号、缩进和 section 名称；不要把 JSON 配置复制进 TOML。
提示 provider 不存在	`model_provider` 是否与 `[model_providers.toodooai]` 完全一致。
提示不支持 Responses	更换为控制台中明确支持 Responses 的模型或分组。
仍然使用旧模型	检查项目目录配置、环境变量和顶部 `model` 是否覆盖用户配置。

请求失败后先看日志功能，再按错误码与排障处理；不要在不确定请求是否执行时连续重试。