Claude Code + Hermes MCP 消息桥接实战：任务完成自动通知手机

Claude Code 跑了 20 分钟你不在电脑前，怎么知道它完成了？

这是一个高频痛点。你启动了 SEO 审计、代码重构或者批量文件处理，然后去泡咖啡、看手机。回来一看——Claude 十分钟前就跑完了，白等。

当前有三种方案解决这个问题：

接下来按复杂度递进，逐个拆解配置方法、适用场景和真实限制。

方案一：Hooks 原生通知

Hooks 是 Claude Code 内置的生命周期钩子系统。与通知最相关的是 Stop 事件——Claude 完成一轮响应后自动触发你预设的 Shell 命令。

核心事件

最简配置：macOS 桌面通知

在 ~/.claude/settings.json 中配置 Stop 事件钩子，指向一个自定义通知脚本：

提示词：生成 Hooks Stop 事件配置

请帮我生成 ~/.claude/settings.json 的 Hooks 配置。要求：

• 监听 Stop 事件
• 类型为 command，执行 bash ~/.claude/hooks/notify.sh
• JSON 结构遵循 Claude Code Hooks 规范（hooks → 事件名 → 数组 → hooks 数组 → 单个钩子对象）

对应的通知脚本 ~/.claude/hooks/notify.sh 负责接收 Stop 事件的 JSON 输入，判断是否需要通知，然后弹出桌面提醒：

提示词：生成 macOS 桌面通知脚本

请帮我生成 ~/.claude/hooks/notify.sh，用于 Claude Code Stop Hook。要求：

• Bash 脚本，set -euo pipefail
• 从 stdin 读取 JSON 输入
• 首先检查 stop_hook_active 字段，为 true 时立即 exit 0（防止 Hook 无限循环，Claude Code 连续阻塞 8 次后会强制覆盖）
• 用 jq 提取 stop_reason（默认 "unknown"）和 stop_message（默认 "Claude 已停止"，截取前 300 字符）
• 用 osascript display notification 弹出 macOS 桌面通知，标题为 "Claude Code"，副标题为 stop_reason
• 用 afplay 后台播放系统提示音 /System/Library/Sounds/Hero.aiff

这个方案 5 分钟搞定，零依赖。但问题明显：你必须在电脑前才能看到通知。

Stop 事件的 JSON 输入格式

理解 Stop 事件的输入结构有助于写出更精确的通知脚本。Claude Code 通过 stdin 向脚本传入以下 JSON：

{
  "session_id": "abc123",
  "stop_reason": "end_turn",
  "stop_message": "我已经完成了所有修改，共处理 47 个文件...",
  "stop_hook_active": false
}

关键字段说明：

• stop_reason——停止原因。end_turn 表示正常完成，max_tokens 表示达到输出上限，tool_use 表示需要工具调用。通知脚本通常只在 end_turn 时推送
• stop_message——Claude 最后一条消息的文本内容，可以截取前 300 个字符作为通知正文
• stop_hook_active——是否已在 Hook 循环中。如果为 true，脚本必须立即退出（exit 0），否则会触发无限循环。Claude Code 在 Stop Hook 连续阻塞 8 次且无进展时会强制覆盖该 Hook

Linux 用户需要把 osascript 替换为 notify-send：

# Linux 桌面通知
notify-send "Claude Code" "$MESSAGE" --icon=dialog-information

进阶：Hooks + Telegram 推送

如果需要手机收到通知，在脚本中加入 Telegram Bot API 调用：

提示词：生成 Telegram 推送通知脚本

请帮我生成 Claude Code Stop Hook 的 Telegram 推送脚本。要求：

• Bash 脚本，set -euo pipefail
• 从 stdin 读取 JSON，检查 stop_hook_active 为 true 时立即退出
• 用 jq 提取 stop_reason 和 stop_message（截取前 300 字符）
• 定义 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID 两个变量（留占位符让用户替换）
• 用 curl 异步调用 Telegram Bot API 的 sendMessage 接口，消息格式为 Claude Code [{reason}]: {message}
• curl 调用放后台（&），输出重定向到 /dev/null，不阻塞 Hook 执行

Hooks 方案的局限

