admin/CC-Switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-07-24 12:44:18 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
989c4458289edb0924c9bccf8d986ba103bc2510
CC-Switch/docs/user-manual/zh/2-providers/2.2-switch.md
T
Jason a058ebeafc docs(user-manual): update to v3.13.0 across en/zh/ja 
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
2026-04-09 16:49:14 +08:00

3.3 KiB
Raw Blame History

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 个性化配置 → 轻量模式。

image-20260108004348993

生效方式

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 格式。

Reference in New Issue View Git Blame Copy Permalink