前面聊过 cc switch 的基础用法，今天单独说一下 CC Switch 里 Claude Desktop 面板的配置。在 3.15.0 中加入的功能，专门用来给 Claude Desktop 这个官方桌面客户端接入第三方供应商。

CC Switch 中的「Claude」和「Claude Desktop」是两个不同的面板，分别对应 Claude Code（CLI）和 Claude Desktop（桌面客户端）。区别在于 Claude Desktop 用的是自己的 3P profile 配置，而不是 ~/.claude/settings.json，两个面板在图标右下角会有小标记区分。

功能说明

Claude Desktop 面板能做的事情很简单：

• 给 Claude Desktop 接入 Anthropic 兼容的第三方供应商
• 为 DeepSeek、Kimi、DouBao、OpenAI、Gemini 等非 Claude 模型配置模型映射
• 在 Claude Desktop 官方模式和第三方供应商之间一键切换

支持 macOS 和 Windows。Linux 暂时不能写入 Claude Desktop 的 3P 配置。切换供应商后需要重启 Claude Desktop 才能生效，它不会像 Claude Code 那样热加载。

另外有一点需要注意：Claude Desktop 的 3P profile 不走 CC Switch 的 MCP / Skills 同步，这些功能在桌面端是独立管理的。

快速上手

1. 切到 Claude Desktop 面板

左侧应用切换器里选择 Claude Desktop。

如果没看到入口，去 设置 → 通用 → 应用可见性 里确认没有被隐藏。

2. 导入或添加供应商

从 Claude Code 一键导入（推荐）

大部分用户是先在 Claude Code 里配好了一堆供应商，然后才想把这些配置带到 Claude Desktop 里。第一次进入 Claude Desktop 面板时，如果这里还没有供应商，直接点 将 Claude Code 中已有的供应商导入 就行。

这个功能会帮你把 Claude Code 那边的供应商配置一键搬过来，不用重新填接口地址、API Key 和默认模型。导入逻辑大概是：

• 已存在同 ID 供应商时不会覆盖
• 能直连且模型名安全的供应商会导入为直连模式
• 需要模型转换的供应商会尝试导入为模型映射模式
• ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 会自动转成 Desktop 的 Sonnet / Opus / Haiku 映射
• 旧的 [1M] 后缀会转成 Desktop profile 中的 supports1m 标记
• 无法判断模型映射关系的供应商会跳过

导入之后建议逐个检查一下模型映射是否正确，尤其是 Kimi、DeepSeek、GLM、DouBao 这类非 Claude 模型，通常需要用模型映射模式。

手动添加

如果没有可导入的配置，或者想专门给 Claude Desktop 加一个不同的供应商，点右上角 + 添加即可。

三种选择：

• 预设供应商：从内置预设里选，只填 API Key
• 自定义供应商：手动写名称、接口地址、API Key 和模型设置
• Claude Desktop Official：恢复 Claude Desktop 官方登录模式

对于普通的 Anthropic Messages API 兼容供应商，流程很简单：选预设或自定义 → 填 API Key → 确认接口地址 → 关掉「需要模型映射」→ 添加。

3. 切换并重启 Claude Desktop

在供应商卡片上点「启用」，然后完全退出并重启 Claude Desktop。

注意：Claude Desktop 不会热重载配置，只关聊天窗口不够，要从托盘里退出或者确保进程完全结束。

两种工作模式

直连模式

适合供应商本身提供了原生 Anthropic Messages API 的情况。CC Switch 会把 Claude Desktop 的 3P profile 直接指到供应商接口：

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://api.example.com",
  "inferenceGatewayAuthScheme": "bearer",
  "inferenceGatewayApiKey": "你的 API Key"
}

适用条件：供应商暴露的是原生 Anthropic Messages API，模型 ID 是 claude-* 或 anthropic/claude-* 格式，不需要格式转换。直连模式下不需要 CC Switch 一直开着本地路由。

「手动指定 Claude Desktop 模型列表」是个高级选项，大部分原生 Claude 模型供应商不需要填，Claude Desktop 会自动读 /v1/models。只有供应商的 /v1/models 不可用，或者返回的模型名 Claude Desktop 不认识时才需要手动添加。

模型映射模式

如果供应商不是 Claude 系列模型（比如 deepseek、kimi 等），或者接口格式需要 CC Switch 做转换，就要开启「需要模型映射」。

