集成
Hermes Agent + Claude Code 中文集成指南
Claude Code 是 Anthropic 官方的终端 Coding Agent CLI。Hermes Agent 是 Nous Research 开源的多渠道 Bot Runtime(Telegram / Discord / WeChat / Web 全平台)。这两个不是替代关系 —— 它们解决的问题不一样。本文讲三种典型搭配方式。
两者定位
| Claude Code | Hermes Agent | |
|---|---|---|
| 形态 | 终端 CLI | 容器 Bot Runtime |
| 主用例 | 本地写代码 / 调试 / 重构 | 跑多渠道用户 Bot |
| 会话方式 | 开发者 1:1 对话 | 1:N 用户对话 |
| 持久化 | 当前 cwd 工作区 | 容器全局工作区 + DB |
| 渠道 | 终端 | Telegram / Discord / WeChat / Web / API |
| 模型绑定 | Anthropic(Sonnet / Opus) | 任意 OpenAI 兼容(GPT / Claude / Qwen / DeepSeek 等) |
方式一:用 Anthropic OAuth 让 Hermes 复用 Claude Code 的 Pro 额度
如果你已经买了 Claude Code 订阅(Pro / Max / Team),Anthropic 颁发的 CLAUDE_CODE_OAUTH_TOKEN 可以直接喂给 Hermes — Hermes 上游的 anthropic Provider 同时读 ANTHROPIC_API_KEY、ANTHROPIC_TOKEN、CLAUDE_CODE_OAUTH_TOKEN 三个变量。
# 把 Claude Code 的 OAuth Token 喂给 Hermes
export CLAUDE_CODE_OAUTH_TOKEN=...
docker run -d \
-e CLAUDE_CODE_OAUTH_TOKEN \
ghcr.io/nousresearch/hermes-agent:latestHermes 拿到 Token 后,用 claude-sonnet-4.6 或 claude-opus-4.7 走 Anthropic 原生通道。注意:Anthropic 自 2026 年起对第三方客户端复用 Claude Code 订阅额度的政策时有变动,长期方案建议直接配 API Key(按 token 计费)。详见 Hermes Agent + Anthropic(英文)。
方式二:Claude Code 通过 Hermes 调任意模型(CC Switch)
反过来:Claude Code 默认只能用 Anthropic 模型。但通过 CC Switch 或 claude-code-router,可以把 Claude Code 的请求转到 Hermes 暴露的 OpenAI 兼容 API。等于:用 Claude Code 的 UI,跑 GPT / DeepSeek / Qwen / MiMo。
- 部署 Hermes(OpenClaw Launch 或自托管),拿到
https://hermes-<port>.openclawlaunch.app/v1+ token - 装 CC Switch(见 CC Switch 中文指南)
- 在 CC Switch 里建一个 Profile:base URL 指向 Hermes,model 选
deepseek-v4或xiaomi/mimo-v2-pro - 切到这个 Profile 后,Claude Code 的所有请求都走 Hermes
方式三:共享 Skills 仓库
Hermes Skills 和 Claude Code Skills 协议兼容(都是 SKILL.md + scripts/ 目录)。两边可以共用一份 skill 库:
# Claude Code 装 skill
claude-code skill install ~/my-skills/seo-blog-creator
# Hermes 装同一个 skill
hermes skills install ~/my-skills/seo-blog-creator这样写一次,两边都能用。详见 Hermes Skills 中文指南。
典型使用流
- 开发阶段:Claude Code 在你本地写代码、调试、重构
- 调通后:把同一个 skill 装进 Hermes,让 Bot 在 Telegram / Discord 上跑给用户
- Hermes 收集真实用户输入,回流到 skill 改进 —— Claude Code 在本地继续迭代
常见组合场景
场景 1:SEO 写作 Bot
Claude Code 本地调试 seo-blog-creator skill,调通后装到 Hermes,让团队成员通过 Telegram 给 Hermes 发关键词、自动生成文章。
场景 2:客服 Bot
Claude Code 本地写 support-email-replier skill 处理邮件,Hermes 把同一个 skill 装上跑 WhatsApp / WeChat 客服。两边逻辑同步。
场景 3:用 Anthropic 订阅省钱
团队已经买了 Claude Pro,每月 $20 包月。Hermes OAuth 接 Anthropic 后,团队 5 个 Bot 共享一个 Pro 额度,单独跑 Claude 4.6 不再额外烧 API token。
限制
- Anthropic OAuth 共享额度有并发限制 —— 高 QPS Bot 还是建议走 API key
- CC Switch 转发 Hermes 时,Claude Code 的某些 Anthropic 专属 feature(Computer Use、Long Output 1M)可能失效
- Skills 兼容性:Hermes Skills 多了“渠道感知”字段,Claude Code 装它们时这部分被忽略