在常用工具里配置
这篇讲 Codex 以外的工具。Codex 请看 Codex 接入 HiveGPT。
所有工具的思路都一样:在设置里找到 「自定义 / OpenAI 兼容」 一类的模型服务,填三项:
| 项目 | 填写 |
|---|---|
| API 地址(Base URL) | https://hivegpt.cn/v1,个别工具填 https://hivegpt.cn |
| API Key | 你在 API 密钥 页创建的 Key |
| 模型 | 你的分组里可用的模型,例如 gpt-5.5,用 /v1/models 查 |
菜单名称以工具当前版本为准
各工具更新很快,下面写的是要找的设置项,具体菜单的位置和叫法可能和你看到的略有不同。
OpenCode
OpenCode 是开源的终端编程助手。HiveGPT 的「使用密钥」弹窗能直接生成它的配置:
在 API 密钥 页找到 GPT 类分组的 Key,点「使用密钥」,选 OpenCode。
复制生成的
opencode.json,保存到:- macOS / Linux:
~/.config/opencode/opencode.json - Windows:
%USERPROFILE%\.config\opencode\opencode.json
目录不存在就先创建。
- macOS / Linux:
在项目目录里运行
opencode,用/models选择一个 HiveGPT 的模型,随便问一句试试。
生成的配置大致是这样(Key 换成你自己的):
json
{
"provider": {
"openai": {
"options": {
"baseURL": "https://hivegpt.cn/v1",
"apiKey": "sk-你的Key"
}
}
}
}弹窗生成的文件里还带着各个模型的上下文长度和推理强度,直接用弹窗里的版本即可。
CodeBuddy 等 IDE 编程助手
如果你用的 IDE 助手支持「自定义模型」或「OpenAI 兼容接口」:
- 打开模型设置,新增一个自定义模型(提供商类型选 OpenAI / OpenAI 兼容)。
- API 地址填
https://hivegpt.cn/v1,API Key 填你的 Key,模型名填gpt-5.5等分组里的模型。 - 保存后在对话里切换到这个模型,发一句话测试。
只支持官方账号登录、没有自定义模型入口的工具,用不了第三方接口。
Cherry Studio
API 地址填 https://hivegpt.cn(不加 /v1,Cherry Studio 会自动补),类型选 OpenAI。完整步骤见 Cherry Studio 配置教程。
沉浸式翻译
自定义 API 接口地址要填完整的 https://hivegpt.cn/v1/chat/completions。完整步骤见 沉浸式翻译接入 GPT API。
Chatbox
API 模式选 OpenAI API 兼容,API 主机填 https://hivegpt.cn/v1,API 路径保持 /chat/completions。完整步骤见 Chatbox 接入第三方 API。
还是不通?
- 地址到底加不加
/v1,对照 Base URL 填法对照表。 - 先用 接入教程首页 里的 curl 命令测一下 Key 本身是否可用。curl 能通,问题就在工具的配置上。
- 对照 报错速查 排查。最常见的是:地址多了或少了
/v1,以及模型名不在你 Key 的分组里。 - 到 使用记录 看请求有没有到达 HiveGPT:有记录说明网络和 Key 都没问题;没有记录说明请求没发过来。