开启后，Claude Desktop 会连到 CC Switch 的本地网关：

http://127.0.0.1:15721/claude-desktop

CC Switch 在中间负责：向 Claude Desktop 暴露安全的 claude-* 模型路由，把 Desktop 选的模型角色映射到真实上游模型，按供应商要求做 Anthropic / OpenAI / Gemini 格式转换，并用 CC Switch 里存的凭据访问上游。

支持的格式：

模型映射模式下，Claude Desktop 只能看到 claude-* 形式的路由模型名，真实的上游模型名不会写进 Claude Desktop profile。

配置模型映射

模型映射的核心思路是：Claude Desktop 现在会拒绝非 claude-* 的模型名，所以需要通过 CC Switch 做一轮角色映射。

举个例子，如果想在 Claude Desktop 里用 Kimi：

想用 DeepSeek：

三个角色的建议分工：

如果供应商只有一个模型，只配一个 Sonnet 也行。模型映射模式至少需要一条有效映射。

本地路由

模型映射模式必须依赖 CC Switch 的本地路由来做请求转换。这个开关默认在主界面是隐藏的，需要手动打开。

去 设置 → 路由 → 本地路由，开启 在主页面显示本地路由开关。

打开后回到 Claude Desktop 面板，右上角就能看到本地路由开关了。

状态含义：

只有开了「需要模型映射」的供应商才需要本地路由，直连的不用管。

如果其他应用正在用代理接管，关本地路由可能会被阻止。先去设置里的路由服务区域关掉对应应用接管，再停本地路由。

恢复官方 Claude Desktop

想切回官方登录模式的话：

1. 选 Claude Desktop Official
2. 点「启用」
3. 重启 Claude Desktop

CC Switch 会恢复 Claude Desktop 的官方 1P 模式，把 3P profile 清理掉。官方模式不需要 API Key，也不需要本地路由。

从 Claude Code 导入供应商时，会自动加一条 Claude Desktop Official，方便随时切回去。

配置文件位置

CC Switch 写入的是 Claude Desktop 的 3P 配置目录：

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json
~/Library/Application Support/Claude-3p/claude_desktop_config.json
~/Library/Application Support/Claude-3p/configLibrary/_meta.json
~/Library/Application Support/Claude-3p/configLibrary/00000000-0000-4000-8000-000000157210.json

Windows：

%LOCALAPPDATA%\Claude\claude_desktop_config.json
%LOCALAPPDATA%\Claude-3p\claude_desktop_config.json
%LOCALAPPDATA%\Claude-3p\configLibrary\_meta.json
%LOCALAPPDATA%\Claude-3p\configLibrary\00000000-0000-4000-8000-000000157210.json

配置文件由 CC Switch 自动维护，不建议手动改。如果出现配置不一致，重新启用一次当前供应商一般就能修好。

总结

CC Switch 的 Claude Desktop 面板本质上就是把原本只对 CLI 工具开放的供应商管理能力搬到了桌面端。对于已经在 CC Switch 里配置了一堆供应商的用户来说，从 Claude Code 一键导入是最快的路径。

直连模式省心，模型映射模式灵活。如果主力用 Claude 系列模型，直连就够了；如果想在 Claude Desktop 里用 Kimi、DeepSeek 等模型，模型映射模式配合本地路由就能搞定。

在 AI 编程工具的世界里，Claude Code 无疑是当前最强大的选择之一。然而，随着各大云服务商纷纷推出自己的大语言模型 API，如何方便地在不同供应商之间切换，成为了一个实际的需求。今天就给大家介绍两款工具：cc switch 和 cc desktop switch，帮助你快速切换 Claude Code 的模型供应商。

项目地址：

• cc switch: farion1231/cc-switch (54.9k ⭐)
• cc desktop switch: lonr-6/cc-desktop-switch

什么是 cc switch

cc switch 是一款跨平台的桌面应用，专门用于管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 这五款主流 AI 编程 CLI 工具的供应商配置。

核心功能

