⌘Hermes Agent · 本地命令行 · Codex 接口兼容

在 Hermes Agent 中配置使用

这篇教程适合想在自己电脑上直接运行 hermes 的用户。它会带你完成安装、连接鬼魅云、补丁兼容和最小可用验证。

Windows 用户先看这里

Hermes 不支持 Windows 原生命令行安装。如果你是 Windows 用户，请先进入 WSL 配置 页面完成基础环境准备。

第一步：安装 Hermes

根据你的系统运行安装脚本。Windows 用户需要在 WSL 中打开 Linux 终端后再执行。

请先打开 WSL 里的 Ubuntu、Debian 等 Linux 终端，然后运行：

Windows + WSL

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

macOS

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Linux

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，Hermes 的配置目录通常位于 ~/.hermes。如果当前终端里找不到 hermes 命令，先把终端关掉再重新打开一次。

图片占位：Hermes 安装完成截图

第二步：把 Hermes 连到鬼魅云

先打开 Hermes 的配置目录，然后修改 config.yaml 和 .env。

Windows + WSL

cd ~/.hermes
explorer.exe .

macOS

open "$HOME/.hermes"

Linux

xdg-open "$HOME/.hermes"

图片占位：打开 Hermes 配置目录截图

model:
  provider: custom
  default: gpt-5.5
  base_url: https://gvmz.systems/v1
  api_mode: chat_completions

1. base_url 告诉 Hermes 请求该发往哪条接口。
2. default 决定默认使用哪个模型。
3. api_mode 按示例填写即可，不需要先研究底层协议。

然后在 ~/.hermes/.env 中填入：

OPENAI_API_KEY=你的鬼魅云Key

如果你还没有 Key，可以先看 ApiKey 管理。

图片占位：Hermes config.yaml 和 .env 配置截图

第三步：打缓存兼容补丁（高级）

这一步的目的

让 Hermes 更适合鬼魅云这类 /codex 接口，从而提高缓存命中率，避免额度使用过快。

git clone https://github.com/foryourhealth111-pixel/hermes-codex-proxy-cache-compat.git
cd hermes-codex-proxy-cache-compat
bash scripts/apply_patches.sh ~/.hermes/hermes-agent
bash scripts/install_skill.sh ~/.hermes

你可以简单理解成：这个补丁把 Hermes 原本没有处理好的请求细节补齐，让它更接近原生 Codex 的缓存命中方式。

图片占位：Hermes 缓存补丁执行成功截图

第四步：最小可用验证

完成配置后，直接启动 Hermes 并发起一条最简单的问题测试是否成功。

hermes

请用三句话介绍一下 hermes 是做什么的。

如果能正常返回内容，这一轮就已经跑通。若报的是 Key、地址、模型错误，就回到第二步重新检查。

图片占位：Hermes 最小可用验证截图

TIP

如果你想再确认缓存是否正常，可以在同一个会话里连续提两次前缀相近的问题，再观察 cached_tokens 或 cache_read_tokens 是否变化。

上一步 / 下一步

上一步：WSL 配置如果 Hermes 环境还没准备好，先回到 WSL 页面补齐终端依赖。下一步：常见问题如果接入过程中遇到权限、模型、余额或响应异常，继续查看排查说明。