手动配置 · Windows、macOS 与 Linux
Hermes Agent + Space Router
Hermes Agent 是 Nous Research 开源的智能体，以常驻后台进程方式运行，并支持任意自定义模型端点。把它指向 Space Router 只需要五条配置命令。
Hermes 没有一键安装脚本。请先按 Hermes 自己的文档完成安装，确认终端里能跑通 hermes，再回到本页。
开始之前
你需要一个 Space Router API key。它所属的分组同时决定了可用模型和你要配置的线路。在 Space Router 后台的 API Keys → Create API Key 中创建，分组要与购买的一致。
| Key 分组 | 线路 | 模型 slug |
|---|---|---|
| Claude（group 3） | Anthropic Messages | claude-opus-5、claude-sonnet-5、claude-opus-4-8、claude-opus-4-7、claude-opus-4-6、claude-sonnet-4-6 |
| Claude Fable 5（group 5） | Anthropic Messages | claude-fable-5 |
| GPT（group 4） | OpenAI 兼容 | gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5、gpt-5.4、gpt-5.4-mini |
key 只在本分组内有效。用 Claude 分组的 key 去请求 gpt-5.5，或用它去请求 claude-fable-5，都会直接报错而不会自动降级——Fable 属于单独购买的分组。完整目录发布在 /models.json。
第 1 步 · 找到配置文件
-
打印路径
打开终端执行下面这条。它会告诉你下一步将写入哪个文件——在改动任何东西之前，先知道这一点是值得的。
hermes config path -
与默认路径对照
macOS 与 Linux
~/.hermes/config.yamlWindows
%LOCALAPPDATA%\hermes\config.yaml如果打印出来的是别的路径，说明 Hermes 用的是非默认配置——下面的内容依然适用，只是落在那个文件里。
-
文件里已有设置就先备份
第 2 步的命令只会覆盖
model.下的键，但备份一份并不费事。cp ~/.hermes/config.yaml ~/.hermes/config.yaml.bak
第 2 步 · 设置自定义 provider
按你的 key 分组执行对应的一组命令。每一行都是独立命令，按顺序执行。
Claude 或 Fable key —— Anthropic Messages 线路
-
执行这五条命令
hermes config set model.provider custom hermes config set model.base_url https://space.stationine.com hermes config set model.api_mode anthropic_messages hermes config set model.api_key sk-your-space-router-key hermes config set model.default claude-sonnet-5 -
注意 Base URL 不带后缀
anthropic_messages模式会自己拼上/v1/messages，所以这里填到网关根地址为止。多加/v1会得到一个看起来很像「key 不对」的404。
GPT key —— OpenAI 兼容线路
-
执行这四条命令
hermes config set model.provider custom hermes config set model.base_url https://space.stationine.com/v1 hermes config set model.api_key sk-your-space-router-key hermes config set model.default gpt-5.6-sol -
完全不要设置
model.api_mode「不设置这一项」本身就是 OpenAI 线路的标志。这条线路的 Base URL 要 止于
/v1，因为 Hermes 会自己拼上/chat/completions。
第 3 步 · 核对写入内容
打开第 1 步得到的那个文件。上述命令写入的就是下面这段，你也可以直接编辑它，而不必重新执行命令。
model:
provider: custom
base_url: https://space.stationine.com
api_mode: anthropic_messages
api_key: sk-your-space-router-key
default: claude-sonnet-5确认两件事：四到五个键都在；model: 下面没有上一个 provider 残留的设置。
.env 里。 Hermes 也会从自己的 .env 读取凭证。把 key 放在那里而不是 config.yaml 是更稳妥的习惯——被顺手贴进错误报告、或被误提交进仓库的，往往是配置文件。
第 4 步 · 验证
-
启动 Hermes
如果它本来就作为后台进程在运行，请重启，让它重新加载配置。
-
发一条短消息
发送
Reply with OK。能收到回复，才同时证明 Base URL、key、线路与模型 slug 四者都对。把配置文件读一遍并不能证明其中任何一项，只有真实请求可以。
之后切换线路
从 Anthropic 线路切到 OpenAI 线路，不只是改 Base URL，还必须清掉 model.api_mode。残留的 anthropic_messages 配上 /v1 的 Base URL，是本页最让人困惑的故障：key 和模型都没问题，报错却只是一个干巴巴的 404。
常见报错
| 你看到的 | 含义 |
|---|---|
401 或 403 |
key 错误、已吊销或余额不足。回后台重新复制一次，并检查前后有没有空格。 |
404 |
Base URL 与线路不匹配——带了 /v1 却设了 api_mode: anthropic_messages，或用了根地址却没设它。也可能是模型 slug 拼错。 |
| 提示模型不受支持 | 该 slug 不属于你 key 的分组。对照上面的表格核对。 |
| 第一次工具调用就失败 | 所选模型不支持 function calling，而 Hermes 每次请求都要用到它。 |
| 改了配置没有任何变化 | 后台进程没有重启，或者 hermes config path 指向的并不是你编辑的那个文件。 |
Space Router 是什么？
Space Router 是由 Station Nine 运营的 AI API 中转服务，Base URL 为 https://space.stationine.com。它在 POST /v1/messages 接收 Anthropic Messages 请求，在 POST /v1/chat/completions 接收 OpenAI Chat Completions 请求，在 POST /v1/responses 接收 OpenAI Responses 请求，提供 OpenAI GPT 与 Anthropic Claude 两大模型家族。服务与账户细节见 Space Router 总览。
还没有凭证？前往 Space Router 获取 API key。