Claude Code Model Switcher

一个基于 Electron 的系统托盘应用，用于快速切换 Claude Code 的模型配置。

English README

功能特性 • 安装使用 • CLI 工具 • 开发指南

截图

主界面

配置

托盘

深色模式

功能特性

🚀 一键切换模型来源

系统托盘菜单快速切换不同 Provider（Kimi、GLM、Anthropic、DeepSeek、Copilot）
自动更新 ~/.claude/settings.json 配置文件
切换时自动备份和清除会话缓存
托盘图标显示当前激活状态

🎯 灵活配置模型

支持配置四种模型角色：Opus、Sonnet、Haiku、Subagent
API 自动拉取：从各 Provider API 获取最新可用模型列表
下拉选择或手动输入模型 ID
每个 Provider 独立保存配置，支持预设模板

🔐 安全凭证管理

加密存储各 Provider 的 API Token
支持配置 Base URL、超时时间等参数
内置连接测试功能验证凭证有效性

🤖 Copilot 深度集成

一键安装管理：自动检测并安装 copilot-api
服务管理：启动/停止代理服务，实时状态监控
OAuth 认证：简化 GitHub 认证流程
Token 自动管理和状态显示

支持的 Provider

Provider	名称	Base URL	特点
Kimi K2	Moonshot AI	`https://api.moonshot.cn/anthropic`	支持长上下文
GLM	智谱 AI	`https://open.bigmodel.cn/api/anthropic`	国内高速访问
Anthropic	Claude 官方	`https://api.anthropic.com`	原生支持
DeepSeek	DeepSeek V3	`https://api.deepseek.com/anthropic`	经济实惠
Copilot	GitHub Copilot	`http://localhost:4141`	通过 copilot-api 代理

安装使用

🖥️ 桌面应用

下载安装

从 Releases 页面下载对应平台的安装包：

平台	文件格式	说明
macOS	`.dmg`	双击安装，拖拽到 Applications
Windows	`.exe`	双击运行安装程序
Linux	`.AppImage` / `.deb`	AppImage 添加执行权限后直接运行

macOS 无法打开应用的解决方案

如果 macOS 提示"应用已损坏，无法打开"，这是因为应用未经过 Apple 代码签名。您可以通过以下方式解决：

方法 1：通过"系统设置"解除限制 ⭐️ 推荐

尝试双击打开应用，macOS 会弹出警告
打开"系统设置"(System Settings) → "隐私与安全性"(Privacy & Security)
在"安全性"部分，会看到："已阻止使用 'Claude Code Model Switcher'，因为来自身份不明的开发者"
点击 "仍要打开"(Open Anyway) 按钮
在确认对话框中点击 "打开"(Open)

💡 提示：这条消息只会在尝试打开应用后的约 1 小时内显示，如果没看到请重新尝试打开应用。

方法 2：右键菜单打开

在 Finder 中找到应用
按住 Control 键点击（或右键点击）应用图标
选择"打开"(Open)
在弹出的对话框中点击"打开"(Open) 按钮

方法 3：使用终端命令

# 移除隔离属性
xattr -cr "/Applications/Claude Code Model Switcher.app"

首次使用

启动应用：安装后在系统托盘找到图标
添加 Provider：点击"管理 Providers" → "添加 Provider"

配置凭证：

- 输入 Provider ID（如 kimi）
- 填写 API Token
- 设置 Base URL（自动添加 /anthropic 后缀）

拉取模型列表：点击"从 API 拉取模型列表"
选择模型：为 Opus/Sonnet/Haiku/Subagent 选择合适的模型
保存并切换：保存配置后，在托盘菜单中切换到该 Provider

日常使用

快速切换：托盘菜单 → 选择 Provider
查看状态：托盘菜单会标记当前激活的 Provider（✓）
编辑配置：管理 Providers → 选择 Provider → 点击配置图标
查看脚本：点击"编辑脚本"查看/修改模型获取逻辑

CLI 工具

专为无 GUI 的服务器环境设计的命令行工具，与桌面应用共享配置。

📦 安装

# 方式一：全局安装（推荐）
npm install -g cc-model-switcher

