Skip to main content
本文介绍如何在 Claude Desktop 中接入 DeerAPI。配置完成后，Claude Desktop 的 Cowork、Projects 以及支持的桌面工作流会通过 DeerAPI 调用 Claude Messages API。 官方参考：
Claude Desktop 第三方推理需要 Anthropic-compatible Gateway。DeerAPI 通过 Claude 消息接口支持 Claude 模型调用。
从 Claude Desktop 发送的提示词、文件内容和项目上下文会经过 DeerAPI 与所选模型供应商处理。不要在未获授权的情况下发送敏感资料。

​
前置条件

  • 已安装 Claude Desktop
  • Claude Desktop 版本包含 Developer mode 和 Configure third-party inference
  • 已开通 DeerAPI 并拥有 API Key
  • DeerAPI 账号具备 Claude 模型调用权限
  • 本机网络可访问 https://api.deerapi.com
从 Claude Desktop 登录页开始配置。若已经登录 Anthropic 账号，先退出账号，再配置第三方推理。

​
配置 Claude Desktop

1

启用开发者模式

打开 Claude Desktop，停留在登录页。在应用菜单中打开 Help → Troubleshooting，然后选择 Enable Developer Mode。Windows 登录页上菜单不易点击时，先聚焦邮箱输入框，按 Tab 切到菜单区域，再按 Enter 打开菜单。
2

打开第三方推理配置

启用开发者模式后，打开 Developer → Configure third-party inference。配置窗口左侧会显示多个栏目。DeerAPI 相关字段集中在 Connection 栏目。
3

配置 Gateway

在 Connection 栏目中填写以下值：
字段填写值
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.deerapi.com
Gateway API key你的 DeerAPI API Key，例如 <DEERAPI_KEY>
Gateway auth schemeBearer
Gateway extra headers留空
Base URL 按表格填写。Claude Desktop 要求 Gateway 使用 HTTPS。下图展示了已填写 DeerAPI 参数的 Connection 页面。Claude Desktop 的 Connection 页面，已填写 DeerAPI 的 Gateway base URL、API Key 和 bearer 认证方式
4

添加模型 ID

在 Model list 中手动添加以下模型 ID：
模型 ID建议用途
claude-opus-4-7复杂规划与 Agent 任务
claude-sonnet-4-6日常桌面使用
claude-haiku-4-5-20251001轻量提示词与草稿
列表中的第一项会作为默认模型。如果希望使用通用默认模型，可将 claude-sonnet-4-6 放在第一项。
模型可用性会变化。如果 Claude Desktop 中没有显示某个模型，到 DeerAPI 模型列表确认账号权限与模型状态。
下图展示了已添加三个 Claude 模型 ID 的 Model list 页面。Claude Desktop 的 Model list 页面，已添加 claude-opus-4-7、claude-sonnet-4-6 和 claude-haiku-4-5-20251001
5

本地应用配置

点击 Apply locally。Claude Desktop 会把所选配置写入本机用户配置并重新启动。如果应用没有自动重启，完全退出 Claude Desktop 后重新打开。
6

启动 Cowork 会话

在登录页选择 Cowork 第三方推理入口。打开 Cowork 或 Projects，选择已配置的 Claude 模型，并发送一条测试提示词。如果模型正常回复，说明 Claude Desktop 已通过 DeerAPI 发起模型调用。

​
验证配置

使用不依赖外部工具的短提示词验证： 
用一句话回复：Claude Desktop 已通过 DeerAPI 连接。
如果 Claude Desktop 返回回复，说明 Base URL、API Key 与模型 ID 配置正确。 下图展示了 Claude Desktop 通过 DeerAPI 成功回复后的界面。 Claude Desktop 中通过 DeerAPI 发起 Cowork 会话并成功返回回复的界面 如需查看配置读取情况，打开 Help → Troubleshooting → Copy Managed Configuration Report。复制出的报告会隐藏敏感字段。

​
常见问题

确认已经选择 Help → Troubleshooting → Enable Developer Mode。然后完全退出 Claude Desktop，再重新打开。如果仍然没有该选项，安装包含第三方推理配置能力的 Claude Desktop 版本。
逐项检查以下配置：
  • Inference provider 已设置为 Gateway。
  • Gateway base URL 是 https://api.deerapi.com。
  • Gateway API key 中的 DeerAPI API Key 没有多余空格。
  • 已点击 Apply locally，并完全重启 Claude Desktop。
确认 Base URL 以 https:// 开头。Claude Desktop 不接受 HTTP Gateway URL。同时确认 DeerAPI 账号具备 Claude 模型调用权限，且 API Key 没有被删除或停用。
重新打开 Developer → Configure third-party inference，检查 Model list 中的模型 ID。每个模型 ID 需要单独添加。不要在 UI 字段中加入引号、逗号或多余空格。
这个流程需要 Anthropic-compatible Gateway。使用 https://api.deerapi.com 和上文列出的 Claude 模型 ID。
Code 标签页使用 Claude Desktop 内嵌的 Claude Code 引擎。部分桌面配置在 Code 会话中的表现可能与 Cowork 不一致。如果需要在终端中使用 Claude Code，参考 Claude Code 集成指南。