Hermes 接入 AIGoCode，先确认你走哪种兼容模式

Hermes 的自定义接入需要在终端向导里选择协议、地址、Key 和模型名称。AIGoCode 官方教程分别给出 OpenAI 与 Claude 两条路径，并说明当前 Hermes 的第三方自定义接口不能直接使用 Gemini 分组的原生接口。

本文把两条配置放在一起，帮助你识别每个提示对应哪一类设置，再完成消息与用量验证。

安装完成后先确认 hermes model 可用

官方教程要求先根据系统安装 Hermes，完成后重新打开终端并运行 hermes --version。看到版本号后，再运行 hermes model 进入自定义模型配置。

首次配置时，先准备与协议匹配的 AIGoCode Key。OpenAI 路径使用 ChatGPT API（Azure）分组，Claude 路径使用 Claude API（AWS）分组。不要用一个协议的地址和模式去套另一个协议的模型。

OpenAI 路径：Responses / Codex 与 /v1

在 hermes model 中选择 Custom endpoint (enter URL manually)。OpenAI 示例的 API base URL 是 https://api.aigocode.dev/v1，API compatibility mode 选择 Responses / Codex，模型名称填 gpt-6-astra，显示名称可填 AIGoCode OpenAI。

Context length 和 Reasoning effort 如果出现，官方示例要求直接按 Enter 保留默认值。API Key 输入时会隐藏或显示为星号，粘贴后按 Enter 完成配置。

这些字段要作为一组核对。只改模型名称，不能自动把 compatibility mode 或 base URL 改成另一条协议。

Claude 路径：Anthropic Messages 与根地址

Claude 路径同样先选择 Custom endpoint。API base URL 改为 https://api.aigocode.dev，API compatibility mode 选择 Anthropic Messages，模型名称填 claude-sonnet-5-5，显示名称可填 AIGoCode Claude。

这里的地址层级与 OpenAI 示例不同。不要看到两个配置都叫 API base URL，就把 /v1 机械地加到 Claude 这一项；按照当前 Hermes 教程各自填写。

如果你希望切换接入方式，需要退出当前对话，重新运行 hermes model，按另一条路径重新填写。官方明确说明，只在对话中输入 /model 不会替你配置新的 Key 和请求地址。

为什么 Hermes 暂时没有 Gemini 路径

官方教程说明，Hermes 的第三方自定义接口当前不支持 AIGoCode Gemini 分组使用的原生接口，因此页面没有提供 Gemini 接入步骤。这个结论只针对 Hermes 当前的自定义接口能力，不代表 AIGoCode 的 Gemini API 本身不可用。

不要为了让菜单出现 Gemini 而把 OpenAI 或 Claude 模式强行改成 Gemini 模型。若要使用 Gemini 分组，需要改用文档中支持该协议的工具。

发送消息，同时核对用量记录

配置完成后运行 hermes，发送一句简短消息，例如“你好，请简短介绍一下你能帮我做什么”。收到正常回复后，到 AIGoCode 控制台的用量记录确认出现对应模型请求，才算完成接入。

模型不可用时检查 API Key 所属分组、请求地址和模型名称列表。遇到 401、403、429 时查看错误码；连接失败则检查网络或代理。你还可以参考本站模型名与协议示例和401、403 认证与额度排查。

最后保留四项非秘密记录：兼容模式、base URL、模型名称和是否在控制台看到请求。下次切换 OpenAI 与 Claude 时，就能逐项对照，而不必重复覆盖全部配置。