CC Switch 统一配置

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

安装

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

Windows

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

macOS

bash

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

Linux

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

bash

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

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

通用配置流程

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

四步搞定：

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

Micu 预设供应商

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

渠道与模型对应关系

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

最常见的几条规则：

Claude 类分组（vip_1_* / free_2*）→ model 留空或填 Claude 模型名
Codex / OpenAI 类（vip_2*）→ 填 gpt-5.4 或对应分组指定的 GPT 模型
vip_2_cc → Claude Code 调 OAI 模型，必须改成 gpt-5.4，不能继续填 Claude 模型名
Gemini / Grok / 国产（vip_3 / grok / vip_4*）→ 按模型广场中的模型 ID 填写

`vip_2_cc` 使用说明

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

这时需要在 CC Switch 中将 model 改成 gpt-5.4，或其他可用的 GPT 系列模型。

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

CC Switch codex2cc 渠道配置截图

外接调用说明

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

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

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

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

CC Switch 统一配置 ​

安装 ​

Windows ​

macOS ​

Linux ​

通用配置流程 ​

渠道与模型对应关系 ​

vip_2_cc 使用说明 ​

外接调用说明 ​

相关页面 ​