# 方式二：手动安装（从源码）
git clone git@github.com:rasenjs/ccms.git cc-model-switcher
cd cc-model-switcher
npm install
npm run build:cli
npm link

🎮 命令

# 查看帮助
ccms help

# 列出所有 Provider（标记当前激活）
ccms list
# 或
ccms ls

# 切换到指定 Provider
ccms switch <provider-id>

# 显示当前配置详情
ccms current
# 或
ccms show

💡 使用示例

# 查看所有可用 Provider
$ ccms list
Available Providers:
  ▶ kimi         - Kimi K2
    glm          - 智谱 GLM
    anthropic    - Anthropic 官方
    deepseek     - DeepSeek V3
    copilot      - GitHub Copilot

# 切换到 GLM
$ ccms switch glm
✓ Switched to provider: glm
  Config: ~/.claude/settings.json
  Backup: ~/.claude/settings.json.backup.2025-12-11T10-30-00-000Z

# 查看当前配置
$ ccms current
Current Provider: glm (智谱 GLM)

Configuration:
  Base URL: https://open.bigmodel.cn/api/anthropic
  Token: eabe***b770
  Models:
    Opus:     glm-4-plus
    Sonnet:   glm-4-flash
    Haiku:    glm-4-flash
    Subagent: glm-4-flash

🔧 配置位置

