CC-Switch 一键配置工具

CC-Switch 是 BytePass 官方推荐的配置方式，支持 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 五款工具。它是一个跨平台桌面应用，自动处理 API 地址、Key 和环境变量——无需手动编辑任何文件。

手动配置CC-Switch
首次配置时间5–10 分钟不到 2 分钟
切换服务商手动改文件一键切换
URL 后缀弄错经常发生自动处理
环境变量冲突难以排查自动检测并提示
多套配置切换手动改文件一键切换 / 系统托盘

安装 CC-Switch

CC-Switch 是基于 Tauri 2 构建的桌面应用。官网：ccswitch.io

macOS（推荐 Homebrew）

brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch

也可以从 GitHub Releases 下载 .dmg 安装包。

CC-Switch macOS 版已通过 Apple 公证签名，可直接安装打开。

Windows

从 GitHub Releases 下载 CC-Switch-v{version}-Windows.msi，双击安装。

也有便携版 CC-Switch-v{version}-Windows-Portable.zip，无需安装。

Linux

Debian/Ubuntu：

sudo dpkg -i CC-Switch-v{version}-Linux-x86_64.deb

Arch Linux：

paru -S cc-switch-bin

AppImage（通用）：

chmod +x CC-Switch-v{version}-Linux-x86_64.AppImage
./CC-Switch-v{version}-Linux-x86_64.AppImage

所有安装包可从 GitHub Releases 下载。

最快的方式：从 BytePass 控制台一键导入

BytePass 控制台内置了一键导入功能，无需手动复制粘贴 Key 和 URL：

  1. 安装并打开 CC-Switch
  2. 在浏览器中访问 bytepass.ai/keys
  3. 点击 API Key 旁边的 「导入到 CCS」 按钮

BytePass 控制台 — 点击「导入到 CCS」一键配置 CC-Switch

CC-Switch 会自动打开，并预填正确的 API 地址和 Key。点击「保存」即可完成。

这使用了 CC-Switch 的 Deep Link 功能（ccswitch://），安全传递配置信息。

手动配置

如果你更喜欢手动添加配置：

1. 获取 API Key

进入 BytePass 控制台，复制你的 API Key（格式：sk-...）。

还没有 Key？先看 快速开始。

2. 添加服务商

打开 CC-Switch，点击 「添加服务商」，填入：

字段填写内容
服务商名称BytePass（随意命名）
API Base URLhttps://api.bytepass.ai
API Key你的 sk-... Key

3. 点击「启用」

CC-Switch 会将配置写入对应工具的配置文件。Claude Code 支持热切换，立即生效。其他工具需要重启终端。

4. 验证

claude

输入一句话测试，收到回复即配置成功。

切换配置

CC-Switch 让切换变得极简：

  • 主界面： 选择服务商 → 点击「启用」
  • 系统托盘： 直接点击服务商名称——立即生效

Claude Code 不需要重启终端。其他工具需要重启终端。

核心功能

功能说明
5 款工具Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw——全部在一个应用中管理
50+ 服务商预设内置热门 API 服务商预设，选择即可使用
系统托盘快切无需打开主界面，托盘菜单直接切换
统一 MCP & Skills 管理在一个面板中管理所有工具的 MCP 服务器和 Skills
本地代理 & 故障转移自动故障转移、熔断机制、服务商健康监控
用量仪表盘追踪花费、请求量和 Token 消耗，带趋势图表
会话管理器浏览、搜索和恢复所有工具的历史对话
云同步通过 Dropbox、OneDrive、iCloud 或 WebDAV 同步配置
配置备份导出所有配置，自动轮转备份

常见问题

切换后配置没有生效？

  • Claude Code：应该立即生效（热切换）。如果没有，重启终端
  • 其他工具：切换后一定要重启终端

想切回官方登录？

在 CC-Switch 中添加「官方登录」预设，重启工具后按提示登录即可。

CC-Switch 数据存在哪里？

  • 数据库：~/.cc-switch/cc-switch.db
  • 设置：~/.cc-switch/settings.json
  • 备份：~/.cc-switch/backups/

下一步

← 上一篇Quick Start下一篇 →Claude Code