Claude Code 對話紀錄是明文、預設留 30 天:cleanupPeriodDays、retention sweep 與 claude purge 各清什麼
假設你的 .env 有加進 .gitignore,Claude Code 為了查一個設定值讀了它一次。官方文件說,只要有工具讀過 .env,或某個指令把憑證印到畫面上,那個值就會寫進 ~/.claude/projects/<project>/<session>.jsonl。文件的原話是 Transcripts and history are not encrypted at rest,唯一的保護是作業系統的檔案權限。
這個檔案裡的東西比對話本身多。文件列出 transcript 還可能包含 system prompt、tool definitions、送給模型的 request 參數,以及它載入過的指令檔,例如 CLAUDE.md。工具碰過的檔案內容、指令輸出、你貼上的文字,一律落地。
所以接下來要問的是:這些東西會留多久,誰負責清,清不到的部分在哪裡。
值日生制度:有人進辦公室才倒垃圾
預設答案是 30 天。cleanupPeriodDays 的預設值是 30,下限是 1。負責清的叫 retention sweep,運作方式很像辦公室的值日生:有人進辦公室才順手倒一次垃圾,沒人進來就一直堆著。文件的說法是,Claude Code 在背景最多每個 session 跑一次;如果同一台機器上 24 小時內已經有 session 掃過,這次的 sweep 會再延後至少 10 分鐘。整台機器都沒人啟動 Claude Code,就沒有任何東西被掃,資料留到下次啟動。
掃過之後你也不會知道。文件寫得很直白,sweep 刪 transcript 時不顯示任何訊息,超過保留期的 session 只是悄悄從 /resume 的清單消失。
掃的範圍也不只 transcript。我把文件的清單和 claude purge 的範圍並排,放成一張表:
| 位置 | sweep(cleanupPeriodDays) |
claude purge |
|---|---|---|
projects/<project>/<session>.jsonl 與 subagents、tool-results |
清,超過保留期就刪 | 清 |
file-history/<session>/(改檔前快照) |
清 | 清 |
projects/<project>/memory/(auto memory) |
不清(v2.1.228 之前會清到) | 一併刪 |
history.jsonl(你輸入過的 prompt) |
一般情況不清,HIPAA 設定生效時才依期限清 | 刪該專案的那幾行;加 --all 則整個檔案刪掉 |
| 暫存目錄裡的圖片與 scratchpad | 清(scratchpad 隨 transcript 一起刪) | 不碰 |
shell-snapshots/、backups/ |
清(backups/ 留最新五份) |
不碰,因為不屬於單一專案 |
/heapdump 寫出的 heap snapshot |
不碰 | 不碰 |
file-history/ 存的是 checkpoint 還原用的快照,所以 sweep 清掉它之後,退回那個 checkpoint 有可能失敗,文件寫的錯誤是 No files were restored。想退回三十幾天前的狀態,靠的就是這個目錄還在。前面寫過 /rewind 怎麼用,這篇補的是它的保存期限。
再看 heap snapshot。文件的說法是它含有完整的對話,以及該行程當時持有的任何憑證,sweep 和 purge 都不碰,要你自己刪。這是整張表裡我覺得最容易漏掉的一格,因為兩邊的清理機制都沒有它。
一個沒人通知你的暫停
預設 30 天這件事,有幾種情況會失效,而且都很安靜。
最容易踩的是想「永久保留」的人。直覺會設成 0,文件明說 0 不會被當成永久,而是驗證失敗,要保留很久就設一個大數字,文件舉的例子是 3650。
另一種是設定檔本身有問題。文件說,Claude Code 如果無法確定保留期限,就暫停 sweep。原因包括設定檔讀不到或解析失敗,或是設定有錯、而你又設了 cleanupPeriodDays。暫停期間,/status 會顯示警告,直到你修好為止。也就是說設定檔壞掉的後果,不是退回 30 天照掃,而是不掃。
還有一類是根本沒啟動掃描。用 claude -p --bare 跑的 session 不會執行 sweep,所以無人值守的定時腳本如果全部走 --bare,那些 session 本身不負責清。另外,如果你用 --setting-sources 之類的方式把使用者設定排除掉,又沒有其他來源提供 cleanupPeriodDays,sweep 同樣會跳過,遙測事件裡的 skip_reason 會是 "user_source_disabled"。受管設定(managed settings)有設值的話,文件說那個值會釘住保留期限,就算較低優先序的設定檔壞了,sweep 照跑。
要看到這些 skip_reason,得靠 claude_code.retention_sweep 這個遙測事件(v2.1.227 以上)。文件只說它送到你自己設定的遙測後端。你沒架 OpenTelemetry 的話,我不確定還有什麼方式能看到它,這是我沒查到,不是文件說沒有。
另外有一條規則會讓人以為設定沒生效:在 Claude Desktop 或 Cowork 開始或最近繼續的 session,預設會留得比期限更久,即使你自己設了 cleanupPeriodDays。v2.1.248 起有個獨立的 desktopSessionCleanupPeriodDays,沒設它的話,文件說那些 transcript 不論多久都留著,在 Desktop 裡刪掉的 session 這類情況除外。設了以後,要超過它和 cleanupPeriodDays 兩邊才會刪,所以 cleanupPeriodDays 維持預設 30 的時候,把它設成 7 仍然會留 30 天。
purge 和 sweep 不是同一把掃帚
sweep 看的是「多老」,claude purge 看的是「哪個專案」。
claude purge [path] 會刪掉一個專案的所有本機狀態:transcript、task 清單、debug log、檔案編輯歷史、prompt 歷史裡屬於它的那幾行,還有 ~/.claude.json 裡那個專案的條目。不給路徑會跳出互動清單讓你選。旗標有 --dry-run 預覽、-y/--yes 跳過確認、-i/--interactive 逐項確認、--all 清掉所有專案。這個指令從 v2.1.288 開始叫 claude purge,之前叫 claude project purge;2026-11-18 查 npm dist-tags,stable 是 2.1.311、latest 是 2.1.327,兩條通道都比 2.1.288 新。
purge 會連 auto memory 一起刪,而 sweep 不會。文件給的確認提示長這樣:Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N],這是官方範例輸出,不是我跑出來的。文件提供 --dry-run 旗標可以先預覽,動手之前先用它。
sweep 是按年齡的例行清掃,它會留下 auto memory、history.jsonl 和 heap snapshot;purge 是針對專案的整批清除,它會連 memory 一起帶走,卻碰不到暫存目錄與 backups/,purge 過的 session 的 scratchpad 要等你自己刪,或等作業系統清掉暫存目錄。
怎麼選
我先講立場:我把 cleanupPeriodDays 當成「我想回頭翻多久」的設定,不當資安開關。調小它縮短的只是暴露時間,transcript 裡的明文憑證在期限內一樣躺著,而 history.jsonl(一般情況)和 heap snapshot 它都掃不到。所以如果你的目的是不讓憑證落地,調這個數字抓錯了重點。
想回頭翻舊 session、想保留 /rewind 的退路,就把它調大,記得是 3650 這種數字,不是 0。
某個專案結案、你要它在這台機器上乾淨消失,用 claude purge <path> --dry-run 先看範圍,確認之後再拿掉 --dry-run。如果那個專案的 auto memory 還有用,先備份,因為它會被一起帶走。
一次性的腳本、不想留任何紀錄,文件給了 CLAUDE_CODE_SKIP_PROMPT_HISTORY=1,設了之後 prompt 歷史與 session transcript 都不寫進硬碟,也不會出現在 --resume、--continue 或方向鍵歷史裡。代價顯然是你也回不去那個 session。print mode 另有 --no-session-persistence 旗標做同樣的事。至於不落檔的狀態下 /rewind 還能不能用,文件沒有直接表態,我沒查到。
什麼條件下我會改變這個判準:如果文件哪天改成一般情況下 sweep 也會清 history.jsonl,或是我實際看過 sweep 的結果和文件寫的對不上,上面這段就要重寫。
我沒做過的部分
這篇我只讀了官方文件,沒有在自己的機器上跑過 claude purge,也沒有觀察過 sweep 實際刪了哪些檔案。表格裡的每一格、暫停條件、skip_reason 的值,都是「文件這樣寫」。sweep 實際花多久、刪了多少量、/status 警告的確切字句,文件都沒給,我也沒有。
原文來源:Explore the .claude directory、Settings reference、Monitoring usage、Environment variables、CLI reference、Checkpointing;版本號取自 2026-11-18 的 npm dist-tags 與發布時間查詢

















