CC-Switch使用教程

Packy Team2025/11/23大约 9 分钟CC-Switch

通用步骤

CC-Switch介绍

Claude Code / Codex 全方位辅助工具

更新日志 | 下载地址

从供应商切换器到 AI CLI 一体化管理平台

统一管理 Claude Code、Codex 等 CLI 的供应商配置、MCP 服务器、Skills 扩展和系统提示词。

使用 CC-Switch，您可以：

✅ 一键切换 API 配置 - 在多个 API 提供商之间快速切换
✅ 可视化配置管理 - 通过图形界面轻松管理所有配置
✅ 内置 PackyAPI 模板 - 预设了 PackyAPI 的配置模板
✅ MCP / Skills / 提示词统一管理 - 一处维护，同步到多个 CLI
✅ 会话与用量 - 会话过程可读，用量和额度一屏看全

温馨提示

CC-Switch 已经内置了 PackyAPI 的快捷配置模板，无需手动编辑配置文件！

软件下载

Windows

点击下载链接→传送门←，进入 CC-Switch 的 GitHub Releases 页面
鼠标滚动到页面底部，在 Assets 中选择适合自己系统的安装包。Windows 系统推荐下载普通 .msi 安装包（CC-Switch-v版本号-Windows.msi）；不想安装可以选择免安装版 CC-Switch-v版本号-Windows-Portable.zip；ARM 机器选文件名里带 arm64 的那几个

安装完成后运行 CC-Switch 主程序，界面如下

MacOS

MacOS安装推荐使用HomeBrew，Cask 源里已经有 cc-switch，不需要先添加 tap
开启终端后，运行以下命令：

# 安装 CC-Switch
brew install --cask cc-switch

# 以后升级到最新版本
brew upgrade --cask cc-switch

也可以直接下载安装包：CC-Switch-v版本号-macOS.dmg（推荐）或 .zip。macOS 版是 Universal 包，Apple 芯片与 Intel 芯片通用，且已通过 Apple 签名与公证，可以直接打开

Linux

重要

从 4.0 开始安装包文件名自带版本号和架构，形如 CC-Switch-v版本号-Linux-x86_64.deb。下面的命令里版本号单独提出来做变量，请先到 GitHub Releases 页面确认当前版本号再替换。

Debian/Ubuntu 系统：

# 版本号以 Releases 页面为准；普通电脑用 x86_64，ARM 机器用 arm64
VER=x.x.x
ARCH=x86_64

# 下载 .deb 包
wget https://github.com/farion1231/cc-switch/releases/download/v${VER}/CC-Switch-v${VER}-Linux-${ARCH}.deb

# 安装
sudo dpkg -i CC-Switch-v${VER}-Linux-${ARCH}.deb

Fedora 等 RPM 系统把文件名里的 .deb 换成 .rpm 即可；其他发行版也可以在同目录下载 CC-Switch-v版本号-Linux-架构.AppImage 直接运行。

Arch Linux 用 AUR：

paru -S cc-switch-bin

系统要求

Windows：Windows 10 及以上
macOS：macOS 12（Monterey）及以上
Linux：x86_64 或 ARM64，需要 glibc 2.35+ 与 WebKitGTK 4.1（如 Ubuntu 22.04+、Debian 12+、较新的 Fedora）；RHEL / Rocky / Alma 8–9 暂不支持

环境检查

注意

请你最好进行此步的环境检查步骤！！！
如果你有经验，能确认你的 Nodejs 环境以及 Claude Code、Codex 的 CLI 安装没问题，配置目录也都存在，可以忽略这一步，直接进入以下的 CC Switch 配置

点击右侧传送门查看如何进行环境检查？

不提供 Gemini CLI 教程

本站不再提供 Gemini CLI 的配置教程（该工具几乎无法正常使用）。CC-Switch 若仍显示 Gemini 入口，请忽略；使用 Gemini 模型请改用 Cline / Roo Code 等，见 Gemini 相关问题。

Claude Code配置

打开 CC Switch，在左侧栏选择 Claude Code。页面上方有三个连接模式标签：直连 / 路由 / 聚合，本教程全程使用直连（点标签只是切换查看，不会改配置）
点击右上角 添加供应商

在搜索框输入 packycode，在「第三方平台」分类里选择 PackyCode

回顾创建 API 令牌，在 PackyApi 中创建 CC 分组的令牌，然后点击右侧的复制按钮拿到 API Key

把复制到的 Key 粘贴到 API Key；再把 请求地址 改成 https://cf.api.fan，最后点击右下角添加

请求地址必须改

PackyCode 预设默认填的请求地址是 https://www.packyapi.ai，那是浏览器打开的控制台网页地址，不能当接口地址用。CC Switch 会把它当成上游端点，照着默认值添加，调用就会失败。

