Claude Code 歷史記錄在哪、文件夾在哪：~/.claude 裏每個文件是什麼，哪些 30 天后會被清掉，哪些不能刪

本文根據 Claude Code 官方文檔《Explore the .claude directory》《Manage sessions》《Authentication》整理，資料核對於 2026-11-05。配圖為本站整理的示意圖，不是介面截圖。本站（bigolab.com）不是 Anthropic 官方網站。

適用於誰

• 搜「claude code 歷史記錄在哪」「claude code 文件夾在哪」，想找到會話記錄的人；
• 想清理磁盤、又怕誤刪設定和登入資料的人；
• 想知道自己的對話內容有沒有明文留在電腦上的人。

結論先說

1. 用戶級的東西都在 ~/.claude，Windows 上就是 %USERPROFILE%\.claude。設定了環境變量 CLAUDE_CONFIG_DIR，則都改到那個目錄下；~/.claude.json 也一樣。
2. 會話記錄在 ~/.claude/projects/<項目>/<會話 ID>.jsonl；你輸入過的提示在 ~/.claude/history.jsonl。
3. 項目級的東西在你項目裏的 .claude/ 文件夾，以及項目根目錄的 CLAUDE.md、.mcp.json。
4. 預設超過 30 天的會話記錄等會被自動清理，由設定項 cleanupPeriodDays 控制；history.jsonl 這類則不會被自動清。
5. ~/.claude.json、~/.claude/settings.json、~/.claude/plugins/ 官方明確說不要刪，裏面有帳號資料、偏好和已裝插件。
6. 這些文件是明文，沒有加密，對話裏出現過的文件內容、命令輸出都可能在裏面。

圖：本站根據 Claude Code 官方文檔：Explore the .claude directory 整理的示意圖

一、會話記錄和提示歷史

會話記錄的完整路徑是 ~/.claude/projects/<項目>/<會話 ID>.jsonl，其中 <項目> 是你啟動時所在目錄的路徑，把非字母數字的字符都換成 -（例如 /Users/you/my-project 會變成以 -Users-you-my-project 為名的文件夾）。裏面是對話消息、工具調用和結果，以及 Claude Code 發給模型的請求。會話怎麼恢復見 /guides/claude-code-resume-history，導出成文字見 /guides/claude-code-export-conversation-context。

~/.claude/history.jsonl 存的是你輸入過的提示，附時間戳和項目路徑，用於按 ↑ 召回、Ctrl+R 搜尋歷史和 ! 開頭的 shell 命令補全。

同一個項目下還有這些子目錄，官方說它們和會話記錄一起按保留期清理：

• projects/<項目>/<會話>/subagents/：子代理的記錄；
• projects/<項目>/<會話>/tool-results/：太大而單獨存放的工具輸出；
• file-history/<會話>/：Claude 改文件前的快照，/rewind 靠它還原，見 /guides/claude-code-rewind-checkpoints-undo。

二、設定、憑據和其他個人文件

登入憑據的位置，官方在認證文檔裏寫明：macOS 存在加密的 Keychain（Keychain 拒絕寫入時退回到 ~/.claude/.credentials.json）；Linux 存在 ~/.claude/.credentials.json，文件權限 0600；Windows 存在 %USERPROFILE%\.claude\.credentials.json，沿用你用戶目錄的訪問控制。官方說這個文件由 /login 和 /logout 管理，登入與退出見 /guides/claude-code-login-logout-switch-account。

三、項目裏的 .claude 文件夾

項目級配置放在你的項目裏，提交到 git 就能和團隊共享：

• 根目錄的 CLAUDE.md：每次會話都會加載的項目說明；
• .claude/settings.json：項目的權限、Hook、環境變量；
• .claude/settings.local.json：你個人對本項目的覆蓋，官方說 Claude Code 往裏存設定時會讓它被 git 忽略；
• .mcp.json：團隊共享的 MCP 伺服器，配置見 /guides/claude-code-mcp-setup；
• .claude/skills/、.claude/agents/、.claude/rules/：技能、子代理和按主題寫的規則。

四、保留多久、會不會被自動刪

官方的規則：~/.claude 下的會話記錄、子代理記錄、工具輸出、文件快照、調試日誌等，超過 cleanupPeriodDays 就會被刪，預設 30 天，最小值是 1，設成 0 會報校驗錯誤。

不會被自動清理的包括：history.jsonl、stats-cache.json，以及 projects/<項目>/memory/ 下的自動記憶文件。想讓快照和記錄保留更久，就把 cleanupPeriodDays 調大；想縮短，調小。

圖片和臨時草稿目錄不在 ~/.claude 裏：官方說新版本把粘貼和附加的圖片存到臨時目錄下每個會話的 images/ 裏，會話草稿目錄（scratchpad）在 Windows 上是 %TEMP%\claude\<項目>\<會話 ID>\scratchpad\。

五、想清理，先看會丟什麼

圖：本站根據 Claude Code 官方文檔：Explore the .claude directory 整理的示意圖

官方有一個專門的命令：claude purge，用來刪除某個項目的狀態。它會刪這個項目的會話記錄和自動記憶、對應的 tasks/、debug/、file-history/ 條目、history.jsonl 裏屬於該項目的提示行，以及 ~/.claude.json 裏該項目的條目。用法：

bash
claude purge ~/work/my-repo --dry-run
claude purge ~/work/my-repo

第一條只預覽刪除計劃，不真刪；第二條會先打印同樣的計劃，再要求你確認（[y/N]）。省略路徑則從交互列表裏選；--all 清所有項目。官方說 v2.1.288 之前這條命令叫 claude project purge。

六、明文存儲：注意什麼

官方在文檔裏寫明，轉錄和歷史不加密，只有操作系統的文件權限保護它們。工具讀到 .env 文件，或命令打印了憑據，這些值就會寫進 .jsonl。官方給的降低風險的辦法包括：縮短 cleanupPeriodDays；設環境變量 CLAUDE_CODE_SKIP_PROMPT_HISTORY 讓任何模式下都不寫轉錄和提示歷史；用權限規則禁止讀取憑據文件。權限規則的寫法見 /guides/claude-code-stop-asking-permission。

常見問題

Q：Windows 的 ~ 是哪裏？

官方說是 %USERPROFILE%，通常是 C:\Users\你的用戶名。

Q：能把 .claude 搬到 D 盤嗎？

官方給的做法是設定環境變量 CLAUDE_CONFIG_DIR，讓所有 ~/.claude 下的路徑改到那個目錄。官方也說 .claude.json 會跟着走。

Q：刪了 projects/ 會怎樣？

官方的說法是：丟失過去會話的恢復、繼續和回退，以及所有項目的自動記憶。

Q：想看某個會話的內容，直接打開 .jsonl 行嗎？

可以打開看，但官方說格式是內部的、會隨版本變化，不建議用腳本解析。

相關教學

• /guides/claude-code-common-errors：常見報錯與解決
• /guides/ai-coding-security-secrets-permissions：密鑰保護

參考資料

• Claude Code 官方文檔：Explore the .claude directory — https://code.claude.com/docs/en/claude-directory
• Claude Code 官方文檔：Manage sessions — https://code.claude.com/docs/en/sessions
• Claude Code 官方文檔：Authentication — https://code.claude.com/docs/en/authentication