1. 单向通知：只能从 Claude Code 向外推送，无法从手机回复控制 Claude
2. 触发粒度粗：每轮响应后都触发，不仅限于"真正的任务完成"——Claude 先提交再推送，你会收到两条通知
3. 依赖本地 Shell：脚本在 Claude Code 所在机器上运行，需要预装 curl、jq
4. 无消息历史：通知发出即完毕，没有对话上下文
5. Codex 不支持：Hooks 是 Claude Code 专属功能，OpenAI Codex 无法使用
6. Stop Hook 阻塞上限：连续阻塞 8 次且无进展时 Claude Code 强制覆盖该 Hook

适合场景：个人开发者、只需要简单提醒、不需要从手机回复。

方案二：Claude Code Channels

Channels（通道）是 Anthropic 于 2026 年 3 月发布的 Research Preview 功能，核心定位是将外部事件推入正在运行的 Claude Code 会话，实现手机端与本机 Claude Code 的双向对话。

架构原理

标准 MCP 流程是 Claude 主动查询外部数据。Channels 反转了这个方向：

• 标准 MCP：用户指令 → Claude → 调用 MCP Server → 返回数据 → Claude 回复
• Channels：外部消息 → Channel 插件（本地 Bun 脚本） → 推入 Claude Code 会话 → Claude 处理 → 通过 Channel 回复

每个 Channel 实质上是一个本地运行的 MCP Server，通过轮询外部平台获取消息，通过 MCP 协议的 notifications/claude/channel 事件推入 Claude Code 会话。

支持的平台

配置方法（以 Telegram 为例）

# 1. 安装插件
/plugin install telegram@claude-plugins-official

# 2. 配置 Bot Token
/telegram:configure <your-bot-token>

# 3. 启动 Claude Code（带 Channels）
claude --channels plugin:telegram@claude-plugins-official

# 4. 在 Telegram 中找到你的 Bot，发送任意消息获取配对码

# 5. 在 Claude Code 中配对
/telegram:access pair <code>

# 6. 锁定为仅允许列表
/telegram:access policy allowlist

配对完成后，你在 Telegram 发送的消息会直接进入 Claude Code 会话。Claude 的回复也会出现在 Telegram 聊天中。

核心特性

1. 双向通信：从手机发消息到 Claude，Claude 的回复出现在同一聊天中
2. 完整文件系统访问：Channel 消息进入的是本地 Claude Code 会话，拥有完整的文件系统和 Git 权限
3. 权限远程审批：将权限弹窗转发到手机端远程批准或拒绝
4. 会话状态持久：会话存续期间保持上下文
5. 事件驱动：不仅限于聊天——可以接收 CI Webhook、监控告警等外部事件

Channels 的局限

1. Research Preview 阶段：语法和协议可能变化
2. 认证绑定：必须通过 claude.ai 或 Console API key 认证，不支持 Bedrock、Vertex
3. 依赖 Bun：官方插件都是 Bun 脚本
4. 需要会话存活：事件只在会话打开期间到达，不是持久后台服务
5. Codex 不支持：Channels 是 Claude Code 专属功能
6. 单会话绑定：一个 Channel 只连接到一个 Claude Code 会话

企业控制

Channels 提供了企业级的管控能力：

Channels 与其他远程方案的区别

Anthropic 同时提供了多种远程使用 Claude Code 的方式。Channels 的定位是"外部事件推入本地会话"，与其他方案的边界清晰：

如果你需要的是在外面用手机向正在跑任务的 Claude Code 发消息，Channels 是最正统的选择。如果你需要的是 Claude Code 跑完后主动告诉你，Hooks 或 Hermes MCP 更直接。

适合场景：需要从手机远程控制 Claude Code、需要双向对话、纯 Anthropic 生态用户。

方案三：Hermes MCP 反向桥接

Hermes Agent（Nous Research 开源）是一个支持多平台消息网关的 AI Agent。v0.16.0（截至 2026 年 6 月的最新版本）起支持 hermes mcp serve 命令，将自身暴露为 MCP Server。Claude Code 和 Codex 通过 SSH 连接远程机器上的 Hermes，按需调用 messages_send 向已连接的消息平台推送通知。

