Claude Code 可以記住您跨會話的偏好設定,例如風格指南和工作流程中的常用命令。

確定記憶體類型

Claude Code 提供三種記憶體位置,每種都有不同的用途:

記憶體類型位置用途使用案例範例
專案記憶體./CLAUDE.md團隊共享的專案指示專案架構、編碼標準、常見工作流程
使用者記憶體~/.claude/CLAUDE.md適用於所有專案的個人偏好設定程式碼風格偏好、個人工具快捷方式
專案記憶體(本地)./CLAUDE.local.md個人專案特定偏好設定(已棄用,見下文) 您的沙盒 URL、首選測試數據

所有記憶體檔案在 Claude Code 啟動時都會自動載入到其上下文中。

CLAUDE.md 導入

CLAUDE.md 檔案可以使用 @path/to/import 語法導入額外的檔案。以下範例導入了 3 個檔案:

查看 @README 了解專案概述和 @package.json 了解此專案可用的 npm 命令。

# 額外指示
- git 工作流程 @docs/git-instructions.md

相對路徑和絕對路徑都是允許的。特別是,導入使用者主目錄中的檔案是一種方便的方式,讓您的團隊成員提供不會被檢入儲存庫的個人指示。先前的 CLAUDE.local.md 提供了類似的功能,但現在已被導入功能取代,因為導入在多個 git 工作樹中運作得更好。

# 個人偏好設定
- @~/.claude/my-project-instructions.md

為了避免潛在的衝突,導入不會在 markdown 程式碼段和程式碼區塊內進行評估。

這個程式碼段不會被視為導入:`@anthropic-ai/claude-code`

導入的檔案可以遞迴地導入額外的檔案,最大深度為 5 次跳轉。您可以通過運行 /memory 命令查看載入了哪些記憶體檔案。

Claude 如何查找記憶體

Claude Code 遞迴地讀取記憶體:從當前工作目錄開始,Claude Code 遞迴向上到 / 並讀取它找到的任何 CLAUDE.md 或 CLAUDE.local.md 檔案。這在大型儲存庫中特別方便,當您在 foo/bar/ 中運行 Claude Code,並且在 foo/CLAUDE.mdfoo/bar/CLAUDE.md 中都有記憶體。

Claude 還會發現嵌套在當前工作目錄下子樹中的 CLAUDE.md。這些檔案不會在啟動時載入,而是僅在 Claude 讀取這些子樹中的檔案時才包含進來。

使用 # 快捷方式快速添加記憶體

添加記憶體的最快方法是以 # 字符開始您的輸入:

# 始終使用描述性變數名稱

系統會提示您選擇要將此記憶體存儲在哪個記憶體檔案中。

使用 /memory 直接編輯記憶體

在會話期間使用 /memory 斜線命令在系統編輯器中打開任何記憶體檔案,以進行更廣泛的添加或組織。

記憶體最佳實踐

  • 具體明確:「使用 2 空格縮進」比「正確格式化程式碼」更好。
  • 使用結構來組織:將每個單獨的記憶體格式化為項目符號,並在描述性的 markdown 標題下對相關記憶體進行分組。
  • 定期審查:隨著專案的發展更新記憶體,確保 Claude 始終使用最新的信息和上下文。