配置模型供应商

Codex 默认连 OpenAI。改用 U-Token 通用币 需要一段供应商配置，核心是这三项：

知道该往哪填，看到这里就够了。不确定的话，下面三种方式挑一种做完，结果完全相同：

准备工作

创建 API Key

打开控制台的 API Keys 页（图中 1），点右上角的 + 创建 API Key（图中 2）。完整流程（含模型选择与限额设置）见创建 API Key。

安装 CC Switch

方式 A 和方式 B 都通过 CC Switch 落地配置——一款开源的供应商管理工具，可视化操作，无需手动编辑配置文件或环境变量。走方式 C 的话这一步可以跳过。

支持 macOS 12+、Windows 10+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+。

方式 A：控制台一键导入（推荐）

控制台直接生成好一份 U-Token 通用币 供应商配置推给 CC Switch，请求地址、配置名称、模型都是填好的，你只需要粘一次密钥。Codex 的请求地址必须带 /v1，这一步也由控制台按应用类型填对，不用自己记。

第 1 步：生成导入配置

回到 API Keys 页，点上方「如何使用 API Key?」卡片右侧的导入到 CC Switch，按弹窗填：

1. 应用切到 Codex——请求地址会自动变成 https://u-token.ai/v1。
2. 把刚才复制的密钥粘进 API Key。配置名称 U-Token 通用币 已经填好，不用动。
3. 粘贴生效后，主模型下拉会自动拉取你账号可用的模型，从中选一个作为默认模型。
4. 导入后立即启用保持打开，这样导入完就是当前生效的供应商。
5. 点右下角打开 CC Switch。

第 2 步：在 CC Switch 里确认导入

浏览器会唤起本机的 CC Switch，弹出确认框。核对应用类型是 Codex、API 端点是 https://u-token.ai/v1、密钥掩码对得上，然后点导入。

导入后这条供应商就出现在 CC Switch 列表里，密钥也一并写进了 Codex 的配置，方式 C 里设环境变量那步不用做。直接跳到验证配置。

方式 B：在 CC Switch 里手动添加

装好 CC Switch 后，也可以自己一项项填。想配多个模型映射（让 Codex 的 /model 命令能切换）时用这种方式更方便。

第 1 步：新增供应商

切换到顶部的 Codex 标签页（图中 1），点击右上角的 + 按钮（图中 2）。

第 2 步：填写配置

先按下表填写基本信息。

模型映射决定 Codex 里 /model 命令和桌面版模型下拉能看到哪些模型，在高级选项下面，按图中 5 → 6 → 7 三步填：

1. 点获取模型列表（图中 5），按刚填好的地址和密钥拉取可用模型。
2. 点添加模型（图中 6），表格里会多出一行。
3. 点这一行的下拉三角（图中 7），从刚拉取到的列表里选模型；也可以直接手工输入，实际请求模型一列要与模型列表一致。

要几个模型就重复第 2、3 步几次。改完要重启 Codex 才会刷新。

最后继续下滑到 config.toml（TOML） 区块——这里能看到 CC Switch 实际会写进去的内容。勾选右上角的应用通用配置，配置才会写进全局的 ~/.codex/config.toml、对所有项目生效；然后点右下角添加完成。

CC Switch 会自动写入 Codex 的配置文件（密钥也在内），不需要手动编辑任何文件，方式 C 里设环境变量那步也不用做。

第 3 步：启用供应商

添加完成后回到列表，鼠标移到 U-Token 通用币-Codex 一行，点击右侧浮出的启用按钮。该行高亮即表示当前生效。

上图拍的是 Claude Code 标签页，Codex 标签页的列表布局和启用操作完全一样，只是行里显示的是你的 Codex 供应商。

方式 C：手动配置

不想装 CC Switch 的话，把下面的内容写进 ~/.codex/config.toml（文件不存在就新建）：

model_provider = "gateway"
model = "gpt-5.6-sol"

[model_providers.gateway]
name = "U-Token 通用币"
base_url = "https://u-token.ai/v1"
env_key = "AI_GATEWAY_API_KEY"

这段配置里有几点容易搞错：

• gateway 是你自己起的名字，但 model_provider = "gateway" 和 [model_providers.gateway] 这两处必须写成同一个词，想改名要两处一起改。别用 openai、ollama、lmstudio，这三个是 Codex 的保留名。
• env_key 填的是环境变量的名字，不是密钥本身——密钥在下一步单独设置，不会出现在这个文件里。
• model 只能填一个，它是默认模型，可用的 id 见模型列表。想临时换用别的（如 gpt-5.6-luna），启动时加 --model 即可，见指定模型。
• wire_api 可以不写：Codex 目前只支持 Responses 协议，省略时就用它。

macOS / Linux 可以一条命令写完：

mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "gateway"
model = "gpt-5.6-sol"

[model_providers.gateway]
name = "U-Token 通用币"
base_url = "https://u-token.ai/v1"
env_key = "AI_GATEWAY_API_KEY"
EOF

再把密钥配成环境变量：

# macOS / Linux——加进 ~/.zshrc 或 ~/.bashrc 可持久生效
export AI_GATEWAY_API_KEY="sk-你的KEY"

# Windows (PowerShell)
setx AI_GATEWAY_API_KEY "sk-你的KEY"

验证配置

先重启终端——Codex 启动时才读配置和环境变量。

codex "hello"

正常返回 AI 响应即表示配置成功。

指定模型

codex --model gpt-5.6-luna "重构这个函数"

Codex CLI 使用 OpenAI Responses API（wire_api = "responses"），并非所有模型都支持这个格式。选模型前请在模型列表确认该模型支持 Responses 协议，否则会报错。

常用调整

常见问题排查