Claude Desktop 接第三方 API 教程：用 CC Switch 快速配置

📚 零基础 AI 编程课：我开了一门系统的入门课，专门带完全没写过代码的人用 AI 做出第一个作品，跟本文正好配套。 👉 https://vibecoding.hot/

之前我写过 Claude Code VS Code 插件版教程，反馈一直分两派。

懂技术的觉得「这就够了」，不懂技术的反馈是：「VS Code 那个界面我一打开就想关掉。」「能不能给个不用敲命令的方案？」

现在直接用 CC Switch 就能配置。

推荐先走本文的 CC Switch 流程：在左侧选择 Claude Desktop，导入已有供应商或添加一个新供应商，切换后重启 Claude Desktop。已经在 CC Switch 里配置过 Claude Code 的朋友，还能复用已有的接口地址和 API Key。

Anthropic 官方桌面 app 在四月份悄悄开放了一个隐藏模式，不用登 claude.ai 账号，直接填你自己的 API key，界面就是普通聊天软件的样子，全程不碰命令行。

先认识一下：Cowork 和 Code 是什么

配通之后，Claude 桌面 app 里会有两个 tab，分别对应两种工作模式：

Cowork 模式：任务协作。

把它当一个能干活的对话框就行：写周报、整理会议纪要、改文档、做研究、生成网页/小工具（Artifacts 直接渲染出来看）。它会读取你指定的工作目录，知道你在做什么项目，配合 MCP 工具和 Skills 插件，是日常办公场景的主力。

适合：写作者、产品经理、运营、研究人员，所有「想用 AI 干活但不写代码」的人。

Code 模式：内嵌 Claude Code。

就是把命令行版的 Claude Code 包了一层界面进来，能直接读项目代码、改文件、跑命令。如果你之前看 Claude Code 教程被命令行劝退，这里你只需要点开 Code tab 就能用。

适合：写代码（包括 vibe coding 的非程序员）、调脚本、做网页项目。

简单说：日常对话用 Cowork，写代码用 Code，一个 app 两套场景。下面正式开始配置。

第一步：准备工作

1.1 准备一个 API key

跟 Claude Code 一样，推荐用中转方案，或者国产平替。

中转方案：

注册 → 充值（50 块就能起步）→ 在控制台复制两样东西：

• Base URL：长得像 https://api.xxx.com
• API Key：以 sk- 开头的一串

添加供应商时会用到这两个值。已经在 CC Switch 里配过供应商的，可以直接导入。

提示：这两个值跟你之前 Claude Code 配置用的完全一样。如果你已经在用 Claude Code，直接拿来复用即可。

1.2 安装 Claude Desktop

下载地址：claude.ai/download

• Mac：下载 .dmg，拖进 Applications。系统要求 macOS 13 以上。
• Windows：下载 .msix，双击安装。系统要求 Windows 10 或 11。

Windows 用户特别注意：如果之前没装过虚拟机相关的东西，第一次跑会要求你打开「虚拟机平台」特性并重启一次。装之前先把没保存的文件保存好。

装完先打开一次，让它跑起来。这一步看到登录窗口直接关掉，不要登 claude.ai 账号。

第二步：安装 CC Switch，选择 Claude Desktop

从 CC Switch 官方 GitHub Releases 下载适合你系统的版本并安装。使用包含 Claude Desktop 入口的新版。

打开 CC Switch，在左侧应用列表中点击 Claude Desktop。注意选桌面端这一项；Claude Code 和 Claude Desktop 的配置是分开的。

如果侧栏里看不到 Claude Desktop，先到左下角「应用」里检查是否隐藏了该入口，并确认 CC Switch 已更新。

图中是本文配置时的界面。不同版本的标签和布局可能有所变化，按 Claude Desktop 入口和供应商配置操作即可。

第三步：导入或添加供应商

已经配过 Claude Code：直接导入

点击页面中的 「将 Claude Code 中已有的供应商导入」，导入后检查接口地址和模型设置，再切换到要使用的供应商。

这是已有 CC Switch 用户最省事的做法，不用重新抄一遍 API Key。导入后仍需要在 Claude Desktop 页面切换供应商；只在 Claude Code 页面切换不会替桌面端完成配置。

第一次使用：添加供应商

点击右上角 「添加供应商」，优先选择对应的预设；没有对应预设时，再添加自定义供应商。

接 Claude 模型：供应商提供 Anthropic Messages API，且支持 Desktop 可识别的 claude-sonnet-*、claude-opus-*、claude-haiku-* 模型角色时，可以使用直连。

