Claude 如何記住您的專案

• CLAUDE.md 檔案：您撰寫的指示，為 Claude 提供持久內容。Claude 也可以讀取儲存庫的 AGENTS.md 檔案，單獨使用或與 CLAUDE.md 一起使用
• 自動記憶：Claude 根據您的更正和偏好自己撰寫的筆記

• 撰寫和組織 CLAUDE.md 檔案
• 使用現有的 AGENTS.md 作為您的專案指示，單獨使用或與 CLAUDE.md 一起使用
• 使用 .claude/rules/ 將規則範圍限定於特定檔案類型
• 設定自動記憶，讓 Claude 自動記筆記
• 疑難排解當指示未被遵循時

​

CLAUDE.md 與自動記憶

​

CLAUDE.md 檔案

​

何時新增至 CLAUDE.md

• Claude 第二次犯同樣的錯誤
• 程式碼審查發現 Claude 應該知道的關於此程式碼庫的事項
• 您在聊天中輸入的相同更正或澄清是您上一個工作階段輸入的
• 新的團隊成員需要相同的背景資訊才能提高生產力

​

選擇 CLAUDE.md 檔案的放置位置

​

設定專案 CLAUDE.md

​

撰寫有效的指令

• 「使用 2 空格縮排」而不是「正確格式化程式碼」
• 「在提交前執行 npm test」而不是「測試您的變更」
• 「API 處理程式位於 src/api/handlers/」而不是「保持檔案組織」

​

匯入其他檔案

See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md

# Individual Preferences
- @~/.claude/my-project-instructions.md

​

CLAUDE.md 檔案如何載入

​

從其他目錄載入

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

​

使用 .claude/rules/ 組織規則

​

設定規則

your-project/
├── .claude/
│   ├── CLAUDE.md           # Main project instructions
│   └── rules/
│       ├── code-style.md   # Code style guidelines
│       ├── testing.md      # Testing conventions
│       └── security.md     # Security requirements

​

路徑特定規則

---
paths:
  - "src/api/**/*.ts"
---

# API Development Rules

- All API endpoints must include input validation
- Use the standard error response format
- Include OpenAPI documentation comments

---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

​

規則 frontmatter 參考

​

使用符號連結在專案間共享規則

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

​

使用者級規則

~/.claude/rules/
├── preferences.md    # Your personal coding preferences
└── workflows.md      # Your preferred workflows

​

為大型團隊管理 CLAUDE.md

​

部署組織範圍 CLAUDE.md

{
  "claudeMd": "Always run `make lint` before committing.\nNever push directly to main."
}

​

排除特定 CLAUDE.md 檔案

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

​

AGENTS.md

​

Claude Code 何時讀取 AGENTS.md

• 計入，因此 Claude 改為讀取它們而不是 AGENTS.md：您的工作目錄或其上方任何目錄中的 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md
• 不計入，並繼續與 AGENTS.md 一起載入：您的 ~/.claude/CLAUDE.md、您組織的受管 CLAUDE.md 和 .claude/rules/ 檔案

• 在工作階段開始時：您的工作目錄及其上方目錄中的每個 AGENTS.md 和 .claude/AGENTS.md。在互動式工作階段中，您會在對話中看到類似 no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md 的行
• 當 Claude 在子目錄中工作時：當 Claude 使用 Read 工具在該處開啟檔案且該子目錄沒有三個 CLAUDE.md 檔案之一時，子目錄的 AGENTS.md
• 在每個 AGENTS.md 內：@path 匯入會展開，claudeMdExcludes 模式適用，跳過專案指示的子代理也會跳過這些檔案
• 不讀取：AGENTS.local.md、AGENTS.override.md 或 .agents/ 目錄下的任何內容

​

選擇要載入的指示檔案

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

​

當 AGENTS.md 支援不可用時

• 您使用的是 v2.1.277 之前的 Claude Code 版本
• 您停用了內建 agents-md 外掛程式在 /plugin 中
• 在某些情況下，這是您從 v2.1.276 或更早版本升級後的第一個工作階段。Claude 會從您的下一個工作階段開始讀取 AGENTS.md

​

AGENTS.md 與 CLAUDE.md 的差異

​

移除較早的 AGENTS.md 因應措施

