用途:Ralph Wiggum Mode 是一个自主 AI 编码循环,让 Claude Code 在无人干预下连续处理任务,适合过夜功能开发、批量修 bug、提升测试覆盖率、重构大型代码库、生成文档等多步骤工作。
核心原理:进度不保存在 LLM 上下文窗口中,而是保存在文件与 git 里。当上下文写满,循环会用全新上下文重启 Claude,新实例从文件系统状态(代码、git 历史、任务跟踪文件)继续。
主要能力:外部 Bash 循环反复启动 Claude 会话,每轮读取 RALPH_PROMPT.md、检查 IMPLEMENTATION_PLAN.md、挑选一个任务实现、运行测试并提交;支持可配置迭代上限、每轮 git 提交、优雅关闭。
使用方式:先运行 ./ralph-init.sh 生成 RALPH_PROMPT.md、IMPLEMENTATION_PLAN.md、ralph.sh、ralph-sandbox.sh、Dockerfile.ralph;在 specs 目录写需求并更新实施计划;推荐用 ./ralph-sandbox.sh 运行,可加迭代数如 ./ralph-sandbox.sh . 20;用 tail -f ralph.log 和 git log 查看进度。环境变量包括 RALPH_MAX_ITERATIONS(默认 0 不限)、RALPH_MODEL(默认 sonnet)、RALPH_COST_LIMIT(默认 50.00 美元)、ANTHROPIC_API_KEY(可选)。
安全限制:Ralph 使用 --dangerously-skip-permissions,可能删除文件、读取凭据、发起网络请求、执行任意命令,因此强制要求沙箱:检测容器环境、网络隔离、非 root 用户、无敏感路径访问,至少三项通过才启动。仅在你已验证的自定义沙箱中可用 RALPH_I_KNOW_WHAT_IM_DOING=sandboxed ./ralph.sh 覆盖。建议安装 ralph-safety-check 与 ralph-cost-monitor 钩子。
适用场景与限制:适合可分解为原子任务、有测试可验证的编码工作;任务过大或提示不明确时容易卡住,需人工查看日志并更新计划或提示。具体收费、价格与平台支持资料未提供。