探索 .claude 目錄

Claude Code 從您的專案目錄和主目錄中的 ~/.claude 讀取指令、設定、skills、subagents 和記憶。將專案檔案提交到 git 以與您的團隊共享；~/.claude 中的檔案是個人設定，適用於您的所有專案。在 Windows 上，~/.claude 解析為 %USERPROFILE%\.claude。如果您設定了 CLAUDE_CONFIG_DIR，此頁面上的每個 ~/.claude 路徑都會改為位於該目錄下。大多數使用者只編輯 CLAUDE.md 和 settings.json。如果您的儲存庫已經有一個 AGENTS.md 供其他編碼代理使用，Claude Code 可以自行讀取或與 CLAUDE.md 一起讀取。目錄的其餘部分是可選的：根據需要新增 skills、rules 或 subagents。

探索目錄

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

未顯示的內容

探索器涵蓋您編寫和編輯的檔案。一些相關檔案位於其他位置：

檔案	位置	用途
`managed-settings.json`	系統層級，因作業系統而異	企業強制執行的設定，您無法覆寫，除了狹隘的例外。請參閱檔案儲存位置和 Claude Code 使用的受管來源。
`CLAUDE.local.md`	專案根目錄	您對此專案的私人偏好設定，與 CLAUDE.md 一起載入。手動建立它並將其新增至 `.gitignore`。
`AGENTS.md`	專案根目錄、`.claude/` 或任何目錄	您為 AI 編碼代理撰寫的專案指示。Claude Code 可以自行載入它或與 `CLAUDE.md` 一起載入。
已安裝的 plugins	`~/.claude/plugins`	複製的市集、已安裝的 plugin 版本、`installed_plugins.json` 安裝記錄，以及各 plugin 資料，由 `claude plugin` 命令管理。從您的 claude.ai 帳戶同步的 plugins 會下載到 `~/.claude/plugins/synced/`。對於從市集`command` 來源以連結模式安裝的 plugin，Claude Code 會在此儲存連結而不是副本，plugin 的檔案保留在命令列印的目錄中。`command` 來源需要 Claude Code v2.1.229 或更新版本。本機目錄市集中以相對路徑列出的 plugin 也會就地載入其來源目錄，而不是從快取副本載入。請參閱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
透過指令碼協調許多 subagent	`workflows/*.js`	專案或全域	Dynamic workflows
透過 MCP 連接外部工具	`.mcp.json`	僅專案	MCP
變更 Claude 格式化回應的方式	`output-styles/*.md`	專案或全域	Output styles

檔案參考

此表列出探索器涵蓋的每個檔案。專案範圍的檔案位於您的儲存庫中的 .claude/ 下（或 CLAUDE.md、.mcp.json 和 .worktreeinclude 的根目錄）。全域範圍的檔案位於 ~/.claude/ 中，適用於所有專案。

有幾件事可以覆蓋您在這些檔案中放入的內容：

您的組織部署的受管設定優先於所有內容，除了設定優先順序下的例外
CLI 旗標（如 --permission-mode 或 --settings）會覆蓋該工作階段的 settings.json
某些環境變數優先於其等效設定，但這會有所不同：檢查環境變數參考以了解每個變數

請參閱設定優先順序以了解完整順序。

點擊檔案名稱以在上方的探索器中開啟該節點。

