ralph-claude-code
9,724
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Shell
语言
创建时间
最近更新
项目能做什么
面向 Claude Code 的自主 AI 开发循环工具，具备智能退出检测功能。
来源：AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
中文使用说明暂未生成。下面保留原仓库 README 摘录，命令与配置均以原文为准。
原始 README 摘录（英文原文，节选前 3000 字符）
# Ralph for Claude Code [](https://github.com/frankbria/ralph-claude-code/actions/workflows/test.yml) [](LICENSE)   [](https://github.com/frankbria/ralph-claude-code/issues) [](https://github.com/hesreallyhim/awesome-claude-code) [](https://github.com/varun1505/awesome-software-factories) [](https://x.com/FrankBria18044) > **Autonomous AI development loop with intelligent exit detection and rate limiting** Ralph is an implementation of the Geoffrey Huntley's technique for Claude Code that enables continuous autonomous development cycles he named after [Ralph Wiggum](https://ghuntley.com/ralph/). It enables continuous autonomous development cycles where Claude Code iteratively improves your project until completion, with built-in safeguards to prevent infinite loops and API overuse. **Install once, use everywhere** - Ralph becomes a global command available in any directory. ## Project Status **Version**: v0.11.5 - Active Development **Core Features**: Working and tested **Test Coverage**: 784 tests, 100% pass rate ### What's Working Now - Autonomous development loops with intelligent exit detection - **Dual-condition exit gate**: Requires BOTH completion indicators AND explicit EXIT_SIGNAL - Rate limiting with hourly reset (100 calls/hour, configurable) - Circuit breaker with advanced error detection (prevents runaway loops) - Response analyzer with semantic understanding and two-stage error filtering - **JSON output format support with automatic fallback to text parsing** - **Session continuity with `--resume` flag for context preservation (no session hijacking)** - **Session expiration with configurable timeout (default: 24 hours)** - **Modern CLI flags: `--output-format`, `--allowed-tools`, `--no-continue`** - **Interactive project enablement with `ralph-enable` wizard** - **`.ralphrc` configuration file for project settings** - **Live streaming output with `--live` flag for real-time Claude Code visibility** - **Log rotation: `ralph.log` rotates at 10MB, keeping 4 archived files** - **Dry-run mode (`--dry-run`) to simulate loops without API calls** - **Metrics tracking with `ralph-stats` analytics command (JSON Lines per-loop metrics)** - **Desktop notifications (`--notify`) for key loop events (macOS/Linux/terminal-bell)** - **Automatic git backup branches (`--backup`) with `--rollback` restore** - Multi-line error matching for accurate stuck loo阅读完整原文
商业机会分析 AI 生成
Ralph Cloud: 面向 Claude Code 的云端托管与守护运行平台
| 产品构想 | 基于 Ralph 的循环控制与熔断机制，封装出无需本地开机的云端无头工作流平台，支持从 GitHub Issue 自动认领、启动沙箱执行并自动提 PR。 |
| 核心功能 | 云端临时沙箱（E2B/Docker）、任务队列管理（ralph-queue 扩展）、GitHub Webhook 自动触发、成本与 API 消耗硬上限限制、实时 Web 终端看板。 |
| 目标用户 | 频繁接外包项目的个人开发者、希望自动化处理日常微小 bug/依赖升级的初创团队。 |
| 难度/周期 | 中等 · 4-6 周 · 成本：极低（主要为云服务器与沙箱运行实例成本） |
| 收费模式 | SaaS 订阅制（基础席位费 + 任务并发/运行时长配额） |
| 竞争风险 | 高依赖 Anthropic 官方政策；Claude Code 原生后续可能内嵌类似长循环守护能力。 |
| 依据 | 已验证事实 |
Ralph Desktop: 本地安全沙箱与可视化控制台 (Electron/Tauri GUI)
| 产品构想 | 将 Bash 脚本工具包装为桌面可视化软件，提供一键式环境检测、可视化的 API 限额看板、本地 Git 分支回滚管理和沙箱隔离网络控制。 |
| 核心功能 | 可视化 PRD/Issue 导入向导、多项目循环状态并发监控、本地 Docker 沙箱一键配置、实时 Token 消耗估算与断路器开关、通知集成。 |
| 目标用户 | 不习惯纯 CLI 操作的个人开发者、对本地脚本执行安全性敏感的开发者。 |
| 难度/周期 | 中等 · 3-5 周 · 成本：极低（主要是本地客户端分发签名与打包） |
| 收费模式 | 买断制 License（含 1 年更新支持）或 Pro 版订阅 |
| 竞争风险 | 纯 CLI 开发者对 GUI 需求偏弱，需重点打安全隔离与多任务看板痛点。 |
| 依据 | AI推测 |
Enterprise Ralph: 团队级 AI 编程守护与审计中间件
| 产品构想 | 为企业团队提供自托管的 Claude Code 调度中间件，规范团队成员使用本地智能体时的安全边界、预算审批和审计回溯。 |
| 核心功能 | 集中式 Token 预算池与频次风控、沙箱网络白名单强制注入（基于项目现有的 SANDBOX_DOCKER_NETWORK 参数扩展）、Git 提交自动校验与回滚审计、统一凭证注入（无需在工程师个人环境存明文 API Key）。 |
| 目标用户 | 允许工程师使用 Claude Code 但担忧代码外泄、失控循环与超预算的技术总监/研发主管。 |
| 难度/周期 | 较高 · 6-8 周 · 成本：低（基础软件开发，主要为团队测试环境资源） |
| 收费模式 | 企业级自托管私有授权（按席位/年收费）与部署技术支持服务 |
| 竞争风险 | 企业对引入第三方包装工具决策周期长，需满足严格合规要求。 |
| 依据 | 尚需验证的假设 |
AI 基于仓库公开数据分析生成，含推测成分，不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| michaelshimeles/ralphy | 中文介绍暂未生成 My Ralph Wiggum setup, an autonomous bash script that runs C |
2,981 | TypeScript |
| Th0rgal/open-ralph-wiggum | 中文介绍暂未生成 Type `ralph "prompt"` to start open code in a ralph loop. Al |
1,906 | TypeScript |
| AnandChowdhary/continuous-claude | 中文介绍暂未生成 🔂 Ralph loop with PRs: Run Claude Code in a continuous loop, |
1,389 | Shell |
| tzachbon/smart-ralph | 中文介绍暂未生成 Spec-driven development with smart compaction. Claude Code p |
567 | Shell |
| blencorp/lisa | 中文介绍暂未生成 Lisa plans. Ralph does. Interactive specification interview |
121 | TypeScript |
| hellangleZ/burn-in-cceverywhere-ralph | 中文介绍暂未生成 Claude Code Enhanced: 整合 everything-claude-code + ralph 的最佳能 |
110 | Shell |
以上为通过 GitHub 官方 Search API 检索的相似项目，功能差异与优劣势需进一步人工确认，配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 ，最近推送 |
| 社区活跃 | Star 9,724 / Fork 0 / Issue 0（数据支持，可自行核实） |
| 许可证 | 未检测到（需人工确认） |
| 主要风险 | 上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价 |
安装与使用
快速开始（以仓库 README 为准）
git clone https://github.com/frankbria/ralph-claude-code.git cd ralph-claude-code # 请阅读仓库 README 获取确切安装步骤（依赖、配置、启动命令）
术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。