hermes proxy 的作用,是把 Hermes Agent 已经登录的 OAuth provider 包装成本地 OpenAI 兼容接口,让 Codex CLI、Aider、Cline、Continue 或自写脚本像调用 OpenAI API 一样调用它。新手最重要的一点是:先只监听本机,不要直接暴露到公网。
它解决的是什么问题
很多 AI 编程工具只认识 OpenAI-compatible endpoint,但你的模型能力可能来自 Claude Pro、ChatGPT Pro、SuperGrok 或其他通过 Hermes 登录的 provider。v0.14 加入 local proxy 后,Hermes Agent 相当于在中间做了一层桥接:上游仍然用你在 Hermes 里配置好的账号和模型,下游给其他工具一个熟悉的 API 地址。
这不是让你绕过计费或共享账号,而是为了减少重复配置。你不用在每个工具里重新找 provider、填 token、调模型路由,统一让 Hermes 管模型和认证。
推荐的使用顺序
- 先在 Hermes 里确认 provider 已能正常对话,例如
hermes里问一个简单问题。 - 运行
hermes proxy,确认本地端口和 API base 地址。 - 在 Codex、Aider、Cline、Continue 里把 base URL 指向这个本地地址。
- 先用低风险请求测试,例如解释一段小代码。
- 确认稳定后,再考虑放进日常工作流。
常见问题怎么排
如果客户端连不上,先查端口是否监听、base URL 是否带对路径、客户端是否强制要求 API key。若模型返回认证错误,问题多半在 Hermes 的上游 provider 登录状态,而不是客户端。若请求很慢,再看所选模型、上下文长度和 provider 限流。
安全上要记住三件事:默认本地使用,别把端口绑到 0.0.0.0;不要把代理地址给团队成员共用;如果必须远程访问,用 SSH tunnel 或 VPN,并保留最小权限。hermes proxy 很方便,但它接的是你的模型账号,安全边界要比普通本地服务更谨慎。