CC Switch
CC Switch 是 farion1231 维护的第三方社区配置管理器，不是 OpenAI、Anthropic 或其他模型厂商的官方产品。v3.18.0 的官方说明称支持 8 个工具，并包括 Gemini CLI 与 Grok Build；准确客户端清单以当前 官方仓库 README 为准。
安装
到 farion1231/cc-switch 官方 Releases 选择与 Windows 版本和 CPU 架构匹配的发布资产。核对仓库所有者与发布签名；本站不托管安装包。
Homebrew Cask（macOS 12 Monterey 及以上）：
brew install --cask cc-switch或从 官方 Releases 下载当前 macOS 发布资产。若系统提示发布方或签名异常，停止打开并回到官方仓库核实，不要绕过 Gatekeeper。
要求 Ubuntu 22.04+ / Debian 11+ / Fedora 34+：
| 包格式 | 安装方式 |
|---|---|
.deb | sudo dpkg -i cc-switch_*.deb |
.rpm | sudo rpm -i cc-switch-*.rpm |
.AppImage | chmod +x cc-switch-*.AppImage && ./cc-switch-*.AppImage |
| AUR（Arch） | paru -S cc-switch-bin |
AUR 的 cc-switch-bin 由社区维护，不是 farion1231 官方发布渠道；安装前可用 paru -Gp cc-switch-bin 查看 PKGBUILD，确认 source 指向 github.com/farion1231/cc-switch 官方 Releases。
选配置向导
安装完成后，顶部工具栏点击对应客户端图标，跟着向导填表单即可。
| 工具 | 向导 | 配置文件 |
|---|---|---|
| Claude Code CLI | 配置向导 | ~/.claude/settings.json |
| Claude 桌面版 | 配置向导 | 以当前版本的备份提示和 Claude 官方说明为准 |
| Codex | 配置向导 | ~/.codex/config.toml |
| OpenCode | 配置向导 | ~/.config/opencode/opencode.json |
| OpenClaw | 配置向导 | 以 CC Switch 备份提示与 OpenClaw 官方文档为准（通常在 ~/.openclaw/ 下） |
| Hermes | 配置向导 | ~/.hermes/config.yaml 与 ~/.hermes/.env |
模型与网关支持
CC Switch 负责写配置，不决定上游网关真正提供哪些模型。OpenAI/Anthropic 官方模型清单、CC Switch 表单可选项和第三方网关实际能力不能互相替代。配置时应先从网关控制台或模型列表获取当前模型 ID、上下文、输出限制和协议，再按对应客户端官方文档填写。
数据位置
| 路径 | 用途 |
|---|---|
~/.cc-switch/cc-switch.db | SQLite 数据库，存供应商、MCP、Prompts、Skills |
~/.cc-switch/settings.json | 设备级 UI 偏好 |
~/.cc-switch/backups/ | 自动备份，保留最近 10 份 |
~/.cc-switch/skills/ | 默认以符号链接同步到各 AI 客户端 |
这些目录可能含 API Key、Token、供应商地址和备份。不要上传到公开仓库或第三方排障网站；卸载前也应按项目官方说明确认是否保留配置。
常见问题
资料来源：CC Switch 项目官网 · farion1231/cc-switch 官方仓库 · 官方 Releases（2026-07-26 核对）