工作流出现在 · 横条 / 弹窗 / 状态行收录

Stuck Detector 卡死检测

发现 Claude 反复重试同一个失败操作,就提醒、劝它换思路,必要时拦下。

Stuck Detector 卡死检测 · 效果预览 · 示意示意
> 给订单列表加上分页
⏺ 我先看看列表组件。
✗ 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 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 次相同失败会被拦截,需发新提示才能继续。