如何安全卸载 Ralph for Claude Code：6 步自查式清理指南（新手可照做）
【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code
Ralph for Claude Code 是一个让 Claude Code 自主循环开发项目、并带智能退出检测的开源 CLI 工具。当你不再需要这个自主开发循环、或者环境里残留了旧版本时，可以按本文完成 Ralph 卸载：先判断影响范围，再备份、停止进程，最后分级清理并验证。
一、先判断：什么情况需要移除 Ralph
删除前先问自己三个问题，确认影响范围，避免误删还在用的东西：
- 命令还能用吗：运行
command -v ralph，有输出说明还装在全局命令目录里。 - 还有没有在跑的循环吗：Ralph 的循环通常在 tmux 会话里运行，
tmux ls查看是否存在ralph-开头的会话。 - 有没有脚本依赖它：如果你有 CI 或定时任务里调用了
ralph、ralph-monitor等命令，先暂停这些脚本，否则删除后它们会持续报错。
只满足"想换版本"的情况时，直接重装覆盖通常比卸载更省事；确认彻底不用了，再往下走。
二、动手前的 3 项准备
1. 备份要保留的数据
~/.ralph/：全局配置、模板、脚本库。如果你使用过 E2B 云沙箱，里面的~/.ralph/e2b_api_key是 API 密钥文件，丢了需要重新申请，建议单独备份。- 各项目根目录下的
.ralph/（包含PROMPT.md、.ralphrc、logs/ralph.log、metrics.jsonl等）：卸载脚本不会动它们，是否保留由你决定，想留就整目录拷走。
# 示例：把全局目录备份到别处（路径请确认后再执行） cp -a ~/.ralph ~/backup-ralph-$(date +%F)2. 停止正在运行的进程
tmux ls # 找到 ralph- 开头的会话 tmux kill-session -t ralph-1700000000 # 确认后逐个结束 ps aux | grep -i ralph | grep -v grep # 确认没有其他残留进程3. 暂停会写文件的任务
确认没有 CI 流水线、cron 定时任务在调用 Ralph 命令：
crontab -l | grep -i ralph # 应无输出三、第 1 步：用官方卸载命令做轻量移除
仓库提供了卸载脚本（见 uninstall.sh），它会先打印"将删除什么"的计划，确认后才动手。进入你 clone 下来的代码目录执行：
./uninstall.sh # 交互式，会先展示移除计划 # 或跳过确认（确认过计划之后再用） ./uninstall.sh --yes另外 install.sh 也支持./install.sh uninstall作为备用入口。脚本会清理两类东西：
~/.local/bin/下的命令：ralph、ralph-monitor、ralph-setup、ralph-import、ralph-migrate、ralph-enable、ralph-enable-ci、ralph-stats、ralph-queue- 全局目录
~/.ralph/
注意：脚本明确不会删除你用ralph-setup创建的项目目录，项目代码和数据是安全的。
验证入口是否移除
command -v ralph # 应提示找不到命令 ls ~/.local/bin | grep ralph # 应无输出四、第 2 步：深度清理配置、缓存与沙箱
如果自动卸载没跑完、或者代码目录已被删，手动按"从低风险到高风险"的顺序检查并清理：
1. 命令入口（低风险）
ls ~/.local/bin | grep ralph # 先确认列出的确实是 Ralph 的命令确认无误后再删除，例如：
rm -f ~/.local/bin/ralph ~/.local/bin/ralph-monitor ~/.local/bin/ralph-setup ~/.local/bin/ralph-import2. 全局目录（高风险，确认备份过再删）
ls -la ~/.ralph # 先看看里面有什么，确认 e2b_api_key 等已备份确认备份完成后：
rm -rf ~/.ralph3. 沙箱镜像（可选）
如果你用ralph --sandbox docker构建过沙箱镜像，卸载不会自动移除它：
docker images | grep ralph-sandbox # 先确认 docker rmi ralph-sandbox # 确认后执行4. 环境变量与 PATH
- 打开你的 shell 配置（
~/.bashrc、~/.zshrc等），搜索ralph和~/.local/bin：
grep -n -i "ralph\|\.local/bin" ~/.bashrc ~/.zshrc 2>/dev/null- 如果
~/.local/bin是安装 Ralph 时加的、且没有其他工具依赖，可以注释掉对应行；如果别的工具也用这个目录，保留即可，它本身无害。 - 如果设置过
E2B_API_KEY、CLAUDE_CODE_CMD等 Ralph 相关变量，一并删除或注释。 - 修改后执行
source ~/.bashrc（或对应文件）使其生效。
echo $PATH | tr ':' '\n' | grep -i ralph # 应无输出五、第 3 步：残留检查清单
如果你不确定是否还有残留，先只跑这些只读检查命令，全部确认无输出（或无匹配）才算干净：
| 检查对象 | 命令 | 期望结果 |
|---|---|---|
| 残留文件 | find ~ -maxdepth 2 -name "*ralph*" 2>/dev/null | 仅剩你有意保留的目录 |
| 运行进程 | ps aux \| grep -i ralph \| grep -v grep | 无输出 |
| tmux 会话 | tmux ls 2>/dev/null \| grep ralph | 无输出 |
| 定时任务 | crontab -l 2>/dev/null \| grep -i ralph | 无输出 |
| 命令入口 | command -v ralph ralph-monitor ralph-stats | 全部找不到 |
补充两点：
- 各项目目录里的
.ralph/和.ralphrc属于你的项目文件，卸载不会碰它们。想彻底移除某个项目的 Ralph 痕迹，先cp -a .ralph .ralph.bak备份，再rm -rf .ralph .ralphrc。 - 缓存目录
~/.cache/ralph一般不存在，若存在且确认是旧缓存，备份后可删除。
六、删除后怎么验证
全部操作完成后，用下面这张表做最终验收：
| 项目 | 验证命令 | 通过标准 |
|---|---|---|
| 命令 | ralph --help | 提示命令不存在 |
| 全局目录 | ls -d ~/.ralph 2>&1 | 提示目录不存在 |
| PATH | echo $PATH | 不含 Ralph 相关路径 |
| 进程与会话 | ps aux \| grep -i ralph \| grep -v grep和tmux ls | 无 ralph 进程/会话 |
| 文件残留 | find ~ -maxdepth 2 -name "*ralph*" | 只剩你保留的项目文件 |
5 项全部通过，说明本次 Ralph 卸载已完成。
七、以后还要用？重装与验证
万一之后又需要自主开发循环，从源码恢复即可（仓库地址见项目页面，克隆命令示例）：
git clone https://gitcode.com/GitHub_Trending/ra/ralph-claude-code cd ralph-claude-code ./install.sh装好后按顺序验证：
ralph --help能正常打印选项；- 把之前备份的
~/.ralph（含e2b_api_key等）拷回原位置； - 把备份的项目级
.ralph/目录放回对应项目根目录，运行一次ralph --dry-run（干跑模式，不真正调用 API）确认循环可以正常启动。
更多命令细节可参考仓库内的 README.md 和 CLI_OPTIONS.md。
写在最后
- 删除类命令一律"先
ls/grep确认目标，再执行"，路径看清了再回车。 - 不要对卸载操作使用
sudo，它只应作用于你自己的用户目录。 - 项目代码和
.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），仅供参考
