登录控制台

Claude Desktop

用 Claude Desktop 的第三方推理模式，把对话、Cowork 和 Code 接到 HopBase。

Claude Desktop 是 Anthropic 的桌面应用。它的「第三方推理」模式（Claude Desktop on 3P）可以把请求发到任意实现 Anthropic Messages 接口的网关，HopBase 按网关方式接入。

配置项	填什么
Inference provider	Gateway
Gateway base URL	`https://api.hop-base.com`（不带 `/v1`）
Gateway API key	Claude 分组的密钥
Credential kind	Static API key（默认）
Gateway auth scheme	Bearer（默认）

开始前准备

从 claude.com/download 安装 Claude Desktop。官方系统要求是 macOS 14 及以上，或 Windows 10 2004 及以上；Windows 请用 .msix 安装包，旧的 .exe 安装包没有 Cowork。

在控制台「API 密钥」页准备一把 Claude Max (官号满血版) 分组的密钥。Claude Max （ccmax）分组只放行 Claude Code 客户端，不要用在 Claude Desktop。

第三方推理模式不登录 Anthropic 账号，对话记录只保存在本机。claude.ai 网页版、手机端和语音模式在这个模式下不可用。

配置步骤

打开开发者模式

启动应用，停在登录界面，不要登录。macOS 在顶部菜单栏、Windows 在登录界面左上角的 ☰ 菜单，依次点 Help → Troubleshooting → Enable Developer Mode。

打开第三方推理配置窗口

点 Developer → Configure Third-Party Inference…。

填写连接信息

在 Connection 里把 Inference provider 设为 Gateway，再按上表填 Base URL 和密钥，其余两项保持默认。

应用并重启

点 Apply Changes，再点 Save & Restart。应用重启后，在登录界面选择以第三方推理模式启动。

发一条测试消息

新建对话，让它只回一个词。成功后到控制台「使用记录」能看到这次请求。

选择模型

模型列表可以留空，应用启动时会调 GET /v1/models 自动读取。选择器是空的，或出现调不通的模型时，在配置窗口的 Models 里手动填写模型 ID，第一个是默认模型。

claude-opus-5
claude-sonnet-5

只填当前密钥调 GET /v1/models 返回的 ID，区分大小写。

能用哪些功能

按官方功能表，第三方推理模式下的对话（Chat）、Cowork 和 Code 都通过网关调用模型，也就是全部走 HopBase。项目、Artifacts、本地和远程 MCP、技能与插件同样可用。

更多细节

下一步

Claude Code：在终端里使用同一批 Claude 模型
Anthropic SDK：在自己的程序里调用 Claude
报错速查：按报错原文排查

本页目录

开始前准备配置步骤打开开发者模式打开第三方推理配置窗口填写连接信息应用并重启发一条测试消息选择模型能用哪些功能更多细节下一步