Appearance
CC-Switch 快速配置
CC-Switch 是一款桌面端配置切换工具，适合同时管理 Claude Code、Codex 以及其他兼容 CLI 的网关配置。它的核心用途不是替代客户端，而是把 Base URL、API Key、模型和环境变量统一收口，减少每个工具单独改配置的成本。
适合谁用
- 同时使用多个 AI 编程工具的人
- 经常在不同模型提供商之间切换的人
- 想把网关配置统一管理的人
能做什么
- 一键切换不同工具的提供商配置
- 测试 API 端点速度和可用性
- 管理常用系统提示
- 统一管理 MCP 服务器配置
- 备份和恢复历史配置
- 检测环境变量冲突
安装
Windows
- 打开项目发布页：https://github.com/farion1231/cc-switch/releases
- 下载最新的
.msi安装包 - 按安装向导完成安装
- 从开始菜单启动 CC-Switch
macOS
推荐用 Homebrew：
bash
brew tap farion1231/ccswitch
brew install --cask cc-switch如果需要手动安装：
- 打开项目发布页：https://github.com/farion1231/cc-switch/releases
- 下载
.dmg文件 - 将 CC-Switch 拖入应用程序文件夹
- 从启动台或应用程序文件夹启动
Linux
Debian 或 Ubuntu：
bash
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -fAppImage：
bash
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImageArch Linux AUR：
bash
paru -S cc-switch-bin第一次配置
建议先准备好这三样东西：
- Filifili 控制台给出的 Base URL
- 你在 创建令牌 里生成的 API Key
- 你要用的模型名或模型别名
配置步骤如下：
- 启动 CC-Switch。
- 点击添加提供商或新建配置。
- 填写提供商名称，建议直接写
Filifili。 - 填入 Base URL 和 API Key。
- 选择模型或模型组。
- 保存配置。
切换配置
- 在提供商列表中选中要使用的配置。
- 点击启用或设为当前使用。
- 如果你更习惯托盘操作，也可以从系统托盘里直接切换。
- 切换完成后，重启对应的 AI 工具。
推荐填写方式
- 提供商名称：
Filifili - API 端点：填写 Filifili 控制台提供的地址
- API 密钥：填写你在 创建令牌 里生成的 key
- 模型名：与控制台可选项保持一致
配置检查顺序
当工具无法正常调用时，按这个顺序看：
- Base URL 是否填对。
- API Key 是否完整复制。
- 模型名是否和控制台一致。
- 是否已经切到当前使用配置。
- 客户端是否已经重启。
常见问题
1. 切换后没有生效
- 确认已经点击保存。
- 确认已经切换到当前使用的配置。
- 重启对应客户端，不要只重启 CC-Switch。
2. 速度测试失败
- 先确认网络能访问控制台。
- 再检查 Base URL 是否可达。
- 如果你的网络走代理，确认代理配置没有和本地环境冲突。
3. 工具提示鉴权失败
- 大多数情况下是 API Key 错了。
- 也可能是令牌已失效，需要重新创建。
- 还有一种情况是客户端读到了旧配置，重启后再试。
4. 模型列表为空
- 检查你是否已经选择正确的提供商。
- 检查模型名是否与控制台别名一致。
- 需要的话先回到 创建令牌 和 Claude Code 使用指南 复查一遍。
使用建议
- 如果你经常在不同工具之间切换，先把 Filifili 作为统一提供商配置好，再按客户端分开验证。
- 如果你只用一个工具，也可以把 CC-Switch 当作配置备份和恢复工具来用。
- 遇到问题时，优先看网关和令牌，不要先怀疑客户端本身。