CC-Switch 通用步骤

CC Switch 是一个开源的 AI 编程 CLI 统一管理工具。它主要解决一个问题：你同时使用 Claude Code、Codex、Gemini CLI、OpenCode 等工具时，不想每个工具都单独改一遍 Key、Base URL、模型名和 MCP 配置。

官方信息 下载和文档以官方站点为准

官方网站 CC Switch 官方站点 安装说明 下载安装和 Homebrew GitHub 官方仓库和 Releases

它适合已经安装了多个命令行 AI 编程工具的人。普通新手如果只用一个聊天软件，不需要先学 CC Switch；如果你开始同时用 Claude Code、Codex CLI、Gemini CLI，再考虑用它统一管理 Provider。

多 CLI 共用服务商同一个中转站或官方 API，需要同时给 Claude Code、Codex、Gemini CLI 使用。

经常切换 Provider比如白天用官方账号，测试时切到中转站，或者在不同项目里切不同模型。

统一 MCP / SkillsCC Switch 官方说明里也包含 MCP、Skills 等跨工具管理能力，新手先从 Provider 切换学起即可。

先确认主界面 安装完成后先打开主程序，确认左侧能看到 Provider、MCP、Skills 等入口。新手先只处理 Provider，不要同时改 MCP 和提示词。

新增 Provider 参考 这里先确认新增 Provider 的入口和字段位置；不同目标 CLI 的字段会随版本有细节差异。

先分别确认 Claude Code、Codex CLI、Gemini CLI 这些工具本身已经能启动。CC Switch 是管理工具，不是替你安装所有 CLI。
从 CC Switch 官方仓库或官网下载安装包。不要从不明网盘下载。
打开 CC Switch，进入 Provider 或供应商管理页面。
新增一个 Provider，名称写服务商名称，例如“某某中转站”。
把服务商后台提供的 Base URL、API Key、模型名填进去。不同目标工具字段可能不同，按 CC Switch 当前页面提示填写。
保存后选择要应用的目标工具，例如 Claude Code、Codex、Gemini CLI。
执行 Switch / Apply 之后，按提示重启对应终端或 CLI。官方文档说明多数工具切换后需要重启，Claude Code 当前支持热切换。

配置项	怎么填	新手注意
Provider 名称	写服务商或用途	例如“主力中转站”“备用官方 Key”，不要只写 1、2、3
Base URL	复制服务商后台 API 链接	按后台示例决定是否带 `/v1`
API Key	复制完整 Key	不要截图公开，不要把备注名当 Key
模型名	照抄模型列表	Claude Code、Codex、Gemini CLI 可能需要不同模型名
目标工具	选择要同步的 CLI	不是所有 Provider 都能适配所有工具，失败时先只选一个工具测试

目标工具	先核对什么	详情页
Claude Code	Claude / Anthropic 接口地址、Key、Claude 模型名	CC-Switch Claude Code
Codex CLI	OpenAI / Codex 兼容地址、Key、Codex 可用模型名	CC-Switch Codex
Gemini CLI	Google / Gemini 或 Vertex 相关认证方式	CC-Switch Gemini
CC-Switch-CLI	没有图形界面时的命令行配置方式	CC-Switch-CLI 使用

CC Switch 是统一管理入口，不代表一个 Provider 可以无差别套到所有 CLI。Claude、Codex、Gemini 的接口协议不同，失败时先只选择一个目标工具测试。

切换完成后，不要马上处理真实项目。先在一个空目录或测试项目里发最短问题，确认请求确实走到你选的服务商。

切换后的最小测试命令

claude "请只回复：配置成功" codex "请只回复：配置成功" gemini "请只回复：配置成功"

如果某个 CLI 仍然走旧配置，先关闭当前终端窗口，重新打开终端再试。不要同时手动改配置文件和用 CC Switch 改同一项。