跳轉到

M2：寫你的第一個 Global CLAUDE.md

目標：教 Claude「我是誰、我喜歡怎麼被回應」，省下每次都要重複交代的力氣。 時長：20 min

什麼是 Global CLAUDE.md？

Claude 沒有跨對話的「長期記憶」。每次你跟它對話，它都是從零開始。所以如果你不告訴它「我是 HR 人員」「請用繁中」「請簡潔」，它每次都會猜，每次都可能猜不一樣。

CLAUDE.md 是一份你寫給 Claude 的「常駐 context」。啟動 Claude Code 時會自動讀取。

它有兩種：

類型 位置 適用範圍
Global（本模組） ~/.claude/CLAUDE.md 你所有專案
專案級（M4 會教） 專案根目錄下的 CLAUDE.md 只有那個專案

Global 放「不論你做什麼專案都成立的個人偏好」。

步驟 1：找到你的 ~/.claude/ 資料夾

~ 代表「你的 user 資料夾」。

  • Windows：C:\Users\你的名字\ → ~/.claude/ 就是 C:\Users\你的名字\.claude\
  • macOS：/Users/你的名字/ → ~/.claude/ 就是 /Users/你的名字/.claude/

你現在要做

在 PowerShell 輸入： 

cd $HOME\.claude
ls

你現在要做

在 Terminal 輸入： 

cd ~/.claude
ls -a
（加 -a 是因為 macOS 預設不顯示 . 開頭的隱藏資料夾。）

你應該看到

一堆資料夾（projects/、shell-snapshots/、sessions/、settings.json 等等）， 內容會因 Claude Code 版本而異，不需要逐一對照。重點是這個資料夾存在。 你目前還不會看到 CLAUDE.md，下面步驟才要建立。

卡住了？

  • 顯示「找不到路徑」→ 表示你還沒跑過 Claude Code。回 M1 的步驟 7「第一次跟 Claude 對話」跑一次，這個資料夾才會自動建立
  • Windows ls 顯示一堆紅字 → 沒關係，那只是「找不到此檔案類型的處理常式」，不影響功能

步驟 2：開一個新的 PowerShell + 啟動 Claude Code

接下來我們要用 Claude 自己幫我們寫這份 CLAUDE.md，不要手寫。

你現在要做

  1. 回到桌面或你習慣的工作資料夾：

    cd $HOME\Desktop

    cd ~/Desktop

  2. 啟動 Claude Code： 

    claude

你應該看到

Claude Code 啟動，等你輸入。

步驟 3：第一輪 — 基本偏好

你現在要做

把下面這段整段複製貼上給 Claude：

跟 Claude 說

我想建立我的 Global CLAUDE.md（在 ~/.claude/CLAUDE.md）。

請先用對話方式問我幾個基本問題，例如： - 我希望你用什麼語言跟我對話？ - 我喜歡的回應風格是長還是短？ - 我希望你回應時用怎樣的語氣？

不要直接寫檔案，先把問題列出來，我一個一個回答。

你應該看到

Claude 會列出 3-5 個關於風格偏好的問題。例如：

好的，為了讓我之後的回應更貼近你的偏好，請回答以下幾個問題： 1. 語言：你希望我用繁體中文、簡體中文還是英文回應？ 2. 回應長度：你偏好簡短直接的回答，還是希望我提供詳細的解釋與範例？ 3. 語氣：你希望我用正式的口吻，還是輕鬆對話式的語氣？ 4. 程式碼註解：當我寫程式碼時，註解該用中文還是英文？

卡住了？

  • Claude 直接開始寫檔案沒問你 → 告訴它「等一下，我想先回答問題你再寫」
  • 問題太多 / 太技術 → 告訴它「我是 HR 人員，零程式背景，請用我聽得懂的方式問」

步驟 4：回答 Claude 的問題

依照你的真實偏好回答。沒有標準答案，下面只是參考：

問題 參考回答
語言 繁體中文
長度 簡短直接，但程式碼相關步驟可以詳細
語氣 輕鬆對話式，不要太正式
程式碼註解 英文（這是業界慣例）
解釋程式時 用比喻、少用術語

你現在要做

把你的答案告訴 Claude。可以一段話講完，例如：

跟 Claude 說（範例）

我的偏好： 1. 繁體中文 2. 預設簡短直接；只有在我問「為什麼」或「請詳細解釋」時才詳細 3. 輕鬆對話式 4. 程式碼註解英文 5. 我是 HR 人員，零程式背景，解釋程式時請用比喻、少用術語

你應該看到

