使用交互向导配置 Hermes Agent

接入条件与分组

Hermes 是独立代理，必须使用可外接的 MonkeyAI 密钥。在密钥管理选择 Claude Plus（精品）、Claude Max（外接版） 或适当的官方直连组；使用 GPT 时可选择 Codex Pro（外接版） 或支持外接的 Lite。不要使用 Claude Max（仅限CC） 或 Codex Pro（仅限Codex）。Lite 没有免费 Fast，也未列出图片模型。费用见实时价格。

安装

官方安装说明支持 Windows 原生、macOS（含 Apple Silicon）与 Linux；WSL 可选。下载官方脚本，先阅读确认，再执行。安装后重开终端，运行 hermes --help。

Windows

Invoke-WebRequest https://hermes-agent.nousresearch.com/install.ps1 -OutFile hermes-install.ps1
Get-Content .\hermes-install.ps1
# 阅读脚本后执行
& .\hermes-install.ps1

macOS

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o hermes-install.sh
less hermes-install.sh
# 阅读脚本后执行
bash hermes-install.sh

Linux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o hermes-install.sh
less hermes-install.sh
# 阅读脚本后执行
bash hermes-install.sh

运行 hermes model

使用已确认的交互式模型配置入口：

hermes model

按向导选择可自定义地址的提供商或自定义 API，逐项输入以下信息。界面文字随版本变化，以当前帮助为准：

项目	Claude 路线	Codex 路线
API 协议	Anthropic Messages	OpenAI Responses
base	https://monkeytheme.com	https://monkeytheme.com/v1
模型 ID	claude-opus-4-8	gpt-6.1-sol
密钥	私下输入自己的密钥	私下输入自己的密钥

Claude base 不手动附加 /v1/messages。Codex 必须确认向导支持 Responses，自定义 OpenAI 选项若仅代表 Chat Completions 则不足以证明兼容。若向导不提供所需协议，暂停该路线，核对版本或选择受支持的 Claude 路线。不要选择依赖官方 OAuth 的入口后填本站密钥。

保存并启动

完成向导后查看其保存结果提示，确认提供商与模型，再运行 hermes。若已有会话，先退出重开。Windows、WSL、macOS 与 Linux 应在实际运行 Hermes 的同一用户环境中配置。通过交互向导保存即可，无需手动创建配置文件。

验证与恢复

用户可确认价格后在空白目录询问一个短问题。401 查密钥，403 查组与外接限制，404 查协议与地址，model_not_found 查模型拼写。工具调用失败与文本请求失败需分别排查；文本可用不代表所有工具、图片或长期任务兼容。重新运行 hermes model 可切换回先前提供商，保留脱敏错误用于排错。图片能力见图片生成。