CLAUDE.md 是什麼？如果你用 Claude Code 每次開新工作都要重新交代「回答用繁體中文」「這個資料夾不要動」「檔名要用日期開頭」，CLAUDE.md 就是解決這件事的檔案。這篇用不寫程式也看得懂的方式，整理 CLAUDE.md 放在哪、該寫什麼、3 份可以直接改的範例，以及寫了沒效時怎麼檢查。資料以 Claude Code 官方文件為準，更新至 2026 年 10 月。
CLAUDE.md 是什麼？
CLAUDE.md 是一份用 Markdown 寫的文字檔，Claude Code 每次開始工作時會自動讀取，讓 Claude 帶著你交代過的規則、專案背景和偏好上工。Markdown 是一種很簡單的文字格式，用 # 當標題、用 – 當清單，用記事本就能寫。
你可以把它想成新同事到職第一天拿到的工作守則。Claude Code 每次開新的工作階段，都像一個記性很好、但對你的專案一無所知的新同事；CLAUDE.md 就是你預先寫好、它每天上班都會先翻一遍的那本守則。依 Claude Code 官方記憶說明，CLAUDE.md 適合放每次工作都該知道的事：常用指令、慣例、資料夾結構，以及「一律要這樣做」的規則。
要先知道一件事：CLAUDE.md 是給 Claude 參考的背景資料，不是強制設定。官方文件寫得很直接，指令寫得越具體、越精簡，Claude 遵守得越一致。真的不能讓它做的事，例如刪除某些檔案，要用權限設定或 Hooks（在特定動作前後自動執行的檢查機制）來擋。
CLAUDE.md 和一般對話的指示有什麼不同？
在 claude.ai 網頁版，你可以在設定裡寫「給 Claude 的指示」，或在 Project 裡放專案指示。CLAUDE.md 是 Claude Code 的版本，差別在它是一個實際存在你電腦裡的檔案：可以依資料夾分層、可以跟著專案一起備份，也可以讓團隊成員共用同一份規則。反過來說，如果你只用網頁版或手機 App 聊天，用「給 Claude 的指示」和 Project 指示就夠了，不需要另外建 CLAUDE.md。
CLAUDE.md 放在哪？4 個層級
CLAUDE.md 不只一份，依放的位置分成 4 個層級，範圍從大到小，Claude Code 會把找到的全部讀進來。
| 層級與位置 | 適合放什麼 | 誰會讀到 |
|---|---|---|
| 組織層（由公司 IT 統一部署） | 全公司的資安規範、合規要求 | 組織內所有人 |
個人層：~/.claude/CLAUDE.md | 你個人到哪個專案都適用的偏好，例如回答語言 | 依本機權限與同步設定而定 |
專案層：專案根目錄的 ./CLAUDE.md 或 ./.claude/CLAUDE.md | 這個專案的結構、慣例、常用指令 | 所有能存取該專案的人 |
本機層：專案根目錄的 ./CLAUDE.local.md | 只屬於你的專案設定，例如本機測試網址 | 請用 .gitignore 避免提交；實際可見性仍取決於本機權限與同步設定 |
路徑裡的 ~ 代表你電腦的使用者資料夾。個人層的檔案放在使用者資料夾底下一個叫 .claude 的隱藏資料夾裡。CLAUDE.local.md 是放個人設定用的，如果專案有用 Git 做版本控制，記得把它加進 .gitignore，不要上傳給別人。
個人層和本機層有什麼不同？
個人層的 ~/.claude/CLAUDE.md 對你所有專案都有效，適合放「回答用繁體中文」這種到哪都成立的習慣；本機層的 ./CLAUDE.local.md 只對某一個專案有效，適合放只跟一個專案有關的個人設定。請把 CLAUDE.local.md 加進 .gitignore，避免提交到版本控制；它是否能被同一台電腦的其他帳號或備份工具讀到，仍取決於作業系統權限與同步設定。
規則衝突時誰說了算？
官方文件說明，所有找到的檔案會串接在一起讀，不會互相覆蓋。越靠近你工作資料夾的檔案越晚被讀到，同一層裡 CLAUDE.local.md 排在 CLAUDE.md 之後。但如果兩條規則互相矛盾，Claude 可能任意選一條遵守。所以重點是避免寫出衝突的規則，不要指望哪一層會自動壓過另一層。
子資料夾裡的 CLAUDE.md 什麼時候讀？
你開始工作的資料夾和它上層資料夾的 CLAUDE.md，會在一開始就讀進來；子資料夾裡的 CLAUDE.md，要等 Claude 實際處理那個子資料夾的檔案時才讀。這個設計讓大型專案可以把細節分散到各個子資料夾，不必全部塞在最外層。
怎麼建立第一份 CLAUDE.md？
建立 CLAUDE.md 有兩種方式，都不需要會寫程式：
- 用 /init 自動產生：在 Claude Code 裡輸入 /init，Claude 會分析你的專案，自動寫出一份包含常用指令、慣例的初稿。如果資料夾裡已經有 CLAUDE.md，它會提出修改建議，不會直接覆蓋。
- 直接請 Claude 幫你寫：用一般對話說「請在 CLAUDE.md 加一條規則：回答一律用台灣繁體中文」，Claude 就會幫你更新檔案。
產生初稿之後，再補上 Claude 自己看不出來的事，例如「這個資料夾是客戶原始檔，不能修改」「交付格式一律用 Word」。這些只有你知道的規則，才是 CLAUDE.md 最有價值的部分。
/init 產生的初稿要怎麼改？
/init 的初稿是 Claude 讀完你的檔案後整理出來的，通常會包含很多它自己本來就看得懂的內容。拿到初稿後做 3 件事：刪掉 Claude 讀檔案就知道的描述、補上只有你知道的規則、把最不能出錯的規則移到最前面。改完之後的檔案通常會比初稿短，這是正常的。
CLAUDE.md 該寫什麼、不該寫什麼？
判斷一條規則要不要寫，只要問一句：拿掉這條，Claude 會不會做錯？會，就寫；不會，就不用寫。
| 類型 | 該寫 | 不用寫 |
|---|---|---|
| 專案背景 | 一句話說明這是什麼、給誰用 | 公司沿革、長篇的專案介紹 |
| 資料夾結構 | 哪個資料夾放什麼、哪些不能動 | Claude 讀檔案就看得出來的內容 |
| 慣例 | 檔名格式、輸出格式、用語規範 | 「寫好一點」「注意品質」這類空泛要求 |
| 常用指令 | 怎麼測試、怎麼發布 | 一般常識性的操作 |
| 地雷 | 做錯會出大事的事，例如不能覆寫原始檔 | 只發生過一次的小錯誤 |
官方文件也提醒：如果一段內容是多步驟的流程，或只跟某一部分的檔案有關，就不要放在 CLAUDE.md，改用 Skills 或針對特定路徑的規則檔，需要時才載入。
CLAUDE.md 最常見的 4 個錯誤
- 寫成專案介紹文：一大段散文講專案的來龍去脈，Claude 讀完抓不到該遵守什麼。改成一條一條的規則。
- 塞進大量資料：把整份產品規格、API 文件貼進來，每次都佔掉上下文。資料放在專案資料夾裡，需要時讓 Claude 自己去讀。
- 重複檔案裡已經有的東西：Claude 可以自己讀檔案，不用把檔案內容再抄一次。
- 寫進敏感資訊：密碼、API 金鑰、客戶個資不要放進 CLAUDE.md，尤其是會跟著專案分享出去的那一份。
CLAUDE.md 範例：3 份可以直接改的範本
下面 3 份範本分別給個人偏好、網站專案和內容工作用。複製之後，把括號裡的內容換成你自己的狀況，不要原封不動照抄。
範例 1：個人層，放在 ~/.claude/CLAUDE.md
這份是你到哪個專案都適用的個人偏好，寫一次，所有專案都受益：
# 個人偏好
- 回答一律使用台灣繁體中文與台灣用語（軟體、影片、網路、專案）。
- 程式碼、指令、檔名保留原文，不要翻譯。
- 動手修改檔案前，先列出計畫給我確認。
- 刪除或覆寫任何檔案前，一律先問我。
- 不確定的地方直接說不確定，不要自己猜。
範例 2：專案層，一個公司網站專案
這份放在網站專案的資料夾裡，讓 Claude 知道這個網站的結構和地雷：
# （公司名稱）官網
一個介紹產品與接收詢價表單的形象網站，讀者是（目標客群）。
## 資料夾
- pages/：各頁面內容
- images/：圖片，檔名用英文小寫加連字號
- legacy/：舊版網站，只能讀，不能修改
## 規則
- 修改文案時保留原本的標題層級，不要新增 H1。
- 新增圖片一律附上中文替代文字（alt）。
- 詢價表單的欄位名稱不能更動，會影響後台通知。
## 常用指令
- 本機預覽：（你的預覽指令）
- 發布前檢查：（你的檢查指令）
範例 3：內容工作，一個 SEO 文章資料夾
CLAUDE.md 不只給工程師用。如果你用 Claude Code 處理文章、報告這類文字工作，也可以在資料夾裡放一份：
# SEO 文章工作區
- inputs/：客戶提供的素材與參考文章，只能讀
- drafts/：Claude 產出的草稿
- final/：我確認過的定稿，不要修改
## 寫作規則
- 文章只用 H2 到 H4，不要寫 H1。
- 價格、日期、數字一律標註資料來源與查證日期。
- 參考文章只用來了解主題，不能照抄句子。
- 交付格式：一篇一個檔案，檔名「客戶名_關鍵字_日期」。
套用範例 2 時，最重要的是「規則」那一段。想想你的網站過去出過什麼問題：改文案時把標題層級弄亂、上傳的圖片沒有替代文字、動到表單欄位害通知收不到。把這些實際發生過的狀況寫成規則，比抄任何範本都有用。
3 份範本都不長，這是刻意的。先從 10 到 30 行開始，工作中發現 Claude 一直犯同一種錯，再補一條規則，比一開始就想寫滿更實際。
CLAUDE.md 怎麼寫才有效？4 個原則
有效的 CLAUDE.md 有 4 個共同點：
- 精簡：官方建議每份 CLAUDE.md 控制在 200 行以內。檔案越長，佔用的上下文越多，Claude 遵守的程度也會下降。上下文就是 Claude 一次能讀進來的資料量，CLAUDE.md 每次都會先佔掉一部分。
- 具體：「程式碼要寫得乾淨」沒有用；「每個檔名用英文小寫加連字號」才能照著做。測試方法是把規則拿給一個不懂專案的人看，他能不能照做。
- 用標題分類：用 ## 把規則分成資料夾、規則、常用指令等區塊，Claude 比較容易找到對應的規則。
- 定期整理：專案改了，規則也要跟著改。過時的規則比沒有規則更麻煩，因為 Claude 會照著錯的規則做。
規則要不要寫原因？
重要的規則建議附上一句原因。例如「legacy/ 資料夾只能讀，因為那是舊版網站的備份，改了會無法還原」。Claude 知道原因之後，遇到規則沒寫到的狀況，比較能判斷該怎麼做。不是每條都要寫，挑最容易出錯、後果最嚴重的幾條就好。
什麼時候該更新 CLAUDE.md？
有 3 個時間點：Claude 同一種錯誤犯了第二次的時候，當下就補一條規則；專案的資料夾結構或工作方式改變的時候；以及每個月固定花十分鐘看一遍，把過時的規則刪掉。CLAUDE.md 是會跟著專案長大的檔案，不是寫一次就放著不管。
檔案太長怎麼辦？
有兩個拆分方法。第一是用 @ 引入其他檔案，例如在 CLAUDE.md 寫 @docs/style-guide.md，Claude 就會一起讀那份檔案，但這只是讓檔案好管理，不會減少佔用的上下文。第二是用 .claude/rules/ 資料夾，把規則拆成好幾份主題檔，還可以設定只在處理特定檔案時才載入，這樣才真的能省下上下文。
怎麼讓規則只在特定檔案生效？
在 .claude/rules/ 資料夾裡的規則檔，可以在檔案開頭用 paths 指定適用的路徑，Claude 只有在處理符合條件的檔案時才會載入。例如只在處理 drafts 資料夾裡的文章時套用寫作規則：
---
paths: drafts/**
---
# 草稿寫作規則
- 每篇草稿開頭先列出核心關鍵字。
- 段落不超過 5 行。
這樣做的好處是，處理其他檔案時這些規則不會佔用上下文，CLAUDE.md 本身也能維持精簡。
CLAUDE.md、Skills、自動記憶差在哪？
Claude Code 有好幾種讓 Claude「記住」的方式，各自負責不同的事：
| 機制 | 誰寫、放什麼 | 什麼時候載入 |
|---|---|---|
| CLAUDE.md | 你寫，放規則、慣例、專案背景 | 每次工作開始都載入 |
| Skills | 你寫（或請 Claude 寫），放完整的工作流程 | 需要時才載入，或用 / 指令叫出 |
| 自動記憶（MEMORY.md） | Claude 自己寫，記下你糾正過的事和偏好 | 每次工作開始載入前 200 行或 25KB，以先達到的上限為準 |
用比喻來說，CLAUDE.md 是入職手冊，Skills 是各項工作的 SOP，自動記憶則是 Claude 自己的工作筆記。如果你發現自己連續好幾次跟 Claude 交代同一套步驟，例如「寫週報要先整理數字、再寫三段摘要、最後存成 Word」，那就是該寫成 Skill 的時候，不要全塞進 CLAUDE.md。Skill 的寫法可以參考 Claude Code 官方的 Skills 說明。
依 官方文件，自動記憶預設存於本機，不跨機器或雲端環境同步；同一個 Git repository 的 worktree 與子資料夾會共用同一份專案記憶。你可以在 Claude Code 裡輸入 /memory 查看、編輯，或關掉自動記憶。
CLAUDE.md 寫了沒效怎麼辦？
CLAUDE.md 寫了 Claude 卻沒照做，通常是下面 5 個原因之一，依序檢查：
- 檔案沒被讀到：輸入 /memory，看看目前載入了哪些檔案。沒看到你的 CLAUDE.md，就是位置或檔名錯了，檔名要剛好是 CLAUDE.md。
- 規則太模糊：把「注意格式」改成具體的動作，例如「標題用 H2，不要用 H1」。
- 規則互相矛盾：例如一條寫「回答要詳細」，另一條寫「回答越短越好」，Claude 只能猜你要哪一個。
- 檔案太長：超過 200 行，後面的規則容易被忽略，把重要的規則移到最前面，其他拆出去。
- 放錯層級：個人偏好寫在專案層，換了專案就失效；專案規則寫在個人層，同事就讀不到。確認每條規則放在對的那一層。
Claude Code v2.1.283 以上也有內建健檢功能：輸入 /doctor prompt-audit，Claude 會檢查你的 CLAUDE.md、規則檔和 Skills，找出過時的指令、不存在的檔案或互相矛盾的地方，列出修改建議。它只會給報告，你同意之後才會真的修改檔案。
不寫程式也用得到 CLAUDE.md 嗎？
用得到。CLAUDE.md 不限工程師使用，只要你用 Claude Code 處理任何資料夾裡的工作，不管是整理檔案、寫文章、做報表，都可以用 CLAUDE.md 把規則先講好。上面的範例 3 就是給內容工作者的版本。
如果你主要用的是 Claude 桌面版的 Cowork，它也有「資料夾指示」的設計，概念和 CLAUDE.md 一樣：選一個資料夾，就把那個資料夾的專屬規則帶進來。學會寫 CLAUDE.md，等於學會怎麼把工作交代清楚，換到哪個 AI 工具都用得上。
對老闆和主管來說，CLAUDE.md 還有一個好處：它就是一份寫好的工作規範。你可以把公司的檔名規則、交付格式、品牌用語寫進去，之後不管是誰用 Claude Code 處理這個資料夾，產出都會照同一套規矩走。
不用一開始就研究完四個層級、規則檔和引入語法，先在個人層寫 3 條你最常重複交代的話就好。工具越強，你把事情講清楚的能力就越值錢。
常見問答
CLAUDE.md 和 AGENTS.md 差在哪？
AGENTS.md 是可供多種 AI 程式工具共用的說明檔格式。Claude Code v2.1.277 以上預設支援直接讀取 AGENTS.md。當工作目錄或其上層沒有專案用的 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md 時，Claude Code 會讀取 AGENTS.md；兩種檔案同時存在時，預設只讀 CLAUDE.md。使用者層的 ~/.claude/CLAUDE.md、組織管理檔與 .claude/rules/ 不會阻止這個 fallback。若要固定同時讀兩者，可在 /config 把 Project instructions 設為 claude-md-and-agents-md；舊版本或不支援的工作階段，則在 CLAUDE.md 中用 @AGENTS.md 匯入。
改了 CLAUDE.md 要重新開 Claude Code 嗎？
先用 /context 或 /memory 確認目前是否已載入最新內容；未反映時，再開一個新的工作階段。
CLAUDE.md 可以寫英文還是中文？
都可以。CLAUDE.md 是寫給 Claude 看的自然語言，用你最能把規則講清楚的語言寫就好。重點在規則具體、不互相矛盾，語言本身不影響效果。
CLAUDE.md 最多可以寫多長？
依官方文件，CLAUDE.md 在 4 MiB 以內都會完整載入，超過就會被略過。但能載入不代表應該寫這麼長，官方建議每份控制在 200 行以內，越短越容易被遵守。
團隊要怎麼共用 CLAUDE.md？
把專案層的 CLAUDE.md 跟著專案一起放進 Git 這類版本控制，團隊每個人用 Claude Code 時都會讀到同一份規則。每個人自己的偏好放在個人層或 CLAUDE.local.md，不要寫進共用的那一份，避免把個人習慣變成全團隊的規定。
CLAUDE.md 會不會被別人看到？
個人層與 CLAUDE.local.md 預設存於本機；專案層若提交到 Git，能存取該 repository 的人就可能看到。任何層級都不要寫密碼、API 金鑰或客戶個資。
結語：寫好 CLAUDE.md，凱哥建議先從 3 條規則開始
CLAUDE.md 是 Claude Code 每次上工都會先讀的工作守則：放在對的層級、只寫拿掉就會出錯的規則、控制在 200 行以內，Claude 就不用每次重新聽你交代。下一步很簡單，打開 Claude Code，輸入 /init 產生初稿，或在個人層寫下你最常重複交代的 3 句話。
如果你想用 Claude Code 處理自己的工作流程，卻不知道規則該怎麼寫、資料夾該怎麼分，可以加 LINE 找凱哥，一對一家教會依你的實際工作，陪你寫出第一份 CLAUDE.md。先做再說，規則可以邊用邊補。
