如何清理 Mac 上 AI 程式開發工具留下的檔案
一顆撐了兩年都很寬裕的磁碟,天天用編碼 agent 之後,幾個月就滿了。agent 本身很小,變的是這台機器編譯的頻率、CLI 在磁碟上把自己換掉的頻率,以及你自己的思考過程有多少已經以文字形式住在家目錄裡。增長幾乎全落在三類上,而這三類要下三種不同的決定,因為它們拿回來的代價差得非常遠。
模型權重是最明顯的嫌疑犯,對這個問題通常也是抓錯人。Ollama、LM Studio 和 Hugging Face 用的是內容定址的儲存區,只有它們自己的工具才修剪得安全,那件事單獨寫在清掉 AI 工具的殘留。這篇談的是你在工作的時候,AI 編碼 agent 一路留下的東西。
動手刪之前先量
兩條指令回答得了大半。第一條把各個 agent 的家目錄加總起來:
du -sh ~/.codex ~/.claude ~/.local/share/claude ~/.grok ~/.cache 2>/dev/null | sort -h
第二條把建置產物找出來,它們散在你開過的每個專案裡。把裡面的根目錄換成你放程式碼的地方:
find ~/www ~/Projects -maxdepth 3 -type d \
\( -name target -o -name node_modules -o -name .next -o -name dist -o -name build \) \
-prune -exec du -sh {} + 2>/dev/null | sort -h | tail -20
-prune 讓 find 不再往已經命中的資料夾裡鑽,這一點很關鍵:少了它,find 會把一個 24 GB 的 target/ 裡每個檔案都走一遍才往下走。寫這篇時我量的那台 Mac,前兩行是一個 24 GB 的 Rust target/ 和一個 Tauri 專案 9.8 GB 的 target/,而 node_modules 那幾棵從 134 MB 到 1.5 GB。這次測量中,兩個 Rust 建置目錄都比列出的單個相依套件目錄大。
比起清單更想看圖的話,Mole 的分析頁會將磁碟區畫成方塊圖,讓你點進最大的區塊查看,不必猜該把哪個根目錄傳給 find。
第一類:被放大的建置產物
這一類不新,新的是量。人手動寫程式,一天編譯幾次。agent 在做一個任務時,幾乎每改一次就編譯一次,跑測試,換第二種做法,再編譯一次。原本幾個月才長起來的快取,現在一個下午就長出來了,而增量建置的資料夾,設計上就是拿磁碟換速度。
Rust 通常大得遙遙領先。一個 target/ 資料夾裝著編譯好的相依套件、增量編譯狀態和建置腳本的輸出,還按 profile 分開存,所以 debug 和 release 是兩份完整的複本。不帶參數的 cargo clean「會刪掉整個 target 資料夾」。先預覽一次:
cargo clean --dry-run
cargo clean --release
cargo clean -p <package> 只清點名的那幾個套件,問題出在 workspace 裡某一個成員時,用的就是它。
JavaScript 的產物攤得比較薄。除了 node_modules 本身,還有打包器和轉譯器在用的 node_modules/.cache、Next.js 建置的 .next,以及工具鏈寫出來的 dist 或 build。專門把那些快取找出來:
find ~/www -maxdepth 4 -type d -path '*/node_modules/.cache' -prune -exec du -sh {} + \
2>/dev/null | sort -h | tail
Python 在它匯入的每個套件旁邊留一個 __pycache__。單個很小,但數以千計。先數再刪,因為同樣一條指令後面接上 rm -rf,一旦根目錄寫錯就沒有回頭路:
find ~/www -type d -name __pycache__ -prune -print | wc -l
原始碼仍在時,位元組碼快取會在下次匯入時重新產生,不需要連網。先停止相關工作,再確認資料夾內確實只有快取。
Go 用的是一份全域建置快取,不是每個專案一個資料夾。go env GOCACHE 印出它的位置,go clean -cache「會讓 clean 移除整份 go 建置快取」。go clean -testcache 讓快取的測試結果過期,但不丟掉編譯好的套件。我這台機器上建置快取是 183 MB,模組快取只有 38 MB,所以就算下載的模組不大,建置這一側還是值得看一眼。
Xcode 要另外處理,因為 DerivedData、封存檔、裝置支援檔和模擬器執行環境是四種東西,還原代價各不相同。這台 Mac 上的 DerivedData 資料夾量到 9.3 GB。清理 Xcode 佔用的空間講哪些可以刪、哪些要留著做符號還原。Gradle 和 Maven 也是同樣的分法,一邊是每個專案的 build/ 資料夾,一邊是 ~/.gradle 或 ~/.m2 底下的全域儲存區,全域那一側歸到清開發快取跟其他套件庫放在一起。
第二類:被取代的舊版 CLI
這一類幾乎沒有人會去找,而在同時跑好幾個 agent 的機器上,它常常比所有快取加起來還大。
agent CLI 自我更新的方式,是下載一整份帶版本號的新發行版,再把啟動器指過去。每份發行版都是自足的,和前一份不共用任何檔案。指標移過去了,舊的那份留在原地,這次檢查的安裝中,被取代的舊版本仍留在磁碟上。
它們的擺法是同一套,差別只在表面:
- Codex 放在
~/.codex/packages/standalone/releases/<version>-<arch>/,上一層有一個current符號連結指著正在用的那份。 - Claude Code 放在
~/.local/share/claude/versions/<version>,每一項是單一個可執行檔而不是資料夾,~/.local/bin/claude是指向正在用的那個的符號連結。 - Grok 以檔案形式放在
~/.grok/downloads/grok-<version>-macos-<arch>,~/.grok/bin/grok和~/.grok/bin/agent指向目前這一版。 - Cursor Agent 放在
~/.local/share/cursor-agent/versions/<date>-<sha>/,啟動器是~/.local/bin/cursor-agent。 - Cursor 桌面版自己還帶一份 cursor-agent,放在
~/Library/Application Support/Cursor/User/globalStorage/anysphere.cursor-agent-worker/agent-cli/.local/share/cursor-agent/versions/,同一個.local底下的bin/cursor-agent指向正在用的那份,後來量的那台 Mac 上它累積了 7 個版本,共 4.1 GB。 - GitHub Copilot CLI 透過 npm 安裝時是就地替換,但它的安裝腳本會在一個前綴底下寫一份帶版本號的套件,非 root 使用者預設是
$HOME/.local。Mole 會去~/.copilot/pkg/universal檢查同一種擺法。
一次全部量完:
du -sh ~/.codex/packages/standalone/releases/* \
~/.local/share/claude/versions/* \
~/.grok/downloads/* \
~/.local/share/cursor-agent/versions/* 2>/dev/null
寫這篇時我用的那台 Mac 印出來的是:五份 Codex 發行版,262 MB 到 310 MB;五個 Claude Code 執行檔,293 MB 到 306 MB;兩份 Grok 建置版;兩個 Cursor Agent 版本。合計約 3.5 GB,其中正在用的大約 920 MB,其餘全是已經被換掉的執行檔。Codex 自己的問題追蹤裡有一則還開著的請求,回報者量到的增長大約是每次更新 250 MB,詳見問題回報 openai/codex#22293。
刪掉任何一個資料夾之前,先把啟動器解出來
誘人的捷徑是按日期排序、留最新的那份。別這樣做。兩種很平常的情況會讓這招失效:遇到回歸之後你刻意鎖了一個舊版本,或者一次更新已經把新資料夾放好、指標還沒翻過去。把正在用的那份刪掉,啟動器就指向空無一物。
改成問啟動器。它是一個符號連結,把它解開:
readlink -f "$(command -v codex)"
readlink -f "$(command -v claude)"
readlink -f "$(command -v grok)"
印出來的是真正的目標,比如 ~/.codex/packages/standalone/releases/0.147.0-aarch64-apple-darwin/bin/codex,而 ls -l "$(command -v codex)" 顯示的是連結指向,不一定是最終目標。這只能確認目前啟動器指向哪個版本,不能證明其他同層資料夾都已閒置,還要檢查是否有其他程序正在使用,或更新尚未完成。確認不用的版本再移至垃圾桶,不確定就保留。移走後先確認 CLI 能正常執行,不急著清空垃圾桶。
第三類:agent 的工作狀態,不是垃圾
第三類是清理工具真的會造成傷害的地方,因為它看起來跟前兩類一模一樣。
工作階段的對話紀錄、記憶、計畫和產生的附件,住在 ~/.codex/sessions、~/.codex/archived_sessions、~/.codex/memories、~/.claude/projects 和 ~/.grok/sessions。它們是以工作階段 id 命名的 JSONL 檔,帶時間戳,只追加不修改,而且一直長。通用清理工具用的每一條啟發式規則都會說:這是日誌檔。我量的那台 Mac 上,~/.codex/sessions 是 9.8 GB,~/.claude/projects 是 2.7 GB、共 2362 個對話紀錄檔,~/.grok/sessions 是 1.3 GB,一個很大、很誘人的數字,掛在一堆看起來可以丟的檔案上。
它們不是日誌。一份對話紀錄記的是一個改動怎麼被想出來的:試過又被否決的做法、把某條路排除掉的那個限制、最後為什麼定成這樣。那些推理過程別的地方都沒有。commit message 記的是改了什麼,程式碼記的是活下來的那個選項,不是被丟掉的另外四個。它們安安靜靜累積好幾個月,而你第一次回頭問「這東西當初為什麼要這樣做」的時候,就會知道它的價值。
更大的風險其實不是第三方清理工具。Claude Code 自己就帶了一輪保留期清理:cleanupPeriodDays 預設 30 天,啟動時會刪掉 projects/ 底下超過這個天數的對話紀錄、計畫檔、file-history/ 裡編輯前的快照,以及每個工作階段的任務清單。它的 .claude 資料夾說明寫清楚了哪些路徑會被掃、哪些永久保留。你想留一年的紀錄,現在就把那個數字調大,不要事後才發現預設值是多少。同一頁也寫了反過來要用的 claude project purge,確實想把某個專案的狀態徹底清掉時用它。
Mole 的「清理」一概不碰。上面那五條路徑,加上 ~/.claude/file-history、~/.claude/plans、~/.claude/tasks、~/.codex/attachments 和 ~/.codex/generated_images,放多久都在它的保護清單上。沒有年齡門檻,沒有「超過 90 天」的例外,也沒有哪個開關能把它打開。這幾條路徑的年齡例外做過一次,當天就被撤掉了,因為舊的對話紀錄不等於過期的對話紀錄。
舊工作階段另有一條要你親手走的路。清理頁遠處的月亮通往 AI 清理與維護,那裡每個工具各自設定保留期,列出超過保留期的 Codex 和 Claude Code 工作階段,以及專案資料夾已經不在的 Claude Code 工作階段,每一筆都帶標題和時間,你勾選之前一筆都不會動。Codex 的工作階段會先複製一份到垃圾桶,再交給 Codex 自己的指令刪除,它的索引不會亂,Codex 為這個工作階段產生的圖片和筆記也會一起移到垃圾桶。24 小時內用過的工作階段不會出現在清單裡,所以 Codex 和 Claude Code 開著的時候也能清,記憶、計畫和技能檔案在那裡也不在任何清單上。
一條判準:按還原代價排序,不按大小
這條規則讓三類都變得可判斷。每個候選都按「拿回來要花多少」排,不按它顯示幾 GB 排。
本機可重新產生。 建置產物、增量編譯狀態、位元組碼快取、DerivedData。原始碼、相依套件與工具鏈齊全時,通常能在本機重新產生,主要代價是重新建置的時間。先停止建置、測試與開發伺服器,確認沒有混入需要保留的輸出,再清理。
重建代價高。 套件庫、node_modules、CocoaPods、Python 虛擬環境、vendor 資料夾、模型權重、iOS DeviceSupport。每一項都需要網路,需要套件庫到今天還供得出 lockfile 指名的那些版本,有時候還需要一套原生工具鏈。真正的代價不是網路好的時候那幾分鐘,而是你在火車上還能不能工作。這些要一項一項審。
不可替代。 對話紀錄、agent 的記憶、計畫檔、專案狀態、本機微調過的模型。再多 CPU 和頻寬都換不回來。它們永遠不該進批次刪除,也不該出現在你有機會勾錯的地方。
麻煩的是第一層和第二層長得一模一樣。target/ 和 node_modules/ 都是專案根目錄下的大資料夾,都塞滿相依套件的產物,都寫在 .gitignore 裡,也都是一行指令就能重新生成。按大小排序,它們就挨在一起。但 cargo build 需要原始碼、相依套件與工具鏈可用,npm ci 還可能需要從套件庫下載,並成功解析 lockfile。兩者耗時都取決於專案,相依套件無法取得時也都可能中斷。把兩者混為一談是這一類裡最常見的錯誤,也是為什麼「刪最大的資料夾」即使釋放最多空間,仍然是壞建議。
在 Mole 裡做這件事
手動路線走得通,也不花錢。Mole 多做的一件事,是把三類東西收進同一份先審再清的清單,分層的界線已經套好,哪個點開頭的資料夾裝著對話紀錄,不必由你記。
打開清理頁執行掃描,掃描免費,也不需要購買授權。候選項目會列出路徑、所屬應用程式與量出的大小,確認清單前不會刪除。需要複查的項目預設不勾選,快取預設永久刪除,也可在設定中改為移至垃圾桶,檔案仍在垃圾桶中時可還原。批次操作也會列出略過與失敗的項目。
舊版 CLI 這一項,上面那段啟動器解析是 Mole 幫你做的。它讀每個 agent CLI 的啟動器符號連結,解析到正在用的那份發行版,再把那一份排除在候選之外,所以刻意的降級會原封不動留著,不會被當成舊版本。這個行為是照著 Codex 量出來的情況做的:五份發行版共 1.2 GB,只有一份在用。Cursor 桌面版自己那份也照同樣的方式處理,Cursor 開著的時候,只要沒有程序正在用某個舊版本,它一樣能清。
Mole CLI 免費、開源,可用 mo clean 在終端機清理;清理、解除安裝與最佳化指令支援 --dry-run,執行前可以先看候選清單。兩邊共用 ~/.config/mole/whitelist 這份使用者保護清單,並使用 ~/Library/Logs/mole/operations.log 記錄操作,全部在本機執行,不上傳,也不回傳遙測。
邊界講白了:Mole 不是備份,不處理惡意軟體,遇到帶驅動程式或系統延伸功能的軟體也取代不了原廠的解除安裝程式。它自己從不刪模型檔案,一般清理也從不碰 AI 對話紀錄,舊工作階段和一個月沒用的 Ollama 模型只在 AI 清理與維護裡由你一筆一筆勾選,模型交給 Ollama 自己的指令刪除,其他模型留給擁有它們的工具。
讓它不要再長回來
三個設定改一下,大部分東西就不會再長回來。
讓 Rust 全部寫進同一個建置資料夾。 CARGO_TARGET_DIR 設定的是「所有產生的產物放在哪裡」,這樣每個專案都寫進同一棵樹,你可以在同一個地方量、同一個地方清。取捨是真的:Cargo 會鎖住建置資料夾,所以共用同一個 target 的兩個專案只能一個一個建,不能平行。日常會同時跑多個建置的話,就讓它們各自分開,改成定期清一次。
全域儲存區交給既有機制定期修剪,不要手動刪。 現在的 Cargo 跑一般的 build 和 fetch 時,就會順手移除全域快取裡沒用到的條目,npm 則把自己的快取描述成可自癒,維護指令是 npm cache verify。讓這些機制自己跑,不要直接去刪家目錄底下那些點開頭的資料夾。清開發快取裡有各個工具的指令。
確認 agent CLI 會不會自己修剪舊發行版,而且先假設它不會。 寫這篇時,Codex 和 Claude Code 我都沒找到有正式文件說明的旗標或設定項,能清掉被取代的發行版執行檔,Codex 那則請求也還開著。Claude Code 的 cleanupPeriodDays 掃的是工作階段資料,不是版本執行檔,在這裡幫不上忙。在這件事改變之前,這是一份會重複出現的工作,也是清單上價值最高的一項,因為 agent 發版多快,它就長回來多快。
常見問題
AI 編碼工具實際上佔多少磁碟?
執行檔各自只有幾百 MB,重點在累積。這篇量的那台機器上,四個 agent CLI 的版本資料夾合計約 3.5 GB,其中正在用的只有 920 MB,工作階段的對話紀錄約 14 GB,而單單一個 Rust target/ 資料夾就是 24 GB。這些數字跟你用什麼語言的關係,遠大於跟你用哪個 agent 的關係,所以跑一次文章開頭那兩條 du 指令,不要相信任何人給的數字,包括這一份。
刪掉舊的 Claude Code 或 Codex 版本安全嗎?
先確認哪些版本已經不用。執行 readlink -f "$(command -v claude)" 或對應 CLI 的指令,保留它指向的版本,再檢查其他版本是否被程序或更新工作使用。只移走確認閒置的版本,不要單憑日期留下最新的。移至垃圾桶後先確認工具能正常執行,暫時保留還原的餘地。
Mac 清理工具會刪掉 agent 的對話紀錄嗎?
有些會,因為那些檔案看起來就是日誌,這正是這一類特有的風險。Mole 的一般清理放多久都不碰 ~/.codex/sessions、~/.codex/archived_sessions、~/.codex/memories、~/.claude/projects 和 ~/.grok/sessions。跑任何清理工具之前,先看那些路徑有沒有出現在它的候選清單裡,而如果那個工具在動手之前不肯把清單給你看,那就是答案。獨立的 AI 清理與維護頁可以列出超過各自保留期的 Codex 和 Claude Code 工作階段,以及專案已不存在的 Claude Code 工作階段,預設不勾選,逐項確認後才處理。
清掉建置快取會讓什麼變慢嗎?
通常會讓下一次建置變慢,快取重新產生後會逐漸恢復。前提是原始碼、相依套件與工具鏈都還在,而且已停止相關建置與測試。還原代價低不代表可以邊用邊刪;像 node_modules 需要重新下載套件,還要考慮網路與套件庫是否可用。
Ollama 模型和 Hugging Face 快取呢?
不在這篇範圍內,而且是刻意的。那些工具用的是內容定址的儲存區,兩個模型可以共用同一塊資料,所以手動刪檔案,可能讓一個還引用著它們的模型再也載入不起來。用每個工具自己的移除指令,這寫在清掉 AI 工具的殘留。Ollama 的模型是 Mole 唯一會處理的例外,AI 清理與維護會列出一個月沒用的,你勾選的交給 Ollama 自己的 ollama rm 刪除,其他模型還在用的資料塊會留著。
AI 清理也會檢查 Codex 未完成的執行環境安裝和 LM Studio 已被取代的引擎執行環境,不把模型檔案或聊天記錄當成這類快取。Worktree 的提交需要先由 Git 確認已保留在分支上,提交已在儲存庫主分支上的 worktree 會在該列註明「變更均已合併到主分支」,其中留下的變更如果內容已進入主分支,就不算尚未儲存的工作。若 worktree 仍被已結束執行的 Claude Code agent 鎖定,Mole 會先解鎖,讓 Git 紀錄隨資料夾一併移除。有本機變更且至少三天沒有活動的合格 worktree 會單獨列出,預設不勾選,核對這些變更後可以把整個目錄移到垃圾桶,必要檢查無法完成時仍會保留。
接下來看哪裡
按還原代價排序,刪發行版之前先解啟動器,對話紀錄別碰。量出來最大的那一行是套件儲存區,清開發快取有各個工具的修剪指令;是 Xcode,清理 Xcode 佔用的空間把可重建的資料夾和要留著的封存檔分開;是模型倉庫,清掉 AI 工具的殘留解釋為什麼刪除這件事必須由所屬工具來做。