Ralph CLI Options 完全参考指南Claude Code 自主开发循环的每一个参数与.ralphrc配置模式【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code导读ralph-claude-code是一个面向 Claude Code 的自主 AI 开发循环工具它反复调用 Claude Code CLI在每一次迭代中注入循环上下文、执行工具调用、分析响应、判定任务是否完成并通过熔断器与速率限制防止失控消耗。本文是 docs/CLI_OPTIONS.md 的深度展开版覆盖全部ralph命令行参数、底层实现机制以及.ralphrc配置模式。读完你将掌握每个核心参数如何影响循环行为、--output-format json与text两种退出检测机制的本质差异、如何为本地工作站 / Docker / 离线 / CI 场景编排配置以及如何使用--backup/--rollback构建可回滚的自动化工作流。快速上手ralph --help可查看全部参数摘要。本文对每个参数都给出深度说明、默认值、对应.ralphrc键、示例与源码依据。所有配置的权威源头见 templates/ralphrc.template参数解析实现见 ralph_loop.sh参数解析入口位于ralph_loop.sh第 3032 行起的while循环帮助文本见第 2915 行的show_help()。一、核心标志Core Flags1.1-h, --help—— 查看帮助显示帮助信息并退出。帮助文本由 ralph_loop.sh 的show_help()生成不仅列出全部标志还附带了示例工作流ralph-setup my-project→cd my-project→ralph --monitor与生成的运行产物文件清单。ralph --help1.2-c, --calls NUM—— 每小时 API 调用上限限制每小时最多发起的 Claude API 调用次数用于速率限制rate-limiting。默认值.ralphrc键100MAX_CALLS_PER_HOURralph --calls 50 # 保守策略——慢速、精细的项目 ralph --calls 200 # 激进策略——大批量任务积压从源码看调用计数由ralph_loop.sh的init_call_tracking()按小时重置.ralph/.call_count、.ralph/.last_resetcan_make_call()ralph_loop.sh第 801 行起在每次执行前检查计数是否达到上限达到后由wait_for_reset()第 869 行起显示倒计时并睡眠至整点重置。--calls解析在第 3038 行未做数值校验因此建议用合理正整数。提示项目初始化阶段应把该值调低避免.ralph/PROMPT.md尚未调优时循环失控。1.3-p, --prompt FILE—— 循环驱动提示词文件指定驱动每一轮循环迭代的提示词文件路径。默认值.ralphrc键.ralph/PROMPT.mdPROMPT_FILEralph --prompt .ralph/PROMPT_experimental.mdPROMPT_FILE在ralph_loop.sh第 52 行定义运行时通过build_claude_command()把提示词内容作为-p参数传给 Claude CLI。在--monitor模式下第 545-547 行当提示词路径非默认时会自动把--prompt转发给子进程。1.4-s, --status—— 查看当前循环状态打印.ralph/status.json中的当前循环状态并退出不会启动循环。状态文件由update_status()第 714 行起写入包含时间戳、循环计数、本小时已用调用数/Token 数、上限、最近动作、状态、退出原因、沙箱信息与下次重置时间等字段。实现见第 3046-3054 行存在则cat $STATUS_FILE | jq .美化输出不存在则提示 Ralph 可能未运行。ralph --status1.5-m, --monitor—— 集成 tmux 监控会话启动一个集成的 tmux 会话左窗格运行循环右上窗格用tail -f实时查看 Claude 输出.ralph/live.log右下窗格运行ralph-monitor状态监控面板。需要本机安装tmux。ralph --monitor ralph --monitor --calls 50 --prompt my_prompt.md交互式使用首选。无需另开终端即可实时看到循环进度、熔断器状态与 API 调用数。setup_tmux_session()第 480-658 行的实现细节很值得注意自动检测用户的base-index与pane-base-index先启动 tmux server 再查询避免首次运行时检测失败导致窗格编号错位子进程命令会转发所有非默认的 CLI 参数--calls、--prompt、--output-format、--verbose、--timeout、--allowed-tools、--no-continue、--session-expiry、--auto-reset-circuit、--backup以及 GitHub issue 生命周期、沙箱、同步过滤等参数保证监控模式与普通运行的配置语义一致循环命令以; tmux kill-session串联循环结束后整个 tmux 会话自动销毁避免tail -f与监控面板把会话永久挂住对应 issue #176。1.6-v, --verbose—— 详细进度输出显示执行过程中的详细进度更新同时写入 stdout 与日志文件.ralph/logs/ralph.log。解析为VERBOSE_PROGRESStrue第 3059-3062 行RALPH_VERBOSEtrue环境变量与.ralphrc键效果相同。ralph --verbose ralph --live --verbose # 实时流 详细日志1.7-l, --live—— 实时流式输出将 Claude Code 输出实时流式传输到终端。若此前把--output-format设为text会自动切换为json。ralph --live ralph --live --timeout 30注意Live 模式通过流式管道输出stream-jsonjq过滤输出较为冗长——长时间运行建议用--monitor获得更整洁的视图。从源码看第 1897-1920 行Live 模式把--output-format的值替换为stream-json并追加--verbose --include-partial-messages两个流式必需标志再用jq过滤text_delta、tool_use等事件实时渲染。两个降级保障缺少jq时回退到后台模式第 1883-1886 行text输出格式会被强制覆盖为json第 1828-1831 行。对应测试见 tests/unit/test_cli_modern.bats。1.8-t, --timeout MIN—— 单次调用超时限制单次 Claude Code 调用允许运行的最大分钟数超时以退出码 124 终止。默认值.ralphrc键15CLAUDE_TIMEOUT_MINUTESralph --timeout 5 # 快速任务 / 紧密反馈环 ralph --timeout 60 # 长时间重构 / 大型代码库参数解析第 3067-3075 行限定取值范围为 1 到 120 分钟。超时后的处理逻辑第 2324-2396 行对应 issue #198会检查 git 在超时期间是否有变更有文件变更→ 记为生产性超时productive timeout对已有输出继续运行响应分析循环继续进度文件写入{status: timed_out_productive, ...}无文件变更→ 记为空闲超时idle timeout本轮计为失败迭代。文件变更通过对比循环开始时的git rev-parse HEAD保存在.ralph/.loop_start_sha第 1790-1796 行与当前 HEAD、工作区、暂存区 diff 计算得出。二、熔断器标志Circuit Breaker Flags熔断器是 ralph 防止 token 失控消耗的核心安全机制基于 Michael Nygard《Release It!》的经典模式实现源码见 lib/circuit_breaker.sh。它维护三种状态CLOSED正常检测到进展、HALF_OPEN监控模式试探恢复、OPEN故障执行暂停。状态持久化在.ralph/.circuit_breaker_state状态迁移历史在.ralph/.circuit_breaker_history。2.1--reset-circuit—— 手动复位熔断器将熔断器重置为CLOSED正常状态并退出。在解决触发熔断的根本问题后使用。实现第 3076-3084 行调用reset_circuit_breaker Manual reset via command line该函数把状态文件重置为CLOSED并清零所有连续计数lib/circuit_breaker.sh同时会调用reset_session manual_circuit_reset清理会话。ralph --reset-circuit2.2--circuit-status—— 查看熔断器状态打印当前熔断器状态CLOSED、HALF_OPEN或OPEN并退出。实现调用show_circuit_status()lib/circuit_breaker.sh输出状态、触发原因、距上次进展的循环数、最近进展循环、当前循环与累计打开次数。ralph --circuit-status2.3--auto-reset-circuit—— 启动时自动复位启动时把熔断器直接重置为CLOSED绕过冷却计时器。仅作用于单次运行不持久化。.ralphrc键默认值CB_AUTO_RESETfalseralph --auto-reset-circuit # 一次性复位 运行使用时机完全无人值守的部署CI、cron 任务中不会有真人来执行--reset-circuit。交互式使用请优先--reset-circuit以便先排查触发原因。对应机制在 lib/circuit_breaker.sh启动时若状态为OPEN且CB_AUTO_RESETtrue直接迁移到CLOSED保留total_opens计数否则进入冷却逻辑根据.opened_at与CB_COOLDOWN_MINUTES计算是否可过渡到HALF_OPEN时钟回拨时保持OPEN更安全。参数解析在ralph_loop.sh第 3128-3131 行--monitor模式下会转发给子进程。2.4--reset-session—— 重置会话清除保存的 Claude 会话 ID 并退出强制下一轮循环开启全新对话、不带任何历史上下文。ralph --reset-session会话漂移或 Claude 陷入低效模式时使用。会话状态保存在.ralph/.claude_session_id。实现第 3085-3092 行调用reset_session manual_reset_flag并输出成功提示。会话连续性由init_claude_session()/save_claude_session()配合--continue标志实现过期时间由SESSION_EXPIRY_HOURS控制。2.5--dry-run—— 模拟运行模拟循环执行而不发起真实的 Claude API 调用。Ralph 会运行完整的循环脚手架速率限制检查、退出检测、完整性校验但跳过 Claude 调用且不递增 API 调用计数。默认值环境变量falseDRY_RUNralph --dry-run # 在消耗 API 配额前验证配置 ralph --dry-run --verbose # 观察每一轮循环会做什么适合验证新的.ralphrc或提示词配置也适合做演示。从源码看第 1798-1807 行dry-run 会记录[DRY RUN]日志、打印将要执行的命令与输出格式/超时配置模拟 2 秒执行延迟后返回不经过increment_call_counter()。参数解析在第 3132-3135 行。2.6-n, --notify—— 桌面通知为关键循环事件启用桌面通知循环完成、错误、熔断器跳闸、API 限额、项目完成。跨平台实现macOS 用osascriptLinux 用notify-send都不存在时回退到终端响铃。默认值.ralphrc键falseENABLE_NOTIFICATIONSralph --notify --monitor # 循环需要关注时收到提醒实现见send_notification()第 749-766 行会剥离双引号防止 AppleScript 字符串破坏且所有通知错误都被抑制——通知失败绝不影响循环本身。2.7-b, --backup—— 自动 git 备份在每一轮循环迭代前创建自动 git 备份分支命名为ralph-backup-loop-{N}-{timestamp}。提交使用--allow-empty即使没有暂存变更也保证存在恢复点。要求项目是 git 仓库否则为 no-op。默认值.ralphrc键falseENABLE_BACKUPralph --backup # 每轮循环前快照create_backup()第 1647-1701 行对应 issue #23完整流程先git stash push -u暂存本地变更 →git checkout -b创建分支 →git add -A→git commit --allow-empty→git checkout -返回原分支并git stash pop恢复。每一步失败都会警告并回滚恢复不中断循环。2.8--rollback [BRANCH]—— 回滚到备份回滚到--backup创建的备份分支。不带参数时列出所有ralph-backup-loop-*分支按最新优先排序并退出带分支名时检出该分支。ralph --rollback # 列出可用备份 ralph --rollback ralph-backup-loop-3-1775155286 # 恢复到指定备份实现见rollback_to_backup()第 1710-1742 行列表通过git branch --list ralph-backup-loop-*并按时间戳字段倒序排序恢复前校验分支存在非 git 仓库或分支不存在都会给出明确错误。2.9--show-tool-args—— 显示工具参数在实时流式输出中显示工具参数命令、文件路径、搜索模式。默认关闭避免原始命令和路径被记录到日志。默认值.ralphrc键falseLIVE_SHOW_TOOL_ARGSralph --live --show-tool-args # 完整查看每次工具调用仅与-l, --live配合才有意义。三、现代 CLI 标志Modern CLI FlagsPhase 1.1这一组标志面向新版 Claude CLI提供结构化输出、工具权限白名单与会话续接控制。设计评审可参考 docs/code-review/2026-01-08-phase-1.1-modern-cli-review.md测试覆盖见 tests/unit/test_cli_parsing.bats 与 tests/unit/test_cli_modern.bats。3.1--output-format FORMAT—— 输出格式设置 Claude Code 响应的输出格式。值行为json默认结构化 JSON——启用会话续接、退出信号检测与 Token 计数text遗留纯文本——仅启发式退出检测误报率更高默认值.ralphrc键jsonCLAUDE_OUTPUT_FORMATralph --output-format json # 默认推荐 ralph --output-format text # 遗留回退强烈推荐 JSON 模式。在 text 模式下启发式退出检测要求confidence_score 70且has_completion_signaltrue双重条件以防止文档关键词触发误退出在 JSON 模式下启发式被完全抑制——只有RALPH_STATUS块中显式的EXIT_SIGNAL: true才能触发退出。这一区别直接对应响应分析器的两条代码路径lib/response_analyzer.sh 会从 Claude 响应的.result文本中解析---RALPH_STATUS---/EXIT_SIGNAL: bool块第 263-309 行只有在 JSON 模式下才会尊重 Claude 显式表达的退出意图参数解析校验只接受json或textralph_loop.sh第 3100-3108 行。3.2--allowed-tools TOOLS—— 工具白名单Claude 被允许使用的工具列表逗号分隔。覆盖本次运行的.ralphrc默认值。默认值.ralphrc键见下方ALLOWED_TOOLS默认值Write,Read,Edit,Bash(git add *),Bash(git commit *),Bash(git diff *),Bash(git log *), Bash(git status),Bash(git status *),Bash(git push *),Bash(git pull *),Bash(git fetch *), Bash(git checkout *),Bash(git branch *),Bash(git stash *),Bash(git merge *),Bash(git tag *), Bash(npm *),Bash(pytest)# 审计运行限制为只读 ralph --allowed-tools Read,Grep,Glob # 允许全部 git 命令不太安全——包含 git clean、git rm ralph --allowed-tools Write,Read,Edit,Bash(git *),Bash(npm *)为什么只放行特定 git 子命令默认白名单刻意省略Bash(git *)以防止git clean、git rm、git reset删除.ralph/配置文件。背景见 CLAUDE.md文件保护问题与templates/ralphrc.template中的注释。排查被拒绝的命令。若命令被拒绝但ALLOWED_TOOLS看起来正确运行RALPH_VERBOSEtrue ralph记录传给 Claude 的精确 argv或运行tools/inspect-allowed-tools.sh在不调用 Claude 的情况下检查解析结果。对含管道/重定向的复合命令如mvn clean | tail当基础命令已在白名单中时ralph 会自动把拒绝降级为警告继续执行issue #243更宽泛的Bash(git *)通配符限制问题跟踪于 issue #154。从源码看工具白名单通过--allowedTools参数逐项传给 Claude CLIbuild_claude_command()构造参数数组validate_allowed_tools()用 ralph_loop.sh 中VALID_TOOL_PATTERNS列表校验每个条目非法条目直接报错退出第 1148 行。tools/inspect-allowed-tools.sh 复刻了同样的逗号拆分与去空白解析逻辑并逐项输出printf %q转义后的 argv——若字面*被展开成文件名即说明存在引用 bug。相关测试见 tests/unit/test_inspect_allowed_tools.bats。3.3--no-continue—— 关闭会话续接禁用会话连续性。每一轮循环迭代都从完全全新的 Claude 对话开始不带任何之前迭代的记忆。默认值.ralphrc键会话续接开启SESSION_CONTINUITYtrueralph --no-continue会话上下文积累过多、Claude 基于过时假设做决策时使用。也适合隔离单次迭代做调试。实现CLAUDE_USE_CONTINUEfalse时init_claude_session()不会恢复历史会话 IDClaude 调用不带--continue。load_ralphrc()会把.ralphrc中的SESSION_CONTINUITY映射到内部变量CLAUDE_USE_CONTINUEralph_loop.sh第 304-306 行。3.4--session-expiry HOURS—— 会话过期时间覆盖会话 ID 保留的小时数超过后自动丢弃并开启新会话。默认值.ralphrc键24SESSION_EXPIRY_HOURSralph --session-expiry 48 # 长周期项目上下文稳定 ralph --session-expiry 4 # 短生命周期任务新上下文更佳参数解析要求正整数小时数第 3120-3127 行。会话过期逻辑由 lib/response_analyzer.sh 中的SESSION_EXPIRATION_SECONDS默认 86400 秒 24 小时驱动24 小时默认值在项目连续性与上下文新鲜度之间取得平衡——太短频繁丢上下文太长则陈旧上下文导致不可预测行为。四、常见.ralphrc配置模式.ralphrc文件位于项目根目录在每一轮循环前被 source加载函数见 ralph_loop.sh 的load_ralphrc()。环境变量永远优先于.ralphrc值。完整的可参考模板在 templates/ralphrc.template。4.1 本地工作站默认MAX_CALLS_PER_HOUR100 CLAUDE_TIMEOUT_MINUTES15 CLAUDE_OUTPUT_FORMATjson CLAUDE_AUTO_UPDATEtrue SESSION_CONTINUITYtrue SESSION_EXPIRY_HOURS244.2 Docker 容器# 版本在构建镜像时固定——跳过 npm registry 检查 CLAUDE_AUTO_UPDATEfalse # 容器是临时的——持久化会话没有意义 SESSION_CONTINUITYfalse # 更紧的超时保证 CI 运行时长可预测 CLAUDE_TIMEOUT_MINUTES104.3 离线 / 隔离网络环境air-gapped# npm registry 不可达——防止超时与警告刷屏 CLAUDE_AUTO_UPDATEfalse # 使用本机特定 Claude CLI 路径不在 PATH 中时 CLAUDE_CODE_CMD/opt/local/bin/claude4.4 无人值守 / cron 运行# 降低调用速率避免夜间失控消费 MAX_CALLS_PER_HOUR50 # 每小时 Token 预算0 禁用。预算耗尽后阻塞调用。 # 与调用计数器一起在整点重置。 MAX_TOKENS_PER_HOUR50000 # 批量任务用更长的超时 CLAUDE_TIMEOUT_MINUTES30 # 无需人工干预即可从熔断器自动恢复 CB_AUTO_RESETfalse # false 使用冷却更安全 CB_COOLDOWN_MINUTES30 # OPEN 后等待 30 分钟再重试MAX_TOKENS_PER_HOUR的实现要点Token 计数通过extract_token_usage()第 771-785 行从 Claude 输出 JSON 的usage/metadata.usage字段提取输入输出总和update_token_count()累加到.ralph/.token_countcan_make_call()第 801-821 行在调用数与 Token 数任一达到上限时拒绝新调用wait_for_reset()会同时显示两类限制信息。4.5 熔断器调优# 连续 N 轮无文件变更即打开熔断默认3 CB_NO_PROGRESS_THRESHOLD3 # 连续 N 轮重复相同错误即打开熔断默认5 CB_SAME_ERROR_THRESHOLD5 # 输出大小下降超过 N% 即打开熔断默认70 CB_OUTPUT_DECLINE_THRESHOLD70 # 在 OPEN 状态等待多少分钟后过渡到 HALF_OPEN默认30 # 设为 0 可立即重试 CB_COOLDOWN_MINUTES30 # 启动时跳过冷却、直接重置为 CLOSED默认false # 谨慎使用——降低无人值守运行的熔断器安全性 CB_AUTO_RESETfalse这些阈值全部在 lib/circuit_breaker.sh 顶部定义并支持环境变量覆盖。record_loop_result()第 151-336 行是状态机的核心根据 git 文件变更、Claude 完成信号、Claude 报告的已修改文件数、是否在提问等综合判断进展还有额外机制——连续CB_PERMISSION_DENIAL_THRESHOLD默认 2轮权限拒绝也会打开熔断issue #101连续 2 轮无进展先进入HALF_OPEN监控。测试见 tests/unit/test_circuit_breaker_recovery.bats。4.6 限制工具权限# 宽松开发允许全部 git 子命令 ALLOWED_TOOLSWrite,Read,Edit,Bash(git *),Bash(npm *),Bash(pytest) # 安全默认仅放行特定 git 子命令无破坏性 git 命令 ALLOWED_TOOLSWrite,Read,Edit,Bash(git add *),Bash(git commit *),Bash(git diff *),Bash(git log *),Bash(git status),Bash(git push *),Bash(npm *),Bash(pytest) # 只读审计 ALLOWED_TOOLSRead,Grep,Glob4.7 模型与努力程度覆盖# 使用特定 Claude 模型而非 CLI 默认 CLAUDE_MODELclaude-sonnet-4-6 # 设置努力程度high 更彻底low 更快/更便宜 CLAUDE_EFFORThigh两者也可用环境变量设置环境变量优先于.ralphrcCLAUDE_MODELclaude-opus-4-6 ralph --monitor从源码看ralph_loop.sh第 114-115 行CLAUDE_MODEL/CLAUDE_EFFORT默认为空即使用 CLI 默认非空时才作为--model/--effort追加到 Claude 调用参数中。--monitor模式不会转发这两个值因此以环境变量形式传给ralph --monitor时需确认子进程能继承环境变量在setup_tmux_session()执行前已捕获子 shell 可继承。4.8 自定义 shell 初始化# 每轮循环前 source 一个脚本例如激活 virtualenv 或设置 PATH RALPH_SHELL_INIT_FILE.ralph/init.sh若文件设置了但不存在Ralph 会给出警告并跳过 source存在则每轮调用 Claude 前先 source可用于激活 Python 虚拟环境、加载密钥、切换 PATH 等。五、.ralphrc专属键无 CLI 等价物以下键没有对应的 CLI 标志——只能在.ralphrc或环境变量中设置。键默认值说明CLAUDE_CODE_CMDclaudeClaude Code CLI 命令。非全局安装时覆盖如npx anthropic-ai/claude-code。CLAUDE_AUTO_UPDATEtrue启动时自动检查 npm registry 并更新 Claude CLI。Docker / 离线环境设false。CLAUDE_MIN_VERSION2.0.76最低要求的 Claude CLI 版本。安装版本过旧时 Ralph 警告并退出。MAX_TOKENS_PER_HOUR0每小时 Token 预算input output。0 禁用。耗尽后阻塞后续调用与调用计数一起在整点重置。RALPH_VERBOSEfalse启用详细进度日志。等价于--verbose。CB_NO_PROGRESS_THRESHOLD3连续 N 轮无文件变更即打开熔断器。CB_SAME_ERROR_THRESHOLD5连续 N 轮出现相同错误即打开熔断器。CB_OUTPUT_DECLINE_THRESHOLD70输出大小下降超过 N% 即打开熔断器。CB_COOLDOWN_MINUTES30OPEN 状态下等待多少分钟再过渡到 HALF_OPEN 尝试恢复。CB_AUTO_RESETfalse启动时跳过冷却、直接重置为 CLOSED。降低安全性仅建议完全无人值守的 CI 运行使用。PROJECT_NAMEmy-project提示词与日志输出中的项目标识。PROJECT_TYPEunknown项目类型提示javascript、typescript、python、rust、go、unknown。CLAUDE_AUTO_UPDATE的实现要点为true时启动会检查 npm registry 并尝试npm update -gDocker 镜像构建时版本已固定、容器是临时的因此模板注释明确建议容器设falsetemplates/ralphrc.template。CLAUDE_CODE_CMD的校验在validate_claude_command()ralph_loop.sh第 374-423 行npx 形式会先验证 npx 存在直接命令形式用command -v检查未找到时给出完整安装指引全局安装或CLAUDE_CODE_CMDnpx anthropic-ai/claude-code。六、环境变量优先级环境变量 ← 最高优先级 ↓ .ralphrc 值 ↓ Ralph 默认值 ← 最低优先级所有.ralphrc键都可以用同名环境变量设置MAX_CALLS_PER_HOUR200 ralph --monitor # 仅本次运行覆盖该优先级由load_ralphrc()ralph_loop.sh第 291-366 行精细实现脚本在设置任何默认值之前就把_env_*环境变量快照下来第 67-97 行source.ralphrc后再把快照回写覆盖——这样用户显式设置的环境变量 .ralphrc 脚本默认值的优先级在任何场景下都成立包括--monitor模式下子进程的配置转发。七、延伸.ralphrc中值得了解的更多键除了本文档重点讲解的 CLI 相关键templates/ralphrc.template 还包含面向任务源、GitHub issue 生命周期与沙箱执行的配置它们同样遵循环境变量 .ralphrc 默认值的优先级规则且有对应 CLI 标志完整清单见ralph --help的 Batch processing 与 Sandbox execution 两节ralph_loop.sh第 2943-2993 行任务源TASK_SOURCESlocal可选beads、github、GITHUB_TASK_LABELralph-task、BEADS_FILTERstatus:open对应任务导入功能详见 lib/task_sources.sh 与 docs/QUEUE_MANAGEMENT.mdDocker 沙箱SANDBOX_PROVIDERdocker、SANDBOX_DOCKER_IMAGEralph-sandbox:latest、SANDBOX_DOCKER_MEMORY4g、SANDBOX_DOCKER_CPUS2、SANDBOX_DOCKER_NETWORKbridgenone会阻断 Claude API详见 docs/DOCKER_SANDBOX.mdE2B 云沙箱SANDBOX_E2B_TEMPLATEbase、SANDBOX_E2B_TIMEOUT3600、SANDBOX_E2B_KEEP_ALIVE、SANDBOX_E2B_MAX_COST等成本护栏详见 docs/E2B_SANDBOX.md文件同步过滤SYNC_INCLUDE/SYNC_EXCLUDE/SYNC_MAX_FILE_SIZE10485760/SYNC_LARGE_FILE_ACTIONwarn仅适用于 E2B 沙箱Docker 的 bind mount 实时共享整个项目详见 docs/SANDBOX_SYNC.md。结语ralph的命令行与.ralphrc配置共同构成了一个高度可编排的自主开发循环控制面核心标志--calls、--timeout、--prompt决定循环的节奏与边界熔断器标志--reset-circuit、--auto-reset-circuit、--dry-run决定故障恢复策略现代 CLI 标志--output-format、--allowed-tools、--no-continue、--session-expiry决定与 Claude CLI 的交互深度而.ralphrc模式则针对本地、Docker、离线与 CI 四种典型场景给出开箱即用的配置组合。牢记环境变量 .ralphrc 默认值的优先级配合--dry-run在消耗 API 配额前验证配置你就能让 Ralph 在可控成本与安全边界内持续、稳定地推进项目。【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
