search
官网

cc-switch

circle-info

cc-switch是一款用于管理和切换 Claude Code 和 Codex 提供商配置和 MCP 服务器的跨平台桌面应用程序。Github地址：https://github.com/farion1231/cc-switch

hashtag
功能特性

核心功能

  • 供应商管理：一键切换 Claude Code、Codex 与 Gemini 的 API 配置

  • MCP 集成：集中管理 MCP 服务器，支持 stdio/http 类型和实时同步

  • 速度测试：测量 API 端点延迟，可视化连接质量指示器

  • 导入导出：备份和恢复配置，自动轮换（保留最近 10 个）

  • 国际化支持：完整的中英文本地化（UI、错误、托盘）

  • Claude 插件同步：一键应用或恢复 Claude 插件配置

v3.6 亮点

  • 供应商复制 & 拖拽排序

  • 多端点管理 & 自定义配置目录（支持云同步）

  • 细粒度模型配置（四层：Haiku/Sonnet/Opus/自定义）

  • WSL 环境支持，配置目录切换自动同步

  • 100% hooks 测试覆盖 & 完整架构重构

  • 新增预设：DMXAPI、Azure Codex、AnyRouter、AiHubMix、MiniMax

系统功能

  • 系统托盘快速切换

  • 单实例守护

  • 内置自动更新器

  • 原子写入与回滚保护

hashtag
下载安装

hashtag
系统要求

  • Windows: Windows 10 及以上

  • macOS: macOS 10.15 (Catalina) 及以上

  • Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版

hashtag
Windows 用户

从 Releasesarrow-up-right 页面下载最新版本的 CC-Switch-v{版本号}-Windows.msi 安装包或者 CC-Switch-v{版本号}-Windows-Portable.zip 绿色版。

hashtag
macOS 用户

方式一：通过 Homebrew 安装（推荐）brew tap farion1231/ccswitchbrew install --cask cc-switch更新：brew upgrade --cask cc-switch方式二：手动下载从 Releasesarrow-up-right 页面下载 CC-Switch-v{版本号}-macOS.zip 解压使用。

注意：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开

hashtag
Linux 用户

从 Releasesarrow-up-right 页面下载最新版本的 CC-Switch-v{版本号}-Linux.deb 包或者 CC-Switch-v{版本号}-Linux.AppImage 安装包。

hashtag
快速开始

hashtag
基本使用

  1. 添加供应商：点击"添加供应商" → 选择预设或创建自定义配置

  2. 切换供应商：

    1. 主界面：选择供应商 → 点击"启用"

    2. 系统托盘：直接点击供应商名称（立即生效）

  3. 生效方式：重启终端或 Claude Code / Codex / Gemini 客户端以应用更改

  4. 恢复官方登录：选择"官方登录"预设（Claude/Codex）或"Google 官方"预设（Gemini），重启对应客户端后按照其登录/OAuth 流程操作

hashtag
MCP 管理

  • 位置：点击右上角"MCP"按钮

  • 添加服务器：使用内置模板（mcp-fetch、mcp-filesystem）或自定义配置

  • 启用/禁用：切换开关以控制哪些服务器同步到 live 配置

  • 同步：启用的服务器自动同步到 ~/.claude.json（Claude）或 ~/.codex/config.toml（Codex）

hashtag
配置文件

Claude Code

  • Live 配置：~/.claude/settings.json（或 claude.json）

  • API key 字段：env.ANTHROPIC_AUTH_TOKEN 或 env.ANTHROPIC_API_KEY

  • MCP 服务器：~/.claude.json → mcpServers

Codex

  • Live 配置：~/.codex/auth.json（必需）+ config.toml（可选）

  • API key 字段：auth.json 中的 OPENAI_API_KEY

  • MCP 服务器：~/.codex/config.toml → [mcp.servers]

Gemini

  • Live 配置：~/.gemini/.env（API Key）+ ~/.gemini/settings.json（保存认证模式，支持托盘快速切换）

  • API key 字段：.env 文件中的 GEMINI_API_KEY

  • 托盘快速切换：每次切换供应商都会重写 ~/.gemini/.env，Gemini CLI 无需额外操作即可使用新配置

CC Switch 存储

  • 主配置（SSOT）：~/.cc-switch/config.json

  • 设置：~/.cc-switch/settings.json

  • 备份：~/.cc-switch/backups/（自动轮换，保留 10 个）

hashtag
云同步设置

  1. 前往设置 → "自定义配置目录"

  2. 选择您的云同步文件夹（Dropbox、OneDrive、iCloud、坚果云等）

  3. 重启应用以应用

  4. 在其他设备上重复操作以启用跨设备同步

注意：首次启动会自动导入现有 Claude/Codex 配置作为默认供应商。

上一页OpenCode 配置手册下一页隐私政策

最后更新于