mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-07-31 19:22:15 +08:00
Jason
a058ebeafc
Refresh the user manual to cover the v3.13.0 feature set so users can discover and correctly use new functionality without cross-referencing the release notes. All three language versions are updated line-by-line symmetric. Highlights: - Lightweight Mode: tray-only running state added in 1.5-settings, with a comparison table against "Minimize to tray" and a new OAuth Auth Center (Beta) section - Quota & Balance display restructured in 2.5-usage-query: split into auto-query (Claude/Codex/Gemini official, Copilot, Codex OAuth) vs manual-enable (Token Plan, third-party balances). Explains why manual enabling is required: the same API URL may expose both plan-quota and balance query modes - Codex OAuth reverse proxy: full usage guide in 2.1-add with two entry points (Add Provider panel / OAuth Auth Center), Device Code login flow, token auto-refresh, multi-account management, quota display, common failures, and risk notice - Full URL Endpoint Mode: new advanced option in 2.1-add - Per-app tray submenus: 2.2-switch refactored to reflect the 5-app submenu structure and cross-link to Lightweight Mode - Skills workflow: remove obsolete "automatic update not supported" section in 3.3-skills, add SHA-256 update detection, single/batch update, storage location switch, and skills.sh registry search - Directory picker for Claude terminal resume in 3.4-sessions - Usage stats in 4.4-usage: document the new CLI session log source (no proxy required) and per-app filtering for Claude/Codex/Gemini; note CNY->USD pricing corrections and MiniMax quota fixes - Stream Check coverage extended to OpenCode/OpenClaw in 4.5-model-test - New FAQs in 5.2-questions: quota visibility (auto vs manual), Codex OAuth risks and login flow, deep link wake in Lightweight Mode - v3.13.0 highlights navigation block added to top-level README and each per-language README; version bumped to v3.13.0 / 2026-04-08
130 lines
3.3 KiB
Markdown
130 lines
3.3 KiB
Markdown
# 2.2 切换供应商
|
||
|
||
## 主界面切换
|
||
|
||
在供应商列表中，点击目标供应商卡片的「启用」按钮。
|
||
|
||
### 切换流程
|
||
|
||
1. 点击「启用」按钮
|
||
2. CC Switch 更新配置文件
|
||
3. 卡片状态变为「当前启用」
|
||
4. Claude/Gemini 即时生效，Codex 需重启终端
|
||
|
||
### 状态指示
|
||
|
||
| 状态 | 显示 | 说明 |
|
||
|------|------|------|
|
||
| 当前启用 | 蓝色边框 + 标签 | 配置文件中的当前供应商 |
|
||
| 代理活跃 | 绿色边框 | 代理模式下实际使用的供应商 |
|
||
| 普通 | 默认样式 | 未启用的供应商 |
|
||
|
||
## 托盘快速切换
|
||
|
||
通过系统托盘可以快速切换，无需打开主界面。
|
||
|
||
### 操作步骤
|
||
|
||
1. 右键点击系统托盘的 CC Switch 图标
|
||
2. 将鼠标悬停在对应应用的子菜单上（如 "Claude · 当前供应商"）
|
||
3. 点击要切换到的供应商名称
|
||
4. 切换完成，托盘会短暂提示
|
||
|
||
### 托盘菜单结构
|
||
|
||
v3.13.0 起，托盘菜单从原来的扁平列表重构为**按应用分组的分级子菜单**，为每个应用独立建立子菜单：
|
||
|
||
| 子菜单 | 说明 |
|
||
| ----------- | -------------------------------------------- |
|
||
| Claude | Claude 所有供应商（含 Codex OAuth 反向代理） |
|
||
| Codex | Codex 所有供应商 |
|
||
| Gemini | Gemini 所有供应商 |
|
||
| OpenCode | OpenCode 所有供应商 |
|
||
| OpenClaw | OpenClaw 所有供应商 |
|
||
|
||
**重构带来的好处**：
|
||
|
||
- **防止菜单溢出**：有大量供应商时，扁平列表会超出屏幕高度；分级子菜单天然支持无限扩展
|
||
- **子菜单标题显示当前激活供应商**：无需打开子菜单即可知道每个应用当前用的是哪个供应商
|
||
- **按应用隔离操作**：切换 Claude 的供应商不会干扰到 Codex 的视图
|
||
|
||
> 💡 **提示**：后台常驻 + 轻量模式 + 分级子菜单的组合特别适合频繁切换多个应用的重度用户。参考 [1.5 个性化配置 → 轻量模式](../1-getting-started/1.5-settings.md)。
|
||
|
||
|
||
|
||
## 生效方式
|
||
|
||
### Claude Code
|
||
|
||
**切换后即时生效**，无需重启。
|
||
|
||
Claude Code 支持热重载，会自动检测配置文件变更并重新加载。
|
||
|
||
### Codex
|
||
|
||
切换后需要重启：
|
||
- 关闭当前终端窗口
|
||
- 重新打开终端
|
||
|
||
### Gemini CLI
|
||
|
||
**切换后即时生效**，无需重启。
|
||
|
||
Gemini CLI 每次请求都会重新读取 `.env` 文件。
|
||
|
||
## 配置文件变更
|
||
|
||
切换供应商时，CC Switch 会修改以下文件：
|
||
|
||
### Claude
|
||
|
||
```
|
||
~/.claude/settings.json
|
||
```
|
||
|
||
修改内容：
|
||
```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 格式。
|