檔案	範圍	提交	功能	參考
`CLAUDE.md`	專案和全域	✓	每個工作階段載入的指令	Memory
`rules/*.md`	專案和全域	✓	主題範圍的指令，可選擇路徑限制	Rules
`settings.json`	專案和全域	✓	權限、hooks、環境變數、模型預設值	Settings
`settings.local.json`	僅專案		您的個人覆蓋，當 Claude Code 將設定儲存到其中時會自動 gitignored	Settings scopes
`.mcp.json`	僅專案	✓	團隊共享的 MCP 伺服器	MCP scopes
`.worktreeinclude`	僅專案	✓	Gitignored 檔案以複製到新的 worktrees	Worktrees
`skills/<name>/SKILL.md`	專案和全域	✓	可重複使用的提示，使用 `/name` 叫用或自動叫用	Skills
`commands/*.md`	專案和全域	✓	單檔案提示；與 skills 相同的機制	Skills
`output-styles/*.md`	專案和全域	✓	自訂指令集，調整 Claude 的工作方式	Output styles
`agents/*.md`	專案和全域	✓	Subagent 定義及其自己的提示和工具	Subagents
`workflows/*.js`	專案和全域	✓	Claude 撰寫並從 `/workflows` 儲存的動態工作流程指令碼；每個檔案都會變成 `/<name>` 命令	Dynamic workflows
`agent-memory/<name>/`	專案和全域	✓	Subagents 的持久記憶	Persistent memory
`~/.claude.json`	僅全域		應用程式狀態、OAuth、UI 切換、個人 MCP 伺服器	Global config
`projects/<project>/memory/`	僅全域		自動記憶：Claude 在工作階段間對自己的筆記	Auto memory
`keybindings.json`	僅全域		自訂快捷鍵	Keybindings
`themes/*.json`	僅全域		自訂色彩主題	Custom themes

按檔案分類的 Frontmatter 欄位

Skills、命令檔案、子代理、輸出樣式和規則從檔案頂部的 YAML frontmatter 讀取其設定，每個都接受自己的一組欄位。此表列出每個檔案的欄位名稱，並連結到描述它們的參考資料。

檔案	Frontmatter 欄位	參考資料
`skills/<name>/SKILL.md`	`name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility`	Skill frontmatter
`commands/*.md`	除了 `name` 和 `paths` 之外的 skill 欄位	Skill frontmatter
`agents/*.md`	`name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental`	Subagent frontmatter
`output-styles/*.md`	`name`, `description`, `keep-coding-instructions`, `force-for-plugin`	Output style frontmatter
`rules/*.md`	`paths`	Rule frontmatter

在 plugin 中提供的代理遵守子代理欄位的子集。

疑難排解設定

如果設定、hook 或檔案未生效，請參閱偵錯您的設定以取得檢查命令和症狀優先查詢表。

應用程式資料

除了你編寫的設定外，~/.claude 還保存 Claude Code 在工作階段期間寫入的資料。這些檔案是純文字格式。任何通過工具的內容都會被寫入磁碟上的文字記錄：檔案內容、命令輸出、貼上的文字。

自動清理

Claude Code 會刪除下列路徑中的檔案，只要它們的年齡超過 cleanupPeriodDays，只要它能安全地確定保留期間。預設值為 30 天，最小值為 1；設定 0 會導致驗證錯誤。相同的年齡截止值也適用於孤立 worktrees 的自動移除。

