AI 寫程式記憶實用指南
CLAUDE.md 和 AI 記憶,該把內容放在哪裡?
需要指引整個專案或你的 Claude 對話時,寫進指示檔;Claude Code 可用自動記憶保存有用的 repo 學習。若希望支援且已連線的工具都能取用附有來源的私人筆記,再考慮 Cairn。個人層級的 CLAUDE.md 也能帶著偏好跨專案使用,所以跨專案本身不代表一定要用外部記憶服務。
先看範圍和用途
若一項規則要讓整個 repo 的團隊都看得到、一起維護,就放在專案指示檔。個人檔案 ~/.claude/CLAUDE.md 適合寫你自己的 Claude Code 偏好,能跨專案使用。組織管理的指示則可設定更廣的規範。Claude Code 在支援的 repo 設定中也會讀取 AGENTS.md;它與 CLAUDE.md 如何併用,請以目前的 Claude 文件為準。
這些檔案提供文字指示,作為 Claude 的脈絡使用,不是能從技術上鎖住操作的限制。
Claude Code 本身就有自動記憶
自動記憶會從修正與重複模式保存 Claude 寫下的心得,以 repo 為範圍,並在該 repo 的 worktree 間共用。只對單一 repo 的 Claude Code 有用時,它可能就夠了。
官方文件說記憶和指示檔都是脈絡,不是強制設定。會變動的專案事實仍應留在 repo 維護中的檔案,方便和程式碼一起檢查。
什麼時候適合另外用 Cairn Memory
Cairn 會保存附有來源收據的私人記憶。完成設定後,Claude Code 外掛可自動查詢與記下記憶;支援的 MCP 用戶端則可在連到預期帳號後,明確呼叫工具。實際行為依用戶端和連線設定而異。本機開源核心與託管介面不同,請以產品文件確認各工具提供的功能。
個人範圍會跟著 Cairn 帳號跨專案使用。專案範圍需要相同的不透明 project_id;Cairn 不會只憑資料夾名稱推定共用專案。來源收據能說明筆記從哪裡來,不能證明它現在仍正確。
實際選擇方式
1. 規則是給 repo 的貢獻者一起遵守
寫進該 repo 採用的專案指示檔,例如
CLAUDE.md或AGENTS.md,並隨程式碼一起審閱。2. 這是你在不同專案使用 Claude Code 時的偏好
放在個人層級的指示檔,例如
~/.claude/CLAUDE.md。你可以自行維護,不必因此多接一個服務。3. Claude 學到只對一個 repo 有用的細節
使用 Claude Code 自動記憶;要依賴技術事實前,先查看目前的專案檔案。
4. 你希望多個已連線工具都能取用附來源的私人筆記
每個支援的用戶端都連到預期帳號與範圍時,Cairn 可能適合。使用前先讀取回傳的記憶和收據。
合成範例
合成範例:某位開發者偏好大幅重構前先跑範圍明確的測試,兩個虛構 repo 則使用不同的執行環境版本。這項偏好可以放在開發者的個人層級 CLAUDE.md,供 Claude Code 跨專案使用;各 repo 的版本應留在自己的套件與 CI 檔案。如果也想讓另一個已連線的助理取用偏好,可以用附收據的 Cairn 私人記憶,但它不應取代任何 repo 的指示檔或版本設定。
使用前先知道
- 自動記憶與指示檔都是 Claude Code 的脈絡。個人層級檔案可以跨專案使用,Claude 自動記憶則依 repo 區分。
- 使用 Cairn 需要支援的設定與預期帳號。不同用戶端的 repo 名稱相同,不代表它們有共用專案範圍。
- 記憶和來源收據都不是目前專案的事實依據。請查看 repo;若現行規則不同,就明確重述現在的指示。