自主编排 Claude Code 按计划逐任务执行代码实现与多阶段审查的 CLI 工具
ralphex 是一个基于 Go 构建的独立 CLI 工具，用于自主编排 Claude Code 执行 Markdown 格式的开发计划。它将计划拆解为独立任务，每个任务在全新的 Claude Code 会话中运行以避免上下文退化，执行流程涵盖自动分支创建、任务实现、自动提交、五阶段并行审查（quality / implementation / testing / simplification / documentation）、可选外部审查（默认 OpenAI Codex）、二阶段聚焦审查及计划归档。
支持五种运行模式：完整执行、仅任务、仅审查、仅外部审查、交互式计划创建。提供 Web 仪表盘（SSE + WebSocket）实时监控执行状态，支持多通道通知（Telegram / Email / Slack / Webhook）。通过 --worktree 实现 git worktree 隔离的并行多计划执行，通过 --docker 实现容器化安全隔离。支持 AWS Bedrock 作为 Claude 替代提供商，支持自定义审查 agent（{{agent:name}} 模板系统）。配置体系支持全局（~/.config/ralphex/config）和项目级（.ralphex/config）两级，格式为 INI 和 YAML。运行平台为 macOS 和 Linux，Windows 部分功能受限。
安装方式
- 从源码编译：
go install github.com/umputun/ralphex/cmd/ralphex@latest - Homebrew：
brew install umputun/apps/ralphex - 从 Release 下载预编译二进制文件
- Docker wrapper 脚本
前置依赖：Claude Code（Anthropic CLI，核心依赖，必须预先安装）；可选 OpenAI Codex（外部审查）。
快速开始
- 在
docs/plans/下创建计划文件（Markdown 格式，含 Validation Commands 和 Task 列表） - 运行
ralphex docs/plans/my-feature.md - ralphex 自动完成：创建分支 → 逐任务执行 → 自动提交 → 多阶段审查 → 计划归档至
completed/
核心 CLI 标志
| 标志 | 说明 |
|---|---|
ralphex <plan> | 完整执行模式（默认） |
--tasks-only <plan> | 仅执行任务，跳过审查 |
--review [plan] | 仅审查模式 |
--external-only [plan] | 仅运行外部审查工具 |
--plan "description" | 交互式创建计划 |
--serve | 启动 Web 仪表盘（默认端口 8080） |
--worktree | 在隔离的 git worktree 中执行 |
--docker | Docker wrapper 中运行 |
--claude-provider | Claude 提供商（default / bedrock） |
--effort model[:effort] | 指定模型和 effort 级别 |
--review-patience N | 外部审查僵局检测阈值 |
关键环境变量：RALPHEX_IMAGE（Docker 镜像）、RALPHEX_PORT、RALPHEX_CONFIG_DIR、CLAUDE_CONFIG_DIR、RALPHEX_EXTRA_VOLUMES、RALPHEX_EXTRA_ENV。
架构要点：Go 单二进制 CLI，作为编排层通过子进程调用 Claude Code CLI（--dangerously-skip-permissions 模式）。核心逻辑位于 pkg/，CLI 入口在 cmd/ralphex/。提供 .claude-plugin/ 目录作为 Claude Code 插件（支持斜杠命令如 /ralphex-plan）。E2E 测试使用 Playwright Go。Docker 镜像发布至 ghcr.io/umputun/ralphex-go。
待确认：仓库中存在 site/ 目录可能对应独立文档站但未明确提供 URL；当前版本号需从 Releases 页面获取；go.mod 标注 Go 1.26 待确认准确性。