# Hermes Agent（爱马仕）

Hermes Agent 走 OpenAI-compatible `chat/completions` 协议。把它的自定义 endpoint 指到 4AICode，就能在 Hermes 里使用 `gpt-6-astra`、`gpt-5.6-sol`、`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini` 等模型。

## 准备

- 4AICode token：在 [仪表盘 → 管理 Tokens](https://4aicode.com/tokens) 创建，格式是 `sk-4ai-...`
- Base URL：`https://relay.4aicode.net/v1`
- 推荐模型：`gpt-5.4` 日常使用更稳，`gpt-5.4-mini` 适合轻量任务和成本敏感场景

## 配置

直接运行 Hermes 自带的模型配置向导：

```bash
hermes model
```

按提示依次选择：

```text
More providers...
Custom endpoint (enter URL manually)
```

然后填入：

```text
API base URL: https://relay.4aicode.net/v1
API key: sk-4ai-xxxxxxxxxxxxxxxx
```

接着在模型列表里选择：

```text
gpt-5.4
```

配置完成后运行：

```bash
hermes chat
```

## 可用模型

| 模型 | 适用场景 |
|---|---|
| `gpt-6-astra` | 新一代旗舰，按官方价 1.5 折计费 |
| `gpt-5.6-sol` | 旗舰，复杂编码、长任务、多文件重构 |
| `gpt-5.6-terra` / `gpt-5.6-luna` | 均衡 / 更便宜更快 |
| `gpt-5.5` | 上一代旗舰 |
| `gpt-5.4` | 推荐默认选择，通用任务更稳 |
| `gpt-5.4-mini` | 普通问答、简单改文案、小段代码，速度快、成本低 |
| `gpt-5.3-codex` | 代码优化模型 |

## 测试

进入 Hermes 后，直接发一句话：

```text
你好，用一句话介绍你自己
```

能正常回复就表示配置成功。

## 常见问题

### Empty response from model

Hermes 使用的是 `/v1/chat/completions`。在 `hermes model` 里填写 Base URL：`https://relay.4aicode.net/v1`，让 Hermes 自动拼出 `/chat/completions`。

重新运行 `hermes model`，确认 Base URL、API key、Model name 三项。

### 看到 response.created / response.completed

这表示客户端收到了 Responses API 的 SSE 事件流。Hermes 需要 Chat Completions 格式，4AICode 的 `/v1/chat/completions` 会自动转换。遇到这种情况，优先检查：

- `base_url` 是否是 `https://relay.4aicode.net/v1`
- 请求路径是否是 `/v1/chat/completions`
- 4AICode 后端是否已经部署到最新版本

### 模型不支持

老模型名如 `gpt-5`、`gpt-5-codex` 已废弃。重新运行 `hermes model`，选择 `gpt-5.4`。

## 参考

- [Hermes Agent AI Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers)
- [Hermes Agent Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration/)
- [掘金：在爱马仕里配置模型](https://juejin.cn/post/7629598396504834100)