Claude Code 语音钩子
为 Claude Code 的钩子事件添加声音反馈，让会话和工具活动更容易被察觉。
- Star 数
- ★ 560
- 最近更新
- 4 个月前
- License
- MIT
- 主语言
- HTML
- FA 评分
- 34/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 的开发者希望在会话开始时听到声音提示。
- 不适合
- 不使用 Claude Code 的开发者
这个 Agent 能做什么，适合哪些场景？
这是一个为 Claude Code 配置钩子声音反馈的仓库，README 称其支持 30 种钩子事件。它面向 Claude Code 的会话、工具使用、代理响应等活动播放声音，示例包括会话开始和工具使用时的提示音。仓库提供 macOS、Linux 和 Windows 的安装入口，并要求用户先满足相应前置条件。安装后，在终端启动 claude 并发送提示即可体验声音反馈。README 没有列出具体音频运行时、安装命令、配置文件细节或各事件对应的声音映射。
安装并配置仓库提供的 Claude Code hooks；Claude Code 启动后触发会话、工具和其他钩子事件时播放声音。README 给出的快速体验流程是启动 claude，再发送例如 Hi 的提示。仓库还提供钩子事件概览、跨文件扫描钩子变更的 /workflows:workflow-changelog 工作流，以及用于添加指定钩子的 /workflows:workflow-add-hook <HookName> 工作流。
- 使用 Claude Code 的开发者希望在会话开始时听到声音提示。
- 在执行编码任务时，开发者希望通过声音留意工具使用和代理响应。
- 希望了解仓库所覆盖 Claude Code 钩子事件的用户可查看钩子事件概览。
- 维护这套钩子配置的人可使用
/workflows:workflow-changelog扫描新增钩子和文件差异。 - 需要加入某个推荐钩子的维护者可使用
/workflows:workflow-add-hook <HookName>工作流。
如何安装或部署这个 Agent？
仓库按 macOS、Linux 和 Windows 提供独立安装说明入口。所给材料没有包含这些说明的具体内容，因此无法据此给出可复制的安装命令或前置依赖清单。安装前需按对应系统说明完成前置条件；缺少前置条件时，README 提示 Claude Code 启动可能出现 SessionStart:startup hook error。
如何使用这个 Agent？
完成对应系统的安装和前置条件后，在终端启动 Claude Code：
claude发送提示，例如 Hi。README 称会话开始、工具使用、代理响应等场景会有声音反馈。
这个 Agent 有哪些优点和局限？
- README 标示支持 30 种 Claude Code 钩子事件，覆盖范围包括会话和工具活动。
- 提供 macOS、Linux、Windows 三种安装说明入口。
- 包含跨文件扫描钩子变化和添加指定钩子的工作流。
- 只针对 Claude Code；材料没有记录其他编码代理或平台的运行路径。
- 具体安装命令、前置依赖和音频运行时要求未出现在所给材料中。
- README 提示未满足前置条件可能导致会话启动时报
SessionStart:startup hook error。 - 没有说明声音是否可自定义、各事件默认声音是什么或如何关闭。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Code 语音钩子 当前 | 34 · 缺口较多 | Agent 插件 / 技能免费 | ★ 560 | 4 个月前 | HTML | Claude Code |
| Harmonist | 78 · 表现良好 | 命令行工具免费 + 模型费 | ★ 2.3k | 4 个月前 | Python | — |
| dmux | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.8k | 2 个月前 | HTML | Codex · Claude Code · OpenAI API |
| Vibe Coding Toolkit | 66 · 存在缺口 | Agent 插件 / 技能免费 | ★ 1.7k | 今天 | JavaScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 将产品描述为 Claude Code hooks 的语音反馈，并链接到 macOS、Linux、Windows 安装说明，显示用途和可能的系统影响；但所给材料没有 hook 实现、权限范围、确认机制、数据处理、敏感信息措施、依赖清单或撤销步骤。README 的开发者署名提供有限来源线索，但发布者身份未获验证，维护责任也不清楚，因此各项仅按可见证据给分。
README 列出 hooks 数量、版本及逐步变更，并指出未满足先决条件可能导致启动错误，提供了部分一致性和故障线索；但没有实现、依赖版本或详细诊断信息，无法充分核对这些描述或评估依赖可用性。
README 表明此项目面向 Claude Code 用户，提供三类操作系统的安装入口，并称覆盖多类 hooks；但场景、能力边界、触发行为和环境要求缺少具体说明，需查看未提供的安装与 hook 文件才能确认。
README 有安装入口、演示、链接和按日期记录的 hook 变更，LICENSE 明确为 MIT 并附完整条款。安装细节、常见错误处理和已知限制较少；命名和维护责任也未充分说明，变更记录只覆盖 hook 添加。
按 hook 发出声音的定位明确，若描述准确，可为 Claude Code 会话提供即时音频反馈；但材料未展示实际输出、可配置性、资源成本或比较收益，因此效用和成本判断仅部分有据。
README 将若干版本变更链接到 Claude Code 更新记录，并指向 hooks 说明及演示，提供有限可追踪线索；但本次仅有 README 和 LICENSE，缺少实现及独立佐证，且无法判断文档是否区分事实与推断。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 本评估只依据所给 README 和 LICENSE；未提供的安装说明、hook 实现、依赖及配置均未核验。
- README 提到先决条件不满足时会出现启动 hook 错误，但未在所给材料中说明完整诊断或恢复步骤。
常见问题
它支持哪些操作系统？
如何快速确认声音钩子已工作？
claude 并发送 Hi；README 预期会话开始、工具使用和代理响应等活动会触发声音。