`~/.claude/` 下的路徑	內容
`projects/<project>/<session>.jsonl`	完整對話文字記錄：每條訊息、工具呼叫和工具結果
`projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`、`projects/<project>/<session>.jsonl.superseded-<timestamp>`	Claude Code 為該工作階段設置的先前文字記錄，而不是覆蓋或刪除它。它不會出現在工作階段選擇器中
`projects/<project>/<session>/subagents/`	子代理對話文字記錄，當父工作階段文字記錄過期時被移除
`projects/<project>/<session>/tool-results/`	溢出到單獨檔案的大型工具輸出，以及 MCP 工具返回的圖片的完整大小副本
`file-history/<session>/`	Claude 更改的檔案的編輯前快照，用於檢查點還原。保存 100 個最近檢查點的快照；沒有保留檢查點引用的快照檔案會被刪除，除了每個檔案的第一個快照
`plans/`	在計畫模式期間寫入的計畫檔案
`debug/`	每個工作階段的偵錯日誌，在啟用偵錯日誌時寫入，例如當你使用 `--debug` 啟動或執行 `/debug` 時
`paste-cache/`	大型貼上內容的內容
`image-cache/<session>/`	Claude Code v2.1.274 及更早版本保存的附加圖片。更新版本將貼上和附加的圖片保存在 `~/.claude` 外，在 `CLAUDE_CODE_TMPDIR` 控制的暫存目錄下每個工作階段的 `images/` 目錄中。掃描會移除其他工作階段在此處留下的目錄，無論其年齡如何。
`uploads/<session>/`	你從網路或行動應用程式附加的檔案，以及從行動應用程式附加的照片，當訊息傳送到遠端控制工作階段時。附加到雲端工作階段的附件會保存在該工作階段自己的雲端環境中，而不是在你的機器上。
`session-env/`	每個工作階段的環境中繼資料
`tasks/`	由任務工具寫入的任務清單，每個清單一個目錄
`shell-snapshots/`	在啟動時捕獲的別名、函數和 shell 選項，由 Bash 工具應用於每個命令。在正常退出時移除。掃描會清除任何在崩潰後留下的內容。
`backups/`	`~/.claude.json` 的早期版本，在 Claude Code 重寫檔案時複製。Claude Code 保留五個最新版本，加上任何它無法解析的版本副本。
`feedback-bundles/`	由 `/feedback` 在第三方提供商上或當未配置 Anthropic 認證時寫入的編輯後文字記錄存檔，用於發送到你的 Anthropic 帳戶團隊
`feedback/drafts/`	排隊的 Claude 起草的回饋等待你在 `/feedback` 中審查。在 `cleanupPeriodDays` 或 30 天後掃描，以較短者為準。當佇列達到其 10 份草稿限制時，Claude Code 會刪除最舊的草稿以騰出空間。
`usage-data/`	由 `/insights` 寫入的 `report.html` 和時間戳記報告副本，加上用於建立它們的快取每個工作階段分析資料
`skills/.trash/`、`plugins/.trash/`	claude.ai 同步移除的技能和外掛程式，例如在你在 claude.ai 上關閉一個或停止同步後。檔案保留在此處，以便你可以恢復它們，直到掃描刪除它們
`todos/`、`statsig/`、`logs/`	來自舊版本的舊版目錄。不再寫入。掃描會移除其內容，然後移除空目錄。

sessions/ 中的工作階段檔案、自動記憶和 Claude Desktop 及 Cowork 文字記錄各自遵循自己的保留規則：

sessions/：為每個執行中的工作階段保存一個小檔案，用於偵測並行工作階段和崩潰。它不是基於年齡的掃描的一部分：Claude Code 在其工作階段退出時移除每個檔案，並在下次啟動時清除崩潰遺留物。
自動記憶：掃描不會刪除專案自動記憶目錄 projects/<project>/memory/ 中的記憶檔案。Claude Code 只有在整個保留期間該目錄一直為空時才會移除它。在 v2.1.228 之前，掃描將記憶目錄內的資料夾視為工作階段資料，可能會刪除其下的舊檔案。
Claude Desktop 和 Cowork 文字記錄：Claude Code 保留你在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段的文字記錄，無論年齡如何。要為這些文字記錄設定年齡限制，請設定 desktopSessionCleanupPeriodDays。當受管設定設定 cleanupPeriodDays 時，Claude Code 會在該期間後刪除這些文字記錄。需要 Claude Code v2.1.248 或更新版本；較早版本在 cleanupPeriodDays 後刪除它們。

Claude Code 在這些情況下跳過基於年齡的掃描：

裸機模式：當你使用 --bare 執行 claude -p 時，Claude Code 不會在該工作階段中執行掃描。
暫停掃描：如果 Claude Code 無法安全地確定保留期間，它會暫停保留清理掃描；retention_sweep 事件列出每個暫停它的設定。當原因是無法讀取或解析的設定檔案，或 cleanupPeriodDays 或 desktopSessionCleanupPeriodDays 明確設定的設定錯誤時，Claude Code 也會在 /status 中顯示警告，直到你修復設定錯誤。當受管設定提供 cleanupPeriodDays 時，Claude Code 在任一情況下都會以受管值執行掃描。

工作階段暫存簿目錄

暫存簿是 Claude Code 為 Claude 提供的每個工作階段目錄，用於臨時檔案：中間結果、輔助指令碼和不屬於你的專案的草稿。當 Claude 說它將某些內容保存到「暫存簿」時，該檔案就在那裡。Claude 使用它而不是 /tmp，可以在其中建立、編輯和讀取檔案，無需權限提示。暫存簿位於 Claude Code 的暫存目錄下，而不是 ~/.claude。找到你的平台的目前工作階段路徑：

