mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-03-23 23:59:24 +08:00
e612410deb
- Add OpenCode as 4th supported app throughout all docs - Fix proxy default port 15762 → 15721 - Update Claude presets (9 → 26), Codex (3 → 10), Gemini (3 → 7) - Add OpenCode presets (25 entries) - Fix timeout defaults and ranges (stream first byte 60s/90s, etc.) - Fix circuit breaker defaults with per-app values (Claude vs general) - Fix Skills support: all 4 apps, not just Claude/Codex - Remove non-existent Gemini authMode field - Fix prompt deletion behavior: enabled prompts cannot be deleted - Remove non-existent Legacy deeplink protocol, use V1 only - Fix DB table names (usage_logs → proxy_request_logs) and add missing tables - Fix migration version v3.8.0 → v3.7.0 - Add missing V1 deeplink parameters (config, configFormat, etc.) - Update doc version v3.9.1 → v3.10.3 - Add claude-opus-4-1 to pricing table - Fix recovery wait time range 10-300 → 0-300
2.1 KiB
2.1 KiB
2.2 切换供应商
主界面切换
在供应商列表中，点击目标供应商卡片的「启用」按钮。
切换流程
- 点击「启用」按钮
- CC Switch 更新配置文件
- 卡片状态变为「当前启用」
- Claude/Gemini 即时生效，Codex 需重启终端
状态指示
| 状态 | 显示 | 说明 |
|---|---|---|
| 当前启用 | 蓝色边框 + 标签 | 配置文件中的当前供应商 |
| 代理活跃 | 绿色边框 | 代理模式下实际使用的供应商 |
| 普通 | 默认样式 | 未启用的供应商 |
托盘快速切换
通过系统托盘可以快速切换，无需打开主界面。
操作步骤
- 右键点击系统托盘的 CC Switch 图标
- 在菜单中找到对应应用（Claude/Codex/Gemini/OpenCode）
- 点击要切换的供应商名称
- 切换完成，托盘会短暂提示
托盘菜单结构
生效方式
Claude Code
切换后即时生效，无需重启。
Claude Code 支持热重载，会自动检测配置文件变更并重新加载。
Codex
切换后需要重启：
- 关闭当前终端窗口
- 重新打开终端
Gemini CLI
切换后即时生效，无需重启。
Gemini CLI 每次请求都会重新读取 .env 文件。
配置文件变更
切换供应商时，CC Switch 会修改以下文件：
Claude
~/.claude/settings.json
修改内容：
{
"env": {
"ANTHROPIC_API_KEY": "新的 API Key",
"ANTHROPIC_BASE_URL": "新的端点"
}
}
Codex
~/.codex/auth.json
~/.codex/config.toml（如有额外配置）
Gemini
~/.gemini/.env
~/.gemini/settings.json
切换失败处理
如果切换失败，可能的原因：
配置文件被锁定
其他程序正在使用配置文件。
解决方法：关闭正在运行的 CLI 工具，再尝试切换。
权限不足
没有写入配置文件的权限。
解决方法：检查配置目录的权限设置。
配置格式错误
供应商配置的 JSON 格式有误。
解决方法：编辑供应商，检查并修复 JSON 格式。