結論先說
- 全局 CLAUDE.md 就是用戶級指令文件,路徑是
~/.claude/CLAUDE.md,官方的用途描述是「對所有項目生效的個人偏好」,只有你自己能看到。 - 它和項目 CLAUDE.md 是疊加關係,不是覆蓋。所有找到的文件會拼接進上下文,越靠近你啟動目錄的越後讀。
- 只寫個人偏好,不寫項目細節。 項目細節放項目裏的 CLAUDE.md,經版本控制給團隊共享。
- 文件變長就拆:個人規則可以拆到
~/.claude/rules/下按主題分文件,同樣對所有項目生效。 - 項目裏的私人偏好用
CLAUDE.local.md,並加入.gitignore。

圖:本站根據 Claude Code 官方文檔:How Claude remembers your project 整理的示意圖
本文根據 Claude Code 官方文檔《How Claude remembers your project》整理,資料核對於 2026-11-13。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 搜「全局 claude md 配置」的人;
- 每個項目都要重複告訴 Claude 同樣偏好(比如回答風格、提交習慣)的人;
- 想弄清全局、項目、個人幾種指令文件各管什麼的人。
一、幾種指令文件的分工
官方表格按加載順序從最寬的範圍排到最具體的:
| 範圍 | 位置 | 用途 | 誰能看到 |
|---|---|---|---|
| 組織級(Managed policy) | macOS:/Library/Application Support/ClaudeCode/CLAUDE.md;Linux 和 WSL:/etc/claude-code/CLAUDE.md;Windows:C:\Program Files\ClaudeCode\CLAUDE.md | IT 統一管理的組織級指令 | 組織內所有用戶 |
| 用戶級(User) | ~/.claude/CLAUDE.md | 對所有項目生效的個人偏好 | 只有你 |
| 項目級(Project) | ./CLAUDE.md 或 ./.claude/CLAUDE.md | 團隊共享的項目指令 | 團隊,經版本控制 |
| 本地(Local) | ./CLAUDE.local.md | 當前項目裏的個人偏好,要加入 .gitignore | 只有你,當前項目 |
所以「全局 CLAUDE.md」對應的是用戶級這一行。官方表格寫得很清楚:項目指令會出現在用戶指令之後,所以同一件事上項目指令更靠後,更接近你的實際工作目錄。
二、怎麼建這個文件
按官方文檔:
- 在用戶目錄下的
.claude文件夾裏新建CLAUDE.md(官方寫作~/.claude/CLAUDE.md;Windows 上就是你的用戶文件夾裏的.claude文件夾); - 用 markdown 寫,用標題和列表分組;
- 用
/memory確認:官方說該命令會列出你的 CLAUDE.md、CLAUDE.local.md 等位置,包括還不存在的用戶和項目級文件,選中不存在的會先創建再打開; - 新開會話驗證。

圖:本站根據 Claude Code 官方文檔:How Claude remembers your project 整理的示意圖
三、全局裏該寫什麼
官方對用戶級文件的舉例是「代碼風格偏好、個人工具快捷方式」。按官方寫作原則推斷,適合放全局的是:
- 你和 Claude 的協作方式:先給計劃再動手、不確定時先問;
- 你固定的代碼風格偏好:比如縮進、命名習慣;
- 你的常用工具:習慣用哪個包管理器、哪個編輯器的約定;
- 回答格式偏好:先給結論、再給細節。
不適合放全局的:某個項目的構建命令、目錄結構、業務口徑。這些放項目 CLAUDE.md,換了項目就不會誤用。
寫法依舊是官方的原則:具體到可驗證,不要「好好寫代碼」這類口號,每個文件盡量不超過 200 行,互相矛盾的刪掉。語言用中文還是英文,見 /guides/claude-md-chinese-or-english。
四、拆分:用戶級規則目錄
個人規則多了,可以放進 ~/.claude/rules/。官方說:這裏的個人規則對你機器上的每個項目生效,適合不屬於某個項目的偏好,目錄結構比如:
text
~/.claude/rules/
├── preferences.md # 個人編碼偏好
└── workflows.md # 偏好的工作流
官方還說,所有 .md 文件都會被遞歸發現,沒有 paths 前置字段的規則在啟動時載入,優先級與 .claude/CLAUDE.md 相同。帶 paths 的規則則只在處理匹配文件時才載入,用法見 /guides/claude-code-large-repo-focus-directories。
五、導入其他文件
CLAUDE.md 裏可以用 @路徑 導入別的文件,被導入的文件會和引用它的 CLAUDE.md 一起載入。官方示例裏有這樣一行,從用戶目錄導入:
text
# Individual Preferences
- @~/.claude/my-project-instructions.md
要點:
- 相對路徑相對於包含這條導入的文件,不是工作目錄;
- 可以遞歸導入,最多四層;
- 路徑含空格要在空格前加反斜槓;
- 代碼塊和行內代碼裏的
@不會被當成導入; - 官方提醒:導入只是幫你整理長文件,不會減少上下文佔用,因為被導入的文件會一起載入。
對於項目級文件裏指向工作目錄之外的導入,Claude Code 第一次遇到會彈出批准對話框;官方寫明用戶級的記憶文件(如 ~/.claude/CLAUDE.md)不受這個對話框的保護邏輯約束,因為它們是你自己的。
六、加載順序與疊加
官方說明:Claude Code 從當前工作目錄和它上面的每一級目錄加載 CLAUDE.md 和 CLAUDE.local.md,所有找到的文件拼接進上下文,而不是互相覆蓋,順序是從文件系統根目錄一路到你的工作目錄,所以離你啟動位置越近的越後讀。每個目錄裏 CLAUDE.local.md 排在 CLAUDE.md 之後。子目錄裏的文件在 Claude 訪問那裏時再按需載入。
這就是為什麼全局指令和項目指令衝突時,要自己檢查:兩條矛盾的指令,Claude 可能隨便選一個。
七、幾個常見疑問
- 要不要把全局文件放進 git? 它在你的用戶目錄,不在倉庫裏,本來就不會被提交。想備份,可以自己放到私有倉庫管理;
- 全局文件會不會拖慢每次會話? 它每次都完整載入,越長佔用的上下文越多,所以保持精簡;
- 想讓某個項目不受全局文件影響? 官方有
claudeMdExcludes之類的排除設定,具體用法見 /guides/claude-code-large-repo-focus-directories; - 額度不夠? 訂閱登入的用量和重置,見 /chongzhi/claude-code 裏關於 Claude Code 訂閱的說明,以官方頁面為準。
常見問題
Q:全局 CLAUDE.md 和 settings.json 有什麼區別?
CLAUDE.md 是寫給 Claude 讀的指令,settings.json 是配置項,比如權限、環境變量。後者見 /guides/claude-code-settings-json。
Q:我在不同機器上怎麼保持一致?
官方說用戶級的記憶文件只在本機。需要同步,要自己管理這個文件。
Q:團隊想統一全局規則怎麼辦?
官方有組織級的 CLAUDE.md,由 IT 部署到系統目錄,對所有用戶生效,見上表第一行。
相關教學
- /guides/claude-md-auto-update-how-to-update:CLAUDE.md 會自動更新嗎
- /guides/claude-md-agents-md:CLAUDE.md 與 AGENTS.md
參考資料
- Claude Code 官方文檔:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 條評論
還沒有評論,來搶沙發~