CLAUDE.md 是什麼？寫一次，Claude Code 每次開工都先讀你的規矩

新手第一站學會了怎麼叫 Claude Code 做事，但你可能已經發現一件煩人的事：每次開新對話，它都忘了你上次交代的規矩。這次用英文回你，下次多開一個你沒要的檔案。這篇教你把規則寫進一個叫 CLAUDE.md 的檔案，它每次開工都會先讀，你只要寫一次。

快速回答 CLAUDE.md 是放在專案資料夾裡的說明檔，Claude Code 每次開新對話都會先讀它。讀到了也可能偶爾漏做，所以要用實際工作檢查一次。在專案裡輸入 /init 就會自動產生一份，再把你的規則加進去，例如「回覆一律用繁體中文」。用 /clear 開新對話試一次，看它有沒有照做；輸入 /context，Memory files 列出 CLAUDE.md 就代表有載入。

做完這篇，你會有

• 貪食蛇資料夾裡一份 CLAUDE.md
• 三條你自己的規則：用中文回覆、程式只寫在 index.html、改完列出測試步驟
• 一個新功能「難度選擇」，而且是照你的規則做出來的

開始之前要準備：第一篇做好的 snake-game 資料夾（裡面有 index.html）。

步驟 1：用 /init 產生 CLAUDE.md

在遊戲資料夾啟動 Claude Code，輸入：

/init

它會讀完專案，寫出一份 CLAUDE.md，內容是這個專案怎麼執行、程式怎麼組織。

如果你的狀態列是 manual 模式，它會先問你能不能建立檔案，選 Yes。

步驟 2：加上你的規則

用一句話請它把規則加進去：

在 CLAUDE.md 最上面加一段「我的規則」，寫這三條：回覆一律用繁體中文；所有程式都寫在 index.html，不要新增檔案；每次改完，最後列出在瀏覽器怎麼測試

規則要寫成做沒做到一看就知道的句子。「回覆用繁體中文」好檢查，「程式要寫好一點」就沒辦法檢查。

步驟 3：自己打開看一眼

CLAUDE.md 是普通的文字檔，用記事本或 VS Code 打開 snake-game/CLAUDE.md 就能看、能改。最上面是你的規則，下面是 /init 寫的專案說明。想加規則，直接在檔案裡加一行就好。

步驟 4：開新對話驗證規則

規則要在新對話才看得出效果。輸入 /clear，再交代一個新工作：

加一個難度選擇：簡單、普通、困難，開始前可以選

三條規則都照做了。打開 index.html，遊戲會先停在選擇難度的畫面。

以後不管開幾次新對話，這三條規則都會自動帶上。

步驟 5：用 /context 確認有載入

輸入 /context，往下找 Memory files：

規則沒生效時，第一件事就是來這裡看有沒有列出 CLAUDE.md。

常見卡關

• 規則大多照做，偶爾還是冒出英文：CLAUDE.md 是給它參考的說明，它還是可能沒照做。實測時最後的回覆是中文，但中間一句狀態說明還是英文。重要的規則寫得更具體，或在對話裡再提醒一次。
• 改了 CLAUDE.md 沒效果：它只在對話開始時讀。改完要 /clear 或重開 Claude Code。
• /context 沒有列出 CLAUDE.md：檔案不在你啟動 Claude Code 的資料夾或上層資料夾。確認你是在 snake-game 裡輸入 claude。
• CLAUDE.md 越寫越長：官方建議一份控制在 200 行以內，太長反而比較不照做。

你做到了

• 用 /init 產生 CLAUDE.md
• 加上三條自己的規則，並用新對話驗證它照做
• 用 /context 確認檔案有載入
• 照規則做出了難度選擇

規則寫好了，下一篇把你常做的一串工作，變成一個打 / 就能叫出來的指令。

常見問題

CLAUDE.md 只能放在專案資料夾嗎？

不只。放在 ~/.claude/CLAUDE.md 的規則，你所有專案都會套用，適合放「一律用繁體中文」這種個人習慣。專案資料夾裡的 CLAUDE.md 只對那個專案有效，可以跟團隊共用。

不想讓團隊看到的個人規則放哪裡？

在專案資料夾建一個 CLAUDE.local.md，它會跟 CLAUDE.md 一起載入。用 git 的話，記得把它加進 .gitignore。

已經有 CLAUDE.md 再跑 /init 會被蓋掉嗎？

不會。官方文件說明，已經有 CLAUDE.md 時，/init 會建議怎麼改，不會直接覆蓋。

聽說打 # 就能把規則存進記憶？

那是舊版的快捷鍵，2.0.70 已經移除。現在直接請它「把這條加進 CLAUDE.md」，或自己打開檔案改。

它自己也會記東西嗎？

會。Claude Code 有 auto memory，會把你糾正它的事記成筆記，下次自動參考。在 /memory 可以看它記了什麼，也可以關掉。

下一步

• Claude Code Skills 教學：把重複工作變成一個指令：下一篇，做一個自己的 / 指令。
• Claude Code 2026 更新懶人包：新手先學這 5 個：還沒看新手第一站最後一篇，先看這篇。

參考資料

• Anthropic, How Claude remembers your project（Claude Code 文件，CLAUDE.md 位置、/init、200 行建議、auto memory） https://code.claude.com/docs/en/memory
• Anthropic, Commands（Claude Code 文件，/init、/memory、/context） https://code.claude.com/docs/en/commands
• Anthropic, claude-code CHANGELOG.md（2.0.70 條目，# 快捷鍵移除） https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md