HopBase 文档第三方客户端
在 Cherry Studio、NextChat、LobeChat 等客户端中配置 HopBase。
Cherry Studio、NextChat、LobeChat 等桌面或网页客户端都使用同一组核心参数。供应商类型必须与模型协议一致。
| 你要用的模型 | 供应商类型 | API 地址 / Base URL | API Key |
|---|---|---|---|
| GPT / GLM / Gemini 系列 gpt-5.6-sol / glm-5.3 / gemini-3.8-flash 等 | OpenAI（Chat Completions） | https://api.hop-base.com/v1 | 对应分组的密钥 |
| Claude 系列 claude-sonnet-5 等 | 必须选「Anthropic」 | https://api.hop-base.com（不带 /v1） | Claude Max (官号满血版) 或 Claude Max (官号满血版) - 限时特惠分组密钥；Claude Max （ccmax） 只能用于 Claude Code |
配置步骤
确认可用模型
使用目标分组密钥调用 GET /v1/models，复制完整模型 ID。
新增自定义供应商
在客户端设置中按上表填入供应商类型、Base URL、API Key 和模型 ID。
保存并测试
选择刚新增的模型，传送「只回复 ok」。如果返回 404，先检查 Claude 是否误选了 OpenAI 类型，以及 Base URL 是否多了或少了 /v1。
Claude 密钥必须选 Anthropic 类型：
Claude 分组密钥别选「OpenAI」类型——会报 404「当前平台不支持该 API 路径」，必须选「Anthropic」类型。客户端没有 Anthropic 类型就换一个（Cherry Studio 有），或用控制台线上对话。
网页版已支持直连，但通常不会自动补 API 路径。使用 OpenAI / GPT / GLM 模式时，Base URL 必须填完整的 https://api.hop-base.com/v1；Claude 的 Anthropic 模式依上表不带 /v1。