Claude 本机清理:先备份,再动手
claude-cleanup 是本站维护的一个开源 skill,管的是 Claude Code 与 Claude Desktop 在本机留下的东西:缓存、日志、用量统计这类可再生的,审计过后清掉;项目、会话和配置一个不碰。支持 macOS 和原生 Windows,要 Python 3.10+,没有第三方依赖。本页是介绍和用法,代码在 GitHub 上,本站不托管脚本文件。
为什么要清
一位用户在 X 上写过一篇被转发很多次的复盘:账号被封多次之后,他把可能的原因一条条拆开,其中一整块是本机残留——Claude Code 和 Claude Desktop 在磁盘上存的缓存、日志、遥测记录、用量统计、本地身份 ID,还有以前的登录态。网络环境换得再干净,这台电脑上的旧文件还躺在原地。
这段是社区经验,权重没人能打包票:Anthropic 从未公布过风控到底看哪些信号、本机文件占多大比例。这套清理的定位是把本地状态收拾干净、顺手做隐私排障,不是防封教程。
安全设计
敢对 ~/.claude 动手,前提是别把项目和会话弄丢。顺序是先备份、再清理:
先完整备份
第一个写操作是完整复制 ~/.claude 并备份 ~/.claude.json,存进 ClaudeBackups 下带时间戳的目录。校验两个平台不一样:macOS 对文件数量和总大小,Windows 逐个文件对 SHA-256。备份没成功,后面一步都不走。
窄白名单
能碰的路径写死在脚本里,白名单之外一律不动;目标一旦和保护路径重叠,立即停下。Windows 版还多一层:路径里有符号链接、junction 这类重解析点,或者目标在 Git 仓库里、本身含 Git 仓库,直接停。
移除不删除
文件移除只进带时间戳的批次目录:macOS 是 ~/.Trash,Windows 是 %USERPROFILE%\ClaudeCleanupTrash(一个普通文件夹,别去系统回收站里找)。不永久删除,也不帮你清空,后悔了能捡回来。钥匙串删除和时区修改不算文件移除,捡不回来,脚本会单独提醒。
先看清单,一次确认
写盘前把完整清单摊开,你在真实终端里输入一次 CONFIRM 才开始,没有跳过确认的参数。正在运行的 Claude Code 里只做审计,正式清理换到独立终端跑。中途任何一步失败就停,停下会如实报告做到哪一步,不装作全清好了。
安装与用法
它是一个给 AI 编程工具用的 skill:一份 SKILL.md 加两个平台的脚本。可以装进你的 skills 目录、让工具按说明执行,也可以自己在终端跑脚本。顺序是下面三步:
1. 拿到代码
git clone https://github.com/hans2759/claude-cleanup.git克隆下来就是一个 claude-cleanup 文件夹:把它放进你的 skills 目录(例如 ~/.claude/skills/),或者直接留在原地、进这个目录用也行。
2. 先跑只读审计
macOS:
cd claude-cleanup
python3 scripts/claude_cleanup.py --auditWindows:
cd claude-cleanup
& .\scripts\claude_cleanup_windows.ps1 -Audit审计只列清单、不动任何文件。PowerShell 执行策略不让跑 .ps1 的话,改跑 Python 入口 py -3 -B -X utf8 .\scripts\claude_cleanup_windows.py --audit,不用改系统策略。正在运行的 Claude Code 里也只跑到这一步——它不能改自己的 ~/.claude。
3. 正式清理换个地方跑
macOS:
python3 scripts/claude_cleanup.pyWindows:
& .\scripts\claude_cleanup_windows.ps1在独立终端里运行,macOS 用普通终端或 Codex 的终端,Windows 用单独开的 PowerShell。脚本先做备份,再摊开完整清单:缓存和日志自动进清单,身份、凭据、登录态这类风险操作逐项问你。看完清单、输入 CONFIRM 才真正写盘。
清理清单
脚本能碰什么、不能碰什么,全在下面三张单子里,按仓库的 SKILL.md 和两个平台的说明文件。
自动安全清理
Claude Code 与 Claude Desktop 都退出后,下列现存目标自动纳入最终清单,不逐项问。都是可再生的缓存、日志、崩溃报告和使用统计。Claude 还在运行时,这类清理会直接跳过;脚本不会替你结束进程。
macOS
~/.claude/cache~/.claude/stats-cache.json~/.claude/telemetry~/.claude/usage-data~/.claude/usage.jsonl~/.claude/usage.with-fix.jsonl~/Library/Caches/claude-cli-nodejs~/Library/Caches/com.anthropic.claudefordesktop*~/Library/Logs/Claude~/Library/Logs/DiagnosticReports/Claude*~/Library/Application Support/CrashReporter/Claude*
Windows
%USERPROFILE%\.claude\cache%USERPROFILE%\.claude\stats-cache.json%USERPROFILE%\.claude\telemetry%USERPROFILE%\.claude\usage-data%USERPROFILE%\.claude\usage.jsonl%USERPROFILE%\.claude\usage.with-fix.jsonl%LOCALAPPDATA%\claude-cli-nodejs
再加 Desktop 数据目录里的 Cache、Code Cache、GPUCache、DawnCache、logs、Crashpad 六项。Desktop 数据目录只认 %APPDATA%\Claude 和已存在的 MSIX 目录(%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude),不碰整个 Packages、不碰安装目录。
绝对保护
写死在保护名单里,绝不删除或移动。两个平台同一份名单,Windows 在 %USERPROFILE%\.claude 下:
~/.claude/projects~/.claude/sessions~/.claude/history.jsonl~/.claude/file-history~/.claude/debug~/.claude/skills~/.claude/plugins~/.claude/hooks~/.claude/commands~/.claude/scripts~/.claude/agents~/.claude/mcp-servers~/.claude/plans~/.claude/tasks~/.claude/todos~/.claude/session-env~/.claude/backups~/.claude/CLAUDE.md~/.claude/settings.json~/.claude/settings.local.json- 以及任何项目目录、Git 仓库和 Codex 的数据
风险操作,逐项选
下面这些不会自动做,每一项单独问你,选了才执行。两个平台不完全一样,分开列。
macOS
- 本地身份轮换:轮换
~/.claude.json里的userID、machineID,清掉已知的账号缓存字段,并同步~/.claude/backups/里的内部备份;你自己存在别处的备份保持原值。仅用于隐私和排障,不宣称能改变平台的关联判断。 - 钥匙串:删除钥匙串里的
Claude Code-credentials会退出 CLI 登录,删完要重新登录。这一项不是移文件,备份里没有它,删了捡不回来。 - Claude Desktop:三档:0 保留;1 只移白名单内的持久数据;2 再移走
/Applications/Claude.app。其中~/Library/Application Support/Claude是整个目录移走,里面的 Desktop MCP 配置和扩展会一起走,选之前先把清单核对清楚。 - 精简模式:在 settings.json 里设置或移除
env.CLAUDE_CODE_SIMPLE。启用后 hooks、skills、plugins、MCP 与 CLAUDE.md 都不自动加载,但这些文件本身不会被删,其他设置字段也不动。 - 台北时区:仅在当前时区不是
Asia/Taipei时才问,用sudo systemsetup修改并验证,密码只在 macOS 原生提示里输入,脚本不读取、不保存。
Windows
- 本地 ID 轮换:改
.claude.json的userID、machineID,清账号缓存字段,同步.claude\backups\里的内部备份;外部备份保留旧值。 - CLI 凭据移走:只隔离
.claude\.credentials.json一个文件。不碰 Windows 凭据管理器、不碰环境变量里的 API key,也不碰远程令牌。 - Desktop 登录态重置:只隔离
Cookies、Local Storage、Session Storage、IndexedDB、WebStorage、Service Worker这批登录态文件;claude_desktop_config.json、MCP 配置和扩展都保留。可能丢未同步的内容,也不保证清掉每个版本的全部登录状态。 - 精简模式:设置
env.CLAUDE_CODE_SIMPLE="1"或只移除这个键,其他设置保持原值。
Windows 版不卸载应用、不改时区,也不处理 WSL 里的数据。
遥测三键原样保留:DISABLE_TELEMETRY、DISABLE_ERROR_REPORTING、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 三个键的值、以及有没有设置过,都保持不变。现在关着就继续关着,开着也不替你关。改遥测状态不算清理。
常问的
清理会删掉我的项目和历史会话吗?
不会。projects、sessions、history.jsonl、file-history、plans、tasks、todos、skills、plugins、CLAUDE.md 和 settings.json 都在保护名单里,项目目录和 Git 仓库也不碰。动手前脚本先把 ~/.claude(Windows 是 %USERPROFILE%\.claude)完整复制一份到 ClaudeBackups 并校验;清掉的文件只移进带时间戳的批次目录——macOS 是 ~/.Trash,Windows 是 %USERPROFILE%\ClaudeCleanupTrash——不永久删除,后悔了还能捡回来。
把本机清理干净就能防封吗?
不能。官方从未公布风控看哪些信号、各占多大权重,本机缓存和日志在里面占多少,没人说得清。这个 skill 的定位就是本机隐私和排障,仓库说明里写明了不用于规避封禁或平台风控。账号状态它查不了;网络环境的问题,去本站的 Claude 环境检测页查。
Windows 能用吗?
能。原生 Windows 10/11 有单独的入口脚本,scripts 里的 claude_cleanup_windows.ps1,也能直接跑同名的 .py 文件。有几处跟 macOS 版不一样:Windows 不卸载应用、不改时区;移走的文件进 ClaudeCleanupTrash 隔离目录,那是个普通文件夹,不是系统回收站;Desktop 只移白名单里的登录态文件,MCP 配置和扩展保留。WSL 和 Linux 还不支持,别拿 macOS 的脚本改改路径硬套到 Windows 上。