Hermes Agent 接入 ModelFold

首次会话积分消耗偏高属正常现象

Agent 每次请求都会携带固定的工具定义和系统提示（通常有数万 token）。首次会话这部分内容需要写入缓存，按全量输入计费，所以消耗的积分会比较多；之后的请求命中缓存，这部分按低价缓存计费，消耗会明显下降。这是正常现象，并非多扣费。如有大量使用需求，请联系客服，我们可提供优惠。

全部编程工具 · 更多工具接入 · 不支持与受限工具

按官方文档配置；未进行客户端实测配置入口支持不等于每个模型、每项 Agent 功能都已验证。

安装与准备

通过官方文档中的安装入口安装正式版本；编辑器插件请在对应商店选择官方发布者。到 ModelFold API Keys 创建密钥。配置中出现 MODELFOLD_API_KEY 时，启动工具前设置环境变量：

bash

export MODELFOLD_API_KEY="YOUR_MODELFOLD_API_KEY"

密钥不要提交到项目仓库或贴到截图中。图形界面密钥框通常填写原始 Key，由客户端添加认证头。

配置提供商

配置位置： hermes model / ~/.hermes/config.yaml。验证状态： 按官方文档配置；未进行客户端实测

运行 hermes model，选择自定义端点，填写地址、密钥及模型。若选 Anthropic Messages，使用原生地址；不要把辅助模型的配置当成主模型。

yaml

providers:
  modelfold:
    api: https://modelfold.ai/anthropic
    key_env: MODELFOLD_API_KEY
    transport: anthropic_messages
    default_model: claude-opus-5-5
model:
  provider: modelfold
  default: claude-opus-5-5

接 Claude 优先使用 Anthropic 原生格式，符合条件的重复上下文可使用缓存；命中仍取决于模型、前缀和客户端是否发送缓存标记，不能保证每轮都命中。

官方配置依据。

模型与地址

字段	填写内容
本页示例地址	`https://modelfold.ai/anthropic`
API 模型 ID	`claude-opus-5-5`
凭证	ModelFold 控制台创建的 API Key

模型 ID 以全部模型 ID为准。openai/ 等前缀在部分 CLI 中用来选择适配器，不属于服务端模型 ID。不同工具拼接路径的规则不同，严格按本页填写，不重复添加 /v1 或 /messages。

验证

新建会话，明确选中刚配置的提供商与模型，发送：只回复 OK，不要使用工具。 收到回复只证明该模型的基本对话可用。再到 ModelFold 用量记录核对相应请求；模型出现在列表里不代表连通性验证通过。开始长任务前，可在临时项目中试一次小修改。

常见问题

现象	处理
401	检查是否为 ModelFold Key，而非工具订阅凭证；去掉首尾空格。
404	核对协议、路径后缀与准确模型 ID，避免重复 `/v1`。
模型列表为空	支持手动输入的工具可复制准确 ID；环境变量修改后重启客户端。
对话通但工具调用失败	选择支持工具调用的模型；基本聊天兼容不保证全部 Agent 功能。
仍然调用内置服务	显式切换到自定义提供商，检查旧设置和环境变量覆盖。

报价以模型价格页为准。一次任务可能产生多次请求；实际扣费以账户记录为准，客户端估算不等于实际扣费。

Hermes Agent 接入 ModelFold ​

安装与准备 ​

配置提供商 ​

模型与地址 ​

验证 ​

常见问题 ​

Hermes Agent 接入 ModelFold

安装与准备

配置提供商

模型与地址

验证

常见问题