每次跟 Claude Code 對話都像在跟失憶症患者溝通嗎？明明上一輪已經解釋過專案架構，下次又要重新說明一遍你的程式碼風格偏好？CLAUDE.md 就是解決這個痛點的重要檔案，它讓你的 AI 寫程式夥伴真正「記住」你的需求和習慣。
你已經用過 CLAUDE.md 了？那推薦你直接閱讀 10 個 CLAUDE.md 進階實戰技巧
什麼是 CLAUDE.md？#
當你剛雇用了一位新的程式設計師，為了讓他快速融入團隊，你會給他什麼？當然是一份詳細的工作守則！告訴他這個專案的架構、我們的程式碼風格、常用的指令與工具，更重要的是，那些「千萬不要踩的坑」。
CLAUDE.md 正是給 Claude Code 的工作守則。這個特殊的 Markdown 檔案會在每次啟動 Claude Code 時自動載入，提供持續存在的上下文記憶，讓 AI 知道：
「在這個專案裡，我們是這樣做事的」
CLAUDE.md 就像 Gemini 的 Gem （或是 Claude 的 Project、ChatGPT 的 Custom GPT）一樣，是個儲存上下文和先備知識的地方。更具體來說，CLAUDE.md 擔綱這些關鍵角色：
- 工作流程的指南：記錄如何執行特定任務的詳細步驟
- 實踐提示詞工程：展示什麼該做、什麼不該做的具體範例
- 錯誤記錄簿：所有犯過的錯誤都該立刻記在這，確保 Claude Code 不會重蹈覆轍
- 你的「耳提面命」：只要是你常對 Claude Code 說的話、都可以考慮加入這個檔案，因為這些檔案會自動成為 Claude 提示詞的一部分
CLAUDE.md 的情境正是這句周杰倫的歌詞：「將不該犯的錯都默背好」
（圖片來源：杰威爾音樂）
個人工商時間：歡迎訂閱我的每週電子報，我將會分享資料科學跟 AI 工具，也寫下我正在看什麼、學什麼，想到什麼就寫，讓我們透過 Email 聊聊吧！
為什麼 CLAUDE.md 如此重要？#
告別重複解釋的無限循環#
你是否厭倦了每次開啟 Claude Code 都要重新說明：「記住，我們用 Python 3，遵循 PEP 8 標準，測試框架是 pytest …」？CLAUDE.md 讓你一次設定、終身受用。再也不用每次對話都重講規則、從頭開始建立脈絡。
範例：資料科學團隊設定了統一的 CLAUDE.md，包含資料處理的標準流程和視覺化偏好，例如要求實作 pandas 的 pipeline 並用 matplotlib 畫圖。結果讓整個團隊的程式碼一致性大提升，新成員的上手時間從兩週縮短到三天。
確保一致的程式碼品質和標準#
沒有 CLAUDE.md 的 Claude Code 就像沒有固定風格的設計師，每次產出的結果都可能差很多。如果程式碼風格太跳 tone，你每次看 AI 產出的新程式碼，就需要花費更多時間才能理解。
在 CLAUDE.md 加入明確的指示，Claude Code 將始終遵循你設定的程式碼風格、軟體架構決策、和最佳實務做法，大幅減少程式碼審查時的來回修改。
打造真正個人化的 AI 助手體驗#
CLAUDE.md 不只是技術設定，更是讓 Claude Code 學會你獨特工作風格的關鍵。無論是你偏好的錯誤處理方式、註解風格、還是專案組織邏輯，Claude 都能完美配合你的節奏。
怎麼做？一分鐘上手 CLAUDE.md#
馬上就來體驗 CLAUDE.md 的魔力！打開 Claude Code 後，只需要記得兩個指令就能暢快使用 CLAUDE.md：
/init：創造一個新的CLAUDE.md#：更新記憶，在CLAUDE.md加入新的指令。語法跟程式註解很像
最簡單的例子就是讓預設英文的 Claude Code 改說繁體中文：
- 打開 Claude Code
- 輸入：
# 請總是用繁體中文回覆 - 當選項出現時，選擇更新到
~/.claude/CLAUDE.md（下個段落會介紹）
就這麼簡單！從現在開始，Claude Code 會自動用繁體中文與你對話，每次重新打開 Claude Code 都是如此。從這個例子我們看出，CLAUDE.md 的個人化設定功能是多麼重要且好用，一次設定就能改變所有後續互動的體驗。
三種 CLAUDE.md 記憶類型#
CLAUDE.md 有三種不同的記憶類型，理解它們的差異能幫你更有效地組織 AI 助手的知識庫。讓我用生活化的比喻來介紹：
| 記憶類型 | 生活比喻 | 適用情境 | 實際範例 |
|---|---|---|---|
個人記憶~/.claude/CLAUDE.md | 你的個人習慣 （走到哪帶到哪） | 這台電腦上所有專案都適用的偏好 | 總是用繁體中文、偏好的縮排方式 |
專案記憶./CLAUDE.md | 這個家的家規 （所有家人都要遵守） | 團隊協作、專案特定需求 | React 程式碼風格、API 架構規範 |
本地專案記憶./CLAUDE.local.md | 你的私人小抽屜 （只有你自己知道的秘密） | 個人專用、不想與人分享的設定 | 測試環境網址、個人開發偏好 |
特別值得補充的是 CLAUDE.local.md，裡面放著只有你需要知道的資訊，這個檔案不會被提交到版本控制系統（透過 .gitignore），非常適合存放還在嘗試、不確定是否要分享給團隊的設定，或是只屬於你個人的開發習慣。
舉個實際例子：在團隊專案中，大家都遵循 ./CLAUDE.md 的共同規範，但你個人偏好在開發時使用更詳細的除錯資訊，就可以在 CLAUDE.local.md 中設定「除錯時總是顯示完整的錯誤堆疊」，而不影響其他團隊成員的體驗。
提醒：雖然我個人認為 CLAUDE.local.md 很實用，但這個功能在官方文件中已經被標記為已棄用，官方建議改用在主要 CLAUDE.md 中引用未追蹤檔案的方式（imports）來達到相同效果。
結語#
理解了 CLAUDE.md 的概念和價值後，你可能迫不及待想要動手建立自己的 AI 記憶庫了。我在 下一篇文章 帶你深入實戰操作：
- 常見的設定範例和實用模板
- 進階技巧，例如使用
@語法引用其他檔案 - 團隊協作的最佳實務和避坑指南
推薦你繼續閱讀這 10 個 CLAUDE.md 進階技巧。
如果你還不熟悉 Claude Code 的基本操作，建議先閱讀我的前一篇文章 Claude Code 入門指南，了解這個超讚 AI 寫程式工具的基礎使用方法。
準備好讓你的 Claude Code 變得更聰明、更貼心了嗎？現在就開始習慣狂敲 # 指令，讓你的開發更省時省力吧。
如果這篇文章有幫助到你，歡迎追蹤好豪的 Facebook 粉絲專頁 或是 Threads 帳號，我會分享更多 Claude Code 學習心得。
參考資料：
- 官方文件：Manage Claude’s memory
- 官方線上課程：Claude Code in Action