Skip to main content
Claude Code 從您的專案目錄和主目錄中的 ~/.claude 讀取指令、設定、skills、subagents 和記憶。將專案檔案提交到 git 以與您的團隊共享;~/.claude 中的檔案是個人設定,適用於您的所有專案。 在 Windows 上,~/.claude 解析為 %USERPROFILE%\.claude。如果您設定了 CLAUDE_CONFIG_DIR,此頁面上的每個 ~/.claude 路徑都會改為位於該目錄下。 大多數使用者只編輯 CLAUDE.mdsettings.json。目錄的其餘部分是可選的:根據需要新增 skills、rules 或 subagents。

探索目錄

點擊樹中的檔案以查看每個檔案的功能、何時載入以及範例。

未顯示的內容

探索器涵蓋您編寫和編輯的檔案。一些相關檔案位於其他位置: ~/.claude 還保存 Claude Code 在您工作時寫入的資料:文字記錄、提示歷史記錄、檔案快照、快取和日誌。請參閱下方的應用程式資料

選擇正確的檔案

不同類型的自訂設定位於不同的檔案中。使用此表格找到變更應該位於何處。

檔案參考

此表列出探索器涵蓋的每個檔案。專案範圍的檔案位於您的儲存庫中的 .claude/ 下(或 CLAUDE.md.mcp.json.worktreeinclude 的根目錄)。全域範圍的檔案位於 ~/.claude/ 中,適用於所有專案。
有幾件事可以覆蓋您在這些檔案中放入的內容:
  • 您的組織部署的受管設定優先於所有內容
  • CLI 旗標(如 --permission-mode--settings)會覆蓋該工作階段的 settings.json
  • 某些環境變數優先於其等效設定,但這會有所不同:檢查環境變數參考以了解每個變數
請參閱設定優先順序以了解完整順序。
點擊檔案名稱以在上方的探索器中開啟該節點。

疑難排解設定

如果設定、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。