Claude Code Notify Bridge
一个面向 Windows 的 VS Code 扩展。它通过 Claude Code 原生 Hooks，在 Claude 完成任务、异常结束或等待处理时，把通知转发给你的 HTTP 通知网关。
这不是 Claude 的替代客户端，也不会修改模型、账号或项目代码。它只提供一个独立的配置页，帮助用户安全地安装、更新和移除本扩展创建的 Hook。
系统要求
- Windows 本机、VS Code 1.95 或更高版本，以及已安装并能正常使用的 Claude Code（终端或官方 VS Code Native UI）。
- 可访问你的 HTTP(S) 通知网关。首次需要填写通知地址、API Key 和接收人，再点击“保存并安装 Hook”。
- 不需要安装 Node.js、Python 或额外的 PowerShell 运行环境；Windows 自带的 PowerShell 5.1 即可。脚本与运行时配置均以 UTF-8 BOM 写入，兼容中文路径和中文通知内容。
自动识别与迁移
扩展在 Windows 本机首次启动时会先只读检查当前用户的 Claude 通知配置。下列两种经过严格验证的来源可以自动导入：
- 本扩展此前写入的
claude-notify-bridge.settings.json；
- 旧 Windows Claude Hook（精确指向
claude-notify.ps1、脚本语义匹配）以及其共享的 %USERPROFILE%\.codex\hooks\wecom_notify.settings.json。
检测到完整可信配置后，通知地址、接收人和机器人会自动预填，API Key 直接保存到 VS Code Secret Storage，不会显示在侧栏或日志中。若旧 Hook 通过完整校验，扩展会自动安装新版 Hook 并只替换这五个旧 Handler，避免双发；旧 .ps1 和共享 .codex 配置都会保留，方便回滚和其他工具继续使用。
如果机器从未配置过通知网关，Claude Code 本身并没有可推导的通知接收地址或 API Key；此时仍需首次填写一次，或由部署环境预先提供上述可信配置文件。名称相近、内容无法验证、项目级或受管理的 Hook 一律不会被自动删除或改写。
使用方式
- 在 Windows 上安装
.vsix，重载 VS Code 后打开左侧 Claude 通知 面板。
- 已有上述通知配置时会自动导入并安装；侧栏的“现有 Claude 通知”区域会显示处理结果。
- 新机器则填写通知服务地址、API Key 和接收人；可按需填写机器人、来源标签和代理地址。
- 选择要接收的事件：任务完成、需要权限/人工处理、异常中止；可在高级设置调整时长和延迟。
- 点击 保存并安装 Hook，再点击 发送测试通知。
扩展会以幂等方式更新当前用户的 Claude Code 配置：
%USERPROFILE%\\.claude\\settings.json%USERPROFILE%\\.claude\\hooks\\claude-notify-bridge.ps1%USERPROFILE%\\.claude\\hooks\\claude-notify-bridge.settings.json%USERPROFILE%\\.claude\\hooks\\claude-notify-bridge.state\\（临时状态）
如果设置了 CLAUDE_CONFIG_DIR，则优先使用该目录。现有的 Claude Hooks 和其他 settings 字段会被保留；移除功能只删除带有本扩展专属标识的 Hook。只有自动迁移时，经过完整验证的旧 claude-notify.ps1 Handler 会被替换；未知 Hook 始终保留。
某些版本的官方 VS Code Native UI 会在修改模型或偏好时整体改写该用户设置文件。只要本扩展创建的运行时脚本和配置仍完整，Bridge 会在 VS Code 启动时、以及检测到这类外部改写后，自动且保守地把自己的 Hook 合并回去；它不会改写未知 Hook。使用“移除 Hook”后，运行时标识也会被删除，自动恢复不会重新启用通知。
通知网关约定
扩展会发送：
POST {通知服务地址}/api/notify
X-API-Key: {API Key}
Content-Type: application/json
请求体包含 to、title、text、level、format，并按需带上 bot 与 source。通知正文会包含项目目录、Claude Code 对话路径和任务耗时。
与现有 Windows Hook 一致的行为
UserPromptSubmit 记录本轮任务起点；Stop 仅在任务时长达到阈值后推送完成通知，默认 60 秒。Notification 先等待默认 30 秒（可调至最多 300 秒）；如果期间 Claude 继续执行工具，PostToolUse 会取消该提醒，避免短暂等待造成打扰。idle_prompt 不会重复转发；StopFailure 会立即发送任务异常结束通知。Notification 保持异步等待，避免 30 秒的等待提醒阻塞 Claude；Stop 和 StopFailure 同步发送，避免 Windows 上 Claude Code 在会话结束时提前终止异步通知进程。它们最长等待 30 秒；UserPromptSubmit、PostToolUse 只写入或删除很小的本地状态文件。
VS Code Native UI 完成通知兼容模式
部分版本的官方 Claude Code for VS Code Native UI 会写入已完成的助手回复，却不派发 Stop Hook。默认启用的兼容模式会在这种情况下只检查当前提示之后新增的本机 JSONL 记录：同一会话、claude-vscode 入口、非 sidechain、助手 end_turn / stop_sequence，且存在可见文本块。确认记录稳定默认 3 秒后才处理。
- 原生
Stop 和兼容模式领取同一个本地状态文件，先到的一方处理后另一方自动退出，不会重复推送。
- 完成时长阈值按实际完成记录判断；短任务不会等到 60 秒后被误报。
- 回复正文不会进入通知、日志或网关；兼容模式只在本机读取完成所需的结构字段。通知仍沿用原有的项目目录、对话路径和时长信息。
- 该兜底仅补足“任务完成”。需要权限/人工处理、等待提醒、异常结束仍由 Claude Code 原生
Notification、PostToolUse 和 StopFailure Hook 负责。
安全与边界
- API Key 首先保存在 VS Code Secret Storage，永不回传到侧栏页面或写入 VS Code Settings。
- 为了让 VS Code 关闭后 Claude Code 仍能运行 Hook，安装时必须在用户的
.claude/hooks 写入一份运行时 API Key 副本。请使用受控的 Windows 用户账户和 HTTPS 通知地址。
- Hook 使用 PowerShell 的无 Shell 参数形式，不拼接用户输入为命令；通知失败时不会阻断 Claude Code。
- 当前版本只配置本机 Windows 用户目录，不会悄悄写入 Remote SSH、容器或项目级
.claude/settings.json。
开发与打包
npm install
npm run check
npm run package
生成的 .vsix 可通过 VS Code 的 Install from VSIX... 安装。