这是一种逆向桥接架构：不是让外部消息推入 Claude，而是让 Claude 在需要时主动调用 Hermes 的工具发消息。

与 Channels 的根本区别

SSH stdio 连接原理

SSH stdio 是将远程 MCP Server 暴露给本地 MCP 客户端的轻量方案。Claude Code 启动 ssh 子进程，SSH 将本地与远程 Hermes 的 stdin/stdout 透明桥接：

本地 Claude Code
    │
    │ 启动子进程: ssh [email protected] hermes mcp serve
    │
    ├─ stdin  ──→ SSH 隧道 ──→ 远程 hermes stdin  （JSON-RPC 请求）
    │
    └─ stdout ←── SSH 隧道 ←── 远程 hermes stdout （JSON-RPC 响应）

优势：

• 无需开放额外端口（仅复用 SSH 22 端口）
• 复用现有 SSH 密钥认证，无需额外凭据
• 加密传输
• 对 Claude Code 而言，Hermes 就像一个本地 MCP Server——完全无感

暴露的 10 个工具

Hermes MCP 反向服务暴露了完整的消息操作工具集。通知场景主要用到前四个，其余在调试和高级交互中使用。

messages_send 调用示例

这是通知场景最核心的工具。target 格式为 platform:identifier，支持人类友好的频道名称自动解析：

# 向 Discord 频道发送通知
mcp__hermes__messages_send(
    target="discord:#总部",
    message="SEO 审计完成，共检测到 12 个死链。报告已保存到 收件箱/运行数据/。"
)

# 向 Telegram 个人聊天发送通知
mcp__hermes__messages_send(
    target="telegram:6308981865",
    message="代码重构完成，47 个文件已更新，所有测试通过。"
)

channels_list 调用示例

首次配置时用来确认连接是否成功，返回所有可发送消息的通道：

# 查看所有 Discord 通道
mcp__hermes__channels_list(platform="discord")
# 返回：[{target: "discord:#总部", ...}, {target: "discord:#翔宇-官网", ...}]

# 查看所有平台的通道
mcp__hermes__channels_list()

events_poll 调用示例

如果需要实现双向交互——Claude Code 发通知后等待用户回复：

# 发送通知并告知用户可以回复
mcp__hermes__messages_send(
    target="discord:#总部",
    message="数据库迁移脚本已生成，是否执行？回复 yes 继续。"
)

# 轮询等待用户回复
mcp__hermes__events_poll(after_cursor=0, limit=5)

完整配置教程

前提条件

1. 一台常驻机器（Mac Mini / Linux VPS / WSL 均可），已安装 Hermes Agent
2. 本地开发机到常驻机器的 SSH 免密登录已配置
3. Hermes 已连接至少一个消息平台（Discord / Telegram / 微信等）

如果你的 Hermes 和 Claude Code 在同一台机器上，可以跳过 SSH 配置，直接使用本地 stdio。

步骤一：部署 Hermes Agent

pipx install hermes-agent[messaging]
hermes --version

安装验证通过后，需要初始化配置、连接消息平台并启动网关服务：

提示词：生成 Hermes Agent 初始化与网关启动流程

请帮我完成 Hermes Agent 的初始化配置。要求：

• 运行 hermes init 生成初始配置文件
• 在 ~/.hermes/config.yaml 中配置消息平台凭据（以 Discord Bot Token 为例）
• 启动网关服务 hermes gateway start
• 确认运行状态 hermes gateway status

详细部署步骤参考 Hermes Agent Docker 部署实战。

步骤二：配置 SSH 免密登录

# 在本地开发机上执行
ssh-keygen -t ed25519 -C "claude-code-hermes"

# 复制公钥到 Hermes 机器
ssh-copy-id [email protected]

# 验证免密登录
ssh [email protected] "hermes mcp serve --help"

步骤三：配置 Claude Code MCP Server

编辑 ~/.claude.json，在 mcpServers 字段中添加 Hermes 的 SSH stdio 配置：

提示词：生成 Claude Code 的 Hermes MCP Server 配置

请帮我生成 ~/.claude.json 的 mcpServers.hermes 配置。要求：

