CC Switch

CC Switch 是一个跨平台桌面 GUI（Tauri 2 + React），用于在多个 AI 编程 CLI 的 API 服务商之间一键切换，免去手改 ~/.claude/settings.json、~/.codex/auth.json、~/.codex/config.toml 的麻烦。它本身不是命令行工具，而是托管这些 CLI 的配置文件，并提供系统托盘快速切换。

仓库：https://github.com/farion1231/cc-switch
官网：https://ccswitch.io
协议：MIT

支持的 CLI（与本文档相关）：

Claude Code（Anthropic）
Codex（OpenAI）

前置准备

已按官方说明安装 Claude Code 或 Codex CLI 之一。
在 Sakrylle 控制台创建 API Key。
安装 CC Switch（见下文）。

安装 CC Switch

从 Releases 页面下载最新版本，或使用包管理器：

macOS：brew install --cask cc-switch
Windows：下载 CC-Switch-*-Windows.msi 安装包，或免安装的 Windows-Portable.zip
Arch Linux（AUR）：paru -S cc-switch-bin
Debian / Ubuntu：下载并安装 CC-Switch-*-Linux.deb
Fedora / RHEL / openSUSE：下载并安装 CC-Switch-*-Linux.rpm
其他 Linux：下载 CC-Switch-*-Linux.AppImage，chmod +x 后运行

Windows 需要 Microsoft Edge WebView2 运行时；Win 10/11 默认已自带。

清理冲突变量

CC Switch 通过改写 CLI 的配置文件来切换服务商，但环境变量优先级高于配置文件。如果你的 shell 里已经导出过 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、OPENAI_API_KEY、OPENAI_BASE_URL 等变量，CC Switch 切换的服务商不会真正生效。

CC Switch 检测到冲突时会显示黄色横幅，并提供"备份并移除"按钮（备份保存在 ~/.cc-switch/env-backups/）。建议按提示清理，或自行从 ~/.zshrc、~/.bashrc、~/.bash_profile 删掉相关行。

一键导入

Sakrylle 控制台已对接 CC Switch 的 deep-link 导入。最省事的路径：

在 API Keys 页面创建一个 Key
在该 Key 的操作栏点击 导入到 CCS
浏览器弹出"是否打开 CC Switch"的确认框，点允许
CC Switch 会按 Key 所属分组（例如 Claude-AWSQ / GPT-Pro / GPT-Image）自动加好对应的服务商，回到主界面点启用即可

前提：本机已安装并至少启动过一次 CC Switch，让它注册 cc-switch:// 协议。如果浏览器识别不了这个协议，先打开一次 CC Switch 主程序再重试。

如果你希望手动配置，或一键导入有问题需要排查，请继续看下文。

添加 Claude 服务商

打开 CC Switch 主界面，切到 Claude Code 标签
点击右上角 + 添加服务商
预设下拉里选 自定义（也可以选模板再改）
按下表填写：

字段	值
名称	`Sakrylle`（任意区分用）
API 格式	Anthropic Messages
配置 JSON	见下方

配置 JSON：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.sakrylle.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

字段说明：

ANTHROPIC_BASE_URL：根域名，不带 /v1。Claude Code 会自己拼 /v1/messages，多写一截会 404。
ANTHROPIC_AUTH_TOKEN：把 Sakrylle Key 放这里，CLI 会发出 Authorization: Bearer ...。不要用 ANTHROPIC_API_KEY——后者走 X-Api-Key 头，且会优先覆盖 Pro/Team 订阅，与 Sakrylle 鉴权方式不一致。
ANTHROPIC_MODEL：默认模型名，可选。可用模型见模型与计费。

保存后点该服务商卡片上的启用。CC Switch 会把上面的 JSON 写到 ~/.claude/settings.json。
Claude Code 支持热重载，无需重启，下一条命令即生效。

添加 Codex 服务商

切到 Codex 标签
点 + 添加，选 自定义
填写：

字段	值
名称	`Sakrylle`
`auth.json`	见下方
`config.toml`	见下方

auth.json：

json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

config.toml：

toml

model = "gpt-5.6-sol"
model_provider = "sakrylle"

[model_providers.sakrylle]
name = "Sakrylle API"
base_url = "https://api.sakrylle.com/v1"
wire_api = "responses"
requires_openai_auth = true

字段说明：

model_provider 必须等于下面 [model_providers.X] 的名字；不能用 openai、ollama、lmstudio 等保留名。
base_url：Sakrylle 的 OpenAI 兼容入口，带 /v1。
wire_api：responses 走 Responses API；如果某个模型只支持 Chat Completions，改成 "chat"。
requires_openai_auth = true 让 Codex 把 auth.json 里的 OPENAI_API_KEY 注入到请求头。

保存后点启用。CC Switch 会原子写入 ~/.codex/auth.json 和 ~/.codex/config.toml。
Codex CLI 不会热重载配置——切换后需要关闭并重开终端窗口（不是只重启 codex 进程）。

切换、托盘、回到官方登录

切换：主界面点其他服务商卡片上的启用，或在系统托盘图标的菜单里直接点服务商名。
托盘菜单：右键托盘图标 → 在 Claude / Codex 子菜单里选目标服务商，最快。
改回官方登录：用预设里的 Claude 官方登录 或 Codex 官方登录 服务商，启用后按 CLI 自身的 OAuth 流程登录即可。Codex 仍需要重启终端。

数据存放

CC Switch 自身：~/.cc-switch/（SQLite 数据库 + 备份 + 设置）
Claude Code：~/.claude/settings.json
Codex：~/.codex/auth.json、~/.codex/config.toml

CC Switch 在每次写入前会原子化备份，并支持把这些目录指向 iCloud / Dropbox / OneDrive / WebDAV 实现多机同步（在"设置"里改路径即可）。

常见问题

切换后没生效：先看是不是有冲突的环境变量（见上文）；其次确认你切换的是当前 CLI 对应的服务商（Claude / Codex 两个标签独立）。
Codex 切换后还在用旧服务商：Codex 不热重载，必须关掉所有终端窗口重开，不是杀 codex 进程就够。
Claude Code 报 404：ANTHROPIC_BASE_URL 写成了 https://api.sakrylle.com/v1。去掉 /v1。
Claude Code 报 401：用了 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN，改字段名。
手动改过配置文件会丢吗？：编辑 当前已启用 服务商时，CC Switch 会先把 CLI 配置文件里的内容回填到数据库，所以手改不会丢。但如果你改的是 未启用 服务商对应的文件，下次启用它时会被覆盖。
删不掉某个服务商：CC Switch 强制每个 CLI 至少保留一个启用中的服务商。先切到别的，再删。
402 余额不足：到控制台充值。

CC Switch ​

前置准备 ​

安装 CC Switch ​

清理冲突变量 ​

一键导入 ​

添加 Claude 服务商 ​

添加 Codex 服务商 ​

切换、托盘、回到官方登录 ​

数据存放 ​

常见问题 ​