macOS：/private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
Linux：/tmp/claude-<uid>/<project>/<session-id>/scratchpad/，或當你的系統設定 $TMPDIR 時在其下的相同形狀
Windows：%TEMP%\claude\<project>\<session-id>\scratchpad\

<project> 是你的工作目錄路徑，其中除字母和數字外的每個字元都被替換為 -，例如 -Users-you-my-project。如果你設定 CLAUDE_CODE_TMPDIR，樹會改為移到該目錄下。Hooks 接收目前工作階段的路徑作為 scratchpad_dir。暫存簿檔案的持續時間與工作階段的文字記錄相同：保留掃描在刪除文字記錄時刪除目錄，claude project purge 不會觸及暫存目錄。因為目錄位於系統暫存位置下，你的作業系統也可以清除它，例如在重新啟動時。要保留 Claude 在那裡寫入的內容，請要求 Claude 將其移到你的專案中。工作階段只有在以下所有情況都成立時才有暫存簿：

你使用 claude.ai 帳戶而不是 API 金鑰登入
工作階段使用 Anthropic API，而不是 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry
enableArtifact 未設定為 false

保留直到你刪除它們

保留清理掃描不會移除下列路徑。Claude Code 保留它們直到你刪除它們，除了兩個快取在你登出時刪除。

`~/.claude/` 下的路徑	內容
`history.jsonl`	你輸入的每個提示，帶有時間戳記和專案路徑。用於向上箭頭回憶、`Ctrl+R` 歷史搜尋和 `!` shell 命令完成。
`stats-cache.json`	由 `/usage` 顯示的彙總權杖和成本計數
`remote-settings.json`	伺服器受管設定的快取副本，用於你的組織，或當你的組織未配置任何設定時為 `{}`。只有在工作階段擷取它們時才存在。Claude Code 在啟動時和工作階段期間每小時檢查更新。Claude Code 在你登出時刪除它。
`cache/changelog.md`	Claude Code 變更日誌的快取副本，由 `/release-notes` 顯示。在背景中重新整理。
`policy-limits.json`	你的組織的快取功能原則設定。僅對某些帳戶類型存在。自動重新整理。`policy-limits.json.stamp.json` 側車記錄快取屬於哪個帳戶或 API 金鑰。Claude Code 在你登出時刪除兩個檔案。

其他檔案根據你使用的功能而出現。快取和鎖定檔案可以安全刪除。保留這些狀態檔案：

.credentials.json：你的登入認證
agent-memory/：子代理記憶
jobs/ 和 daemon/：背景工作階段狀態

純文字儲存

文字記錄和歷史在靜止時未加密。OS 檔案權限是唯一的保護。如果工具讀取 .env 檔案或命令列印認證，該值會被寫入 projects/<project>/<session>.jsonl。要減少暴露：

降低 cleanupPeriodDays 以縮短 Claude Code 保留文字記錄的時間
設定 desktopSessionCleanupPeriodDays 以給予 Claude Desktop 和 Cowork 文字記錄年齡限制
設定 CLAUDE_CODE_SKIP_PROMPT_HISTORY 環境變數以在任何模式下跳過寫入文字記錄和提示歷史。在非互動模式下，你可以改為在 -p 旁邊傳遞 --no-session-persistence，或在 TypeScript Agent SDK 中設定 persistSession: false；Python SDK 沒有等效選項。
使用權限規則拒絕讀取認證檔案

清除本機資料

執行 claude project purge 以刪除 Claude Code 為一個專案保存的狀態。它刪除：

projects/ 下的文字記錄和自動記憶
每個工作階段的 tasks/、debug/ 和 file-history/ 項目
history.jsonl 中的匹配提示行
專案在 ~/.claude.json 中的項目

