拾光 AI 工作室

Claude Code 非工程師實戰・第 3 篇・約 9 分鐘

讓它記住你的習慣：非工程師的 CLAUDE.md 怎麼寫

本文目錄

    寫作時版本：Claude Code 2.1.x／2026 年 11 月（內容依官方文件 2026-11 查閱整理）。 Claude Code 更新很快，畫面文字、指令名稱、預設值都可能改變。看到的畫面和本文不一樣時，請以官方文件為準。

    這篇文章要幫你做到什麼

    用過前兩篇你應該發現一件事：每次開新的對話，它都忘了你是誰。

    昨天你才教它「檔名不要用最終版」，今天開新視窗，它又問你一次。你得重講命名規則、報表格式、哪些資料夾不能碰……

    這篇要解決的就是這個：把你的習慣寫成一個叫 CLAUDE.md 的純文字檔，放在資料夾裡。之後每次在這個資料夾啟動 Claude Code，它一開始就會讀到。 一次設定，長期有效。

    讀完你會：

    • 知道 CLAUDE.md 是什麼、放哪裡
    • 用一份「六段式」結構，在 20 分鐘內寫出你的第一份
    • 用 /memory、/context all 確認它真的讀到了
    • 知道哪些內容不該寫進去，以及它沒照做時怎麼查

    需要準備：

    • 已照第 1 篇裝好並登入 Claude Code
    • 一個你平常會處理檔案的資料夾（練習用資料夾也行，沿用第 1、2 篇的 Claude練習）
    • 約 30 分鐘

    先搞懂：CLAUDE.md 是什麼，不是什麼

    是什麼： 一個你自己用記事本就能寫的文字檔（Markdown 格式，其實就是純文字加幾個 # 標題符號）。Claude Code 每次開始工作時，會把它讀進去當作背景資料。官方的說法是：把它當成「你原本需要重複解釋的內容」的存放處。

    不是什麼： 它不是強制執行的設定。官方文件明講，Claude 把 CLAUDE.md 當「背景資訊」，會盡力遵循，但沒有嚴格遵守的保證，指令越模糊、互相衝突，越容易被忽略。

    這點對非工程師特別重要：

    「不准刪除檔案」寫在 CLAUDE.md 裡，是提醒它，不是鎖住它。真正的煞車，還是第 1 篇教的權限模式（動手前它會問你）。兩層要一起用。

    它可以放在哪裡（你只需要記兩個）

    官方文件列了好幾種位置，非工程師只要記這兩個：

    想要的效果 檔案位置 說明
    只在某個資料夾工作時適用 該資料夾裡的 CLAUDE.md 例如 Claude練習 資料夾。你在這個資料夾（或它底下）啟動，就會讀到
    不管在哪個資料夾都適用 ~/.claude/CLAUDE.md ~ 在 Windows 就是 C:\Users\你的名字。適合放「我是誰、回答一律用繁體中文」這類個人偏好

    另外兩個細節：

    • 它會讀「你啟動的資料夾」以及它上層資料夾裡的 CLAUDE.md，內容是疊加、不是互相覆蓋。
    • 子資料夾裡的 CLAUDE.md 不會一開始就讀，而是它開始處理那個子資料夾的檔案時才讀進來。

    建議做法：先只做一份，放在你最常工作的資料夾。 寫順手了再加。

    步驟 1：先讓它幫你起個草稿（/init）

    不想從空白頁開始，可以在工作資料夾啟動 Claude Code 後輸入：

    /init

    官方文件說明，/init 會自動產生一份起始 CLAUDE.md；如果檔案已經存在，它會建議改進，而不是直接覆蓋。

    但請注意：/init 是設計給程式專案的，它會分析程式碼庫，找建置指令、測試指令。如果你的資料夾是一堆 Word、Excel、圖片，它產生的內容可能很空泛或不太對。（本文作者未在純文件資料夾實測 /init 的輸出，標「待驗證」。）所以對非工程師，我更建議下一步：自己寫，或請它訪談你。

    步驟 2：用「六段式」寫你的第一份

    打開記事本，另存新檔，檔名必須是 CLAUDE.md（注意存檔類型選「所有檔案」，不然會變成 CLAUDE.md.txt，它就讀不到了）。放在你的工作資料夾裡。

    把下面的架構複製進去，換成你自己的內容：

    # 關於我