Claude 會回應並準備進入下一輪，或者直接問你還有沒有其他補充。

步驟 5：第二輪 — 你的工作脈絡

你現在要做

告訴 Claude 你的工作環境，讓它知道你會用它做什麼類型的事。

跟 Claude 說（範例）

補充我的工作脈絡： - 我做 HR 工作，常處理 Excel - 我有 Windows 電腦 - 我未來會用 Claude Code 做一些小工具（CLI 為主），不會做網站、不會碰雲端 - 我不喜歡你一次問我很多問題，先做你能做的，需要時再問 - 如果我的需求模糊，請主動列出 2-3 個可能的方向，讓我選

你應該看到

Claude 確認理解，可能會問一兩個釐清問題或直接準備寫檔。

步驟 6：請 Claude 把上面這些寫進 Global CLAUDE.md

你現在要做

跟 Claude 說

請把以上偏好整理成一份 Global CLAUDE.md，寫到 ~/.claude/CLAUDE.md。

格式請用 Markdown，分成幾個段落： 1. 我是誰 2. 回應風格偏好 3. 對話互動規則

寫完之後請把檔案內容貼給我看一眼。

你應該看到

Claude 會跳出權限提示問你要不要寫檔案。選 Yes。

然後 Claude 會把寫好的內容貼給你。長相類似：

# Global CLAUDE.md — Calvin

## 我是誰
HR 同事，零程式背景，使用 Windows 電腦。
常用 Excel 處理資料。

## 回應風格
- 語言：繁體中文
- 長度：預設簡短直接，問「為什麼」時才詳述
- 語氣：輕鬆對話式
- 程式碼註解：英文

## 對話互動
- 不一次問很多問題，先做能做的
- 需求模糊時，主動列 2-3 個方向讓我選
- 解釋程式時用比喻、少用術語

卡住了？

  • 權限提示拒絕後 Claude 沒寫 → 再說一次「請寫，我同意」
  • 寫到別的位置 → 告訴它「請確認寫到 ~/.claude/CLAUDE.md，不是專案資料夾」

步驟 7：驗證 — Claude 真的有讀進去嗎？

寫好不代表生效。要重啟 Claude Code 驗證。

你現在要做

  1. 在 Claude Code 對話框打 /exit 或按 Ctrl+C 兩次離開
  2. 在 PowerShell 重新打 claude 啟動
  3. 對 Claude 說：

跟 Claude 說

請告訴我，根據我的 Global CLAUDE.md，我是誰、我有什麼偏好？

你應該看到

Claude 應該能複述你寫進去的偏好。例如：

根據你的 Global CLAUDE.md，你是 HR 同事，零程式背景，使用 Windows。你偏好繁體中文、簡短直接的回應、輕鬆對話式語氣。你不喜歡一次被問很多問題。

如果它能複述 = 設定生效了。

卡住了？

Claude 說「我看不到你的 CLAUDE.md」→ 確認 ~/.claude/CLAUDE.md 真的存在：

cat $HOME\.claude\CLAUDE.md

cat ~/.claude/CLAUDE.md

若顯示找不到，請 Claude 重寫一次，特別強調路徑

⚠️ 重要警示：別寫機敏資料

Global CLAUDE.md 是會跨專案被讀到的

這份檔案在你任何專案下都會被 Claude 載入。不要寫入：

  • ❌ 員工姓名、工號、薪資資訊
  • ❌ 合約條款、內部規章原文
  • ❌ 密碼、API key、token
  • ❌ 任何「外流出去會出事」的內容

這些東西該放在專案級 CLAUDE.md（M4 會教），且該專案要在公司控管環境內。

如果你不小心寫進去了 → 直接把那幾行刪掉、存檔，就好。沒有什麼「同步到雲端」這種事，這只是你電腦上的一份檔案。

步驟 8（選做）：微調

用一陣子之後你會發現「啊我也不喜歡這樣」「我希望它這樣」。隨時可以：

跟 Claude 說

請更新我的 Global CLAUDE.md，加上「[你的新偏好]」。

或者直接打開 ~/.claude/CLAUDE.md 編輯：

  • Windows：用記事本開 C:\Users\你的名字\.claude\CLAUDE.md
  • macOS：用 TextEdit 或 nano ~/.claude/CLAUDE.md

M2 完成檢查

  • ~/.claude/CLAUDE.md 存在且有內容
  • 重啟 Claude Code 後它能複述你寫的偏好
  • 你知道「別寫機敏資料」這條紅線

✅ 全部 → 進 M3a：Quick Win 專案

← M1 ｜ M3a →