Ralph Wiggum
148,649 starsAnthropic 官方 Claude Code 插件:實作「Ralph 技術」——用一個 Stop hook 攔截 Claude 的退出意圖,把同一個提示再餵回去,形成會話內的 while-true 自我迭代迴圈,直到任務完成(以 --completion-promise 指定完成暗號,如 DONE);/ralph-loop 啟動、/cancel-ralph 停止。無需外部 bash 迴圈。
- 首次公開:2025-11-16
- 數據截至:
- 2026-09-30
宿主
迴圈裡的 Claude 擁有你這個 session 的全部工具權限(檔案、shell、已接的 MCP server),並且會反覆使用它們——同一任務每輪都可能再次讀寫檔案、再次執行命令,直到模型自己宣告完成暗號。
核心是 Claude Code 的 Stop hook(hooks/stop-hook.sh)——攔截「session 退出」這個事件是 Claude Code 專有的 hook 點;其他宿主要嘛沒有同名事件,要嘛 hook 機制完全不同(OpenClaw 的插件 contract、Hermes 的 hooks/middleware、DSH 的 Cordis 事件)。
風險
這是把 human-gated 拿掉的實驗:完成條件由模型自己判斷,判斷失準就是無限迴圈——token 與 API 費用持續燃燒、每輪反覆改動檔案。在帶破壞性工具的 session 裡跑 Ralph,等於讓無人看守的 agent 連續做幾十次高權限操作。務必在可丟棄的環境、受限的工具面下使用。
安裝提示詞
在 Claude Code 的插件管理介面中,從官方 marketplace(claude-plugins-official)安裝 ralph-wiggum;之後用 /ralph-loop 命令加任務描述與完成暗號啟動迴圈,用 /cancel-ralph 停止。使用前請先讀插件 README——它會改變 session 的退出行為。把這段貼給你的 agent。它刻意不含任何工具子命令 —— 指令請以該工具的官方文件為準。