平台	配置目录
macOS/Linux	`~/.config/cc-model-switcher/`
Windows	`%APPDATA%\cc-model-switcher\`

CLI 工具会读取桌面应用的配置，反之亦然。你可以在桌面应用中添加 Provider，然后在服务器上用 CLI 切换。

开发指南

🛠️ 环境要求

Node.js >= 20
npm >= 9

📥 克隆项目

git clone git@github.com:rasenjs/ccms.git cc-model-switcher
cd cc-model-switcher
npm install

🚀 开发模式

# 启动开发服务器（热重载）
npm run dev

# 单独编译主进程（TypeScript 监听模式）
npm run dev:main

# 单独编译渲染进程（Vite 开发服务器）
npm run dev:renderer

访问 http://localhost:9527 查看渲染进程，主进程会自动在 Electron 中运行。

🔨 构建

# 编译所有代码
npm run build

# 单独编译主进程
npm run build:main

# 单独编译渲染进程
npm run build:renderer

# 编译 CLI 工具
npm run build:cli

# 类型检查
npm run typecheck

# 代码检查
npm run lint

📦 打包应用

# 打包当前平台
npm run package

# 打包指定平台
npm run package -- --mac     # macOS
npm run package -- --win     # Windows
npm run package -- --linux   # Linux

输出目录：dist/

electron-builder 打包输出目录：release/

🧪 测试 CLI

# 编译 CLI
npm run build:cli

# 直接运行（无需安装）
node dist/cli/index.js list
node dist/cli/index.js switch kimi
node dist/cli/index.js current

项目结构

cc-model-switcher/
├── src/
│   ├── main/                    # Electron 主进程
│   │   ├── index.ts             # 主入口，IPC 通信
│   │   ├── tray.ts              # 系统托盘管理
│   │   ├── config.ts            # 配置读写，Provider 切换
│   │   ├── preload.ts           # 预加载脚本，安全桥接
│   │   └── providers/
│   │       ├── copilot.ts       # Copilot 服务管理
│   │       ├── model-fetcher.ts # API 模型列表拉取
│   │       └── script-loader.ts # 脚本沙盒执行
│   ├── renderer/                # React 渲染进程
│   │   ├── App.tsx              # 根组件
│   │   ├── main.tsx             # React 入口
│   │   ├── index.html           # HTML 模板
│   │   ├── components/
│   │   │   ├── ProviderList.tsx    # Provider 列表
│   │   │   ├── ProviderConfig.tsx  # Provider 配置面板
│   │   │   ├── CopilotPanel.tsx    # Copilot 管理
│   │   │   └── InputDialog.tsx     # 输入对话框
│   │   ├── hooks/
│   │   │   └── useElectronAPI.ts   # Electron API Hook
│   │   └── styles/
│   │       └── index.css           # 全局样式
│   ├── cli/                     # CLI 工具
│   │   └── index.ts             # CLI 入口，命令处理
│   └── shared/                  # 共享代码
│       ├── types.ts             # TypeScript 类型定义
│       └── presets.ts           # 预设配置和脚本模板
├── assets/                      # 应用图标
│   ├── icon.icns               # macOS 图标
│   ├── icon.ico                # Windows 图标
│   └── icon.png                # Linux 图标
├── .github/
│   └── workflows/
│       ├── build.yml           # 自动构建和发布
│       └── lint.yml            # 代码检查
├── dist/                        # 构建输出（gitignore）
├── package.json                 # 项目配置
├── tsconfig.json                # TypeScript 配置
├── tsconfig.main.json           # 主进程 TS 配置
├── tsconfig.cli.json            # CLI TS 配置
├── vite.config.ts               # Vite 配置
└── README.md                    # 本文档

配置说明

Claude Settings 文件

应用会修改 ~/.claude/settings.json，注入以下环境变量：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-token",
    "ANTHROPIC_BASE_URL": "https://api.provider.com/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
    "ANTHROPIC_SUBAGENT_MODEL": "model-subagent"
  }
}

自动备份

每次切换 Provider 时，当前配置会自动备份到：

~/.claude/settings.json.backup.<ISO-timestamp>

会话缓存清理

切换后会自动清除 ~/.claude/session-env/ 中的缓存文件。

跨平台支持

功能	macOS	Linux	Windows	说明
桌面应用	✅	✅	✅	完全支持
CLI 工具	✅	✅	✅	完全支持
配置目录	`~/.config`	`~/.config`	`%APPDATA%`	自动适配
Copilot API	✅	✅	⚠️	Windows 进程管理有限制

详见 CROSS_PLATFORM_CHANGES.md

常见问题

Q: 如何获取 API Token？

Kimi: https://platform.moonshot.cn/console/api-keys
GLM: https://open.bigmodel.cn/usercenter/apikeys
Anthropic: https://console.anthropic.com/settings/keys
DeepSeek: https://platform.deepseek.com/api_keys
Copilot: 使用应用内的 OAuth 认证

Q: 切换后 Claude Code 不生效？

确认 ~/.claude/settings.json 已更新
重启 Claude Code 应用或 VS Code
检查 Provider 配置中的 Base URL 是否正确

Q: Copilot 服务启动失败？

确认已安装 copilot-api：npm install -g copilot-api
检查端口 4141 是否被占用
完成 GitHub OAuth 认证
查看应用日志获取详细错误信息

Q: CLI 工具找不到配置？

确保至少运行过一次桌面应用并添加了 Provider。CLI 和桌面应用共享配置目录。

贡献指南

欢迎提交 Issue 和 Pull Request！

Fork 本仓库
创建功能分支：git checkout -b feature/amazing-feature
提交更改：git commit -m 'Add amazing feature'
推送到分支：git push origin feature/amazing-feature
提交 Pull Request

许可证

MIT License

致谢

Electron - 跨平台桌面应用框架
React - UI 框架
Vite - 构建工具
copilot-api - Copilot 代理服务

⬆ 回到顶部

Made with ❤️ by developers, for developers

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
.github		.github
.vscode		.vscode
assets		assets
scripts		scripts
snapshots		snapshots
src		src
.editorconfig		.editorconfig
.eslintignore		.eslintignore
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
.release-it.json		.release-it.json
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
RELEASE.md		RELEASE.md
ROADMAP.md		ROADMAP.md
SECURITY.md		SECURITY.md
icon-silhouette.png		icon-silhouette.png
icon-solid.png		icon-solid.png
package-lock.json		package-lock.json
package.json		package.json
tsconfig.cli.json		tsconfig.cli.json
tsconfig.json		tsconfig.json
tsconfig.main.json		tsconfig.main.json
tsconfig.node.json		tsconfig.node.json
tsconfig.preload.json		tsconfig.preload.json
vite.config.mts		vite.config.mts

License

rasenjs/ccms

Folders and files

Latest commit

History

Repository files navigation