你在專案工作階段中貼上或附加的圖片以及每個工作階段的暫存簿儲存在 Claude Code 的暫存目錄下，而不是 ~/.claude，所以清除不會移除它們。保留掃描仍會在圖片年齡超過 cleanupPeriodDays 時刪除它們；清除的工作階段的暫存簿會保留，直到你刪除它或你的作業系統清除暫存目錄。該命令列印完整的刪除計畫並在移除任何內容之前要求確認。下面的範例使用 ~/work/my-repo 作為佔位符。將其替換為你的專案的路徑。如果沒有狀態符合該路徑，該命令會列印錯誤並以狀態 1 退出。預覽計畫而不刪除任何內容：

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

該計畫列出每個匹配項目及其包含的原因：

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

使用單一確認提示刪除：

claude project purge ~/work/my-repo

該命令列印相同的計畫，然後詢問 Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] 並且只有在你回答 y 時才刪除。省略路徑以從互動清單中選擇專案。跳過確認提示以在指令碼中使用：

claude project purge ~/work/my-repo --yes

傳遞 --all 而不是路徑以一次清除每個專案的狀態，這會直接刪除 history.jsonl 而不是篩選它。傳遞 -i 以逐項逐步執行刪除計畫。該命令保留 shell-snapshots/ 和 backups/ 不動，因為那些不是專案範圍的，並在計畫輸出中警告它們。你也可以手動刪除上述任何應用程式資料路徑，除了保留的狀態檔案。新工作階段不受影響。下表顯示你對過去工作階段失去的內容。

刪除	你失去
`~/.claude/projects/`	恢復、繼續和倒帶過去工作階段，以及每個專案的自動記憶
`~/.claude/history.jsonl`	向上箭頭提示回憶、`Ctrl+R` 歷史搜尋和 `!` shell 命令完成
`~/.claude/paste-cache/`	回憶提示中的貼上文字；請參閱貼上大型內容
`~/.claude/uploads/`	過去遠端控制工作階段按路徑引用的附件
`~/.claude/file-history/`	過去工作階段的檢查點還原
`~/.claude/stats-cache.json`	由 `/usage` 顯示的歷史總計
`~/.claude/usage-data/`	過去的 `/insights` 報告和用於建立它們的快取分析資料
`~/.claude/feedback-bundles/`	你還未發送到你的 Anthropic 帳戶團隊的回饋和錯誤報告存檔
`~/.claude/feedback/drafts/`	你未發送的 Claude 起草的回饋
`~/.claude/remote-settings.json`	無。在下次啟動時重新擷取。
`~/.claude/cache/changelog.md`	無。在背景中重新整理。
`~/.claude/policy-limits.json`	無。自動重新整理。
`~/.claude/tasks/`	恢復的工作階段會拾取的任務清單
`~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/`	恢復同步技能和同步外掛程式的機會，Claude Code 已移除
`~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/`	無使用者面向的內容
`~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/`	無。舊版本的舊版目錄，不由目前版本寫入。

不要刪除 ~/.claude.json、~/.claude/settings.json 或 ~/.claude/plugins/：那些保存你的驗證、偏好設定和已安裝的外掛程式。

管理 Claude 的記憶：寫入和組織 CLAUDE.md、rules 和自動記憶
設定設定：設定權限、hooks、環境變數和模型預設值
建立 skills：建立可重複使用的提示和工作流程
設定 subagents：定義具有自己上下文的專門代理

開始使用

核心概念

使用 Claude Code

平台與整合

探索目錄

未顯示的內容

選擇正確的檔案

檔案參考

按檔案分類的 Frontmatter 欄位

疑難排解設定

應用程式資料

自動清理

工作階段暫存簿目錄

保留直到你刪除它們

純文字儲存

清除本機資料

​探索目錄

​未顯示的內容

​選擇正確的檔案

​檔案參考

​按檔案分類的 Frontmatter 欄位

​疑難排解設定

​應用程式資料

​自動清理

​工作階段暫存簿目錄

​保留直到你刪除它們

​純文字儲存

​清除本機資料

​相關資源

探索目錄

未顯示的內容

選擇正確的檔案

檔案參考

按檔案分類的 Frontmatter 欄位

疑難排解設定

應用程式資料

自動清理

工作階段暫存簿目錄

保留直到你刪除它們

純文字儲存

清除本機資料

相關資源