為什麼 AI 每次都需要你重新介紹你的專案？
你是否有過這樣的經驗：好不容易和 AI 建立了默契，描述清楚了你的專案架構、命名慣例、測試規範，結果下一個對話又要從頭說起？這不是 AI 的智力問題，而是「記憶設計」問題。
Claude Code 針對這個痛點推出了兩個關鍵機制：CLAUDE.md 檔案與自動記憶（Auto-Memory）。這兩個工具加在一起，能讓 AI 在每次開啟工作階段時，就像一位已經熟悉你整個專案的資深工程師。
什麼是 CLAUDE.md？
CLAUDE.md 是一個你手動建立、放在專案根目錄的 Markdown 檔案。每次 Claude Code 啟動新工作階段時，它都會自動讀取這個檔案作為「背景知識」。
這個設計的關鍵在於：它是持久的、可版本控制的、可與團隊共享的。你只需要寫一次，之後每次互動都帶著這份知識進來。
CLAUDE.md 可以放什麼內容？
根據官方文件（code.claude.com/docs/zh-TW/overview），以下是最具實際價值的幾類內容：
1. 編碼標準與規範
例如：「本專案使用 TypeScript strict mode，所有函式必須有型別標注；禁止使用 any 型別。」這類規範一旦寫入，AI 就會在每次生成程式碼時自動遵守，省去你反覆提醒的時間。
2. 架構決策與技術選型
「我們使用 Next.js App Router，不使用 Pages Router；狀態管理選用 Zustand，不使用 Redux。」讓 AI 了解為什麼你做了這些選擇，它就不會建議你改用其他方案。
3. 常用指令與建置流程
列出 npm run dev、npm run test、docker-compose up 等指令，以及它們各自的用途。這樣 AI 在幫你執行任務時就能直接使用正確的指令。
4. 審查清單與品質標準
「每次提交前必須確認：單元測試通過、ESLint 無錯誤、有更新 CHANGELOG.md。」把這類流程寫成清單，AI 就會在完成任務時自動幫你確認。
5. 首選函式庫與禁用函式庫
「HTTP 請求使用 axios，不使用 fetch；CSS 使用 Tailwind，不使用 styled-components。」避免 AI 使用你不熟悉或已棄用的依賴。
自動記憶：讓 AI 主動學習你的習慣
除了 CLAUDE.md 之外，Claude Code 還有另一個更聰明的機制：自動記憶（Auto-Memory）。
當 Claude Code 在工作過程中發現值得記住的事情，例如一個反覆使用的建置指令、一個除錯時發現的特殊環境限制、或是你偏好的程式碼組織方式，它會主動將這些內容儲存起來，在未來的工作階段中繼續使用。
這個機制的意義在於：你不需要親自寫所有規則，AI 會在合作過程中逐漸「認識」你。就像一個新人工程師，剛開始需要你說明，但幾個月後他已經內化了你的工作方式。
CLAUDE.md 的最佳實踐建議
保持簡潔、有重點：不要把 CLAUDE.md 寫成一本書。重點放在那些「如果 AI 不知道這件事，他一定會做錯」的資訊。
用具體指令而非抽象原則：「程式碼要寫得清楚易懂」這類話沒有用。「函式長度不超過 50 行，複雜邏輯必須加上行內註解」才有用。
加入專案特有的注意事項：比如「資料庫欄位命名使用 snake_case，前端變數使用 camelCase」這類只有你的專案才有的規則，最值得寫入。
與團隊共享：把 CLAUDE.md 加進版本控制（git）裡，讓整個團隊都能受益。每個人使用 Claude Code 時都會得到一致的行為。
小結：讓 AI 成為真正的長期夥伴
CLAUDE.md 和自動記憶機制，解決的不只是便利性問題，更是一致性問題。當你的 AI 助手每次都能帶著完整的專案知識開始工作，你才能真正把它當作團隊成員，而不是一個每次都要重新簡報的臨時工。
想深入了解 Claude Code 的完整功能，可參考官方文件：code.claude.com/docs/zh-TW/overview