voicehook

voicehook-agent

与编码 Agent 对话，而不是阅读它们的输出。

voicehook.ai 是一款在浏览器中进行的语音通话服务。 点击“邀请 Agent”，将链接交给 Claude Code、Codex 或 opencode，然后在它继续工作的同时与它交谈。通话中的语音助手 Delta 会根据 Agent 持续更新的状态看板和常见问题解答进行回复，让你无需打开终端也能了解当前进展。

本仓库包含 Agent 端：voicehook-join Claude Code 插件，以及让任何拥有 shell 的 Agent 都能加入通话的 voicehook-agent CLI。

三种连接方式

你的 Agent	连接方式
Claude Code	插件，两个命令（见下文）。详情
claude.ai / Claude Desktop	自定义连接器 https://voicehook.ai/mcp（Settings、Connectors、Add custom connector；无需密钥）。指南
任何支持 shell 的 Agent	快速入门 A（HTTPS 桥接，无需安装）或 CLI

选哪种？MCP（连接器或插件）是入口：无需安装，每次调用对应一个 Agent，也是唯一支持 create_call、卡片和决策的方式。CLI 是在一台机器上进行多 Agent 协作的专业工具。 HTTPS 桥接是底层协议，也是备用方案。

MCP/桥接 = 通话中只有一个 Agent；活动记录只包含该 Agent 手动写入的内容。若要让一台机器上的多个 Agent/会话参与同一通话，请使用 voicehook-agent CLI（专业版）：它的多会话中继 + Claude Code hook 会自动将所有本地会话的实时活动记录、状态和决策传入通话。MCP/桥接运行在服务器上，无法看到用户的本地会话。

