Hermes 部署教程

Hermes 是 Nous Research 推出的 AI Agent 工具。如果你想在 Windows 上把它跑起来，并接入 Ai Go Code 平台使用 Codex、Claude 和 Gemini，可以直接按这篇教程一步步配置。

文中的命令默认在 Windows PowerShell 里执行。

准备工作#

开始之前，请先准备好以下内容：

• 一个 Ai Go Code 账号。
• 已创建好的 Codex、Claude 和 Gemini API Key。

第一步：安装 Hermes#

先打开 PowerShell，执行下面的命令把 Hermes 拉到本地：

git clone --depth=1 --recurse-submodules https://github.com/NousResearch/hermes-agent.git "$env:LOCALAPPDATA\hermes\hermes-agent"

然后进入项目目录，创建虚拟环境并激活：

cd "$env:LOCALAPPDATA\hermes\hermes-agent"
uv venv .venv
.venv\Scripts\Activate.ps1

接着安装依赖：

uv pip install -e ".[all]"

如果这一步下载很慢，可以切到清华镜像：

uv pip install -e ".[all]" --index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，直接启动 Hermes：

hermes

如果你之后退出了 Hermes，或者重启了电脑，再次启动时执行下面三行就可以：

cd "$env:LOCALAPPDATA\hermes\hermes-agent"
.venv\Scripts\Activate.ps1
hermes

第二步：配置 Codex#

Hermes 第一次启动时会进入配置流程。先输入 Y 继续：

接下来选择 Full setup：

然后选择 Custom endpoint：

之后按下面这组参数填写：

输入 API Key 时看不到字符是正常现象。PowerShell 和这个 CLI 在这里会进入隐藏输入模式，直接粘贴后按 Enter 即可。

后面如果出现 Keep current settings 或 Skip — keep defaults，优先选这两个；如果没有，直接回车就行。

如果遇到配置项前面是 [] 的情况，也直接回车：

配置完以后，就可以启动 Hermes 尝试使用 Codex：

每次配置完后，最好退出当前终端窗口再重新打开一次，然后再启动 Hermes。有些 TUI 程序在 Windows PowerShell 或部分终端里，首次渲染时会卡几秒到几十秒。

第三步：配置 Claude#

如果你已经进入 Hermes 对话界面，可以直接按 Ctrl + C 退出，再执行下面的命令重新进入配置：

cd "$env:LOCALAPPDATA\hermes\hermes-agent"
.venv\Scripts\Activate.ps1
hermes setup

进入配置页面后，还是选择 Full setup，然后选 Custom endpoint，再填写下面这组参数：

后面的步骤和前面一样：如果看到 Keep current settings 或 Skip — keep defaults 就选它们，没有就直接回车。

配置完成后，回到 Hermes 对话界面输入 /model，切换到 Claude 即可：

第四步：配置 Gemini#

Gemini 的配置方式和 Claude 一样，先重新进入配置流程：

cd "$env:LOCALAPPDATA\hermes\hermes-agent"
.venv\Scripts\Activate.ps1
hermes setup

然后继续选择 Full setup 和 Custom endpoint，再输入下面这组参数：

后续如果再次出现 Keep current settings 或 Skip — keep defaults，照样优先选这两个，没有就直接回车。

完成后，回到 Hermes 对话页面输入 /model，切换到 Gemini 即可正常使用：

常见问题#

如果你在配置过程中看到类似下面这种报错：

通常优先检查下面三件事：

1. endpoint 是否填写成了 https://api.aigocode.com/v1，尤其要注意一定要带上 /v1。
2. API Key 是否可用，是否填成了对应模型的 Key。
3. 模型名称是否选择了当前平台支持的模型，不支持的模型也会直接报错。