配置模型供应商

推荐使用 CC Switch 完成配置 —— 一款开源的供应商管理工具，可视化操作，无需手动编辑 JSON 或环境变量。

1. 安装 CC Switch

macOS

Terminal

brew install --cask cc-switch

或前往 Releases 下载 .dmg 手动安装。

Windows

前往 Releases 下载 .msi 安装程序。

Linux

Terminal

# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb

# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm

# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

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

2. 添加 ClaudeYY 供应商

步骤一：新增供应商

切换到顶部 Codex 标签页，点击右上角 + 按钮。

步骤二：填写配置

按下表填写，点击 + 添加 完成。

配置项	值	说明
❶ 供应商名称	`claudeyy-codex`	自定义，方便识别
❷ 官网链接	`https://claudeyy.com`	供应商官网
❸ API Key	你的 ClaudeYY API Key	在 https://claude.claudeyy.com 获取
❹ 请求地址	`https://claude.claudeyy.com/v1`	末尾不要加斜杠
❺ API 格式	`OpenAI Compatible`	选择 OpenAI 兼容格式
❻ 写入通用配置	✅ 勾选	写入全局配置，所有项目生效

CC Switch 自动写入配置文件，无需手动编辑任何文件。

步骤三：启用供应商

添加完成后回到列表，选中 claudeyy-codex，点击使用按钮，看到「切换成功」提示即完成。确认 写入通用配置 已勾选，配置会自动写入 config.toml。

3. 验证配置

Terminal

codex "hello"

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

4. 指定模型

Terminal

codex --model openai/gpt-5.4-mini-codex "重构这个函数"

Codex CLI 使用 OpenAI Responses API（wire_api = "responses"），并非所有模型都支持此格式。选择模型时，请在 ClaudeYY 模型广场确认该模型支持 Responses 协议，否则会报错。

推荐模型请参考 ClaudeYY 模型广场。

故障排除

Q: 提示 “Authentication error”

确认 API Key 已正确填写，并检查请求地址末尾无斜杠。

Q: 连接超时

确认请求地址为 https://claude.claudeyy.com/v1，末尾不带斜杠。