Hermes Agent 接入 CoderPlan 教程

通过 Hermes Agent 的 Custom endpoint 配置 CoderPlan `/v1` 服务和 Claude 模型。

最后更新：2026/07/12

Hermes Agent 配置

Hermes Agent 支持任何实现 `/v1/chat/completions` 的 OpenAI Compatible endpoint。创建“第三方 Claude 工具”密钥后，运行 `hermes model` 选择 Custom endpoint，填写 CoderPlan `/v1` Base URL、完整 API Key 和控制台中可用的 Claude 模型 ID。

前置条件

先准备 CoderPlan 账号、可用 API 使用额度和 `sk-` 开头的 API Key。建议用小额额度完成一次验证。

填对服务地址

Hermes Agent 中的 Base URL、Endpoint 或 OpenAI Compatible URL 按工具要求填写。Hermes Agent 的 Custom endpoint 使用 OpenAI Compatible `/v1` Base URL；模型 ID 从 CoderPlan 控制台模型列表复制。

Hermes Agent config.yaml 示例

model:  default: your-claude-model-id  provider: custom  base_url: https://api.coderplan.ai/v1  api_key: sk-your-api-key

配置步骤

1
创建第三方 Claude 工具密钥并选择模型
创建“第三方 Claude 工具”密钥，再从控制台模型列表复制一个当前可用的 Claude 模型 ID。
创建 API 密钥
2
运行 hermes model
在终端运行 `hermes model`，选择“Custom endpoint (self-hosted / VLLM / etc.)”，按提示输入 API Base URL、API Key 和模型名。
官方配置依据
Hermes Agent 官方文档把交互式 Custom endpoint 作为推荐配置方式，并说明自定义服务需要实现 `/v1/chat/completions`。
查看 Hermes Agent 官方文档
```
hermes model
```
3
核对 config.yaml
配置会保存到 `~/.hermes/config.yaml`。确认 `model.provider` 为 `custom`，`model.base_url` 指向 CoderPlan `/v1`，并且模型 ID 没有拼写错误。
4
启动 Hermes Agent 发送短请求
启动 Hermes Agent 后先发送一个短问题。若能返回，再进行需要工具调用或长上下文的任务。

验证调用

保存配置后先发起一个简短请求，例如解释短函数。成功返回后，再交给它处理正式任务。

排查顺序

如果失败，先确认配置写在 `~/.hermes/config.yaml`，provider 为 custom，Base URL 包含 `/v1`。

查看排查教程选择编程模型

常见问题

Hermes Agent 的 Base URL 为什么需要 `/v1`？

Hermes Agent 的 Custom endpoint 按 OpenAI Compatible `/v1/chat/completions` 接入，因此 Base URL 使用 CoderPlan 的 `/v1` 地址。

应该修改 `.env` 还是 config.yaml？

自定义 endpoint 和模型配置以 `~/.hermes/config.yaml` 为准。官方文档说明旧的通用 LLM_MODEL 环境变量已移除，Custom endpoint 应通过 `hermes model` 或 model.base_url 配置。

Hermes Agent 为什么找不到 Claude 模型？

请从 CoderPlan 控制台模型列表复制当前账号可见的精确 Claude 模型 ID，并确认使用的是“第三方 Claude 工具”密钥。

使用文档开始使用

Hermes Agent 接入 CoderPlan 教程

通过 Hermes Agent 的 Custom endpoint 配置 CoderPlan `/v1` 服务和 Claude 模型。

最后更新：2026/07/12

Hermes Agent 配置

前置条件

先准备 CoderPlan 账号、可用 API 使用额度和 `sk-` 开头的 API Key。建议用小额额度完成一次验证。

填对服务地址

Hermes Agent config.yaml 示例

model:  default: your-claude-model-id  provider: custom  base_url: https://api.coderplan.ai/v1  api_key: sk-your-api-key

配置步骤

1
创建第三方 Claude 工具密钥并选择模型
创建“第三方 Claude 工具”密钥，再从控制台模型列表复制一个当前可用的 Claude 模型 ID。
创建 API 密钥
2
运行 hermes model
在终端运行 `hermes model`，选择“Custom endpoint (self-hosted / VLLM / etc.)”，按提示输入 API Base URL、API Key 和模型名。
官方配置依据
Hermes Agent 官方文档把交互式 Custom endpoint 作为推荐配置方式，并说明自定义服务需要实现 `/v1/chat/completions`。
查看 Hermes Agent 官方文档
```
hermes model
```
3
核对 config.yaml
配置会保存到 `~/.hermes/config.yaml`。确认 `model.provider` 为 `custom`，`model.base_url` 指向 CoderPlan `/v1`，并且模型 ID 没有拼写错误。
4
启动 Hermes Agent 发送短请求
启动 Hermes Agent 后先发送一个短问题。若能返回，再进行需要工具调用或长上下文的任务。

验证调用

保存配置后先发起一个简短请求，例如解释短函数。成功返回后，再交给它处理正式任务。

排查顺序

如果失败，先确认配置写在 `~/.hermes/config.yaml`，provider 为 custom，Base URL 包含 `/v1`。

查看排查教程选择编程模型

常见问题

Hermes Agent 的 Base URL 为什么需要 `/v1`？

Hermes Agent 的 Custom endpoint 按 OpenAI Compatible `/v1/chat/completions` 接入，因此 Base URL 使用 CoderPlan 的 `/v1` 地址。

应该修改 `.env` 还是 config.yaml？

Hermes Agent 为什么找不到 Claude 模型？

请从 CoderPlan 控制台模型列表复制当前账号可见的精确 Claude 模型 ID，并确认使用的是“第三方 Claude 工具”密钥。

Hermes Agent 接入 CoderPlan 教程

Hermes Agent 配置

前置条件

填对服务地址

Hermes Agent config.yaml 示例

配置步骤

创建第三方 Claude 工具密钥并选择模型

运行 hermes model

官方配置依据

核对 config.yaml

启动 Hermes Agent 发送短请求

验证调用

排查顺序

常见问题

Hermes Agent 的 Base URL 为什么需要 `/v1`？

应该修改 `.env` 还是 config.yaml？

Hermes Agent 为什么找不到 Claude 模型？

Hermes Agent 接入 CoderPlan 教程

Hermes Agent 配置

前置条件

填对服务地址

Hermes Agent config.yaml 示例

配置步骤

创建第三方 Claude 工具密钥并选择模型

运行 hermes model

官方配置依据

核对 config.yaml

启动 Hermes Agent 发送短请求

验证调用

排查顺序

常见问题

Hermes Agent 的 Base URL 为什么需要 `/v1`？

应该修改 `.env` 还是 config.yaml？

Hermes Agent 为什么找不到 Claude 模型？