CC Switch 统一配置

本站默认通过 CC Switch 统一管理 Claude Code、Codex、OpenClaw 等环境的 API 配置。除非需要手动排障或高级自定义，否则不再建议分别编辑各工具配置文件。

---

安装

项目地址：https://github.com/farion1231/cc-switch

Windows

前往 Releases 下载安装版或便携版。

macOS

brew tap farion1231/ccswitch && brew install --cask cc-switch

Linux

Linux 下需要装 Linuxbrew，然后用与 macOS 相同的命令：

brew tap farion1231/ccswitch && brew install cc-switch

如果 Linuxbrew 装不上或不想装，可以直接从 Releases 下载对应架构的二进制（AppImage / deb / rpm，按发行版选）。

---

通用配置流程

CC Switch 已内置米醋站点预设。这是本文档站推荐的唯一配置流程——其它页面（Claude Code、Codex、OpenClaw 快速上手）都引用这一节。

四步搞定：

1. 打开 CC Switch，点 "添加配置"，选对应框架（Claude Code / Codex / 其它外接客户端）
2. 预设供应商列表点 Micu——Base URL 自动填入
3. 填 API Key (sk-xxx)，按所用分组确认 model（见下方渠道与模型对应）
4. 点 "添加" → 重启终端或客户端

日常使用到这里就够了。CC Switch 无法使用或需要排查环境变量覆盖时，才需要看各工具的手动配置页：Claude Code 配置参考 / Codex CLI 配置参考。

---

渠道与模型对应关系

完整 18 个公共分组的用途与 model 填写建议见 首页「令牌分组速查」。

最常见的几条规则：

• Claude 类分组（vip_1_* / free_2）→ model 留空或填 Claude 模型名
• vip_2 → 推荐填 gpt-5.6-sol，或其他可用的 GPT / Codex 模型
• vip_2_cc → Claude Code 调 OAI 模型，必须改成 GPT 模型，推荐 gpt-5.6-sol，不能继续填 Claude 模型名
• 其它 vip_2* 分组 → 按对应分组指定的模型填写，不沿用上述推荐
• Gemini / Grok / 国产（vip_3* / grok / grok_heavy / vip_4* / *_official）→ 按 模型广场 中的模型 ID 填写；grok_heavy 只填 grok-4.5

---

vip_2_cc 使用说明

当你的 API Key 对应的分组是 vip_2_cc时，Claude Code 实际调用的是 OAI 系列模型。

这时需要在 CC Switch 中将 model 改成 gpt-5.6-sol，或其他可用的 GPT 系列模型。vip_2_cc 推荐 gpt-5.6-sol；gpt-5.6-luna 当前有全局限速，不建议作为主力日用模型。

不要继续填写 claude-sonnet、claude-opus、claude-haiku 这类 Claude 模型名，否则容易出现模型不可用、请求失败，或返回模型相关错误。

---

外接调用说明

外接调用时，除了选择正确分组，还需要按接入类型补对应的 User-Agent。

这部分规则已单独拆分到 外接调用 User-Agent 说明，请在以下场景优先查看：

• OpenClaw 接第三方模型
• 第三方平台或网关外接 Claude / Codex / 国产模型
• 请求返回 403 block、403 Forbidden、Connection blocked

---

相关页面

页面	说明
Claude Code 快速上手	安装、启动、常用命令
Codex CLI 快速上手	安装、启动、推理深度
OpenClaw 配置	OpenClaw 初始化和接入
Claude Code 配置参考	手动配置、环境变量与排障
Codex CLI 配置参考	手动配置、模型列表与排障