管理 Claude 的記憶體
了解如何透過不同的記憶體位置和最佳實踐來管理 Claude Code 跨會話的記憶體。
Claude Code 可以記住您跨會話的偏好設定,例如風格指南和工作流程中的常用命令。
確定記憶體類型
Claude Code 提供三種記憶體位置,每種都有不同的用途:
記憶體類型 | 位置 | 用途 | 使用案例範例 |
---|---|---|---|
專案記憶體 | ./CLAUDE.md | 團隊共享的專案指示 | 專案架構、編碼標準、常見工作流程 |
使用者記憶體 | ~/.claude/CLAUDE.md | 適用於所有專案的個人偏好設定 | 程式碼風格偏好、個人工具快捷方式 |
專案記憶體(本地) | ./CLAUDE.local.md | 個人專案特定偏好設定 | (已棄用,見下文) 您的沙盒 URL、首選測試數據 |
所有記憶體檔案在 Claude Code 啟動時都會自動載入到其上下文中。
CLAUDE.md 導入
CLAUDE.md 檔案可以使用 @path/to/import
語法導入額外的檔案。以下範例導入了 3 個檔案:
相對路徑和絕對路徑都是允許的。特別是,導入使用者主目錄中的檔案是一種方便的方式,讓您的團隊成員提供不會被檢入儲存庫的個人指示。先前的 CLAUDE.local.md 提供了類似的功能,但現在已被導入功能取代,因為導入在多個 git 工作樹中運作得更好。
為了避免潛在的衝突,導入不會在 markdown 程式碼段和程式碼區塊內進行評估。
導入的檔案可以遞迴地導入額外的檔案,最大深度為 5 次跳轉。您可以通過運行 /memory
命令查看載入了哪些記憶體檔案。
Claude 如何查找記憶體
Claude Code 遞迴地讀取記憶體:從當前工作目錄開始,Claude Code 遞迴向上到 / 並讀取它找到的任何 CLAUDE.md 或 CLAUDE.local.md 檔案。這在大型儲存庫中特別方便,當您在 foo/bar/ 中運行 Claude Code,並且在 foo/CLAUDE.md 和 foo/bar/CLAUDE.md 中都有記憶體。
Claude 還會發現嵌套在當前工作目錄下子樹中的 CLAUDE.md。這些檔案不會在啟動時載入,而是僅在 Claude 讀取這些子樹中的檔案時才包含進來。
使用 #
快捷方式快速添加記憶體
添加記憶體的最快方法是以 #
字符開始您的輸入:
系統會提示您選擇要將此記憶體存儲在哪個記憶體檔案中。
使用 /memory
直接編輯記憶體
在會話期間使用 /memory
斜線命令在系統編輯器中打開任何記憶體檔案,以進行更廣泛的添加或組織。
記憶體最佳實踐
- 具體明確:「使用 2 空格縮進」比「正確格式化程式碼」更好。
- 使用結構來組織:將每個單獨的記憶體格式化為項目符號,並在描述性的 markdown 標題下對相關記憶體進行分組。
- 定期審查:隨著專案的發展更新記憶體,確保 Claude 始終使用最新的信息和上下文。