跳转到主要内容
使用本指南将 Claude Desktop Cowork 的第三方推理连接到 CometAPI。此配置可让 Claude Desktop 在 Cowork、Projects 以及受支持的桌面工作流中，将 Claude Messages API 请求发送到 CometAPI。 官方参考：
Claude Desktop 第三方推理需要一个兼容 Anthropic 的网关。CometAPI 通过 Anthropic 消息 API 支持 Claude 模型。
你从 Claude Desktop 发送的内容会由 CometAPI 和所选模型提供商处理。除非你的组织允许这种工作流，否则不要发送机密数据。

​
前提条件

  • 从 claude.com/download 安装 Claude Desktop
  • 包含 Developer mode 和 Configure third-party inference 的 Claude Desktop 构建版本
  • 拥有有效 API key 的 CometAPI 账户
  • 可在 CometAPI 中访问 Claude 模型
  • 能够访问 https://api.cometapi.com 的网络路径
从 Claude Desktop 的登录界面开始。如果你已经使用 Anthropic 账户登录，请在配置第三方推理前先退出登录。

​
配置

1

启用开发者模式

打开 Claude Desktop 并停留在登录界面。在应用菜单中，打开 Help → Troubleshooting，然后选择 Enable Developer Mode。在 Windows 上，登录前菜单可能不太容易访问。先聚焦到电子邮件字段，按 Tab 直到菜单获得焦点，然后按 Enter。
2

打开第三方推理设置

启用开发者模式后，打开 Developer → Configure third-party inference。配置窗口打开后，左侧边栏会显示多个部分。请使用 Connection 部分填写 CometAPI 设置。
3

配置网关

在 Connection 部分中，输入下面的 CometAPI 值：
字段值
推理提供商Gateway
网关Anthropic-compatible
网关基础 URLhttps://api.cometapi.com
网关 API key你的 CometAPI API key，例如 <COMETAPI_KEY>
网关认证方案Bearer
网关额外请求头留空
请严格保持基础 URL 与上方完全一致。Claude Desktop 要求使用 HTTPS 基础 URL。下图显示的是已填入 CometAPI 值的 Connection 部分。已填写 CometAPI 网关基础 URL、API key 字段和 bearer 认证方案的 Claude Desktop Connection 设置
4

添加 model ID

在 Model list 中，手动添加以下 model ID：
Model ID推荐用途
claude-opus-4-7复杂规划和 agent 任务
claude-sonnet-4-6通用桌面使用
claude-haiku-4-5-20251001轻量 Prompt 和快速草稿
列表中的第一个模型会成为默认模型。如果你希望默认模型更适合通用用途，请将 claude-sonnet-4-6 放在第一位。
模型可用性可能会变化。如果某个模型在配置后没有出现在 Claude Desktop 中，请在 CometAPI 模型页面 上确认访问权限。
下图显示的是为 CometAPI 配置了三个 Claude model ID 的模型列表。Claude Desktop 模型列表显示了用于 CometAPI 的 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 模型，然后发送一个简短的测试 Prompt。成功返回响应即表示 Claude Desktop 正在使用 CometAPI 进行模型调用。

​
验证配置

使用一个不需要外部工具的简短 Prompt： 
Reply with one sentence: Claude Desktop is connected through CometAPI.
如果 Claude Desktop 返回了响应，则说明基础 URL、API key 和模型列表已正确配置。 下图显示了通过 CometAPI 成功完成的 Cowork 回复。 完成第三方推理设置后，Claude Desktop 通过 CometAPI 返回的 Cowork 回复 如需检查检测到的设置，请打开 Help → Troubleshooting → Copy Managed Configuration Report。复制的报告中会对敏感值进行脱敏处理。

​
故障排查

请确认你已选择 Help → Troubleshooting → Enable Developer Mode。然后完全退出 Claude Desktop 并重新打开。如果该选项不存在，请安装包含第三方推理配置功能的 Claude Desktop 构建版本。
检查以下项目：
  • Inference provider 已设置为 Gateway。
  • Gateway base URL 为 https://api.cometapi.com。
  • Gateway API key 包含你的 CometAPI API key，且没有多余空格。
  • 你已点击 Apply locally 并完整重启 Claude Desktop。
请确认基础 URL 以 https:// 开头。Claude Desktop 不接受普通 HTTP 网关 URL。还请确认你的 CometAPI 账户可以访问 Claude 模型，并且该 API key 没有被删除或禁用。
重新打开 Developer → Configure third-party inference，并检查 Model list 条目。model ID 必须与 CometAPI 提供的 ID 完全一致。将每个 model ID 作为单独条目添加。不要在 UI 字段中包含引号、逗号或多余空格。
Claude Desktop 的第三方推理在此流程中需要兼容 Anthropic 的网关。请使用 https://api.cometapi.com 以及上方列出的 Claude model ID。
Code 标签页在 Claude Desktop 中使用 Claude Code 引擎。某些桌面设置对 Code 会话的适用方式可能与对 Cowork 的适用方式不同。对于独立终端用法，请参阅 Claude Code 集成指南。