內容來源:根據 Bilibili 課程第五集影片畫面筆記整理。本篇只對應第五集,不代表整套付費課程。

第五集主題:讓 Claude Code 記住專案規範

第五集進入 Claude Code 的記憶系統(Memory System),焦點是 CLAUDE.md 的運作方式。它將原本每次會話都要重複交代的背景、規範與限制,整理為專案可持續讀取的標準檔案。

要解決的痛點:新會話的上下文遺忘

大型語言模型不會自然保留不同會話之間的專案規則。例如第一次要求使用駝峰式命名(CamelCase),下一次開啟新會話時,模型可能改用蛇形命名(snake_case),造成程式碼風格不一致。

把命名規則、架構背景與開發限制寫入 CLAUDE.md 後,Claude Code 在該專案啟動會話時會讀取這些指示,減少反覆提供背景 Prompt 的需要,並讓產出更貼近團隊標準。

檔名必須精確

影片特別強調檔案名稱要使用精確的 CLAUDE.md,並留意大小寫。不要任意改為 claude.mdCLAUDE.MD 或其他名稱,以免行為與預期不一致。

分層記憶設計

課程提到 Claude Code 使用分層記憶架構,讓規則可以同時具備全域通用性、專案精確性及本地暫時性。根據本集提供的畫面筆記,以下全域層設定是明確列出的內容。

第 1 層:全域設定檔

/etc/claude-code/CLAUDE.md

  • 作用域:全系統、所有使用者與所有專案。
  • 適用內容:公司共用的程式碼規範、安全開發基準(Security Baselines)、禁止 AI 執行的系統命令,以及統一的錯誤處理方式。
  • 使用原則:只放真正適用於所有專案的規則;專案特有的架構與業務要求,應放在更精確的專案層設定中。

注意:影片筆記提及「五層記憶體系」,但本集提供的內容只具體展示了上述全域層;其餘層級會待後續集數的明確內容再補充,避免把未驗證的設定路徑或優先級當成事實。

把 Prompt 工程化

CLAUDE.md 的核心價值,是把零散的 Prompt 轉為可版本控制、可審查、可在團隊內共享的工程資產。團隊可以把架構規範、安全要求、測試策略、命名規則及必要的業務背景寫成文件,讓 Claude Code 在工作開始時取得一致的上下文。

實務建議

  1. 先從少量、可驗證的規則開始,例如命名風格、測試命令與禁止修改的路徑。
  2. CLAUDE.md 納入版本控制,讓規則變更可審查與追溯。
  3. 把全公司通用規則與專案專屬規則分開,避免全域設定過度限制個別專案。
  4. 不要把 API Key、Token、密碼或私人資料寫入記憶檔。
  5. 即使已有記憶設定,仍應審查 AI 產生的變更並執行測試。

本集總結

第五集將 Claude Code 的「記憶」從一次性對話拉回工程流程:透過精確命名的 CLAUDE.md 與分層設定,團隊可以讓 AI 在每次開始工作時取得一致的規範與背景。這有助減少上下文遺忘與風格漂移,但前提是規則本身要清楚、可維護,且不包含敏感資料。

來源

Bilibili 課程第五集|Claude+Harness 企業級工程實戰|第五集「【基础】记忆系统(1)」。