Claude Code 新手上路：把一堆名詞放回正確位置
剛開始用 Claude Code（或任何一種「AI 進到開發流程」的工具）時，最痛苦的通常不是功能，而是名詞爆炸。
CLAUDE.md、MCP、Subagents、Skills、Slash Commands、Hooks……你明明只是想讓它幫你寫點程式，結果像被丟進一場企業架構課。
我自己會用一個很實務的方式消化：每個名詞都對應一種「團隊裡的角色」或「工程裡的控制點」。你把它放回正確位置，整個系統就突然合理了。
## CLAUDE.md：專案的長期記憶（不常改的那種）
如果你把 Claude 當成加入專案的新同事，CLAUDE.md 就是他入職第一天會拿到的那份文件：
- 系統架構與模組邊界
- 開發慣例（命名、資料夾結構、測試習慣）
- 設計模式與你們不想再爭論的決策
它的重點是「穩定」：不要塞每天都在變的細節，否則它會變成噪音。
我會放的內容
- 這個 repo 的核心目標與不做什麼
- 常見任務的做法（新增 API、跑測試、出 release）
- 你最在乎的品質標準（可讀性、可測試性、效能底線）
## MCP：連外的能力（公司外部資源入口）
MCP 的直覺是「把外部系統接進來，讓 Claude 能用」。
像公司裡的外部資源：
- 資料庫
- 內部 API
- 第三方服務
- 檔案系統／工具鏈
當你需要 Claude 不只是寫字，而是能查資料、做動作、整合系統時，MCP 會變得重要。
提醒：連外就等於權限與風險，越方便越要把邊界定清楚。
## Subagents：把任務分給不同部門，避免主線被污染
Subagents 最好用的地方，是你同時要做很多事，或某個問題需要長時間探索。
你可以把它想成：
- 主 agent：PM／總指揮，掌握主線任務
- subagent：專職部門（除錯、查資料、寫測試、整理文件）
它的價值是避免 context pollution：主線不被大量雜訊塞滿，決策品質比較穩。
## Skills：最佳實踐（那個很可靠的資深同事）
Skills 更像是公司內部的 best practices：
- 你們的寫作風格
- 安全規範
- 測試標準
- 上線前檢查清單
它不是每次都要你手動提醒，而是讓 Claude 自動「照規矩辦事」。
如果你發現 Claude 每次都犯同一種錯，通常不是你要更努力 prompt，而是你該把規範寫進 Skill。
## Slash Commands：你想要「可重複、可控」的流程
Slash command 是把一段流程變成明確的指令：
- 產生 commit message
- 跑測試
- 產生 changelog
- 建立 PR 模板
它的好處是：你不需要每次重新描述需求，行為也比較可預期。
## Hooks：事件觸發的自動化規則
Hooks 是「某個事件發生就自動做事」：
- code 變更就跑格式檢查
- 送出 PR 就跑 QA
- commit 前先做 lint / type check
它在團隊協作裡非常有價值，因為它把品質控制從「靠人記得」變成「系統保證」。
## 一句話總結（我自己用的心智模型）
- CLAUDE.md：專案背景與規矩（長期記憶）
- MCP：外部能力入口（連外）
- Subagents：分工避免干擾（部門化）
- Skills：最佳實踐自動套用（資深同事）
- Slash Commands：可重複的流程（工具化）
- Hooks：事件驅動的守門員（自動檢查）
你不需要一次把全部吃透。
先把「我現在缺的是背景？缺的是連外？缺的是分工？缺的是規範？缺的是流程？缺的是守門？」這個問題答出來，名詞就會自己歸位。
#ClaudeCode #MCP #DevTools #AI工程 #開發流程 #生產力
