全局 CLAUDE.md 怎麼配:~/.claude/CLAUDE.md、用戶級規則、個人偏好和項目指令怎麼分工

想讓 Claude Code 在所有項目裏都遵守你的個人偏好,就配全局 CLAUDE.md。本文按官方文檔講清它放在哪(~/.claude/CLAUDE.md)、和項目 CLAUDE.md、CLAUDE.local.md、~/.claude/rules/ 的分工、加載順序、怎麼導入其他文件,以及什麼該寫進全局。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-13 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

  1. 全局 CLAUDE.md 就是用戶級指令文件,路徑是 ~/.claude/CLAUDE.md,官方的用途描述是「對所有項目生效的個人偏好」,只有你自己能看到。
  2. 它和項目 CLAUDE.md 是疊加關係,不是覆蓋。所有找到的文件會拼接進上下文,越靠近你啟動目錄的越後讀。
  3. 只寫個人偏好,不寫項目細節。 項目細節放項目裏的 CLAUDE.md,經版本控制給團隊共享。
  4. 文件變長就拆:個人規則可以拆到 ~/.claude/rules/ 下按主題分文件,同樣對所有項目生效。
  5. 項目裏的私人偏好用 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.mdIT 統一管理的組織級指令組織內所有用戶
用戶級(User)~/.claude/CLAUDE.md對所有項目生效的個人偏好只有你
項目級(Project)./CLAUDE.md 或 ./.claude/CLAUDE.md團隊共享的項目指令團隊,經版本控制
本地(Local)./CLAUDE.local.md當前項目裏的個人偏好,要加入 .gitignore只有你,當前項目

所以「全局 CLAUDE.md」對應的是用戶級這一行。官方表格寫得很清楚:項目指令會出現在用戶指令之後,所以同一件事上項目指令更靠後,更接近你的實際工作目錄。

二、怎麼建這個文件

按官方文檔:

  1. 在用戶目錄下的 .claude 文件夾裏新建 CLAUDE.md(官方寫作 ~/.claude/CLAUDE.md;Windows 上就是你的用戶文件夾裏的 .claude 文件夾);
  2. 用 markdown 寫,用標題和列表分組;
  3. 用 /memory 確認:官方說該命令會列出你的 CLAUDE.md、CLAUDE.local.md 等位置,包括還不存在的用戶和項目級文件,選中不存在的會先創建再打開;
  4. 新開會話驗證。

配置全局 CLAUDE.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 部署到系統目錄,對所有用戶生效,見上表第一行。

相關教學

參考資料

  • Claude Code 官方文檔:How Claude remembers your project — https://code.claude.com/docs/en/memory

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~