Appearance
CC-Switch 一键配置【推荐配置方式】
使用 CC-Switch 一键配置 Codex CLI，无需手动编辑配置文件。支持快速切换多个渠道，而且支持可视化配置claude code，codex，gemini 的 mcp，skills功能
CC-Switch 下载地址
Mac 下载：https://v2li.lanzouq.com/i4PI63hm6vmh
Windows 下载：https://v2li.lanzouq.com/inq4Y3hm6w4f
为什么推荐 CC-Switch?
💡 图形化界面,无需手动编辑配置文件
🚀 一键切换不同 API 提供商
⚙️ 支持多个 API Key 管理
🔄 保存配置,随时切换
前置准备
在开始前,请确保:
- ✅ 已安装 Codex CLI 工具
- ✅ 已在 CodexZH 控制台创建 API 令牌（Codex 分组）
- ✅ 已下载 CC-Switch 工具
还没完成?
- Codex 安装教程 - 安装 CLI 工具
- 快速开始 - 创建 API 令牌
注意
CC-Switch 会修改你本机的 ~/.codex/config.toml 与 ~/.codex/auth.json（Windows 对应 %USERPROFILE%\\.codex 目录）。如果你之前已经手动配置过或同时管理多个供应商，建议先备份这两个文件。
配置 Codex
步骤 1：打开 CC-Switch
启动 CC-Switch 软件，你会看到初始界面：
步骤 2：选择 Codex 分组
在顶部分组栏选择 "Codex"，点击右侧的 + 按钮：
步骤 3：选择供应商
在供应商列表中，找到并选择 "CodexZH" 或 "api.codexzh.com"：
提示：如果列表中没有 CodexZH，可以选择「自定义供应商」手动添加。
步骤 4：填写 API Key
- 回到 CodexZH 控制台，进入「令牌管理」页面
- 找到你创建的 Codex 分组 令牌，点击「复制」
回到 CC-Switch，在 "API Key" 输入框中粘贴令牌
填写 "API 请求地址"：
https://api.codexzh.com/v1"默认模型"：建议填
gpt-5.2（以控制台实际提供的模型为准）点击右下角 "添加" 按钮
重要提醒
Codex 必须使用 Codex 分组 的令牌！使用其他分组会导致模型不可用。
步骤 5：启用配置
添加成功后，在主界面会看到刚才配置的项目：
点击右侧的 "启用" 按钮，状态变为 "使用中"。
步骤 6：验证配置
打开终端，进入任意项目目录后运行：
bash
codex发送 hi，看到对话界面并能正常回复，即表示配置成功！
常见问题
❓ CC-Switch 无法启动
可能原因：
- 缺少运行库（Windows）
- 权限不足（macOS）
解决方案：
- Windows：安装 VC++ Redistributable
- macOS：右键打开，选择「打开」绕过安全检查
❓ 配置后仍然无法使用 / 401 错误
检查步骤：
- 确认 Codex CLI 已正确安装（运行
codex --version） - 确认 API Key 是 Codex 分组 的令牌
- 确认已点击「启用」按钮
- 重启终端后再试
手动检查配置文件：
核对 CC-Switch 写入的文件是否正确：
~/.codex/config.toml（Windows：%USERPROFILE%\\.codex\\config.toml）中base_url为https://api.codexzh.com/v1~/.codex/auth.json（Windows：%USERPROFILE%\\.codex\\auth.json）中OPENAI_API_KEY为你的真实sk-...
❓ 提示「模型不存在」
原因：令牌分组选择错误
解决：
- 使用 Codex → 必须使用 Codex 分组 令牌
- 不同分组的令牌只能用于对应的工具
手动配置
如果你不想使用 CC-Switch，也可以手动编辑配置文件：
最后更新：2025-02-02