Claude Desktop 配置第三方 API 保姆级教程

947 阅读3分钟

Claude Desktop 配置第三方 API 保姆级教程

本文适合想在 Claude Desktop 里使用 Cowork、Projects、Artifacts 等功能,已有第三方 API 但想通过桌面端图形化界面来使用的用户。

Claude Desktop 第三方 API 配置路线图

第一步:开启隐藏入口

**重要前提:请确保使用最新版 Claude Desktop:低版本可能没有开发者模式或第三方推理配置入口。

打开 Claude Desktop,无需登录官方账号。

Claude Desktop 启动画面(Mac)

如果当前界面不好直接点菜单,可以按键盘 Tab 键切到左上角菜单区域,再按回车打开菜单。

在顶部菜单栏选择 Help(帮助)→ Troubleshooting(疑难解答)。

在弹出的子菜单里点击 Enable Developer Mode(启用开发者模式)。

  • window 启用开发者模式(Windows)

  • mac 启用开发者模式(Mac)

启用成功后,顶部菜单栏会多出一个 Developer(开发者)菜单。

接着点击 Developer 菜单,选择 Configure Third-Party Inference…(配置第三方推理…),进入第三方 API 配置页面。

  • window 打开第三方推理配置(Windows)
  • mac 打开第三方推理配置(Mac)

第二步:填写第三方 API 信息

方式一:直接填写第三方

打开配置窗口后,按下面方式设置:

Gateway:选择 Anthropic-compatible。

Gateway base URL:粘贴你的第三方 API Base URL。

Gateway API key:粘贴你的 API Key,也就是API 服务商后台复制出来的那串密钥。

设置完后,点击右下角 Apply locally。

填写 Gateway 和 API Key(Mac)

方式二: CC Switch

CC Switch配置好了自己apikey和端点并启用,然后按图中配置启用本地路由 CC Switch 本地路由配置

在claude desktop配置好对应的url和key,这里的key记得填:PROXY_MANAGED

Claude Desktop 填写 PROXY_MANAGED

第三步:验证是否成功

切换到本地配置(Mac)

配置完成后,Claude Desktop 可能会提示重启;如果没有提示,也建议手动完全退出后重新打开。

重新打开后,进入 Cowork、Code 或 Projects 相关页面,输入一个简单问题测试。

如果模型能正常响应,或者界面中显示的是你第三方 API 提供的模型,就说明配置成功。

Cowork 测试成功(Mac)

第三方模型已生效(Mac)

配置成功后你会发现:

可以正常使用 Project 功能:

Projects 可正常使用(Mac)

能使用图形化界面的 Claude Code:

Claude Code 可正常使用(Mac)

而且模型调用走你配置的第三方 API,按第三方 API 的计费方式结算。

如果配置有误需要退出:

切回官方 Claude(Mac)

常见坑别踩

找不到 Developer 菜单

确认已经点击 Help → Troubleshooting → Enable Developer Mode。

完全退出 Claude Desktop 后重新打开。

确保 Claude Desktop 已经更新到最新版本。

填了接口却连不上

重点检查这几项:

API Key 是否复制完整,前后不要多空格。

Base URL 是否以 https:// 开头。

确认你的第三方 API 是否支持 Anthropic-compatible,而不是只支持 OpenAI-compatible。

如果你的服务只提供 OpenAI-compatible 接口,需要先通过支持协议转换的网关,转换成 Anthropic Messages API 后再接入。

服务商是否要求额外请求头,如果要求,就需要填到 Gateway extra headers。

第三方 API 余额、额度或模型权限是否正常。

小贴士

这个配置是本地保存的,只影响当前电脑上的 Claude Desktop。

第三方 API 的质量很关键,建议优先选择稳定、透明、可信的服务。

官方客户端和相关功能可能随时更新,如果界面变化,以最新版本里的菜单和提示为准。

配置完成后,可以直接去试试 Cowork 或 Projects,桌面版体验确实很顺手。