Hermes 配置教程

Hermes（Hermes Agent）是开源的命令行 AI 智能体，支持 OpenAI 兼容接口，可以在终端里完成问答、写代码等任务。注意：Hermes 不支持 Windows 原生运行，Windows 用户需要先安装 WSL2，然后在 WSL2 终端里完成配置和使用。

⚠️ 数据迁移提醒：如果你之前在使用其他平台或其他中转站，切换前请先让原平台的 AI 把项目文件完整打包、整理清楚，确保新的 AI 拿到项目后能直接读懂、马上上手，再开始配置。

一、创建 API Key

1. 登录云枢科技AI 后台，点击「API 密钥」→「创建 API 密钥」；
2. 填写名称、分组、过期时间，并按需勾选模型权限（不限制时全部模型可用）；
3. 点击「保存更改」，复制以 sk- 开头的 API Key。

API Key 只在创建时显示一次，请立即保存。配置脚本只把 Key 写入本机，不会上传到任何服务器。

二、安装 Hermes

1. 在 macOS / Linux / WSL2 终端执行：

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

2. 安装完成后验证：

   hermes --version

能显示版本号即安装成功（一键脚本检测到未安装时也会提示这条安装命令）。

三、一键配置（推荐）

在 macOS / Linux / WSL2 终端执行：

bash <(curl -fsSL https://www.yunshukjai.com/codex-hermes-setup.sh)

Windows 用户：请先安装 WSL2，再在 WSL2 终端里执行上面的命令（Windows 的 .ps1 脚本会提示同样的操作方式）。

脚本会自动完成以下配置（等价于手动执行 5 条命令）：

配置项	写入内容
模型供应商	custom
接口地址	https://www.yunshukjai.com/v1
API 协议	openai_chat（OpenAI 兼容）
API Key	你的云枢 API Key
默认模型	deepseek-v4-flash

脚本会提示输入 API Key（如果系统已设置过 YUNSHUKJAI_API_KEY 环境变量，则直接使用），看到 Done. 即配置成功。

说明：这些配置就是 hermes config set model.provider custom、hermes config set model.base_url https://www.yunshukjai.com/v1、hermes config set model.api_mode openai_chat、hermes config set model.api_key <你的Key>、hermes config set model.default deepseek-v4-flash 这几条命令，脚本帮你一次写完。

四、验证

执行：

hermes chat -q "hello"

能正常回复即配置成功；也可以直接输入 hermes 进入对话。

五、切换其他模型（可选）

一键脚本默认使用 deepseek-v4-flash；云枢科技AI 平台上的其他模型可以随时切换，执行：

hermes config set model.default 模型ID

可用的模型 ID：

• deepseek-v4-flash、deepseek-v4-pro
• glm-5.2
• kimi-k3
• MiniMax-M3
• qwen3.7-flash、qwen3.7-max、qwen3.7-plus、qwen3.8-max

例如切换到 glm-5.2：

hermes config set model.default glm-5.2

切换后重新执行 hermes chat -q "hello" 验证。

六、常见问题

现象	解决办法
提示 Hermes 未安装	先执行第二节的安装命令，再重跑一键配置
提示认证失败 / 401	API Key 复制错或已删除 → 后台重新创建，重跑一键脚本
提示无模型权限 / 403	令牌未勾选对应模型 → 后台勾选或新建令牌
提示模型不存在 / 404	model.default 填写的模型 ID 有误 → 用 /v1/models 查询准确 ID 后原样填写
切换模型后不生效	完全退出 Hermes 后重新打开（WSL2 中请关闭并重开终端）
配置不生效	完全退出 Hermes 后重新打开

相关文档

• API 密钥创建
• Codex配置
• Reasonix配置