- 我是【某某公司】的【行政專員】，名字叫【小安】。
- 我不是工程師，請用白話說明你做了什麼，不要丟一大段技術術語。
- 回答一律用繁體中文（台灣用語）。

# 這個資料夾放什麼
- 00 待整理：還沒分類的檔案
- 10 會議：會議紀錄，依年份分資料夾
- 90 封存：已結案，只讀不改

# 檔名規則
- 格式：YYYYMMDD_類型_主題_版本.副檔名，例如 20261105_會議_採購檢討_v1.docx
- 版本從 v1 開始，改版加 1。不要用「最終版」「最終版(2)」。

# 常見工作怎麼做
## 整理檔案
1. 先列出「舊檔名 → 新檔名」給我看，我說「好」才動手。
2. 動手前先把原檔名清單存成 CSV，方便我救回來。

# 不能做的事
- 不刪除任何檔案；要移除的，移到 90 封存。
- 不覆蓋原檔；修改一律另存新版本。
- 不確定的事先問我，一次問一個問題。

# 不要寫進任何檔案的東西
- 密碼、銀行帳號、身分證字號、客戶私人聯絡方式。

    這六段（我是誰／資料夾／檔名／常見工作／不能做／敏感資料）涵蓋了多數辦公室情境。

    寫的時候抓這四個原則

    官方文件對「怎麼寫才有效」的建議，翻成白話：

    1. 要具體到可以檢查。 「檔名要整齊」不行；「格式是 YYYYMMDD_類型_主題_版本，例如……」可以。官方例子：「使用 2 空格縮排」比「正確格式化程式碼」有效。
    2. 短。 官方建議每份控制在 200 行以內；太長會佔用它的工作記憶、反而降低遵守度。
    3. 用標題和條列。 分好段的內容，比一大段文字好讀。
    4. 不要自相矛盾。 如果上層資料夾說「用英文檔名」、這份說「用中文檔名」，它可能隨機選一個。

    該寫進去 vs. 不該寫進去

    適合寫 不適合寫
    每次都要的規則（命名、格式、語氣） 只有這一次要用的指令（直接在對話裡講）
    資料夾結構、哪裡不能碰 密碼、帳號、身分證字號、客戶隱私（它會被讀進每一次對話）
    「第二次犯同樣的錯」的更正 整份很長的作業手冊（太長會被稀釋）

    另外一個實用判斷：官方建議，如果是「好幾個步驟的固定流程」，更適合做成「技能卡」（下一篇會教）；CLAUDE.md 放的是「每次都該知道的事實與規則」。

    步驟 3：確認它真的讀到了

    寫好了不代表它讀到。一定要驗證。 存檔後，在那個資料夾啟動 Claude Code：

    cd "$env:USERPROFILE\Claude練習"
