Claude Code 的「永动机」：Ralph Loop 让 AI 自己写完代码再下班

Claude Code 很强，但有个致命弱点：一次对话，它往往在「差不多就得了」的时候交卷，留下半成品。这不是模型的问题，是机制的问题——没有循环，就没有真正的完成。

Ralph Loop 治这个病。

它是什么

Ralph Loop 的核心思路来自 Geoffrey Huntley，HwangTaehyun 把它做成了一个完整的 CLI 工具。原理很优雅：给 Claude Code 一个任务 + 成功标准，然后它自动进入「写代码 → 跑测试 → 看报错 → 改代码 → 再跑测试」的无限循环，直到条件触发才退出。类比抢票：你不停刷新，看到「有票」才停止。

听起来简单，做起来难。难点不在循环，在「什么时候停」。

三个真正有价值的地方

1. 智能退出检测。普通循环最大的风险是「死循环」——Claude 反复改同一块代码，永远觉得自己还能更好。Ralph 内置了两层错误过滤 + 多行匹配，能判断「是真的 error」还是「正常的日志输出」，从而准确识别「卡住了」的状态。实测 165 个测试，100% 通过。

2. API 限速保护。Claude Code 有 5 小时用量上限，Ralph 内置了速率限制（默认 100 次/小时）和倒计时器，超时前会主动提示，不会等到被限流了才停。这对需要跑一夜的长任务非常重要。

3. tmux 实时监控 + 桌面通知。你把任务丢给 Ralph 去跑，自己去开会或睡觉。它会在 tmux 里实时显示进度，跑完或出错时发桌面通知，回来直接看结果。

使用方式

装一次，全局可用：

curl -fsSL https://raw.githubusercontent.com/HwangTaehyun/ralph-claude-code/main/install.sh | bash

然后在任何项目目录下跑：

ralph --continue "帮我把这个 React 项目迁移到 Next.js App Router"

想从断点继续？加 --continue。想限制 Claude 能用的工具？加 --allowed-tools。想做 Dry Run 验证？加 --dry-run。

为什么值得装

过去一年，Claude Code 生态有两类插件：一类是「给你加功能」（语法检查、代码审查……），另一类是「改变你用 AI 的方式」。Ralph 属于后者。

它把 AI 编程从「对话」变成「委托」——你定义目标，AI 自主循环执行，你在旁边做别的事。这才是 Agent 该有的样子。

GitHub：https://github.com/HwangTaehyun/ralph-claude-code

GitHub: https://github.com/HwangTaehyun/ralph-claude-code