Bible Network Crypto DeFi Onchain RWA AI Agent Stablecoin Chain SAFU CryptoTax DeFAI AGI Claude Me Claude Skill Claude Design Claude Cowork
獨立知識媒體
與任何項目無關聯
學會用 Claude,每件事都做得更好
claudeskill-me.com
最新
用 OpenTelemetry 看 Claude Code 的壓縮與 hook:compaction、hook_execution_complete 與 precompute_reuse 欄位怎麼讀  ·  Bash 權限規則的盲區:deny 擋不住 /bin/rm、bash -c 與 git -C,devbox run * 還會放行內層任何命令  ·  CLAUDE.md 太長了怎麼辦:用 .claude/rules/ 與 paths 讓規則只在碰到特定檔案時才載入  ·  沙盒裡跑 Chromium 出現 No usable sandbox!:--no-sandbox、excludedCommands、allowNestedUserNamespaces 三種解法各放棄什麼  ·  Claude Code v2.1.309:沙盒啟動檔不再在沙盒外執行、denyWrite 經 symlink 失效等一批沙盒與權限缺口修正  ·  auto mode 的 $defaults 陷阱:autoMode.soft_deny 少放一個字串,內建的 force push 攔截規則就整批消失
名詞解析 · workflow

.claude/rules Directory

.claude/rules(規則目錄)
workflow beginner

30 秒版 · 給沒耐心的人
放在 .claude/rules/ 的多個 Markdown 規則檔;沒有 paths 的啟動時載入,用 paths frontmatter 限定的只在 Claude 碰到符合檔案時才載入,用來取代越寫越長的單一 CLAUDE.md。
完整解說 +
01 · 這是什麼?

.claude/rules 是什麼?

依官方記憶文件,它是專案裡的 .claude/rules/ 目錄,每個 .md 檔案涵蓋一個主題(例如 testing.md、api-design.md),會被遞迴發現,所以可以分子目錄。個人版放在 ~/.claude/rules/,對你機器上所有專案適用。

02 · 為什麼存在?

為什麼存在?

官方建議單一 CLAUDE.md 約 200 行以內,更長會耗用 context 並降低遵守度。拆成多個規則檔讓團隊容易維護,而路徑限定讓只和部分程式碼有關的規則,不必每個 session 都佔用 context。

03 · 如何影響你的決策?

怎麼運作?

沒有 paths 的規則啟動時載入,優先順序同 .claude/CLAUDE.md。有 paths(YAML 清單或逗號分隔字串,內容是 glob)的規則,在 Claude 用 Read、Write、Edit 或算作讀取的 Bash 指令(如對單一檔案 cat、head)碰到符合檔案時才載入。paths 是唯一會被讀的 frontmatter 欄位,載入前 frontmatter 會被拿掉。

04 · 你該怎麼辦?

對我有什麼影響?

要小心三件事:frontmatter 的 YAML 解析失敗時,規則會被當成沒有 paths 而無條件載入(用 claude --debug 看錯誤);glob 裡的 [ 要寫成 [;指向工作目錄外的 symlink 需要先核准外部匯入,且之後只有沒 paths 的規則會載入。

資料來源:How Claude remembers your project - Claude Code Docs
實際例子 +

官方文件的例子:paths: ["src/api/**/*.ts"] 的規則檔,內容是「所有 API 端點都要驗證輸入、使用標準錯誤格式、加上 OpenAPI 註解」,只有 Claude 碰到 src/api 下的 TypeScript 檔案時才進入 context。

常見誤解 +
✕ 誤解1
× 誤解:frontmatter 寫壞了規則就不會載入,實際是:解析失敗時會被當成沒有 paths,反而每個 session 都載入
✕ 誤解2
× 誤解:rules 可以放任何 frontmatter 欄位,實際是:Claude Code 只讀 paths,其他欄位被忽略而且不報錯
這件事跟你有什麼關係 +
直接影響

優點是規則模組化、只在相關時佔用 context;缺點是多了一種載入時機要追蹤,YAML 寫壞會無聲變成無條件載入。

提問
請至少輸入 10 個字
更多相關主題