GPT-6 Astra 已上线:了解使用入口、Plus / Pro 套餐与额度。查看 GPT-6 指南

Claude 本机清理:先备份,再动手

claude-cleanup 是本站维护的一个开源 skill,管的是 Claude Code 与 Claude Desktop 在本机留下的东西:缓存、日志、用量统计这类可再生的,审计过后清掉;项目、会话和配置一个不碰。支持 macOS 和原生 Windows,要 Python 3.10+,没有第三方依赖。本页是介绍和用法,代码在 GitHub 上,本站不托管脚本文件。

在 GitHub 查看 claude-cleanup →本站维护的开源 skillmacOS 与原生 WindowsPython 3.10+

为什么要清

一位用户在 X 上写过一篇被转发很多次的复盘:账号被封多次之后,他把可能的原因一条条拆开,其中一整块是本机残留——Claude Code 和 Claude Desktop 在磁盘上存的缓存、日志、遥测记录、用量统计、本地身份 ID,还有以前的登录态。网络环境换得再干净,这台电脑上的旧文件还躺在原地。

这段是社区经验,权重没人能打包票:Anthropic 从未公布过风控到底看哪些信号、本机文件占多大比例。这套清理的定位是把本地状态收拾干净、顺手做隐私排障,不是防封教程。

它不用于规避封禁或平台风控,仓库说明里就是这么定的。清理不承诺防封,也查不了你的账号状态;想查网络环境,去 Claude 环境检测 页。

安全设计

敢对 ~/.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 --audit

Windows:

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.py

Windows:

& .\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 上。

claude-cleanup 是本站(hans2759)在 GitHub 上维护的开源 skill,本页的查看与克隆链接都指向该仓库;本站只作介绍、不托管脚本,清单内容依据仓库内的 SKILL.md 与 references 说明(核对于 2026-11-11),与 Anthropic 无隶属关系。它不用于规避封禁或平台风控,清理也不承诺防封。网络环境自查在 /claude-check,Claude 订阅与直充看 /claude。