• type 为 stdio（标准输入/输出传输协议，Claude Code 通过 stdin/stdout 进行 JSON-RPC 2.0 通信）
• command 为 ssh
• args 数组依次包含：-o StrictHostKeyChecking=no（内网环境跳过 host key 确认；公网建议去掉）、SSH 目标地址 [email protected]、远程 Hermes 可执行路径（如 /Users/user/.local/bin/hermes）、以及 MCP 启动参数 mcp serve
• 如果 Hermes 和 Claude Code 在同一台机器上，省略 SSH 相关参数，command 直接指向本地 Hermes 路径，args 只写 ["mcp", "serve"]

步骤四：配置权限白名单

编辑 ~/.claude/settings.json，在权限白名单中加入 Hermes 相关工具：

提示词：生成 Claude Code 的 Hermes 权限白名单配置

请帮我在 ~/.claude/settings.json 的 permissions.allow 数组中添加 Hermes 工具权限。要求：

• 逐个列出 5 个核心工具：mcp__hermes__messages_send、mcp__hermes__channels_list、mcp__hermes__conversations_list、mcp__hermes__messages_read、mcp__hermes__events_poll
• 或者用前缀通配 "mcp__hermes" 一次性允许所有 Hermes 工具

步骤五：配置 Codex（可选）

如果你同时使用 OpenAI Codex，需要在 ~/.codex/config.toml 中添加 Hermes MCP Server 配置：

提示词：生成 Codex 的 Hermes MCP Server 配置

请帮我生成 ~/.codex/config.toml 的 [mcp_servers.hermes] 配置段。要求：

• command 为 ssh
• args 数组与 Claude Code 相同：包含 -o StrictHostKeyChecking=no、SSH 目标地址、远程 Hermes 路径、以及 mcp serve 参数
• startup_timeout_sec 设为 15.0（SSH 建连 + Hermes 初始化需要时间）
• tool_timeout_sec 设为 60.0（消息发送可能需要等待网络）

Codex 不需要额外的权限白名单配置。

步骤六：验证连接

在 Claude Code 中输入：

列出 Hermes 可用的消息通道

Claude 会调用 channels_list，如果返回了你的 Discord / Telegram 频道列表，说明连接成功。

步骤七：触发通知

帮我跑一下 SEO 审计，完成后通知我 Discord

Claude Code 完成任务后会自动调用：

mcp__hermes__messages_send(
  target="discord:#总部",
  message="SEO 审计完成，共检测到 12 个死链，报告已保存。"
)

三种方案全维度对比

真实场景对比

场景 A：Claude Code 跑 SEO 审计（30 分钟），用户去吃饭

场景 B：Codex 跑代码重构（20 分钟）

Hermes MCP 反向桥接是当前 Codex 唯一可用的按需通知方案。

场景 C：多品牌内容分发通知

使用场景与最佳实践

何时让 Claude Code 主动通知

Hermes MCP 的设计是按需调用——只有用户明确说"通知我"时 Claude Code 才会调用 messages_send。这种零开销设计意味着：

• 短任务（< 2 分钟）：不需要通知，直接等结果
• 中等任务（2-10 分钟）：看个人习惯，可以加声音提示
• 长任务（> 10 分钟）：建议配置手机通知

消息 target 格式

messages_send 的 target 参数格式为 platform:identifier：

discord:#频道名称
telegram:chat-id
slack:#频道名

支持人类友好的频道名称自动解析。调用前可以先 channels_list 查看所有可用目标。

与其他 MCP 通知方案的互补

社区中还有不少专注通知的 MCP Server，各有定位：

关于 MCP 最佳实践和通知方案的选型思路，可以参考通用指南。

成本控制

Hermes MCP 反向桥接本身没有额外的 API 成本——SSH 连接走内网流量，消息发送走各平台免费 Bot API。唯一的成本是 Hermes Agent 自身的模型调用费用，但 MCP 反向服务模式下 Hermes 不需要运行推理，只做消息转发。

详细成本分析参考 Hermes Agent 成本控制实战。

进阶：Hermes 的指针架构

Hermes 最巧妙的设计决策是"指针架构（Pointer Architecture）"——它的配置文件（SOUL / MEMORY / USER）只存两类内容：

1. 不可能从外部读到的行为约束
2. 怎么找到外部内容的路径和方法

