CC Switch 配套工具说明
用 CC Switch 在 Claude Code / Codex / OpenCode 等工具间快速切换供应商与模型配置，并融入日常开发。
概述
CC Switch（官网 ccswitch.io）是跨平台桌面助手，面向 Claude Code、Codex、OpenCode、Gemini CLI 等，用于在多套 API 供应商 / 模型配置间切换，避免手改散落的配置文件。
前置条件
- 已安装至少一种目标 CLI（如 Claude Code）
- 拥有一个或多个 API 供应商账号或本地端点
- 桌面系统可运行 CC Switch 发行版
安装与获取
- 打开官网 ccswitch.io 或 GitHub Releases：farion1231/cc-switch
- 下载对应平台安装包并安装
- 启动后按向导关联本机已安装的 CLI / 配置目录
具体安装包名与权限说明以仓库 README 与官网为准。
首次配置
- 添加常用「配置档」（官方 API、代理、不同模型）
- 为每个配置档填写 endpoint / Key（Key 仅存本机，勿截图外传）
- 选择当前激活档，确认 Claude Code（或其他工具）能正常启动会话
- 需要时再添加 Codex / OpenCode 等其它工具的联动
核心用法
- 一键切换：上午用官方、下午用代理时，切配置档后新开 CLI 会话
- 多模型对比：同一任务在不同模型配置下各跑一遍，比较结果（注意成本）
- 团队场景：本机保留多套配置，仓库内仍只提交无密钥的项目规则
开发实践
- 切换供应商后，用一个固定「探活」提示验证（如
claude --version+ 一次极短对话） - 项目约定（测试命令、目录结构）继续放在
CLAUDE.md/ Rules，不放进 CC Switch - 不要把切换工具当成密钥管理器的替代品：企业环境优先用官方密钥保管方案
- 与站内 Claude Code 教程配合：安装篇装好 CLI → 本篇管多配置 → 使用技巧篇管工作流
常见问题
- 切换后 CLI 仍用旧配置：新开终端/会话；确认改的是当前工具实际读取的配置路径
- 找不到配置目录：对照 README 中各工具的配置位置
- Key 泄露风险：定期轮换；不要把导出文件提交到 Git