cc-switch/docs/user-manual/zh

CC Switch 用户手册

Claude Code / Claude Desktop / Codex / Gemini CLI / Grok Build / OpenCode / OpenClaw / Hermes / Pi / MiniMax Code 全方位辅助工具

目录结构

📚 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 连通检测
│   └── 4.6 聚合模式
│
└── 5. 常见问题
    ├── 5.1 配置文件说明
    ├── 5.2 FAQ
    ├── 5.3 深度链接协议
    └── 5.4 环境变量冲突

文件列表

1. 快速入门

文件	内容
1.1-introduction.md	软件介绍、核心功能、支持平台
1.2-installation.md	Windows/macOS/Linux 安装指南
1.3-interface.md	侧栏布局、连接模式标签、供应商卡片说明
1.4-quickstart.md	5 分钟快速上手教程
1.5-settings.md	设置六个分组：通用、应用配置、本地路由、网络、数据、关于

2. 供应商管理

文件	内容
2.1-add.md	使用预设、自定义配置、统一供应商
2.2-switch.md	直连/路由/聚合、托盘切换、生效方式
2.3-edit.md	编辑配置、修改 API Key、全局设置与编辑冲突
2.4-sort-duplicate.md	拖拽排序、复制供应商、删除
2.5-usage-query.md	用量查询、剩余额度、多套餐显示
2.6-claude-desktop.md	Claude Desktop 第三方供应商、直连与模型映射

3. 扩展功能

文件	内容
3.1-mcp.md	MCP 协议、添加服务器、应用绑定
3.2-prompts.md	创建提示词、启用切换、目标文件
3.3-skills.md	发现技能、安装卸载、仓库管理
3.4-sessions.md	会话浏览、搜索过滤、恢复与删除
3.5-workspace.md	OpenClaw 工作区文件、每日记忆

4. 本地路由与高可用

文件	内容
4.1-service.md	启动本地路由、配置项、接口格式转换
4.2-routing.md	应用路由、配置修改、状态指示
4.3-failover.md	故障转移队列、熔断器、健康状态
4.4-usage.md	用量统计、趋势图表、定价配置
4.5-model-test.md	连通检测、检测参数
4.6-aggregation.md	聚合模式、默认供应商、ccs- 前缀、Codex 重启

5. 常见问题

文件	内容
5.1-config-files.md	CC Switch 存储、CLI 配置文件格式
5.2-questions.md	常见问题解答
5.3-deeplink.md	深度链接协议、生成和使用方法
5.4-env-conflict.md	环境变量冲突检测与处理

快速链接

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

版本信息

• 文档版本：v4.0.4
• 最后更新：2026-10-07
• 适用于 CC Switch v4.0.4+

近期主要变化（v4.0）

• 界面改版：顶部导航换成左侧栏，用量统计、授权中心、MCP、Skills、提示词、会话、应用各占一页；设置分为通用、应用配置、本地路由、网络、数据、关于六组 — 详见 1.3 界面概览、1.5 个性化配置
• 直连 / 路由 / 聚合三种连接模式：在每个应用页顶部选择，回到直连只需一步 — 详见 2.2 切换供应商
• 新增聚合模式：Claude Code 和 Codex 可以在一个会话里按模型混用多家供应商 — 详见 4.6 聚合模式
• 切换只改关键字段：地址、密钥、模型等关键字段以外的设置原样保留，不再使用通用配置片段 — 详见 2.3 编辑供应商
• 授权中心：ChatGPT、GitHub Copilot、xAI 等账号集中在侧栏「授权中心」管理 — 详见 1.5 个性化配置
• 「应用」页：安装、升级各 CLI 工具，选择侧栏显示哪些应用 — 详见 1.2 安装指南
• 完整变化见 v4.0 发布说明

贡献

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

• GitHub Issues
• GitHub Repository