跳轉到主要內容
Claude Code 可以在會話中記住您的偏好設定,例如樣式指南和工作流程中的常用命令。

確定記憶體類型

Claude Code 提供四個記憶體位置,採用分層結構,每個位置都有不同的用途:
記憶體類型位置用途使用案例示例共享對象
企業政策macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md
Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
由 IT/DevOps 管理的組織範圍內指令公司編碼標準、安全政策、合規要求組織中的所有使用者
專案記憶體./CLAUDE.md./.claude/CLAUDE.md專案的團隊共享指令專案架構、編碼標準、常見工作流程透過原始碼控制的團隊成員
使用者記憶體~/.claude/CLAUDE.md所有專案的個人偏好設定程式碼樣式偏好、個人工具快捷方式僅限您(所有專案)
專案記憶體(本機)./CLAUDE.local.md個人專案特定偏好設定(已棄用,見下文) 您的沙箱 URL、首選測試資料僅限您(目前專案)
所有記憶體檔案在啟動 Claude Code 時會自動載入其上下文中。階層結構中較高位置的檔案優先級較高,會先載入,為更具體的記憶體提供基礎。

CLAUDE.md 匯入

CLAUDE.md 檔案可以使用 @path/to/import 語法匯入其他檔案。以下範例匯入 3 個檔案:
See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md
允許相對路徑和絕對路徑。特別是,匯入使用者主目錄中的檔案是讓您的團隊成員提供未簽入存放庫的個人指令的便利方式。以前 CLAUDE.local.md 用於類似目的,但現已棄用,改為使用匯入,因為它們在多個 git worktrees 中效果更好。
# Individual Preferences
- @~/.claude/my-project-instructions.md
為了避免潛在的衝突,匯入不會在 markdown 程式碼跨度和程式碼區塊內進行評估。
This code span will not be treated as an import: `@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 讀取這些子樹中的檔案時才包含。

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

新增記憶體的最快方式是以 # 字元開始您的輸入:
# Always use descriptive variable names
系統會提示您選擇要將其儲存在哪個記憶體檔案中。

使用 /memory 直接編輯記憶體

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

設定專案記憶體

假設您想設定 CLAUDE.md 檔案來儲存重要的專案資訊、慣例和常用命令。專案記憶體可以儲存在 ./CLAUDE.md./.claude/CLAUDE.md 中。 使用以下命令為您的程式碼庫啟動 CLAUDE.md:
> /init 
提示:
  • 包含常用命令(build、test、lint)以避免重複搜尋
  • 記錄程式碼樣式偏好和命名慣例
  • 新增專案特定的重要架構模式
  • CLAUDE.md 記憶體可用於與團隊共享的指令和個人偏好。

組織級別記憶體管理

企業組織可以部署集中管理的 CLAUDE.md 檔案,適用於所有使用者。 要設定組織級別記憶體管理:
  1. 在適合您作業系統的位置建立企業記憶體檔案:
  • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux/WSL: /etc/claude-code/CLAUDE.md
  • Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
  1. 透過您的組態管理系統(MDM、群組原則、Ansible 等)部署,以確保在所有開發人員機器上一致分發。

記憶體最佳實踐

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