CC Switch 教程 — 跨平台 AI CLI 管理工具,统一管理 Claude Code、Codex、Gemini CLI 的 Provider 配置、MCP 服务器与系统提示词。对接 New API 一键填入。🔀 CC Switch 是一款开源、跨平台的 AI CLI 统一管理工具,支持 Claude Code、Codex 和 Gemini CLI 的 Provider 配置一键切换、MCP 服务器统一管理、系统提示词(Prompts)管理以及 Skills 扩展管理, 让你在多个 AI 编程助手之间自由切换,无需手动编辑配置文件。
核心特性#
🔌 Provider 管理#
一键切换 — 在 Claude Code、Codex、Gemini 的 API 配置之间一键切换,无需手动修改环境变量或配置文件
多端点支持 — 每个 Provider 可配置多个端点,支持 API Key 管理与延迟测速
4 层模型配 置 — 支持 Haiku / Sonnet / Opus / Custom 四级模型粒度配置
🛠️ MCP 服务器管理#
跨应用统一管理 — 单面板管理 Claude / Codex / Gemini 三端的 MCP 服务器
三种传输类型 — 支持 stdio、HTTP、SSE(Server-Sent Events)
💬 Prompts 管理#
跨应用支持 — Claude(CLAUDE.md)、Codex(AGENTS.md)、Gemini(GEMINI.md)
Markdown 编辑器 — CodeMirror 6 + 实时预览
🌐 多平台支持#
桌面应用 — Windows、macOS、Linux 原生安装包
Web 版本 — 适用于无头服务器 / SSH 远程环境的浏览器访问方案
中转平台接入方法#
1.
CC Switch 支持 ccswitch:// Deep Link 协议,可从令牌管理页一键导入 Provider 配置。
应用:顶部切换应用类型 — Claude / Codex / Gemini,根据需要选择目标应用
名称:为该配置填写一个名称(例如 My Claude),方便后续在 CC Switch 中识别和切换
所有模型均为下拉选择,未选择时显示「请选择模型」。
3.
完成配置 点击 「打开 CC Switch」 即可将配置导入 CC Switch 并开始使用;点击 「取消」 放弃本次操作。
安装方式#
macOS(推荐 Homebrew)#
brew tap farion1231/ccswitch
brew install --cask cc-switch
Windows#
Linux#
Web 版本(无头 / SSH 服务器)#
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web
默认端口 17666,通过浏览器访问http://localhost:17666。