Stuck Detector 卡死检测
发现 Claude 反复重试同一个失败操作,就提醒、劝它换思路,必要时拦下。
> 给订单列表加上分页
⏺ 我先看看列表组件。
✗ npm test ✗ npm test ✗ npm test ✗ npm test ✗ npm test
🔁 Stuck Detector: npm test failed 5× · Claude was nudged to change approach
[Stuck Detector] 不要原样再跑,先说明根因再换方法。
(示意)失败 8 次后 🛑 拒绝执行,发新提示即可继续
❯
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add choaticpixels/HauntedClaudeMod
/plugin install stuck-detector@claude-mods
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add choaticpixels/HauntedClaudeMod
claude plugin install stuck-detector@claude-mods然后在会话里执行 /reload-plugins,或开一个新会话。
请帮我安装 Claude Code Mod「Stuck Detector 卡死检测」(https://github.com/choaticpixels/HauntedClaudeMod)。安装前先阅读仓库 README 的 Security 和 Requirements 部分,告诉我它会读写哪些内容、运行什么命令、是否联网,以及对 Claude Code 版本、系统和终端的要求。确认没有问题后,运行 claude plugin marketplace add choaticpixels/HauntedClaudeMod 和 claude plugin install stuck-detector@claude-mods 完成安装,最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code,它会先读原作者说明再安装。
git clone https://github.com/choaticpixels/HauntedClaudeMod
cd HauntedClaudeMod
claude --plugin-dir ./plugins/stuck-detector克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明,收录时核对;可用 claude plugin validate 自行检查。
读取
有读取工具调用参数(命令、文件路径、编辑内容)与执行结果、错误文本。
写入文件
有在插件存储中保存开关和累计提示次数,并向会话追加提示消息。
运行命令
未说明联网
未说明介绍
Stuck Detector 是 Claude Code 的 function hooks Mod(来自 HauntedClaudeMod 合集),盯着工具调用,防止 Claude 一直重复同一个失败命令白烧 token 和时间。它分三级反应:
- 同一调用失败 3 次:弹 toast,并在状态行警告。
- 失败 5 次,或不同命令出现同一错误 4 次:往会话里追加一条提示,让 Claude 停下来诊断、换方法。
- 失败 8 次:拒绝再执行这一调用,直到你发新的提示。
同一调用即使成功也重复 6 次(空转)、短时间内对同一文件改 6 次以上(反复改)也会提醒。你发新提示会清零,子代理单独计数;警告显示在输入框上方横条。命令:/stuck 查看状态与最近调用,/stuck reset / off / on。
README 未写 Claude Code 最低版本,本站基线为 2.1.287+。注意它会以用户消息形式向会话追加提示。评分为资料校准,未实测。
适合谁
- 长时间让 Claude 自主跑任务、担心它陷入重试循环的人
运行要求
- 作者未写明 Claude Code 最低版本;本站基线为 2.1.287+ function hooks。
- 第 8 次相同失败会被拦截,需发新提示才能继续。