Hermes
AiCookie 开发者文档
Hermes
安装 Hermes，配置 AiCookie API Key，并发送第一条消息
安装 Hermes 后，选择下方一种接入方式，填入 API Key 和请求地址，即可开始对话。
安装 Hermes
打开终端，运行对应系统的官方安装命令。安装脚本会处理依赖，下面的命令会跳过完整配置向导，安装后只需配置模型。
先确认已安装 Git；Linux 还需要 curl 和 xz-utils。然后执行：
等待安装完成后，重新打开终端，验证安装：
能看到版本号后，继续选择下方的 OpenAI 或 Claude 接入。
OpenAI 接入
-
前往 AiCookie API Key 页面，选择 Codex（可外接） 分组并创建 API Key。
-
在终端运行：
-
选择 Custom endpoint (enter URL manually)。若终端显示编号菜单，输入对应编号并按 Enter。
按下表填写：
| 提示 | 填写或选择 |
|---|---|
| API base URL | https://api.aicookie.net/v1 |
| API key | 刚创建的 API Key |
| API compatibility mode | Responses / Codex |
| Select model / Model name | gpt-6-astra |
| Context length in tokens | 直接按 Enter，自动识别 |
| Display name | AiCookie OpenAI |
| Reasoning effort（如果出现） | 直接按 Enter，保留默认值 |
API Key 输入时会隐藏或显示为星号，粘贴后按 Enter 即可。若出现模型列表，可以选择对应编号，也可以直接输入上表中的模型名称。
出现 Reasoning effort 时，直接按 Enter 保留默认值，完成配置：
配置完成后，继续下方的 验证接入。
Claude 接入
-
前往 AiCookie API Key 页面，选择 Claude Code（可外接） 分组并创建 API Key。
-
在终端运行：
-
选择 Custom endpoint (enter URL manually)，输入对应编号并按 Enter。
按下表填写：
| 提示 | 填写或选择 |
|---|---|
| API base URL | https://api.aicookie.net |
| API key | 刚创建的 API Key |
| API compatibility mode | Anthropic Messages |
| Select model / Model name | claude-sonnet-5 |
| Context length in tokens | 直接按 Enter，自动识别 |
| Display name | AiCookie Claude |
| Reasoning effort（如果出现） | 直接按 Enter，保留默认值 |
出现 Reasoning effort 时，直接按 Enter 保留默认值。配置完成后，继续下方的验证步骤。
验证接入
在终端运行：
输入一句话，例如：
收到正常回复后，到 AiCookie 控制台 → 用量记录，确认出现了对应模型的请求，即表示接入成功。
下面以 Claude Sonnet 5 的成功回复为例：
以后使用时，打开终端运行 hermes 即可。
常见问题
如何更换接入方式？
退出当前对话，重新运行 hermes model，按上方对应步骤填写新的 API Key、请求地址和模型，然后重新启动 hermes。仅在对话里输入 /model 不会替你配置新的 Key 和请求地址。
能否使用 Gemini 分组的 Key？
当前 Hermes 的第三方自定义接口不支持 AiCookie Gemini 分组使用的原生接口，因此本页暂不提供 Gemini 接入步骤。如需使用该分组，可以参考 OpenCode 接入。
没有回复或提示报错怎么办？
先确认 API Key 选择了对应的可外接分组，再核对上表中的请求地址、API 模式和模型名称。模型不可用时，查看 模型名称列表；遇到 401、403、429 等错误时，查看 错误码。
安装问题可参考 Hermes 官方安装文档。