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 遞迴讀取記憶體:從 cwd 開始,Claude Code 向上遞迴到(但不包括)根目錄 / 並讀取它找到的任何 CLAUDE.md 或 CLAUDE.local.md 檔案。這在處理大型儲存庫時特別方便,您在 foo/bar/ 中執行 Claude Code,並且在 foo/CLAUDE.mdfoo/bar/CLAUDE.md 中都有記憶體。

Claude 也會發現嵌套在您當前工作目錄下子樹中的 CLAUDE.md。它們不會在啟動時載入,只有當 Claude 讀取這些子樹中的檔案時才會包含。

使用 # 快捷方式快速新增記憶體

新增記憶體的最快方式是在輸入開頭使用 # 字元:

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

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

使用 /memory 直接編輯記憶體

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

設定專案記憶體

假設您想要設定一個 CLAUDE.md 檔案來儲存重要的專案資訊、慣例和常用命令。

使用以下命令為您的程式碼庫引導一個 CLAUDE.md:

> /init 

提示:

  • 包含常用命令(建置、測試、檢查)以避免重複搜尋
  • 記錄程式碼樣式偏好和命名慣例
  • 新增專案特定的重要架構模式
  • CLAUDE.md 記憶體可用於與團隊共享的指令和您的個人偏好設定。

記憶體最佳實踐

  • 要具體:「使用 2 個空格縮排」比「正確格式化程式碼」更好。
  • 使用結構來組織:將每個個別記憶體格式化為項目符號,並在描述性 markdown 標題下將相關記憶體分組。
  • 定期檢視:隨著專案的發展更新記憶體,以確保 Claude 始終使用最新的資訊和上下文。