小马AI 使用文档

主题

使用 小马AI 配置 Hermes Agent ​

本文档介绍如何将 Hermes Agent 配置为使用 https://code-plan.pony.codes/ 提供的 OpenAI 兼容 API。

前提条件 ​

已安装 Hermes Agent。如果尚未安装，运行：

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

配置步骤 ​

方法一：交互式配置（推荐） ​

在终端运行：

bash
hermes model

按照提示操作：

  1. 在菜单中选择 Custom endpoint (enter URL manually)
  2. API base URL 填入：
    https://code-plan.pony.codes/
  3. API key: 创建 API 令牌后生成的令牌
  4. Hermes 会自动检测可用模型，从列表中选择你想使用的模型，例如：
    • claude-opus-4-8 — Claude 高能力模型
    • gpt-5.5 — GPT 模型
    • claude-sonnet-4-6 — Claude 均衡版本
  5. Context length 留空（自动检测）
  6. Display name 可自定义或直接回车使用默认值

配置完成后会显示：

Default model set to: claude-opus-4-7 (via https://code-plan.pony.codes/v1)
💾 Saved to custom providers as "Code-plan.pony.codes"

方法二：命令行直接配置 ​

bash
hermes config set model.base_url https://code-plan.pony.codes/v1
hermes config set model.default claude-opus-4-7
hermes config set model.provider custom
hermes config set model.api_key sk-xxx

方法三：手动编辑配置文件 ​

bash
hermes config edit

在 config.yaml 中找到或添加以下内容：

yaml
model:
  provider: custom
  default: claude-opus-4-7
  base_url: https://code-plan.pony.codes/v1
  api_key: sk-xxx

验证配置 ​

配置完成后，运行以下命令验证是否正常工作：

bash
hermes chat -q "你好，请介绍一下你自己"

或直接启动交互模式：

bash
hermes

如遇问题，运行诊断：

bash
hermes doctor

切换模型 ​

在 Hermes 会话中，可以随时用以下命令切换模型（仅影响当前 session）：

/model claude-opus-4-7

永久切换：

bash
hermes model

注意事项 ​

  • Hermes 会自动将 URL 修正为带 /v1 的完整路径
  • 配置变更在新会话中生效；当前会话内用 /model 临时切换

小马AI

Copyright © 2026 小马AI