代理 · Claude Code

Claude Code 在你的 Mac 上留下了什麼。

工作階段日誌、檢查點、暫存工作區、worktree。Devbroom 會把它們全部找出來,並告訴你哪些由 Claude Code 自己刪除、哪些留給你處理、哪些從不碰。

來自一次掃描範例
37.8 GBClaude Code 資料
297個工作階段
98個對應已不存在的資料夾
2個正在執行
它查看什麼

每個資料夾都有自己的規則。

Devbroom 依照 Claude Code 自身的行為方式處理每個位置。代理會自己清理的交給代理;有專屬指令的就用那個指令處理。

逐項評估每一項都會單獨檢查;結果為可清理就能清理。
用 claude purge透過 Claude Code 自己的指令,按住按鈕確認。
Claude Code 會刪除舊的由代理自己清理;Devbroom 只會顯示。
從不碰只顯示,從不刪除。

暫存工作區

工作階段的工作區和暫存檔案。已結束工作階段的這些內容,可以在 Claude Code 自己刪除之前,看過後清理;執行中工作階段的會維持已鎖定。

/private/tmp/claude-<uid>
逐項評估

MCP 和錯誤日誌

只是日誌檔案。

~/Library/Caches/claude-cli-nodejs
逐項評估

工作階段日誌

手動刪除這些檔案會破壞工作階段的接續和記憶。Devbroom 為此使用 Claude Code 自己的指令;資料夾已不存在的專案,其歷史會一次清除。除了刪除,你也可以封存某個專案的對話(Pro):封存驗證通過之前什麼都不會搬移,記憶保留在原處,而且可以從「歷史紀錄」重新開啟。

~/.claude/projects
用 claude purge

檢查點

Claude Code 會自己刪除早於 cleanupPeriodDays(預設 30 天)的檢查點。

~/.claude/file-history
Claude Code 會刪除

日誌和快取

除錯日誌、shell 快照、貼上的內容和圖片。舊的由 Claude Code 自己刪除。

~/.claude/debug~/.claude/shell-snapshots~/.claude/paste-cache~/.claude/image-cache
Claude Code 會刪除

CLI 版本

更新程式會保留目前版本、執行中的版本和最新的兩個版本。

~/.local/share/claude/versions
由更新程式管理

外掛

由 /plugin 管理;使用中的外掛不應刪除。

~/.claude/plugins/cache~/.claude/plugins/marketplaces
從不碰

桌面 App 資料

App 的狀態;其中也包含內建的 CLI 和虛擬機器映像檔。

~/Library/Application Support/Claude
從不碰
受保護

你的帳號和設定原封不動。

這些檔案和資料夾受到保護。任何判定都不會讓它們進入清理範圍;不論多大,它們都留在原處。

帳號和全域狀態~/.claude.json
憑證~/.claude/.credentials.json
設定settings.json · settings.local.json
提示詞歷史~/.claude/history.jsonl
代理記憶~/.claude/agent-memory
已安裝的外掛~/.claude/plugins
Worktree

透過痕跡辨識 Claude Code 的 worktree。

它根據這些痕跡判斷 worktree 是否屬於 Claude Code;痕跡越強,顯示的歸屬就越確定。

  • 確定git 中繼資料中的 CLAUDE_BASE 標記
  • 確定Claude Code 設下的 worktree 鎖
  • 很可能位於 .claude/worktrees 資料夾中
  • 很可能位於 Claude Code 工作區中
  • 可能以 worktree- 開頭的分支名稱
  • 含有未儲存的工作時為已鎖定。 沒有 --force,git 不會移除這樣的 worktree;Devbroom 從不使用 --force。
  • 其中或其上層資料夾有工作階段在執行時為已鎖定。
  • 含有被忽略的檔案時為需查看: git worktree remove 會不經詢問就刪除它們。
執行中的工作階段

看得見它們,執行時不打擾。

Devbroom 知道哪些 Claude Code 工作階段正在執行。它從不碰執行中工作階段的程序;工作階段持續期間,其資料夾和暫存空間會維持已鎖定。

2 個工作階段執行中

Claude Code 暫存空間shop · 工作階段 23f5b61713.2 GB已鎖定:含有在此資料夾中執行的工作階段的資料。
Claude Code 暫存空間shop · 工作階段 ab041197 · 已結束7.3 GB
相容性

先檢查 Claude Code 的檔案。

在信任某個代理的資料之前,Devbroom 會檢查其檔案是否符合預期格式。如果不符合,這些資料只會讀取;其中任何內容都不算可清理。

已測試的版本2.1.0 - 2.1.292

超出此範圍的版本只要格式不變仍可正常使用,並顯示為「尚未測試」。

格式檢查cwd 和 sessionId

~/.claude/projects 中的日誌必須帶有這兩個欄位,它們把工作階段和資料夾連結起來。

你的版本devbroom compat

如果它的資料夾在別處,會依照 CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR 尋找。

讓 Claude Code 去工作吧。Devbroom 負責善後。