ralph-claude-code
活跃·★ 9.7k·MIT·更新于 2026-10-25
★ 时下流行
Ralph for Claude Code 实现了 Geoffrey Huntley 提出的、以 Ralph Wiggum 命名的技术，用来让 Claude Code 持续自主地进行开发循环。它一次安装成为全局命令，然后把项目包进一个循环里，并带有保护机制，让循环合理地停下来，而不是失控地一直跑。
README 列出的功能有：需要同时满足完成指示和明确的 EXIT_SIGNAL 的双条件退出门、每小时重置的限速（默认每小时 100 次调用）、带错误检测的熔断器和分两阶段过滤错误的响应分析器、带用户提示的五小时用量上限处理、可配置过期时间（默认 24 小时）的会话延续、tmux 监控、PRD 导入以及卸载脚本。它标注版本 0.10.0 为积极开发中，11 个文件共 308 个测试全部通过；这个版本把所有 Ralph 文件移到 .ralph/ 文件夹，是一次破坏性变更，并新增了 ralph-migrate 命令。仍在开发的项目包括试运行模式、配置文件、日志轮转和指标统计。采用 MIT 许可证。
#自主AI#Claude Code#开发运维#命令行工具#会话管理
01
功能特性
01自主开发循环
02智能退出检测（双条件）
03会话连续性与过期管理
04速率限制与断路器
05产品需求文档（PRD）导入功能（多格式）
02
为什么选择它
+为自主循环加上了护栏：双条件退出、限速、熔断器和错误分析。
+能处理 Claude 的五小时用量上限，并通过可配置的超时保持会话延续。
+tmux 监控让你可以观察循环，PRD 导入便于从需求文档开始。
+对一个小项目来说测试充分（报告有 308 个测试），并提供安装、迁移和卸载脚本。
03
权衡点
!它在循环里自主运行 Claude Code，你不在的时候会消耗你的用量额度和 API 调用（默认上限为每小时 100 次）。
!v0.10.0 把所有文件移到 .ralph/ 文件夹，是破坏性变更，用旧版本设置的项目需要执行 ralph-migrate 迁移。
!列出的几项功能仍在开发中，包括试运行模式、配置文件和日志轮转。
05
维护状况检查
活跃检查日期: 2026-10-27
- 最近提交
- 2026-10-25
- 近 90 天提交数
- 14
- 近 90 天发布数
- 0
- 最新发布
- —
- 未关闭 issue
- 18
- 近期 issue 至少有一条评论的比例
- 21/23
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #327 [P8.1] Recompile triage-incoming-issues.lock.yml to pick up gh-aw v0.79.8 + checkout v6.0.32 条评论 · 2026-06-15
- #389 [P8.7] E2B upload list contains .ralphrc twice (file count off by one)1 条评论 · 2026-10-10
- #388 [P8.6] E2B sandbox: remaining RALPH_DIR edge cases (symlink to outside, cwd /, outside-workspace mapping)1 条评论 · 2026-10-10
- #384 [P8.5] GLM review check fails on every fork PR (no secrets) — skip it for forks1 条评论 · 2026-10-09
- #375 [P8.4] Remove obsolete create_files.sh (embeds a pre-#346/#371 loop)1 条评论 · 2026-10-07
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 想让 Claude Code 在你离开时循环工作，并有保护措施让它适时停下。
- 想要双条件退出、频率限制（默认每小时 100 次调用）和熔断器。
- 想让循环自动处理 Claude 的五小时用量限制，并保持会话连续。
建议换别的情况
- 你承担不起无人值守的用量：运行时会消耗你的额度和 API 调用。
- 你在 v0.10.0 之前装过它且无法迁移：文件已移到 `.ralph/` 目录。
- 你需要试运行模式、配置文件或日志轮转：README 写的是仍在开发中。
06
与同类的区别
07
兼容性
Claude Code CLI
原生支持
已通过文档验证
Claude
支持的AI
已通过文档验证
tmux
监控集成
已通过文档验证
GitHub Actions
CI/CD集成
已通过文档验证
08
快速开始
1
$ git clone https://github.com/frankbria/ralph-claude-code.git
2
$ cd ralph-claude-code
3
$ ./install.sh
09
使用场景
↳使用 Claude Code 自动化软件开发项目。
↳将现有产品需求或规范转换为可执行的自主开发计划。
↳通过AI指导对代码库进行迭代改进、调试和功能添加。
10
同类工具
收录于以下清单
评论
登录后发表评论
暂无评论，来发表第一条吧