1. 统一管理：一个应用同时管理五个 CLI 工具的供应商配置
2. 50+ 供应商预设：内置 AWS Bedrock、NVIDIA NIM 及众多社区中转服务，复制 API Key 即可一键导入
3. 一键切换：主界面或系统托盘都能快速切换供应商
4. MCP & Skills 统一管理：一个面板管理四个应用的 MCP 服务器和 Skills，支持双向同步
5. 代理和故障转移：本地代理支持格式转换、自动故障转移、熔断器、供应商健康监控
6. 使用和成本跟踪：仪表盘展示支出、请求数和 Token 趋势图表
7. 会话管理器：跨应用浏览、搜索和恢复对话历史
8. 云同步：支持 Dropbox、OneDrive、iCloud、NAS 或 WebDAV 服务器同步配置
9. 跨平台：原生桌面应用，支持 Windows、macOS 和 Linux

支持的应用

• Claude Code：Anthropic 的 AI 编程助手
• Codex：OpenAI 的编程 CLI 工具
• Gemini CLI：Google 的 AI CLI 工具
• OpenCode：开源的 AI 编程工具
• OpenClaw：新兴的 AI 编程工具

安装 cc switch

macOS 用户

# 通过 Homebrew 安装（推荐）
brew tap farion1231/ccswitch
brew install --cask cc-switch

# 更新
brew upgrade --cask cc-switch

或者从 Releases 页面下载 CC-Switch-v{version}-macOS.dmg。

Windows 用户

从 Releases 页面下载：

• CC-Switch-v{version}-Windows.msi 安装版
• CC-Switch-v{version}-Windows-Portable.zip 便携版

Linux 用户

# Arch Linux
paru -S cc-switch-bin

# 或从 Releases 下载 deb/rpm/AppImage

什么是 cc desktop switch

cc desktop switch 是一款专注于 Claude Desktop 官方桌面客户端 的轻量级配置工具。它和 cc switch 的定位不同：cc switch 主要面向 CLI 用户，而 cc desktop switch 专注于桌面版 Claude Desktop。

核心功能

1. 管理多个 API 提供商：DeepSeek、Kimi、智谱 GLM、阿里云百炼、SiliconFlow 等
2. 一键写入配置：将选中的供应商配置直接写入 Claude Desktop 的本地配置
3. 直连模式：Anthropic 兼容接口默认直连，关闭本工具后 Claude Desktop 仍可继续使用
4. 实验兼容模式：保留 OpenAI/new-api/反代类接口的本机转发支持
5. 基础连通测速：对提供商 API 地址做基础连通测试
6. 中英文界面：支持中文/英文界面和浅色/深色模式

基本用法

cc switch 用法

1. 添加供应商：点击「Add Provider」→ 选择预设或创建自定义配置
2. 切换供应商：
   • 主界面：选中供应商 → 点击「Enable」
   • 系统托盘：直接点击供应商名称（即时生效）
3. 生效方式：重启终端或对应的 CLI 工具（Claude Code 无需重启）
4. 恢复官方：添加「Official Login」预设，重启 CLI 工具后按照其登录/OAuth 流程操作

cc desktop switch 用法

1. 启动 CC Desktop Switch
2. 在弹出的桌面窗口里操作
3. 选择快捷预设，填写自己的 API Key，必要时调整模型映射
4. 点击「一键应用到 Claude Desktop」
5. 完整重启 Claude Desktop 后测试

注意：只关闭聊天窗口通常不够，请在任务栏托盘里退出 Claude，或在任务管理器里确认没有残留的 Claude 进程。

实际使用体验

笔者使用 cc switch 已经有一段时间了，整体体验非常不错。以下是我的一些使用感受：

优点

1. 切换方便：相比手动修改配置文件，图形界面更加直观
2. 多应用支持：同时支持 Claude Code、Codex、Gemini CLI 等多个应用
3. 成本监控：可以清晰地看到各个供应商的使用情况
4. 托盘运行：最小化到托盘后不会占用太多资源
5. 预设丰富：内置 50+ 供应商预设，无需手动配置

总结

cc switch 和 cc desktop switch 为 Claude Code 用户提供了便捷的供应商管理方案。两者的定位略有不同：

• cc switch：面向 CLI 用户，统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款工具
• cc desktop switch：面向 Claude Desktop 桌面版用户，更轻量，专注于桌面客户端

无论你是需要测试不同模型的效果，还是想要找到性价比最高的供应商，这些工具都能满足你的需求。如果你正在使用 Claude Code，不妨试试这些工具，相信它们会给你带来不错的体验。

如果你对 AI 编程工具感兴趣，也可以看看我之前的文章：Neovim 入门指南系列，里面有很多关于编辑器配置和 AI 集成的相关内容。