接其他模型，或接口需要转换：使用 CC Switch 的模型映射功能，按供应商的 API 格式填写，并把 Sonnet / Opus / Haiku 角色映射到实际的上游模型 ID。具体选项可参考 CC Switch 的 Claude Desktop 配置文档。

保存后，在供应商卡片上点击 「切换」，确认当前供应商显示为使用中。

第四步：完全退出并重启 Claude Desktop

• Mac：按 Cmd + Q，或菜单栏 Claude → Quit Claude。
• Windows：从系统托盘退出 Claude Desktop，确认程序结束后再打开。

每次切换供应商后都要重启，单纯关闭窗口通常不够。

打开后，选一个可用模型，发一句「你好，请简单介绍一下你能做什么」。能正常回复，再试一次读取工作目录或生成文件，确认你要用的工作流程能跑通。

如果用了模型映射，需要让 CC Switch 和本地路由服务保持运行；直连模式下，Claude Desktop 重启并加载配置后可以退出 CC Switch。

备用方法：在 Claude Desktop 中手动配置

想自己填写配置，也可以使用 Claude Desktop 的开发者菜单：

1. 顶部菜单栏 → Help → Troubleshooting → Enable Developer mode。
2. 重启后进入 Developer → Configure third-party inference。
3. Inference Provider 选 gateway，填写 Base URL 和 API Key。
4. 点击 Apply locally，再完全退出并重启 Claude Desktop。

日常添加、管理和切换供应商，推荐直接在 CC Switch 中完成。

跑一下试试

随便发一句话验证下，比如：「帮我做一个待办清单网页，可以添加、勾选完成、删除，数据存在浏览器本地」。

几分钟后你会在对话区看到一个能直接预览的网页（Artifacts），点开可用，代码也能直接拿走。

这就是 Cowork 的日常用法。Code tab 同理，只是它更适合操作真实项目目录。

新手常见问题

Q1：对话历史会同步到 claude.ai 吗？

不会。因为你压根没登录 claude.ai 账号，对话只存本地。换电脑要自己迁移，或者重新开始。

Q2：之前用 claude.ai 网页版的对话还在吗？

在的。这个新模式走的是完全独立的一套数据，不影响你原有的 claude.ai 账号和对话历史。

Q3：怎么切回 claude.ai 账号登录？

在 CC Switch 的 Claude Desktop 页面选择 Claude Desktop Official，点击切换，再重启 Claude Desktop，即可恢复官方登录模式。

Q4：钱怎么算？

第三方模式按所选供应商的 API 规则计费。CC Switch 负责管理配置，费用看供应商控制台；先用小额额度测试，再根据实际用量决定是否继续充值。

Q5：切换了供应商，怎么还没生效？

先确认操作的是 CC Switch 的 Claude Desktop 页面，再完全退出并重开 Claude Desktop。使用模型映射时，还要检查 CC Switch 正在运行、本地路由服务正常，以及实际模型 ID、接口地址和密钥填写正确。

Q6：还需要手动开启开发者模式吗？

使用 CC Switch 时，先按上面的导入、切换和重启流程操作。需要自己维护 Gateway 配置时，再使用本文的手动配置方法。

这条路适合谁

不是每个人都该走这条路。

• ✅ 你想用 Claude，但 claude.ai 账号注册不了或经常被风控
• ✅ 你不想搞魔法，想在国内付款国内访问
• ✅ 你看到 VS Code 和命令行就头疼，只想要一个普通聊天软件
• ✅ 你已经在用 Claude Code，想顺便有个图形版

不适合：

• ❌ 你只是偶尔聊两句，那直接 Cherry Studio、ChatBox 更轻
• ❌ 你是 CLI 重度用户，那继续 CLI，桌面端没有比 CLI 更强

配置参考：CC Switch 官方 Claude Desktop 使用文档 · Anthropic 第三方推理支持文档。

下一步

• 装好之后，找一个真实任务跑跑看：写一份周报、整理一份会议纪要、做一个待办清单网页（直接让 Claude 帮你写一个 HTML 出来，Artifacts 里能直接看效果）
• 公众号「AI 工具进化论」会持续更新这条路线的进展
• 加入 WaytoAGI AI 编程讨论区 一起折腾

关于作者：Ben，WaytoAGI AI 编程区主理人，前飞书多维表格产品经理。用 AI 编程独立完成 40+ 个网站项目。公众号 @AI工具进化论 | Twitter @littlebena