📌

CC Switch 是一款桌面管理工具，让您无需手动编辑配置文件，即可一键切换 Claude Code、Codex、Gemini CLI 等 CLI 工具的 API 供应商。本教程将指导您通过 CC Switch 配置星狐云中转 API。

📋 准备工作

在开始之前，请确保您已完成以下准备：

准备项	说明	获取方式
CC Switch	桌面管理工具	见下方下载安装章节
星狐云 API 令牌	以 `sk-` 开头的密钥	登录 xinghuapi.com → 控制台 → API令牌
API 服务地址	星狐云中转地址	`https://xinghuapi.com`

🚀 下载安装 CC Switch

Windows 用户

前往 CC Switch Releases 页面，下载最新版本的：

CC-Switch-v{版本号}-Windows.msi（安装版，推荐）

或 CC-Switch-v{版本号}-Windows-Portable.zip（绿色便携版）

下载后双击 .msi 文件按提示完成安装。

macOS 用户

方式一：Homebrew 安装（推荐）

方式二：手动下载

前往 CC Switch Releases 下载 .dmg 文件，双击安装即可。

📌

macOS 版本已通过 Apple 代码签名和公证，可直接打开，无需额外授权操作。

Linux 用户

前往 CC Switch Releases 下载对应包：

.deb（Debian / Ubuntu）

.rpm（Fedora / RHEL / openSUSE）

.AppImage（通用）

Arch Linux 用户：

⚙️ 配置星狐云 API

第一步：获取星狐云 API 令牌

前往 xinghuapi.com 注册并登录，进入 控制台 → API令牌 页面，点击 添加令牌 创建一个新令牌。

📝 创建令牌时的建议设置：

名称： 随意命名，例如 cc-switch

分组： 可选择 Claude Code 专属分组或其他Claude分组

额度： 设为无限额度

其他选项： 保持默认设置

创建完成后复制令牌备用（令牌以 sk- 开头）。

第二步：在 CC Switch 中添加 Claude Code 供应商

启动 CC Switch，点击主界面右上角的➕ 按钮，然后点击 "自定义配置"。

第三步：填写星狐云配置信息

只需填写以下两项，其余选项保持默认空着即可，供应商名称随便写：

配置项	填写内容
供应商名称	自定义，例如 `星狐云`
API Key	您的星狐云令牌（`sk-` 开头）
Base URL	`https://xinghuapi.com`

填写完成后点击 "保存"。

第四步：启用星狐云供应商

配置保存后，在 CC Switch 主界面找到刚添加的 星狐云 供应商，点击 "启用" 按钮即可完成切换。

📌

切换供应商后，Claude Code 无需重启终端即可生效；其他 CLI 工具（Codex、Gemini CLI 等）需要重启终端后生效。

🖥️ 系统托盘快速切换

CC Switch 支持通过系统托盘菜单快速切换供应商，无需打开完整应用：

在系统托盘找到 CC Switch 图标（Windows 右下角 / macOS 顶部菜单栏）

点击图标展开菜单

直接点击 星狐云 供应商名称，立即生效

✅ 验证配置是否成功

打开终端，进入任意项目目录，运行：

如果能正常启动并响应，说明星狐云 API 配置成功。

❓ 常见问题解答

Q: 添加供应商后切换没有生效？

A: 请确认已点击"启用"按钮，并根据使用的 CLI 工具决定是否需要重启终端（Claude Code 无需重启，其他工具需要）。

Q: 提示 "Invalid API Key" 错误？

A: 请检查：

API Key 是否完整复制（以 sk- 开头）

Base URL 是否填写为 https://xinghuapi.com

令牌是否已过期或额度不足

Q: 如何恢复官方登录？

A: 在 CC Switch 中添加 "官方登录" 预设并启用，重启 CLI 工具后按照官方 OAuth 流程操作即可。

📌 注意事项

请妥善保管您的 API 令牌，避免泄露

CC Switch 基于 SQLite 数据库和原子写入机制，切换操作不会损坏您的配置文件

如需在多台设备间同步供应商配置，可使用 CC Switch 的云同步功能（支持 Dropbox、OneDrive、iCloud、WebDAV）

🔗 相关链接

CC Switch GitHub
星狐云官网
Claude Code 官方文档

CC Switch配置API教程

📋 准备工作#

🚀 下载安装 CC Switch#

Windows 用户#

macOS 用户#

Linux 用户#

⚙️ 配置星狐云 API#

第一步：获取星狐云 API 令牌#

第二步：在 CC Switch 中添加 Claude Code 供应商#

第三步：填写星狐云配置信息#

第四步：启用星狐云供应商#

🖥️ 系统托盘快速切换#

✅ 验证配置是否成功#

❓ 常见问题解答#

📌 注意事项#