Codex CLI 设置

安装与准备

按 Codex 官方快速开始安装 CLI。准备 WuDi API Key 与可用的 GPT 模型。Codex 使用 Responses 协议，只有 Chat Completions 能用不足以证明 Codex 完全兼容。

1. 配置环境变量

macOS / Linux：

export WUDI_API_KEY='替换为你的WuDi_API_Key'

Windows PowerShell：

$env:WUDI_API_KEY = '替换为你的WuDi_API_Key'

2. 添加自定义 Provider

打开用户配置 ~/.codex/config.toml。Windows 通常是 %USERPROFILE%\.codex\config.toml。先备份原文件，合并以下条目；不要重复声明同名 TOML 表。

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

[model_providers.wudi]
name = "WuDi API"
base_url = "https://wudiapi.com/v1"
env_key = "WUDI_API_KEY"
wire_api = "responses"
requires_openai_auth = false

env_key 填变量名称，真实 Key 保存在环境变量中。模型 ID 必须与你的 Key 权限匹配。不要在未确认能力前添加特殊推理档位、WebSocket 或其他实验设置。

3. 启动并验证

在设置过变量的终端运行 codex，新建会话发送短问题。在 WuDi 使用日志确认 GPT 模型与分组。如果你从系统桌面启动程序，它可能不会继承终端里临时设置的变量，桌面端请看单独教程。

配置冲突

项目级 .codex/config.toml、启动参数或已有 profile 可能覆盖用户配置。看见旧模型时，检查生效配置而不是重复创建 Key。解析失败通常是重复的表、中文引号或顶层字段位置错误。

Responses 报错

先测试最小 Responses 请求。404 表示路径或渠道不支持；400 应阅读具体字段错误。客户端要求的托管能力不一定由网关实现，不应通过改用聊天路径来假装兼容。

恢复原配置

退出 Codex，恢复备份或移除新增 Provider，并将 model_provider 改回之前的值。无需删除整个 .codex 文件夹。

字段参考：OpenAI 官方配置参考。