Codex

推荐：通过 CC Switch 导入

1. 在云筑Hub API Key 页面选择 Import to CC Switch。
2. 应用选择 Codex。
3. 选择一个当前可用的主模型。
4. 打开 CC Switch，确认 Endpoint 为 https://www.yunzhuhub.cn/v1。
5. 启用配置，完全退出 Codex 后重新打开。

验收

• Codex 能发起一个简单任务；
• 控制台日志出现对应模型请求；
• 请求没有访问官方默认地址或其他旧中转地址；
• 客户端日志中不包含完整 API Key。

手工配置

OpenAI 官方配置手册确认，用户级配置放在 ~/.codex/config.toml，自定义供应商可使用 base_url、env_key 和 wire_api。

model = "<MODEL_ID>"
model_provider = "yunzhuhub"

[model_providers.yunzhuhub]
name = "云筑Hub"
base_url = "https://www.yunzhuhub.cn/v1"
env_key = "YUNZHUHUB_API_KEY"
wire_api = "responses"

保存后，在启动 Codex 的同一终端中设置密钥：

PowerShell

$env:YUNZHUHUB_API_KEY="<YOUR_API_KEY>"
codex

macOS / Linux

export YUNZHUHUB_API_KEY="<YOUR_API_KEY>"
codex

协议选择

云筑Hub 已公开 POST /v1/responses，因此配置为 wire_api = "responses"。不要把真实密钥写进 config.toml。

官方来源与最后核验日期见官方核验记录。