CC-Switch · 通用步骤

CC-Switch 是一个开源的 Claude Code / Codex / Gemini CLI 配置管理工具。它用图形界面帮你管理各 CLI 的供应商配置、一键切换,免去手动编辑配置文件。

CC-Switch 是第三方开源工具,非天枢官方维护。安装前可自行查看其开源仓库。

它能做什么

• ✅ 一键切换 API 配置 —— 在多个供应商之间快速切换
• ✅ 可视化配置管理 —— 图形界面管理所有配置
• ✅ MCP 服务器管理
• ✅ 系统托盘快捷操作

软件下载

前往 CC-Switch 的 GitHub Releases 页面下载对应系统的安装包:

Windows

访问 GitHub Releases,选择 .msi 安装包下载并安装。
安装后运行 CC-Switch 主程序。

macOS (Homebrew)

# 添加 tap 源
brew tap farion1231/ccswitch
# 安装 CC-Switch
brew install --cask cc-switch
# 完成后在「启动台 / 应用程序」中找到 CC-Switch 启动

Linux (Debian/Ubuntu)

# 到 GitHub Releases 查看最新版本号,替换下面的文件名
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

先完成环境检查

请勿跳过

CC-Switch 只是帮你管理配置,真正运行模型仍依赖 Node.js 和对应 CLI(Claude Code / Codex)。请先完成 环境检查与 CLI 安装,确保 node、claude、codex 都能正常运行。

把天枢加为自定义供应商

CC-Switch 内置了一些供应商模板,天枢需要你手动添加为自定义供应商:

• 供应商名称:天枢 / tianshu(自定义)
• 接口地址(Base URL):见各 CLI 教程(Claude Code 用 https://tian-shu.org,Codex 用 https://tian-shu.org/v1)
• API Key:在 控制台 → 令牌管理 创建、选对分组的令牌

下一步

按 CLI 类型继续:

• CC-Switch · Claude Code 配置
• CC-Switch · Codex 配置