• 包含 @AGENTS.md 的 CLAUDE.md：您可以保留它。保留匯入永遠不會讓 Claude 讀取 AGENTS.md 兩次，無論您使用哪個專案指示值。如果檔案不包含其他內容，請移除 CLAUDE.md，或如果您的某些工作階段無法直接載入 AGENTS.md，請保留它。
• 告訴 Claude 用文字讀取 AGENTS.md 的 CLAUDE.md：Claude 只有在決定開啟檔案時才會看到 AGENTS.md。刪除 CLAUDE.md 以便 Claude 直接讀取 AGENTS.md，或用 @AGENTS.md 匯入取代該句子。
• 符號連結到 AGENTS.md 的 CLAUDE.md：無，或刪除符號連結。無論哪種方式，Claude 都會讀取內容一次。
• 列印 AGENTS.md 的 SessionStart hook：移除它。一旦 Claude 直接讀取 AGENTS.md，hook 會將第二份副本新增到內容中。

​

與其他編碼工具共享一個檔案

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

ln -s AGENTS.md CLAUDE.md

• 編輯：Claude 通過連結讀取 CLAUDE.md，但 Edit 和 Write 工具拒絕通過符號連結寫入，拒絕會指示 Claude 改為編輯連結的目標 AGENTS.md
• Windows：如果您或任何複製儲存庫的人在 Windows 上工作，請改用 @AGENTS.md 匯入。在那裡建立符號連結需要系統管理員權限或開發人員模式，Git 會將已提交的符號連結簽出為純文字檔案，除非啟用 core.symlinks，這會使該複製具有一行 CLAUDE.md 代替您的指示

​

從其他工具遷移指示

• .cursor/rules/ 或 .cursorrules 中的 Cursor 規則
• .github/copilot-instructions.md 中的 Copilot 規則
• 設定 CLAUDE_CODE_NEW_INIT=1 時：AGENTS.md、.devin/rules/、.windsurf/rules/ 或 .windsurfrules，以及 .clinerules

​

自動記憶

• user：您的角色、專業知識和工作偏好
• feedback：您給 Claude 的更正和您確認的方法
• project：進行中的工作、截止日期和 Claude 無法從程式碼或 git 歷史記錄推導的決策
• reference：在專案外尋找資訊的位置，例如問題追蹤器或儀表板

​

啟用或停用自動記憶

{
  "autoMemoryEnabled": false
}

​

儲存位置

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

~/.claude/projects/<project>/memory/
├── MEMORY.md           # 索引，每個記憶一行，載入到每個工作階段
├── user_role.md        # 一個記憶
├── feedback_testing.md # 一個記憶
└── ...                 # Claude 建立的任何其他主題檔案

​

它如何運作

​

審計和編輯您的記憶

​

使用 /memory 檢視和編輯

​

疑難排解記憶問題

​

Claude 不遵循我的 CLAUDE.md

• 執行 /context 並檢查 Memory files 下的清單，以驗證您的 CLAUDE.md 和 CLAUDE.local.md 檔案是否已載入。如果 CLAUDE.md 檔案未列出，Claude 看不到它。使用 /memory 開啟和編輯檔案。
• 檢查相關的 CLAUDE.md 是否位於為您的工作階段載入的位置（請參閱 選擇 CLAUDE.md 檔案的位置）。
• 使指令更具體。「使用 2 空格縮排」比「正確格式化程式碼」效果更好。
• 查找跨 CLAUDE.md 檔案的衝突指令。如果兩個檔案為相同行為提供不同的指導，Claude 可能會任意選擇一個。

​

我的 AGENTS.md 未載入

1. 在您的工作目錄或其上方的任何目錄中查找 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md，除了您的 ~/.claude/CLAUDE.md。如果您找到一個，Claude 會讀取它而不是 AGENTS.md，除非您將 Project instructions 設定為 claude-md-and-agents-md。
2. 執行 claude --version 並確認 v2.1.277 或更新版本。在 v2.1.281 之前，某些工作階段（例如 Amazon Bedrock 上的工作階段或停用遙測的工作階段）無法載入 AGENTS.md，因此在這些版本上更新至 v2.1.281 或更新版本。
3. 在您的工作階段中輸入 /config 以開啟設定面板，並確認 Project instructions 未設定為 claude-md 或 managed-only。如果您根本看不到該設定，您的工作階段是 無法載入 AGENTS.md 的工作階段。

​

我不知道自動記憶保存了什麼

​

我的 CLAUDE.md 太大了

​

指令在 /compact 後似乎丟失了

​

相關資源

• 除錯您的配置：診斷為什麼 CLAUDE.md 或設定未生效
• Skills：封裝按需載入的可重複工作流程
• 設定：使用設定檔案配置 Claude Code 行為
• Subagent 記憶：讓 subagents 維護自己的自動記憶