集成
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 API Key（订阅额度已被官方封堵）
网上流传的做法，是把 Claude Code 颁发的 CLAUDE_CODE_OAUTH_TOKEN 喂给 Hermes（其上游 anthropic Provider 确实同时读 ANTHROPIC_API_KEY、ANTHROPIC_TOKEN、CLAUDE_CODE_OAUTH_TOKEN 三个变量）。请不要这样做。
Anthropic 在其 官方合规文档中明确写明：OAuth 登录仅限 Claude Code 与 Anthropic 自家应用使用，「不允许第三方开发者代表用户通过 Free、Pro 或 Max 订阅额度转发请求」，并保留不经通知直接执行的权利。自 2026 年 1 月起，Anthropic 已在 API 层封堵——订阅 Token 在 Claude Code 之外发起的请求会被直接拒绝，且可能导致您的 Claude 账号被限制。因此我们不提供订阅额度接入。
官方认可的做法是使用 Claude Console 的 API Key（按 token 计费），同样可以跑 claude-sonnet-4.6 或 claude-opus-4.7：
# 使用 Anthropic API Key（官方支持的方式）
export ANTHROPIC_API_KEY=sk-ant-api03-...
docker run -d \
-e ANTHROPIC_API_KEY \
ghcr.io/nousresearch/hermes-agent:latest详见 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：用 Claude 模型控制成本
团队想跑 Claude 模型又不想为每个 Bot 单独付订阅费。正确做法是共用一个 Anthropic API Key（按 token 计费）：日常对话交给便宜的 Haiku，复杂任务再切 Sonnet / Opus，实际花费往往低于多份包月订阅。注意不要用订阅额度给多个 Bot 供数——那属于 Anthropic 明令禁止的第三方转发。
限制
- Anthropic 订阅额度不能用于第三方转发（官方明令禁止，且已在 API 层封堵）—— Bot 一律走 API Key
- CC Switch 转发 Hermes 时，Claude Code 的某些 Anthropic 专属 feature（Computer Use、Long Output 1M）可能失效
- Skills 兼容性：Hermes Skills 多了“渠道感知”字段，Claude Code 装它们时这部分被忽略