claude

    進去後輸入下面兩個指令（依官方文件）：

    ① 看清單：

    /context all

    在清單的 Memory files（記憶檔案）區塊，應該看到你剛寫的 CLAUDE.md 路徑。沒列在那裡，它就看不到。

    ② 開啟與編輯：

    /memory

    這個指令會列出你的 CLAUDE.md 檔案位置（包含使用者層級、專案層級）。選一個檔案，就能用你電腦上的編輯器開啟修改；如果列出的檔案還不存在，選它會先幫你建立。

    ③ 用一句話考它：

    我剛下載了一份採購檢討會議的 Word 檔，請告訴我依照我的規則，它應該叫什麼檔名。先不要改。

    如果它回答的是 YYYYMMDD_會議_採購檢討_v1.docx 這種格式，就是讀到了。

    注意：畫面長相、區塊名稱可能隨版本不同；上述 /context all、/memory 指令依官方文件記載，作者未逐字比對各版本畫面。

    步驟 4：它沒照做的時候，怎麼查

    官方的疑難排解順序，翻成白話：

    1. 先 /context all：檔案有沒有列在 Memory files？沒有 → 檔名錯了（常見：變成 CLAUDE.md.txt），或你不是在那個資料夾啟動的。
    2. 指令太模糊？ 改成有例子、可檢查的寫法。
    3. 有沒有互相衝突的規則？ 打開 /memory 列出的每個檔案，看有沒有兩處講法不一樣。
    4. 子資料夾的 CLAUDE.md 不會出現在清單裡，它是用到才讀。這不是壞掉。
    5. 「一定要做」的事別只靠 CLAUDE.md。 官方提到，必須在特定時機執行的事，要用 hook（較進階）。非工程師的替代做法：靠第 1 篇的權限模式，讓它動手前問你。

    另一個常見疑問：它自己也會「記筆記」

    除了你寫的 CLAUDE.md，官方文件還說 Claude Code 有「自動記憶」：它會根據你的更正和偏好，自己寫筆記。這些筆記存在你電腦的 ~/.claude/projects/ 底下，你可以用 /memory 開啟、編輯或刪除，也可以在 /memory 裡關掉。

    區別很簡單：CLAUDE.md 是你寫的規則；自動記憶是它寫的筆記。 想要穩定、可預期，就把重要規則自己寫進 CLAUDE.md。

    步驟 5：之後怎麼養這份檔案

    官方建議的時機很實用，直接照用：

    • 它第二次犯同樣的錯，就把更正寫進去。
    • 你發現自己在不同對話裡打同一段更正，就把它寫進去。
    • 想請它代筆也行，直接說：「請把這條規則加到 CLAUDE.md。」
    • 每個月看一次，刪掉過時的規則。官方也提供 /doctor prompt-audit，可請它檢查有沒有過時或互相矛盾的內容（需要較新版本，標「待驗證」）。

    四個「不要」

    1. 不要把密碼、帳號、客戶資料寫進去。 它每次都會被讀進去，而且有些人會把資料夾分享給別人。
    2. 不要寫成一整本手冊。 超過 200 行，效果反而變差。
    3. 不要以為寫了就等於鎖住。 它是提醒，不是保證；重要動作仍要看它的計畫再按同意。
    4. 不要寫了就不管。 一定要用 /context all 驗證一次。

    想直接拿現成的？

    自己從空白寫第一份最花時間。我們整理了三種職業的範本：行政助理、社群小編、接案者，每一份都是寫好結構、標出「要填空的地方」，搭配使用說明與改寫指南，你只要把【　】換成自己的內容。

    👉 看數位商品

    （不買也沒關係，上面的「六段式」已經足夠你寫出能用的第一份。）

    下一篇預告

    第 4 篇：《把每週都要做的事變成一張技能卡：Agent Skills 入門》 CLAUDE.md 放「每次都該知道的規則」；每週固定要做的「多步驟流程」，下一篇教你做成一張技能卡，之後一句話就能叫用。

    參考來源（均為官方文件，2026-11 查閱）

    操作說明：CLAUDE.md 位置、大小建議（200 行）、/context all、/memory、/init、自動記憶的描述均依上述官方文件整理，本篇未在作者電腦上逐項實測畫面；/init 在純文件資料夾的輸出、/doctor prompt-audit 為「待驗證」；Mac 的路徑寫法（~/.claude/CLAUDE.md）相同，但 PowerShell 指令需改用 Terminal 的 cd ~/Claude練習。範例中的人名與公司均為虛構。

    同系列延伸閱讀

    ← 回文章列表