真正能填的接口地址只有两个，按自己的网络情况二选一：

https://cf.api.fan（全球，本文示例统一用它）
https://slb-v1.api.fan（优化线路，延迟敏感用户推荐）

两个地址的说明见 API 端点说明。

添加成功后回到供应商列表，点击 PackyCode 卡片右侧的切换（箭头所指的 ▷ 图标）；卡片显示 使用中 即表示切换成功

在终端运行 claude，如果出现安全确认提示，用方向键选中 Yes, I trust this folder 后回车

claude

进入对话界面后随便发一句话测试，能收到回复即表示配置成功

CC 分组只能用直连，不要开启路由

如果你用的是 CC 分组，请注意该分组不支持第三方接入。

CC Switch 的「路由」模式会把请求先转到本机的 CC Switch，再由它转发给上游，等于在 Claude Code 和 PackyApi 之间加了一层中转，属于第三方接入。所以使用 CC 分组时：

顶部标签保持在直连，不要点 开始路由
配置是否成功，直接以 Claude Code 里的实际对话结果为准

Codex配置

打开 CC Switch，在左侧栏选择 Codex。页面上方同样是 直连 / 路由 / 聚合 三个标签，本教程全程使用直连
点击右上角 添加供应商

在搜索框输入 packycode，在「第三方平台」分类里选择 PackyCode

回顾创建 API 令牌，在 PackyApi 中创建 Codex 分组的令牌，然后点击右侧的复制按钮拿到 API Key

把复制到的 Key 粘贴到 API Key；把 API 请求地址 改成 https://cf.api.fan/v1；模型列表 点 + 手动添加 补齐两行；自动审批模型 选成 Codex 默认 (codex-auto-review)；最后点击右下角添加

请求地址必须带 /v1

Codex 走 OpenAI 兼容端点，地址要带 /v1，这一点和 Claude Code 配置里的 https://cf.api.fan 不一样。PackyCode 预设填的是控制台网页地址 https://www.packyapi.ai/v1，不能当接口地址用，按自己的网络情况二选一：

https://cf.api.fan/v1（全球，本文示例统一用它）
https://slb-v1.api.fan/v1（优化线路，延迟敏感用户推荐）

两个地址的说明见 API 端点说明。

模型要手动加，自动获取拿不到

点 获取模型列表 会失败，拿不到 PackyCode 的模型列表，直接点 + 手动添加 自己填两行：

第一行填你要用的主模型，比如 gpt-5.6-sol：菜单显示名与实际请求模型填同一个模型 ID，可用的 ID 以 Codex 分组页面实时展示为准
第二行两列都填 codex-auto-review，和上面的 自动审批模型 对应上

截图里这两行都框出来了，照着填即可。

添加成功后回到供应商列表，点击 PackyCode 卡片右侧的切换（箭头所指的 ▷ 图标）；卡片显示 使用中、顶部提示变成「直连生效中 · 直接连接 PackyCode」即表示切换成功

切换后 CC Switch 顶部会出现一条黄色提示：切换前就开着的 Codex 可能还在用之前的账号或模型列表。按提示把 Codex 彻底重启一遍：终端里的 codex 会话退出重开，桌面版要彻底退出再打开（macOS 用 ⌘Q，只关窗口不行），编辑器插件要重开窗口

在终端运行 codex，出现对话界面后随便发一句话，能收到回复即表示配置完成

codex

用量查询配置

CC Switch 可以在 PackyCode 供应商卡片中显示已用额度和剩余额度。具体设置方法请查看用量查询配置。

Claude Desktop配置

和上面的"Claude Code配置"是两回事

Claude Desktop（桌面客户端）和 Claude Code（命令行/VSCode 插件）在 CC Switch 里是两个独立入口，配置文件互不相通，需要分别配置。

打开 CC Switch，在左侧应用切换器中选择 Claude Desktop 入口。找不到的话，去 设置 → 通用 → 应用可见性 确认没有被隐藏
首次进入时没有供应商，点击 "将 Claude Code 中已有的供应商导入" 按钮，可以把上面 Claude Code 配好的供应商一键带过来；也可以点右上角 + 手动添加，接口地址填 https://cf.api.fan，API Key 用 CC 分组令牌
导入或添加后，在供应商卡片上点击启用

一定要完全重启 Claude Desktop

Claude Desktop 不会像 Claude Code 那样热重载配置，每次切换供应商后，必须彻底退出程序再重新打开才会生效。

判断是否生效：完全重启后正常发一条消息，能收到回复就是生效了。这里没有单独的"测试连接"按钮，不用纠结有没有测试通过

详细步骤、导入注意事项和排查方法，见 CC Switch · Claude Desktop 配置