Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Claude Code 從您的專案目錄和主目錄中的 ~/.claude 讀取指令、設定、skills、subagents 和記憶。將專案檔案提交到 git 以與您的團隊共享；~/.claude 中的檔案是個人設定，適用於您的所有專案。
在 Windows 上，~/.claude 解析為 %USERPROFILE%\.claude。如果您設定了 CLAUDE_CONFIG_DIR，此頁面上的每個 ~/.claude 路徑都會改為位於該目錄下。
大多數使用者只編輯 CLAUDE.md 和 settings.json。目錄的其餘部分是可選的：根據需要新增 skills、rules 或 subagents。
探索目錄
點擊樹中的檔案以查看每個檔案的功能、何時載入以及範例。
未顯示的內容
探索器涵蓋您編寫和編輯的檔案。一些相關檔案位於其他位置：
| 檔案 | 位置 | 用途 |
|---|
managed-settings.json | 系統級別，因作業系統而異 | 企業強制執行的設定，您無法覆蓋。請參閱伺服器管理的設定。 |
CLAUDE.local.md | 專案根目錄 | 您對此專案的私人偏好設定，與 CLAUDE.md 一起載入。手動建立並將其新增到 .gitignore。 |
| 已安裝的 plugins | ~/.claude/plugins | 複製的市場、已安裝的 plugin 版本和每個 plugin 的資料，由 claude plugin 命令管理。孤立版本在 plugin 更新或解除安裝後 7 天內被刪除。請參閱 plugin 快取。 |
~/.claude 還保存 Claude Code 在您工作時寫入的資料：文字記錄、提示歷史記錄、檔案快照、快取和日誌。請參閱下方的應用程式資料。
選擇正確的檔案
不同類型的自訂設定位於不同的檔案中。使用此表格找到變更應該位於何處。
| 您想要 | 編輯 | 範圍 | 參考 |
|---|
| 為 Claude 提供專案上下文和慣例 | CLAUDE.md | 專案或全域 | Memory |
| 允許或阻止特定工具呼叫 | settings.json permissions 或 hooks | 專案或全域 | Permissions、Hooks |
| 在工具呼叫之前或之後執行指令碼 | settings.json hooks | 專案或全域 | Hooks |
| 為工作階段設定環境變數 | settings.json env | 專案或全域 | Settings |
| 將個人覆蓋保留在 git 之外 | settings.local.json | 僅專案 | Settings scopes |
新增您使用 /name 叫用的提示或功能 | skills/<name>/SKILL.md | 專案或全域 | Skills |
| 定義具有自己工具的專門 subagent | agents/*.md | 專案或全域 | Subagents |
| 透過 MCP 連接外部工具 | .mcp.json | 僅專案 | MCP |
| 變更 Claude 格式化回應的方式 | output-styles/*.md | 專案或全域 | Output styles |
檔案參考
此表列出探索器涵蓋的每個檔案。專案範圍的檔案位於您的儲存庫中的 .claude/ 下（或 CLAUDE.md、.mcp.json 和 .worktreeinclude 的根目錄）。全域範圍的檔案位於 ~/.claude/ 中，適用於所有專案。
有幾件事可以覆蓋您在這些檔案中放入的內容：
- 您的組織部署的受管設定優先於所有內容
- CLI 旗標（如
--permission-mode 或 --settings）會覆蓋該工作階段的 settings.json
- 某些環境變數優先於其等效設定，但這會有所不同：檢查環境變數參考以了解每個變數
請參閱設定優先順序以了解完整順序。 檢查已載入的內容
探索器顯示可以存在的檔案。若要查看在您目前工作階段中實際載入的內容，請使用這些命令：
| 命令 | 顯示 |
|---|
/context | 按類別的權杖使用情況：系統提示、記憶檔案、skills、MCP 工具和訊息 |
/memory | 載入了哪些 CLAUDE.md 和 rules 檔案，加上自動記憶項目 |
/agents | 已設定的 subagents 及其設定 |
/hooks | 作用中的 hook 設定 |
/mcp | 已連接的 MCP 伺服器及其狀態 |
/skills | 來自專案、使用者和 plugin 來源的可用 skills |
/permissions | 目前的允許和拒絕規則 |
/doctor | 安裝和設定診斷 |
/context 以取得概觀，然後執行特定命令以調查您想要的區域。
應用程式資料
除了您編寫的設定外，~/.claude 還保存 Claude Code 在工作階段期間寫入的資料。這些檔案是純文字。任何通過工具的內容都會在磁碟上的文字記錄中結束：檔案內容、命令輸出、貼上的文字。
自動清理
下列路徑中的檔案在啟動時被刪除，一旦它們的年齡超過 cleanupPeriodDays。預設值為 30 天。
~/.claude/ 下的路徑 | 內容 |
|---|
projects/<project>/<session>.jsonl | 完整對話文字記錄：每條訊息、工具呼叫和工具結果 |
projects/<project>/<session>/subagents/ | Subagent 對話文字記錄，當父工作階段文字記錄過期時一起移除 |
projects/<project>/<session>/tool-results/ | 溢出到單獨檔案的大型工具輸出 |
file-history/<session>/ | Claude 變更的檔案的編輯前快照，用於檢查點還原 |
plans/ | 在 Plan Mode 期間寫入的計畫檔案 |
debug/ | 每個工作階段的偵錯日誌，僅在您使用 --debug 啟動或執行 /debug 時寫入 |
paste-cache/、image-cache/ | 大型貼上和附加影像的內容 |
session-env/ | 每個工作階段的環境中繼資料 |
tasks/ | 由 task tools 寫入的每個工作階段任務清單 |
shell-snapshots/ | Bash tool 使用的擷取 shell 環境。在正常退出時移除。掃描會清除任何在當機後遺留的檔案。 |
backups/ | 在設定遷移前取得的 ~/.claude.json 的時間戳記副本 |
feedback-bundles/ | 由 /feedback 在第三方提供者上寫入的已編輯文字記錄存檔，用於傳送到您的 Anthropic 帳戶團隊 |
保留直到您刪除它們
以下路徑不受自動清理覆蓋，並無限期保留。
~/.claude/ 下的路徑 | 內容 |
|---|
history.jsonl | 您輸入的每個提示，帶有時間戳記和專案路徑。用於向上箭頭回憶。 |
stats-cache.json | 由 /usage 顯示的彙總權杖和成本計數 |
remote-settings.json | 您組織的伺服器管理設定的快取副本。僅在您的組織已設定時出現。在每次啟動時重新整理。 |
todos/ | 舊版每個工作階段的任務清單。不再由目前版本寫入；可安全刪除。 |
純文字儲存
文字記錄和歷史記錄在靜止時未加密。作業系統檔案權限是唯一的保護。如果工具讀取 .env 檔案或命令列印認證，該值會寫入 projects/<project>/<session>.jsonl。若要減少暴露：
- 降低
cleanupPeriodDays 以縮短文字記錄的保留時間
- 設定
CLAUDE_CODE_SKIP_PROMPT_HISTORY 環境變數以跳過在任何模式中寫入文字記錄和提示歷史記錄。在非互動模式中，您可以改為在 -p 旁邊傳遞 --no-session-persistence，或在 Agent SDK 中設定 persistSession: false。
- 使用權限規則拒絕讀取認證檔案
清除本機資料
執行 claude project purge 以刪除 Claude Code 為一個專案保存的狀態：
projects/ 下的文字記錄和自動記憶- 每個工作階段的
tasks/、debug/ 和 file-history/ 項目
history.jsonl 中的匹配提示行- 專案在
~/.claude.json 中的項目
該命令會列印完整的刪除計畫，並在移除任何內容之前要求確認。
預覽計畫而不刪除任何內容：
claude project purge ~/work/my-repo --dry-run
claude project purge ~/work/my-repo
claude project purge ~/work/my-repo --yes
--all 而不是路徑以一次清除所有專案的狀態，這會直接刪除 history.jsonl 而不是篩選它。傳遞 -i 以逐項逐步執行刪除計畫。
該命令會單獨保留 shell-snapshots/ 和 backups/，因為這些不是專案範圍的，並在計畫輸出中警告它們。如果沒有狀態與給定路徑相符，它會以狀態 1 退出。
您也可以手動刪除上述任何應用程式資料路徑。新工作階段不受影響。下表顯示您對過去工作階段失去的內容。
| 刪除 | 您失去 |
|---|
~/.claude/projects/ | 過去工作階段的繼續、繼續和倒帶 |
~/.claude/history.jsonl | 向上箭頭提示回憶 |
~/.claude/file-history/ | 過去工作階段的檢查點還原 |
~/.claude/stats-cache.json | 由 /usage 顯示的歷史總計 |
~/.claude/remote-settings.json | 無。在下次啟動時重新擷取。 |
~/.claude/debug/、~/.claude/plans/、~/.claude/paste-cache/、~/.claude/image-cache/、~/.claude/session-env/、~/.claude/tasks/、~/.claude/shell-snapshots/、~/.claude/backups/ | 沒有面向使用者的內容 |
~/.claude/todos/ | 無。舊版目錄不由目前版本寫入。 |
~/.claude.json、~/.claude/settings.json 或 ~/.claude/plugins/：這些保存您的驗證、偏好設定和已安裝的 plugins。
相關資源
