~/.claude 讀取指令、設定、skills、subagents 和記憶。將專案檔案提交到 git 以與您的團隊共享;~/.claude 中的檔案是個人設定,適用於您的所有專案。
在 Windows 上,~/.claude 解析為 %USERPROFILE%\.claude。如果您設定了 CLAUDE_CONFIG_DIR,此頁面上的每個 ~/.claude 路徑都會改為位於該目錄下。
大多數使用者只編輯 CLAUDE.md 和 settings.json。目錄的其餘部分是可選的:根據需要新增 skills、rules 或 subagents。
探索目錄
點擊樹中的檔案以查看每個檔案的功能、何時載入以及範例。未顯示的內容
探索器涵蓋您編寫和編輯的檔案。一些相關檔案位於其他位置:~/.claude 還保存 Claude Code 在您工作時寫入的資料:文字記錄、提示歷史記錄、檔案快照、快取和日誌。請參閱下方的應用程式資料。
選擇正確的檔案
不同類型的自訂設定位於不同的檔案中。使用此表格找到變更應該位於何處。檔案參考
此表列出探索器涵蓋的每個檔案。專案範圍的檔案位於您的儲存庫中的.claude/ 下(或 CLAUDE.md、.mcp.json 和 .worktreeinclude 的根目錄)。全域範圍的檔案位於 ~/.claude/ 中,適用於所有專案。
點擊檔案名稱以在上方的探索器中開啟該節點。
疑難排解設定
如果設定、hook 或檔案未生效,請參閱偵錯您的設定以取得檢查命令和症狀優先查詢表。應用程式資料
除了您編寫的設定外,~/.claude 還保存 Claude Code 在工作階段期間寫入的資料。這些檔案是純文字。任何通過工具的內容都會在磁碟上的文字記錄中結束:檔案內容、命令輸出、貼上的文字。
自動清理
下列路徑中的檔案在啟動時被刪除,一旦它們的年齡超過cleanupPeriodDays。預設值為 30 天。
保留直到您刪除它們
以下路徑不受自動清理覆蓋,並無限期保留。
其他小型快取和鎖定檔案會根據您使用的功能而出現,可安全刪除。
純文字儲存
文字記錄和歷史記錄在靜止時未加密。作業系統檔案權限是唯一的保護。如果工具讀取.env 檔案或命令列印認證,該值會寫入 projects/<project>/<session>.jsonl。若要減少暴露:
- 降低
cleanupPeriodDays以縮短文字記錄的保留時間 - 設定
CLAUDE_CODE_SKIP_PROMPT_HISTORY環境變數以跳過在任何模式中寫入文字記錄和提示歷史記錄。在非互動模式中,您可以改為在-p旁邊傳遞--no-session-persistence,或在 Agent SDK 中設定persistSession: false。 - 使用權限規則拒絕讀取認證檔案
清除本機資料
執行claude project purge 以刪除 Claude Code 為一個專案保存的狀態。該命令需要 Claude Code v2.1.124 或更新版本。它會刪除:
projects/下的文字記錄和自動記憶- 每個工作階段的
tasks/、debug/和file-history/項目 history.jsonl中的匹配提示行- 專案在
~/.claude.json中的項目
--all 而不是路徑以一次清除所有專案的狀態,這會直接刪除 history.jsonl 而不是篩選它。傳遞 -i 以逐項逐步執行刪除計畫。
該命令會單獨保留 shell-snapshots/ 和 backups/,因為這些不是專案範圍的,並在計畫輸出中警告它們。如果沒有狀態與給定路徑相符,它會以狀態 1 退出。
您也可以手動刪除上述任何應用程式資料路徑。新工作階段不受影響。下表顯示您對過去工作階段失去的內容。
不要刪除
~/.claude.json、~/.claude/settings.json 或 ~/.claude/plugins/:這些保存您的驗證、偏好設定和已安裝的 plugins。
相關資源
- 管理 Claude 的記憶:寫入和組織 CLAUDE.md、rules 和自動記憶
- 設定設定:設定權限、hooks、環境變數和模型預設值
- 建立 skills:建立可重複使用的提示和工作流程
- 設定 subagents:定義具有自己上下文的專門代理