Hermes Agent 接入 Claude API

Hermes Agent 配置 1折AI Claude API 中转的地址、密钥与模型教程，包含协议选择、配置示例、验证步骤和常见错误。

使用 Hermes Agent 的自定义供应商功能连接 1折AI。先创建 API 密钥，并确认当前可用模型；下文模型 ID 是示例，请按你的密钥权限调整。

官方配置核对日期：2026-10-15。以下配置依据官方文档整理，本站端到端验证尚未完成；请先完成简短问答和工具调用验证，再用于长任务。OpenAI / GPT 模型已上线，模型列表与价格见模型说明。

依据官方 Providers：终端运行 hermes model → Custom endpoint，API mode 明确选择 chat_completions，Base URL 填 https://1zheai.com/v1，填写密钥和模型。不要选 ChatGPT/Codex 登录，它是另一种接入方式。

可复用的命名 provider 配置，合并到 ~/.hermes/config.yaml：

1
providers:
2
  onezhe:
3
    api: https://1zheai.com/v1
4
    key_env: ONEZHE_API_KEY
5
    transport: chat_completions
6
    default_model: claude-sonnet-4-6
7
model:
8
  provider: custom:onezhe
9
  default: claude-sonnet-4-6

在 ~/.hermes/.env 本地提供：

1
ONEZHE_API_KEY=sk-替换为本站密钥

已配置后可在对话中切换 /model custom:onezhe:claude-sonnet-4-6。/model 不能代替终端 hermes model 创建新 provider。官方支持 anthropic_messages 传输，但本教程使用 Chat Completions，避免按 URL 自动猜测协议。OPENAI_BASE_URL 不是所有自定义 provider 的通用配置；应使用上面的显式配置。

验证接入与排错

保存并重新加载配置，确认当前选中的是 onezhe 供应商或你添加的自定义模型。
发送一句简短问题，确认能够返回；随后尝试一个可撤销的小任务，单独确认工具调用和多轮对话。
打开调用日志，核对请求时间、模型、状态与用量。一次文本回复成功不代表所有 Agent 能力都已兼容。
遇到 404，核对本文地址和协议是否配套；遇到 401，核对密钥来源和进程是否读取到环境变量；遇到 429，查看限流信息后再重试。更多情况见错误码与排错。

密钥只保存在本地环境或工具的凭据存储中，不要提交到代码仓库、截图或公开日志。后台服务可能不继承终端环境变量；辅助模型、搜索和其他工具也可能有独立的供应商设置，需要分别检查。

费用与其他接入方式

查看Claude API 实时价格和计费规则。需要其他客户端时返回工具接入目录；自己编写程序可用SDK 与开发指南。