ralph-claude-code
針對 Claude Code 的自動化 AI 開發迴圈,具備智慧型結束偵測
ralph-claude-code 是什麼?
針對 Claude Code 的自動化 AI 開發迴圈,具備智慧型結束偵測
ralph-claude-code 概覽
這是什麼
Ralph for Claude Code 是一個自主 AI 開發循環工具,實作了 Geoffrey Huntley 為 Claude Code 設計的技術。它讓 Claude Code 能夠持續進行自主開發循環,逐步改進專案直到完成,並內建防止無限迴圈與 API 過度使用的安全機制。此工具安裝後可作為全域指令,在任何目錄下使用。目前版本為 v0.11.5,處於積極開發階段,擁有 784 項測試且通過率達 100%。
主要功能
- 自主開發循環搭配智慧退出偵測,採用雙條件退出閘門(需同時滿足完成指標與明確的 EXIT_SIGNAL)
- 每小時重置的速率限制(預設 100 次/小時,可設定)與具備進階錯誤偵測的斷路器
- 回應分析器具備語意理解與兩階段錯誤過濾;支援 JSON 輸出格式並自動降級為文字解析
- 使用
--resume旗標的會話連續性,以及可設定逾時(預設 24 小時)的會話到期機制 - 互動式專案啟用精靈(
ralph-enable)與.ralphrc設定檔 - 即時串流輸出(
--live)、模擬模式(--dry-run)、指標追蹤(ralph-stats)、桌面通知(--notify)與自動 Git 備份分支(--backup搭配--rollback) - GitHub Issue 匯入(支援中繼資料篩選)、PRD 匯入、tmux 整合與 GitHub Actions CI/CD 管線
使用情境
- 自主迭代開發:讓 Claude Code 根據需求反覆改進專案直到完成
- 持續整合與部署管線:需要自動化程式碼生成與改進的情境
- 需要防止無限迴圈與 API 過度使用的 AI 輔助開發專案
- 團隊希望將 Claude Code 整合至具備會話管理與監控功能的自動化工作流程
快速開始
請參閱儲存庫的 README 以取得安裝說明。
授權與價格
本專案採用 MIT 授權,為開放原始碼(免費)。
內容整理自該專案公開的 README 與儲存庫資訊。