Claude Desktop 配置第三方 API 保姆级教程
本文适合想在 Claude Desktop 里使用 Cowork、Projects、Artifacts 等功能,已有第三方 API 但想通过桌面端图形化界面来使用的用户。
第一步:开启隐藏入口
**重要前提:请确保使用最新版 Claude Desktop:低版本可能没有开发者模式或第三方推理配置入口。
打开 Claude Desktop,无需登录官方账号。
如果当前界面不好直接点菜单,可以按键盘 Tab 键切到左上角菜单区域,再按回车打开菜单。
在顶部菜单栏选择 Help(帮助)→ Troubleshooting(疑难解答)。
在弹出的子菜单里点击 Enable Developer Mode(启用开发者模式)。
-
window
-
mac
启用成功后,顶部菜单栏会多出一个 Developer(开发者)菜单。
接着点击 Developer 菜单,选择 Configure Third-Party Inference…(配置第三方推理…),进入第三方 API 配置页面。
- window
- mac
第二步:填写第三方 API 信息
方式一:直接填写第三方
打开配置窗口后,按下面方式设置:
Gateway:选择 Anthropic-compatible。
Gateway base URL:粘贴你的第三方 API Base URL。
Gateway API key:粘贴你的 API Key,也就是API 服务商后台复制出来的那串密钥。
设置完后,点击右下角 Apply locally。
方式二: CC Switch
CC Switch配置好了自己apikey和端点并启用,然后按图中配置启用本地路由
在claude desktop配置好对应的url和key,这里的key记得填:PROXY_MANAGED
第三步:验证是否成功
配置完成后,Claude Desktop 可能会提示重启;如果没有提示,也建议手动完全退出后重新打开。
重新打开后,进入 Cowork、Code 或 Projects 相关页面,输入一个简单问题测试。
如果模型能正常响应,或者界面中显示的是你第三方 API 提供的模型,就说明配置成功。
配置成功后你会发现:
可以正常使用 Project 功能:
能使用图形化界面的 Claude Code:
而且模型调用走你配置的第三方 API,按第三方 API 的计费方式结算。
如果配置有误需要退出:
常见坑别踩
找不到 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,桌面版体验确实很顺手。