CC-Switch

跨平台桌面应用，一键管理 Claude Code、Codex、Gemini CLI 的 API 配置。告别手动编辑配置文件和环境变量。

CC-Switch 主界面 — 管理多个 API 提供商配置

快速开始

安装 CC-Switch 后，只需三步即可完成 ClearAPI 配置。

1添加供应商

打开 CC-Switch，① 在顶部图标栏选择 Claude 类型（红色 ✳ 图标）→ ② 点击右上角橙色「+」按钮新增供应商。

① 选择类型（Claude）→ ② 点击右上角「+」新增

---

2编辑供应商

在「编辑供应商」页面按下面信息填写：

• 供应商名称：随意填写（方便识别即可）
• 请求地址：https://clearapi.dev（兼容 Claude API 的端点，不要以斜杠结尾）
• API Key：你的 ClearAPI 密钥（sk- 开头）
• API 格式：Anthropic Messages（原生）
• 主模型：可留空；想锁定最强模型可填 claude-opus-4-8

① 随意填写名称 → ② 填写请求地址 https://clearapi.dev 和 API Key（API 格式选 Anthropic Messages 原生，主模型可留空）

---

3应用配置

点击「Apply」按钮，CC-Switch 会自动将配置写入 Claude Code、Codex、Gemini CLI 的对应配置文件和环境变量中。

完成！ 现在打开任意终端，直接运行 claude、codex 或 gemini 即可使用 ClearAPI 的 API。

点击 Apply 自动写入所有工具配置

安装方法

根据你的操作系统选择对应的安装方式。每个系统都提供 GitHub 官方源 和 国内加速源 两个下载入口。

xattr -cr /Applications/CC-Switch.app

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

高级功能

CC-Switch 还提供以下进阶功能，帮助你更高效地管理 AI 工具配置。

多提供商管理

你可以添加多个 API 提供商（如 ClearAPI、官方 Anthropic、OpenAI 等），在不同场景下快速切换。每个提供商独立保存配置，互不干扰。

工具级配置覆盖

默认情况下，切换提供商会同时更新所有工具的配置。你也可以为单个工具指定不同的提供商，例如：

• Claude Code → 使用 ClearAPI
• Codex → 使用 OpenAI 官方
• Gemini CLI → 使用 Google 官方

配置备份与恢复

CC-Switch 在每次修改配置前会自动备份原有配置文件。如果出现问题，可以通过「Restore」功能一键恢复到之前的状态。

配置文件位置

CC-Switch 会修改以下配置文件（根据已安装的工具）：

# macOS/Linux
~/.claude/settings.json

# Windows
%APPDATA%\claude\settings.json

# macOS/Linux
~/.codex/config.toml + ~/.codex/auth.json

# Windows
%USERPROFILE%\.codex\config.toml + auth.json

# 通过环境变量配置（写入 shell profile）
GEMINI_API_KEY + GOOGLE_GEMINI_BASE_URL