Claude Subconscious防止无限循环机制解读stop_hook_active设计全解【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude Subconscious是一个为 Claude Code 提供潜意识的开源插件一个后台智能体默默观察你的每次会话跨会话积累记忆并在你输入下一条提示前悄悄耳语回指引。而它的 Stop 钩子每次响应后都会被触发一旦设计不当极易陷入无限循环——本文带你完整解读stop_hook_active这个 3 行守卫如何优雅防死循环。什么是 Claude Subconscious一句话概括Give Claude Code a subconscious给 Claude Code 装个潜意识。它的核心工作流是时机动作效果每次响应后Stop 钩子异步发送会话记录到后台智能体智能体读代码、更新记忆不阻塞主流程每次输入前UserPromptSubmit 钩子注入记忆与消息Claude 提前拿到跨会话上下文每次工具调用前PreToolUse 钩子注入增量更新长任务中保持上下文不漂移其中Stop 钩子是防循环设计的重灾区我们重点来看它。为什么 Stop 钩子会无限循环先理解 Claude Code 的钩子机制当 Claude 结束一轮回答时会触发Stop钩子。如果钩子以阻塞式退出码exit code 2结束并返回反馈Claude Code 会认为还不能停让 Claude 继续工作——然后再次触发 Stop 钩子。如果钩子脚本没有意识到我是被二次触发的就会出现Claude 停止 → 触发钩子 → 钩子阻塞退出 → Claude 继续 → 又停止 → 又触发钩子 → ……死循环对于 Claude Subconscious 来说每次循环都意味着重复发送整段会话记录给后台智能体既浪费 token 又污染记忆。stop_hook_activeClaude Code 的内置安全开关Claude Code 为此在钩子输入中内置了一个布尔信号stop_hook_active。它表示上一次 Stop 钩子已经激活过——是平台层送给钩子脚本的一面别再阻塞的小旗子。在 scripts/send_messages_to_letta.ts 中钩子输入被完整建模interface HookInput { session_id: string; transcript_path: string; stop_hook_active?: boolean; // ← Stop 钩子是否已处于激活状态 cwd: string; hook_event_name?: string; }3 行代码的防循环守卫源码全解整个防护逻辑浓缩在 scripts/send_messages_to_letta.ts 的第 142-146 行// Prevent infinite loops if stop hook is already active if (hookInput.stop_hook_active) { log(Stop hook already active, exiting to prevent loop); process.exit(0); }设计上有 3 个讲究️ 提前短路守卫放在读取会话记录、调用 API 等一切重操作之前二次触发时零开销退出 留痕可查退出前写入一条日志方便你在$TMPDIR/letta-claude-sync-$UID/send_messages.log中确认守卫确实生效过 以 0 退出用成功码而非错误码退出避免触发任何告警或重试逻辑——我没事只是不该再做了双保险异步钩子 快速退出设计stop_hook_active守卫只是第一道防线Claude Subconscious 实际上有三层防循环设计第一层async 异步钩子。在 hooks/hooks.json 中Stop 钩子注册了async: true和 120 秒超时——它永远在后台运行天然不会阻塞 Claude 的停止流程从源头消除了阻塞→重触发的循环条件。第二层stop_hook_active 守卫。即使某次运行处于激活状态脚本也会立即静默退出见上文源码。第三层快进快出 后台 Worker。主钩子只做轻量工作解析 JSONL 会话记录、把 payload 写入临时文件、派生一个 send_worker_sdk.ts 分离后台进程后立即退出详见 README.md 的 Stop 章节。主钩子越快退出与 Claude Code 生命周期重叠的窗口就越小。主钩子秒级解析记录 → 写 payload → 派生 worker → 退出 后台 worker独立恢复 Letta 会话 → 智能体处理 → 更新状态 → 清理临时文件如何验证防循环机制生效运行插件后用一行命令观察日志即可tail -f /tmp/letta-claude-sync-$(id -u)/send_messages.log每次 Stop 触发日志都会打印当前信号值send_messages_to_letta.ts 第 138 行stop_hook_active: false ← 正常触发继续发送会话 stop_hook_active: true ← 若出现下一行就是 exiting to prevent loop正常情况下你只会看到false一旦看到true后紧跟退出日志说明守卫按预期拦截了二次触发而非真的出现了异常循环。相关文件速查文件职责hooks/hooks.jsonStop 钩子注册async 120s 超时scripts/send_messages_to_letta.ts主钩子stop_hook_active 防循环守卫scripts/send_worker_sdk.ts后台 Worker独立进程完成会话投递README.mdStop 钩子异步模式的官方说明CHANGELOG.md版本演进记录想要动手体验克隆仓库后运行npm install再在 Claude Code 中启用插件即可git clone https://gitcode.com/GitHub_Trending/cl/claude-subconscious cd claude-subconscious npm install小结stop_hook_active防循环机制的精髓在于**平台给信号脚本听劝异步兜底**3 行守卫代码成本极低却与 async 钩子、快进快出设计共同构成纵深防御。这也是所有 Claude Code 钩子开发者值得抄的作业——任何可能阻塞会话的钩子都应先检查再行动。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考