CC Switch 用户手册

Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw 全方位辅助工具

📚 CC Switch 用户手册
│
├── 1. 快速入门
│   ├── 1.1 软件介绍
│   ├── 1.2 安装指南
│   ├── 1.3 界面概览
│   ├── 1.4 快速上手
│   └── 1.5 个性化配置
│
├── 2. 供应商管理
│   ├── 2.1 添加供应商
│   ├── 2.2 切换供应商
│   ├── 2.3 编辑供应商
│   ├── 2.4 排序与复制
│   ├── 2.5 用量查询
│   └── 2.6 Claude Desktop
│
├── 3. 扩展功能
│   ├── 3.1 MCP 服务器管理
│   ├── 3.2 Prompts 提示词管理
│   ├── 3.3 Skills 技能管理
│   ├── 3.4 会话管理器
│   └── 3.5 工作区文件与每日记忆
│
├── 4. 代理与高可用
│   ├── 4.1 代理服务
│   ├── 4.2 应用接管
│   ├── 4.3 故障转移
│   ├── 4.4 用量统计
│   └── 4.5 模型检查
│
└── 5. 常见问题
    ├── 5.1 配置文件说明
    ├── 5.2 FAQ
    ├── 5.3 深度链接协议
    └── 5.4 环境变量冲突

• 新用户：从 1.1 软件介绍 开始
• 安装问题：查看 1.2 安装指南
• 配置供应商：查看 2.1 添加供应商
• 使用 Claude Desktop：查看 2.6 Claude Desktop
• 使用代理：查看 4.1 代理服务
• 遇到问题：查看 5.2 FAQ

• 文档版本：v3.15.0
• 最后更新：2026-05-16
• 适用于 CC Switch v3.15.0+

• Claude Desktop 一等管理面板：支持第三方供应商、直连 / 模型映射两种模式、Copilot / Codex OAuth 复用与 3P profile 写入 — 详见 2.6 Claude Desktop
• 按角色的模型映射：用 Sonnet / Opus / Haiku 路由和 supports1m 标志适配 Claude Desktop 的模型校验
• Claude Desktop 本地路由：通过 127.0.0.1:15721/claude-desktop 为需要转换的供应商提供本地网关
• 轻量模式：退出到托盘时销毁主窗口，空闲占用接近零 — 详见 1.5 个性化配置
• 配额与余额展示：官方订阅类（Claude/Codex/Gemini/Copilot/Codex OAuth）自动展示剩余额度；Token Plan 和第三方余额通过内置模板一键启用 — 详见 2.5 用量查询
• Codex OAuth 反向代理：用 ChatGPT 账号在 Claude Code 中复用 Codex 服务 — 详见 2.1 添加供应商
• 托盘按应用分级菜单：五应用独立子菜单，防止菜单溢出 — 详见 2.2 切换供应商
• Skills 发现与批量更新：SHA-256 更新检测、批量更新、skills.sh 公共注册表搜索 — 详见 3.3 Skills 技能管理
• 完整 URL 端点模式：高级选项支持将 base_url 视作完整上游端点 — 详见 2.1 添加供应商
• OpenCode / OpenClaw 流式检测全覆盖：Stream Check 面板扩展到全部五个应用 — 详见 4.5 模型检查

欢迎提交 Issue 或 PR 改进文档：

• GitHub Issues
• GitHub Repository