它到底是什么

claude project purge 删除某个项目在本地留下的全部 Claude Code 状态。官方 CLI reference 的定义是 "Delete all local Claude Code state for a project"。它是 claude 的 CLI 子命令，在 shell 中运行。

官方文档列出的删除范围：

官方明确不会删除：

• shell-snapshots/：不按项目划分。
• backups/：可能含旧的 .claude.json 快照，最多保留 5 份并自动轮换。

版本：Claude Code 官方 "What's new" 周报（Week 18,2026-04-27 至 05-01）把该命令标注为 v2.1.124。

用法 / 语法

claude project purge [path] [--dry-run] [-y] [-i] [--all]

示例（无 flag、--dry-run、--yes 三种在官方文档中有对应示例，-i 与 --all 的写法是按官方 flag 说明拼出的，并非官方原文）：

# 预览
claude project purge ~/work/repo --dry-run

# 带确认提示地删除
claude project purge ~/work/repo

# 跳过确认(用于脚本)
claude project purge ~/work/repo --yes

# 逐项确认
claude project purge ~/work/repo -i

# 清除所有项目
claude project purge --all

退出码 / 输出格式

其他情况的退出码，以及是否有 --json 之类的结构化输出，官方文档未说明。

确认提示的文案为 Delete X item(s) for <path>? This cannot be undone. [y/N]。

Shell 集成 / 自动化

官方文档给出的脚本化用法是加 --yes 跳过确认：

claude project purge ~/work/my-repo --yes

建议先用 --dry-run 看清列表，再决定是否加 -y 执行。

运行约束 / 限制

经典使用场景

• 想清掉某个项目的历史 transcript、task 列表和 file history 时，先 --dry-run 预览，再执行 claude project purge <path>。
• 交接或退役机器时，用 --all 清除所有项目的本地状态。
• 在脚本里批量清理时，用 -y 跳过确认。

常见坑

• auto memory 也会被删：官方范围写的是 "Transcripts and auto memory",purge 后项目的 memory/ 目录随之消失。
• --all 会清空全局 prompt history:history.jsonl 是被整体删除，不是只移除某个项目的行。
• backups/ 里可能仍有旧的 .claude.json 快照：purge 不处理它们，所以项目 entry 的残留可能存在于备份中。
• 省略 [path] 时的行为以官方为准：官方 CLI reference 写的是"从交互式列表中选择"。第三方文章写成"默认当前目录"，与官方不一致，不要照第三方写法在脚本里省略路径，脚本里请显式传路径。

来源

• CLI reference - Claude Code Docs
• Explore the .claude directory（Clear local data 章节） - Claude Code Docs
• Week 18 · April 27 – May 1, 2026 - Claude Code Docs
• claude project purge: Clean Up Claude Code Project State（第三方博客，仅作交叉参考）
• Claude Code 2.1.126 Project Purge: 3-Min Cleanup | FindSkill.ai
• Claude Code v2.1.126 — project purge, Gateway Model Picker | TurboAI