CC Switch 配置教程

CC Switch 是跨平台桌面 GUI 工具,可一键切换 Claude Code / Codex / Gemini CLI / OpenCode 的 API 配置,免去手动修改 settings.json 的麻烦。

安装 CC Switch

平台安装方式
macOSbrew tap farion1231/ccswitch && brew install --cask cc-switch
WindowsGitHub Releases 下载 .msi 安装包
LinuxArch: paru -S cc-switch-bin 或下载 .deb / .AppImage

添加 TokenAPIBay 提供商

  1. 启动 CC Switch,进入 Provider 管理 页面
  2. 点击 Add Custom Provider(若内置预设列表中没有 TokenAPIBay)
  3. 填写以下字段:
字段
NameTokenAPIBay
API Keysk-你的API密钥
Claude Base URLhttps://www.tokenapibay.com/v1/messages
Codex Base URLhttps://www.tokenapibay.com/v1/chat/completions

配置模型映射

在 CC Switch 的 Model 映射 中,将 Claude Code 的三个 tier 模型指向 TokenAPIBay 支持的模型:

CC Switch 字段建议值
Haiku 模型DeepSeek-V4-Flash(轻量任务)
Sonnet 模型DeepSeek-V4-Pro(主力模型)
Opus 模型DeepSeek-V4-Pro(复杂任务)
Subagent 模型DeepSeek-V4-Flash(子代理低成本)

保存后点击 Apply,CC Switch 会自动写入 ~/.claude/settings.json,无需重启终端即可生效。

CC Switch 也支持 MCP 服务器管理、Skills 一键安装、Prompts 模板编辑等功能,详情见 GitHub 仓库