所有事实性内容让 Hermes 在对话中通过 read_file 现场读取。这意味着 Claude Code 改了知识库任何文件，Hermes 下次对话自动感知，零维护成本。

静态层（系统提示词，每次都在）
├── SOUL.md      → 身份 + 语言规则 + "知识库路径在这"
├── MEMORY.md    → 根路径 + 导航方法
└── USER.md      → 极简画像

动态层（对话中按需 read_file）
├── ~/knowledge-base/CLAUDE.md         → 总路由表
├── ~/knowledge-base/品牌/*/身份/*.md  → 品牌详情
├── ~/knowledge-base/工具/CLAUDE.md    → 工具索引
└── ... 一切以文件系统当前内容为准

这个架构对消息通知的意义：当 Claude Code 通过 Hermes 发通知到 Discord 品牌频道时，Hermes 知道该频道对应哪个品牌——因为频道的 channel_prompts 指向了知识库中的品牌目录。通知内容自动带上品牌上下文，不需要人工标注。

Hermes 运维命令速查

配置完成后，日常运维主要用这几个命令：

# 网关管理
hermes gateway status              # 查看运行状态
hermes gateway start               # 启动后台服务
hermes gateway stop                # 停止
hermes gateway restart             # 重启

# MCP 服务器管理
hermes mcp list                    # 列出已连接的 MCP Server
hermes mcp test <名称>             # 测试连通性

# 全面诊断
hermes doctor                      # 自检（配置、模型、平台连接）
hermes status                      # 模型与 Provider 状态

# 日志排查
tail -30 ~/.hermes/logs/gateway.log        # 网关日志
tail -30 ~/.hermes/logs/agent.log          # Agent 日志
cat ~/.hermes/logs/gateway.error.log       # 错误日志

Hermes 与 Channels 的互补关系

在实际使用中，Hermes MCP 反向桥接和 Channels 并非竞争关系，而是互补的。两者覆盖的场景几乎没有重叠：

最务实的搭配方式：Channels 作为双向交互的主通道（从手机控制 Claude Code），Hermes MCP 作为单向通知的专用出口（多平台、多品牌、Codex 兼容）。两者共存不冲突，也不会产生重复通知——因为触发机制完全不同。

社区中也出现了融合两种方案的项目。hermes-CCC（117 Stars）将 Hermes 的 46 个原生技能移植为 Claude Code Channel 插件，无需 OAuth、无需外部进程。这代表了两种方案融合的趋势，但目前仍处于早期阶段。

部署拓扑参考

一个典型的 Hermes MCP 反向桥接部署拓扑如下：

┌──────────────────────────────────────────┐
│  开发机 — 主力开发环境                   │
│  ├── Claude Code（多窗口并行）           │
│  ├── Codex（独立窗口）                   │
│  └── SSH → 常驻机器                      │
│           ↓ hermes mcp serve             │
│           ↓ JSON-RPC over SSH stdio      │
├──────────────────────────────────────────┤
│  常驻机器 — 7x24 后台服务               │
│  ├── Hermes Agent（launchd / systemd）   │
│  ├── Discord Bot（多频道）               │
│  ├── Telegram Bot（私聊）                │
│  └── 微信 iLink Bot（可选）              │
├──────────────────────────────────────────┤
│  用户手机                                │
│  ├── Discord → 在对应频道收通知          │
│  ├── Telegram → 收到私聊通知             │
│  └── 微信 → 收到 iLink Bot 消息         │
└──────────────────────────────────────────┘

关键设计决策：

1. 开发机与常驻机器分离——开发机可以关机、重启、切换网络，Hermes 在常驻机器上 24/7 运行。即使开发机断电，之前发出的通知不受影响
2. SSH 免密认证——消除每次连接的交互确认。内网环境用 StrictHostKeyChecking=no 即可，公网环境配置 ~/.ssh/known_hosts 精确校验
3. 多客户端共享——同一个 Hermes 实例同时服务 Claude Code 和 Codex，消息通道统一管理

如果你的场景更简单（单机开发、不需要 24/7 常驻），直接在同一台机器上跑 Hermes 和 Claude Code，省掉 SSH 配置。

常见问题排查

问题一：Claude Code 启动后 MCP Server 连接超时

现象：Claude Code 启动时报 MCP server hermes failed to start 或连接超时错误。

排查步骤：

# 1. 验证 SSH 连接
ssh [email protected] "echo ok"

# 2. 验证远程 Hermes 可执行
ssh [email protected] "hermes --version"

# 3. 验证 MCP serve 模式
ssh [email protected] "hermes mcp serve --help"

# 4. 检查 Hermes 路径是否正确（pipx 安装在 ~/.local/bin/）
ssh [email protected] "which hermes"

常见原因：

• SSH 密钥未配置免密，连接时等待密码输入导致超时
• Hermes 安装路径与 ~/.claude.json 中配置的路径不一致
• 远程机器防火墙阻止了 SSH 22 端口

问题二：messages_send 调用成功但手机没收到通知

现象：Claude Code 显示工具调用成功，但 Discord / Telegram 没有新消息。

排查步骤：

# 1. 在远程机器上检查 Hermes 网关状态
hermes gateway status

# 2. 检查消息平台连接
hermes status

# 3. 查看网关日志
tail -30 ~/.hermes/logs/gateway.log

# 4. 查看错误日志
cat ~/.hermes/logs/gateway.error.log

常见原因：

• Hermes 网关未启动（hermes gateway start 启动）
• Discord Bot Token 过期或权限不足
• Telegram Bot 被封禁或 Chat ID 不正确

问题三：首条消息延迟明显（约 20 秒）

现象：第一次调用 Hermes MCP 时响应很慢，后续调用正常。

原因：冷启动时 SSH 建连 + Hermes 进程初始化 + 模型 API 端点探测（如果配置了智谱等国内模型，会自动探测 3 次 HTTPS 请求）。

解决办法：

1. 在 Hermes 的 .env 中显式设置模型端点 URL，跳过自动探测
2. 在 Codex 的 config.toml 中将 startup_timeout_sec 设为 15-20 秒
3. 使用 SSH 连接复用减少后续连接耗时：

提示词：生成 SSH 连接复用配置

请帮我在 ~/.ssh/config 中添加 Hermes 服务器的连接复用配置。要求：

• Host 别名为 hermes-server
• HostName 和 User 按实际填写
• ControlMaster auto（自动复用已有连接）
• ControlPath ~/.ssh/sockets/%r@%h-%p（socket 文件路径，确保 ~/.ssh/sockets/ 目录存在）
• ControlPersist 600（连接空闲 10 分钟后自动关闭）

问题四：Hermes 工具在 Claude Code 中不可见

现象：配置了 ~/.claude.json 但在 Claude Code 中无法调用 Hermes 工具。

排查步骤：

1. 确认 ~/.claude.json 格式正确（JSON 语法校验）
2. 重启 Claude Code 使配置生效
3. 检查 ~/.claude/settings.json 的 permissions.allow 中是否包含 "mcp__hermes" 前缀
4. 使用 /mcp 命令在 Claude Code 内部查看已连接的 MCP Server 列表

选型决策树

你需要 Claude Code / Codex 任务完成后收到通知吗？
├── 是
│   ├── 你用的是 Codex 吗？
│   │   ├── 是 → Hermes MCP 反向桥接（唯一方案）
│   │   └── 否（Claude Code）
│   │       ├── 你需要双向对话（从手机控制 Claude）吗？
│   │       │   ├── 是
│   │       │   │   ├── 需要微信端收通知？
│   │       │   │   │   ├── 是 → Hermes MCP（Channels 不支持微信）
│   │       │   │   │   └── 否 → Channels（Telegram / Discord / iMessage）
│   │       │   │   └── 需要多品牌频道隔离？
│   │       │   │       ├── 是 → Hermes MCP
│   │       │   │       └── 否 → Channels
│   │       │   └── 否（只需单向通知）
│   │       │       ├── 5 分钟内搞定 → Hooks + Shell 脚本
│   │       │       └── 需要多平台同时通知 → Hermes MCP
│   │       └── 需要接收外部事件触发 Claude 行动？
│   │           ├── 是 → Channels（事件驱动架构）
│   │           └── 否 → 按上面的树走
│   └── 否 → 不需要配置

核心结论：

• 最简单：Hooks，一个脚本搞定桌面通知
• 官方双向：Channels，适合远程控制 Claude Code
• 最灵活：Hermes MCP，跨客户端、跨平台、可编程

三种方案互不冲突，可以同时使用。

常见问答

Hooks、Channels、Hermes MCP 可以同时使用吗？

可以。三种方案互不冲突。实际组合例子：Hooks 负责本地声音提示（afplay），Channels 负责 Telegram 双向对话，Hermes MCP 负责向 Discord 品牌频道分发通知。根据场景灵活搭配。

Hermes MCP 反向桥接会不会影响 Claude Code 性能？

不会。hermes mcp serve 只在被调用时才通过 SSH 建立连接并启动 MCP Server 进程。日常使用中 Claude Code 不会主动调用 Hermes，只有用户明确要求"通知我"时才触发。零开销设计。

SSH stdio 连接安全吗？

SSH 隧道本身是加密的，安全等级与直接 SSH 登录相同。关键是 SSH 密钥管理——确保只有授权机器能连接到 Hermes 所在的机器。内网环境下可以使用 StrictHostKeyChecking=no，公网环境建议启用严格校验并配置 ~/.ssh/config 限制连接参数。

Channels 现在值得用吗？还是等正式发布？

如果你只需要 Telegram 或 Discord 双向对话，Channels 已经够用。Research Preview 的主要风险是 API 语法可能变化，但核心架构不太会大改。建议把 Channels 作为主方案使用，Hermes MCP 作为补充——覆盖 Channels 不支持的场景（微信、Codex、品牌频道隔离）。

没有额外服务器也能用 Hermes MCP 吗？

可以。Hermes Agent 可以部署在任何 Python 3.12+ 的机器上——Linux VPS、WSL、另一台 Mac 都行。也可以在同一台机器上运行 Hermes 和 Claude Code，此时不需要 SSH，直接使用本地 stdio 即可（步骤三的提示词中已包含同机配置说明）。

Codex 能用哪种通知方案？

OpenAI Codex 目前不支持 Hooks 和 Channels——两者都是 Claude Code 专属功能。Hermes MCP 反向桥接是当前 Codex 唯一可用的按需通知方案，通过 ~/.codex/config.toml 配置即可获得与 Claude Code 相同的通知能力。

omni-notify-mcp 和 Hermes MCP 有什么区别？

omni-notify-mcp 是专注于通知的轻量 MCP Server，提供 notify（发通知）、ask（发问等回复）、poll（轮询）等工具。Hermes 是一个完整的 AI Agent，MCP 反向服务只是它的一个功能模块。选择标准：

• 只需要通知 → omni-notify-mcp 更轻量
• 还需要 Agent 能力（知识库集成、多品牌路由、技能系统） → Hermes 更合适

Stop Hook 每轮都触发会不会通知太多？

会。Stop 事件在 Claude 每次完成一轮响应后都触发，不仅限于"真正的任务完成"。三种解决办法：

1. 在脚本中判断 stop_reason 字段，只在 end_turn 时推送
2. 设置耗时阈值，只在运行超过 N 分钟的任务完成后通知（社区项目 ai-cli-complete-notify 支持此功能）
3. 用 Hermes MCP 替代 Hooks——只有用户明确说"通知我"时才调用，从根本上避免误触发

延伸阅读

• Hermes Agent 完全指南——从安装到生产部署的完整路径
• Hermes Agent Docker 部署实战——容器化部署方案
• Hermes Agent 成本控制实战——模型选型与 Token 优化
• Claude Code MCP 新手指南——MCP 基础概念与配置入门
• Claude Code Hooks 新手指南——Hooks 详细配置与排查
• 我替翔宇测了 Hermes Agent，说说真实感受——第三视角体验评测
• MCP 最佳实践——MCP Server 选型与集成模式

下一步

• AI 编程实操课：Claude Code + Codex + Agent 工作流，覆盖一人公司、自媒体自动化、AI 副业全场景。237 篇实战教程 + 最佳实践 + 源码包，跟着做就出成果。国内版-FlowUS | 国际版-BMC
• YouTube 频道：翔宇工作流
• 微信公众号：搜索「翔宇工作流」