PREPARE
准备提供商与 API 密钥
先决定使用哪一家模型服务商，并在该服务商的官方网站创建 API 密钥。密钥只保存在自己的设备上，不要通过聊天、截图或文档公开分享。
HERMES / MODEL CONNECTION
配置 Hermes API
为 Hermes 接入模型提供商的 API：通过官方向导填写接口地址、密钥与模型，并完成一次安全校验。
推荐方式hermes model 向导
密钥存放~/.hermes/.env
接口配置~/.hermes/config.yaml
API CONNECTION PATH
先确定模型提供商
API 配置的核心是让接口地址、模型名称与密钥属于同一个服务商；先确认来源，再交给 Hermes 的官方向导保存。OFFICIAL GUIDE打开 Hermes 官方提供商说明
Hermes 需要至少配置一个模型提供商才能工作。官方向导支持云端服务商，也支持任何兼容 OpenAI 接口格式的自定义地址。
打开 Hermes 官方提供商说明 ↗HOW IT WORKS
执行前后要做的四件事
CONNECT
在终端运行 hermes model
打开终端并运行 hermes model。按向导选择已有服务商；如使用自建、Ollama、vLLM 或其他 OpenAI 兼容接口，则选择 Custom endpoint。
CONFIGURE
填写地址、密钥和模型名称
按向导输入 API Base URL、API Key 和模型名称。Hermes 会将模型与接口设置保存到 config.yaml，并将 API 密钥作为机密保存到 .env。
VERIFY
检查配置并开启新会话
运行 hermes config check 检查缺失项；完成后开启一个新的 Hermes 对话，确认模型能够正常响应。出现授权失败时，先确认密钥确实属于当前服务商。
FINAL CHECK
完成后检查这三项
API 密钥未出现在笔记或截图中
密钥只应保存在 ~/.hermes/.env 或由官方向导管理的位置，绝不应提交到 Git 或发送给他人。
模型、地址与密钥来自同一服务商
OpenAI、OpenRouter 或其他服务商的密钥不能混用；自定义接口也要使用与该接口匹配的密钥。
新会话可以正常响应
配置完成后重新开始一次对话，确认模型已被 Hermes 正确调用，再开始处理实际文件或业务任务。