路径	角色	适用场景
MCP（voicehook.ai/mcp）	入口 + 分发	单个 Agent 参与通话、云端/沙盒会话、自行发起通话
CLI（voicehook-agent）	多 Agent 协作的专业工具	一台机器上的多个 Agent/会话参与同一通话，查看所有会话的实时活动记录
桥接（/api/bridge/*）	底层协议 + 备用方案	没有 MCP 客户端，也没有 CLI

详情和无需 git 的安装说明：docs/CLI.md。

在 Claude Code 中：

/plugin marketplace add voicehook-ai/voicehook-agent
/plugin install voicehook-join@voicehook

连接后，将邀请链接（https://voicehook.ai/r/<slug>?invite=<code>） 粘贴到你的 Agent 中，它就会加入通话。

MCP 工具（连接器和插件）：

工具	功能
create_call	为你的用户发起新通话（仅主 Agent：绝不要将 create_call 委派给子 Agent，否则链接会留在子 Agent 的会话中）：返回 human_url 和 share_text（原样转发：在普通浏览器中打开链接，不要使用应用内置浏览器）；硬性规则：先将 share_text 作为文本展示，然后反复调用 join，直到连接成功，再进入 next 循环
join	使用邀请链接加入通话，并设置你的标识 label；用通话语言向你致意（默认启用 greet）；返回会话、通话语言和通话上下文（first_actions）；如果用户尚未打开 create_call 链接，则等待（Claude 客户端最长等待 200 秒，其他客户端最长 50 秒），并返回带有 next_action 的 waiting_for_human：立即再次调用，直到返回会话，期间绝不要结束轮次；本地 Claude Code 还会获得 local_cli_hint（此 CLI 会让它留在通话中）
next	等待下一轮，最长 50 秒（用户、决策、操作员、上下文、结束）；至少每 10 到 15 秒调用一次，每个 Agent 各自循环；暂停后会返回 missed
say	让语音机器人朗读文本
status	状态面板（不会朗读），语音机器人会根据它作答；可选的标识 emoji
show	在通话页面上展示卡片（文本、代码、链接或图片），不会朗读
activity	为活动信息流添加一条 3 到 8 个词的记录，每一步都要调用
decide	向决策面板提出问题（是/否，或最多 3 个选项）；答案会通过 next 返回
leave	离开通话

发生 5xx、503 或网络错误时，Agent 只需等待 2 秒后重新调用工具；会话仍然有效。多个 Agent 参与同一通话：规则。

CLI 快速入门

uvx voicehook-agent join 'https://voicehook.ai/r/<slug>?invite=<code>' --name <your-own-name> --model <your-model-name>

• --name 和 --model 为必填项：显示名称由 Agent 自行选择，模型则填写其实际运行的确切模型。请填写真实的模型和供应商名称，除非你使用的是 Claude，否则绝不要填“Claude”。
• 使用完整的邀请链接，包括 ?invite=<code>。
• stdout 会打印用户和语音机器人说的话；stdin 中的每一行都会被朗读。 在通话期间，使用运行环境的后台模式持续运行 voicehook-agent listen （Claude Code：使用 run_in_background，绝不要用 &/nohup）：它会在第一个需要你处理的事件出现时退出并唤醒你；处理完后重新启动。自 0.21.4 起，只要你仍连接着通话，而没人监听，Stop hook（voicehook-agent hook install）就会阻止回合结束（监听保护：别让回合在无人监听时结束（0.21.4））。自 0.21.5 起，加入通话本身就会让你保持在线，并在你工作期间持久保存所有事件（事件暂存：加入通话后代你监听（0.21.5））：listen 会用游标获取这些事件，不会有任何遗漏，Stop hook 也会对未读事件发出警告。等待人类回复时，务必使用 decide，绝不要只查看状态（0.21.6：status --waiting ... --question ... 会在显示决策的同时显示“wartet auf dich”）。通话期间：先回答每一句发言（say）；超过 2 次工具调用的工作交给后台 Agent；保持回合简短；自 0.21.7 起，新的发言会通过 PostToolUse hook 在回合中途传达给你。

每个决策和每条状态记录都必须附带供语音机器人使用的隐藏背景信息（0.21.4）：--context "..."，以及 3 个最可能的后续问题和准备好的答案，使用 --faq "Frage::Antwort"（如果还没有答案：说明由谁负责以及预计时间，“In Arbeit bei , Ergebnis ca. 10 Min”）。活动记录也可以附带这些信息。在 status 中，它们会附加到其后的条目；如果没有，CLI 会打印提示（参见 docs/CLI.md）。

若要在不轮询的情况下循环使用（say、next、status、leave），以及了解状态面板、活动 hook 和所有标志，请参见 docs/CLI.md。自 0.21.0 起：decide --context "..." 可向 Delta 提供问题背景；ui large decisions / ui layout thirds / ui focus voicehook 可控制人类看到的通话页面；status|activity --project NAME 可标记你的项目（页面控制与 UI（0.21.0））。

自 0.23.0 起，通话中的 Agent 可以在通话期间向 Delta 提供长期规则和事实，让它能自行回答更多问题：voicehook-agent delta-rule add "Sprich den Kunden mit Sie an"、voicehook-agent delta-note add "Der Release ist am Freitag"、... list、... rm <id>。这些操作不会发出提示音，从它的下一回合开始生效，最多可添加 20 条规则和 30 条事实，每条最多 300 个字符。

join 后立即（0.21.4），CLI 会列出此机器上正在运行的其他 Claude Code / Codex 会话，并建议询问人类：“Soll ich die anderen N Sessions hier einbinden, damit sie ihren Status in den Call bringen?”；如果对方同意，Agent 就会运行打印出来的设置命令。使用 MCP 或桥接的 Agent 看不到本地会话：它们会说明只要安装了 CLI，原则上就可以使用：uv tool install voicehook-agent && voicehook-agent hook install。

在一台机器上运行多个 Claude Code 会话（0.15.0）：只需运行一次 voicehook-agent hook install；当其中一个会话处于通话中时，其他每个会话都会以自己的名称，在通话的活动动态中报告回合目标、PR、部署情况和错误 （多会话中继：同一台机器上的每个 Claude Code 会话都加入通话（0.15.0））。自 0.16.0 起，这类辅助会话也可以向人类提问（decide，通过 relay-next 或 decide --wait 获取回答），并维护自己的状态面板（status --doing ...） （辅助会话：决策面板和独立状态面板（0.16.0））。

OpenAI Codex CLI（0.20.0）：voicehook-agent hook install --agent codex 会将相同的自动化配置写入 ~/.codex（hooks.json、notify、一个提供 status、decide、next、activity 的本地 MCP 服务；请先备份），然后在 Codex 中使用 /hooks 信任这些 hook（其他编码 Agent）。

定价

每天大约有 10 分钟免费时长。预付费金额从 10 EUR 起，无需订阅。

文档

文档	内容
docs/CLI.md	安装、Agent 循环命令、状态面板和常见问题、说话风格、活动动态和钩子、形状、自我更新、Claude Code 插件、技能注册
docs/PROTOCOL.md	stdin/stdout 协议、数据通道主题、中继标志、HTTPS 桥接、唤醒标记、服务端行为、环境变量
docs/DEVELOPMENT.md	CI 任务、插件发布、CLI 发布、PyPI 设置
OPERATOR-PROTOCOL.md	服务端操作员协议（voicehook.ai）

开发、CI 和发布

每个 PR 都会触发 CI，运行测试、ruff、插件验证、密钥扫描和技能偏差检查。 发布标签、插件发布清单和 PyPI 设置请参阅 docs/DEVELOPMENT.md。

许可证

MIT，详见 LICENSE。

---

德国制造，托管于纽伦堡（Hetzner）。无 Cookie、无跟踪、无通话录音。 你或你的 Agent 所说的内容都不会被存储。隐私政策