你可能已經用過 Claude Code 寫了幾段程式、修了幾個 bug。但老實說，大多數人只摸到它能力的三成左右。
Claude Code 是 Anthropic 推出的 CLI 版 AI 編程代理工具，能直接編輯檔案、執行命令、整合 MCP 伺服器、建立 Agents 和 Skills，還支援 Plan Mode、Hooks 等進階功能。它不只是聊天機器人，更像是一個代理式開發環境，能讀取檔案、執行命令、修改程式碼，甚至在你離開座位時自主完成工作。
不過，要把這個工具的潛力榨乾，光靠打字下指令是不夠的。關鍵在於你怎麼設定工作流、怎麼餵它 context、怎麼建立約束和分工。
這篇文章整理了來自 Reddit r/ClaudeAI、Builder.io、GitHub 社群（ykdojo/claude-code-tips）、Boris Cherny（Claude Code 作者）以及大量重度使用者（累積超過 11 個月使用經驗）的實戰精華。所有技巧都經過分類整理，方便你直接上手。
一句話先講結論
Claude Code 的上限，不是靠更長的 prompt 撐出來的。真正有效的做法是把它變成一個有記憶、有約束、有分工、有回退機制的執行環境。官方最佳實踐跟 2026 年社群高頻經驗幾乎一致：短 session、硬性 hooks、精簡 CLAUDE.md、subagents 分工、平行 session。
換句話說，Claude Code 的強，不在單次回答，而在你有沒有把它包成一個「短上下文、強約束、可分工、可回退」的系統。
理解 Claude Code 的七層架構
在開始任何技巧之前，先搞清楚 Claude Code 到底是怎麼運作的。它所有功能都建構在七個可擴充系統上面：
| 系統 | 功能說明 | 使用時機 |
|---|---|---|
| CLAUDE.md | 持久性規則與上下文，每次對話自動載入 | 放「每次都適用」的規則 |
| Skills | 按需載入的專業知識，支援自動或手動觸發 | 偶爾才用到的特定工作流 |
| Subagents | 獨立 context 的子代理，隔離執行、回傳摘要 | 探索性研究、大範圍掃描 |
| Hooks | 事件驅動的 Shell 命令，自動攔截與強制執行 | 「必須每次都執行」的事 |
| MCP | 連接外部服務，如 DB、GitHub、Sentry | 需要存取外部資料時 |
| Plugins | 打包分發 Skills + Subagents + Hooks | 團隊共享可重複的配置 |
| Agent Teams | 多個平行 agent 各有獨立 context | 大型專案的平行開發 |
記住一個原則：CLAUDE.md 放持久規則，Skills 放可重複工作流，Hooks 做自動化強制執行，Subagents 做 context 隔離。把所有東西塞進 CLAUDE.md 是最常見的錯誤，它會浪費每一輪對話的 token。
核心心態：14 條讓生產力翻倍的法則
這些不是零碎的小技巧，而是經過數百位開發者反覆驗證的工作原則。
一個 session 只做一件事
不要把 debug、重構、架構討論、部署混在同一條對話裡。官方明確建議在不相關任務之間用 /clear，並用 /compact 壓縮上下文。社群也反覆提到，長時間的 marathon session 會讓上下文衰退，模型開始漂移，回答品質肉眼可見地下降。
上下文就像牛奶，越新鮮越好。新任務時開新會話，或者讓 Claude 寫一份 HANDOFF.md 來傳遞關鍵資訊給下一個 session。
先研究，再規劃，再實作
多檔案修改、陌生模組、架構變更，一律先進 Plan Mode（按兩次 Shift + Tab）。官方建議的流程是 Explore → Plan → Implement → Commit。小改動才直接做。
社群裡有個說法蠻到位的：花 30 分鐘規劃，能把 10 小時的工作縮短到 3 小時。不要一上來就讓它寫程式碼，先讓它「探索程式碼庫」「解釋架構」「提出最簡單方案」，再逐步開始編碼。
把長期規則放進 CLAUDE.md
官方寫得很直白：CLAUDE.md 每次 session 都會載入；太長會降低遵從度；超過約 200 行就該拆到 .claude/rules/ 或用 @path 匯入。用 /memory 可以檢查到底載入了哪些規則。
這比在對話裡反覆提醒有效太多了。一個好的 CLAUDE.md 是精煉的規則手冊，不是一堆 copy-paste 的文件。
軟規則交給記憶，硬規則交給 hooks
.md 檔案是建議，hook 才是強制。需要「每次都必須發生」的事情，像是禁止改某資料夾、改檔後自動跑 lint/test、禁止用某些 Bash 指令，全部寫成 PreToolUse hook。
值得一提的是，PreToolUse hook 的 deny 機制，即使在 bypassPermissions 模式下仍然會攔截。換句話說，hook 是真正的安全網。
用 subagents 做調查
讓 Claude 掃描 30 個檔案會把主 context 塞爆。改用 subagent 在獨立 context 中完成調查，只將結論摘要帶回主對話。這樣主對話保持乾淨，實作時更穩定。
官方把 subagents 視為最強的 context 管理工具之一。調查大型 codebase、做安全審查、找邊界案例，都應該丟給 subagent。
Writer / Reviewer 雙工是最穩的高品質打法
官方直接給了平行 session 的 writer/reviewer 範式：A 寫，B 審，A 再修。Desktop 和 Web 都支援平行 session，Desktop 甚至有自動 Git worktree 隔離。這比單一對話裡同時寫又審，品質高出不少。
Boris Cherny 團隊的最大生產力秘訣就是同時開 3 到 5 個 git worktree，每個跑一個 Claude 會話，設定別名（za/zb/zc）秒切，搭配 tmux 多標籤「瀑布式」處理任務。
不要亂堆記憶檔，要做治理檔
社群裡高效率的做法不是只靠一個 CLAUDE.md，而是用一組治理文件：架構決策紀錄、runbook、session handoff、核准的 patterns。重點不是文件多，而是把「已經決定的事」從每次對話中抽離出來。
權限模式要調對
用 auto mode、/permissions allowlist、/sandbox 三種方式減少中斷。對可信任的本地開發流程，讓 Claude 少一點確認，會直接提高吞吐量；對高風險操作，再用 sandbox 或 deny 規則收緊。
effort 不要永遠開高
官方現在把 medium 當成大多數 coding 任務的甜蜜點；high 或 max 留給困難除錯與複雜架構題。/effort 可即時切換，max 只在 Opus 4.6 可用。要單回合深想，可以用 ultrathink。整天高 effort 不只比較費額度，也容易過度思考簡單的工作。
/fast 只在低延遲互動時開
fast mode 是 Opus 4.6 的高速配置，速度大約 2.5 倍，但屬於額外使用，不算在訂閱內建 rate limits 裡。要即時來回 debug、直播改 code 可以開；大批次、長任務、重上下文 session 就別常駐開著。
平常看健康度，不要等爆掉
/context 會顯示上下文占用、memory bloat、容量警告；/usage 會看 plan limits 和 rate limit 狀態。這兩個比主觀感覺可靠得多。
把 Claude 當新同事，不是搜尋引擎
先給目標、限制、驗收標準、既有模式，再讓它執行。不要只丟一句模糊需求。官方也明講：指定檔案、症狀、測試偏好、參考模式，能顯著減少來回修正的次數。
不要無限加裝 plugin / hook / 記憶層
近期社群一邊分享精簡 setup 後速度提升的經驗，一邊在抱怨 usage 和 compaction 問題。結論很簡單：最小可行配置比巨型全家桶穩。
遇到突然變笨、變慢、狂吃額度，先查 compaction thrash
如果看到 Autocompact is thrashing，代表某個大檔或工具輸出一直把 context 重新灌滿。解法是改成小塊讀檔、手動 /compact keep only the plan and the diff、丟給 subagent，或直接 /clear。
Context Window 管理：你最珍貴的資源
幾乎所有最佳實踐都回歸到一個約束：Context Window 滿得很快，效能會隨之下降。你的整段對話、讀取的每個檔案、每段命令輸出，全部擠在同一個 200K token 的窗口裡。
怎麼管理？四個動作：
第一，頻繁使用 /clear。每開始新任務就清除對話，不需要讓舊歷史吃掉 token。
第二，設定 Status Line 監控 token 用量。執行 /statusline 設定底部狀態列，即時顯示 model、context 使用百分比、git branch、session 費用。社群推薦 ccstatusline 和 ccusage 套件。
第三，用 Subagent 做探索性研究。讓 Claude 在獨立 context 中完成大範圍掃描，只將結論摘要帶回主對話。
第四，把偶爾用的 workflow 從 CLAUDE.md 搬到 Skills。Skills 只在相關時載入；CLAUDE.md 每次對話都吃 context。
CLAUDE.md 寫法精要
CLAUDE.md 是 Claude Code 的「永久規則手冊」。好的 CLAUDE.md 是精煉的規則，壞的 CLAUDE.md 是一堆 copy-paste 的文件。
常見錯誤 vs 正確做法
| 常見錯誤 | 正確做法 |
|---|---|
| 把整份 API 文件貼進去 | 只放「每次都適用的規則」 |
| 把所有 workflow 步驟全寫在裡面 | 偶爾用的 workflow 移到 Skills |
| 超過 500 行的長篇大論 | 精簡、結構化、控制在 150-200 行 |
| 寫了但從不更新 | 用 /review-claudemd 定期優化 |
推薦結構
# CLAUDE.md
## Project Overview
Tech stack, architecture, key directories
## Development Commands
npm run dev, npm run test, npm run lint
## Code Conventions
Naming, file structure, import order
## Important Rules
- Always prefix commits: feat:, fix:, chore:
- Never modify files in src/legacy/
- Always run tests before committing
## Common Gotchas
Project-specific traps Claude should know
另外，CLAUDE.md 支援多層級載入：~/.claude/CLAUDE.md（全域）、專案根目錄（專案級）、子目錄（模組級）。Claude Code 會合併載入所有層級，所以你可以把通用規則放全域，專案特定的放在專案目錄。
定期讓 Claude 自己審閱 CLAUDE.md 並瘦身，也是社群公認能帶來「2 到 3 倍品質提升」的做法。
核心工作流：探索 → 計劃 → 實作 → 驗證
社群一致認為：在 Plan Mode 多花 2 分鐘，省下 20 分鐘的 refactor。
第一步：探索 Explore。 切換到 Plan Mode（Shift+Tab）。讓 Claude 只讀不寫，先搞清楚 codebase 結構。
第二步：計劃 Plan。 要求建立 spec.md，包含需求、技術選型、milestone。用 Ctrl+G 在編輯器中直接修改計劃。
第三步：實作 Implement。 切回 Normal Mode，按照計劃寫 code。要求 Claude 寫測試、執行、修復失敗。
第四步：驗證 & Commit。 讓 Claude commit、開 PR。裝 /install-github-app 後 Claude 會自動 review 你的 PR。
什麼時候跳過 Plan？如果你能用一句話描述 diff（改 typo、加 log line、rename variable），直接做就好。Plan 最適合不確定方向、多檔案改動、或不熟悉的 codebase 的情況。
Prompt 技巧：讓指令精準十倍
提供驗證標準
這是社群公認效果最大的單一技巧。不要說「實作 email 驗證」。要說「寫一個 validateEmail function，測試案例：[email protected] → true、invalid → false。實作完後跑測試。」
提示裡加入「運行測試 / linter / 預期輸出」，讓 Claude 自我驗證錯誤。直接貼原始錯誤日誌或 CI 輸出，然後說 "fix"。
指向具體檔案和 pattern
不要說「加一個 calendar widget」。要說「看 HotDogWidget.php 的實作 pattern，照著實作一個 calendar widget，支援月份選擇和前後翻頁。不要引入新 library。」
用 "think hard" 觸發深度推理
think hard 是關鍵字，會將 effort 設為 high 並觸發 Opus 4.6 的 adaptive reasoning。適合架構決策、複雜 debug、多步驟推理。簡單任務則降低 effort 省 token。也可以用 /effort 永久設定。
截圖驗證 UI 變更
「貼上截圖，實作這個設計，完成後截圖結果，與原始設計比對差異，列出差異後修復。」搭配瀏覽器擴充套件可自動化整個流程。
用 Git History 回答「為什麼」
不要問「為什麼 ExecutionFactory 的 API 這麼奇怪？」要說「看 ExecutionFactory 的 git history，摘要它的 API 是怎麼演變到現在的。」
讓 Claude 自我迭代
修復之後說「Update your CLAUDE.md so you don't make this mistake again.」它會自己寫規則，長期減少重複錯誤。這招很多重度使用者都在用。
挑戰它升級方案
輸出之後說「Knowing everything you know now, scrap this and implement the more elegant solution.」或「Grill me on these changes」。能明顯提升程式碼品質。
Skills、Subagents、Hooks 進階系統
這三個系統是 Claude Code 從「聊天工具」變成「開發作業系統」的關鍵。
Skills — 按需載入的專業知識
Skills 是 .claude/skills/ 目錄下的 Markdown 檔案。它們只在相關時才載入，不像 CLAUDE.md 每次都佔 context。
判斷法很簡單：規則幾乎每次都適用？放 CLAUDE.md。只有特定工作流才需要？做成 Skill。越多「應該是 Skill」的東西被塞進 CLAUDE.md，每輪對話浪費的 token 越多。
重複操作（像是 /techdebt 找重複程式碼、同步 Slack/Notion）做成 Skill，git 提交後還能跨專案複用。比每次重寫提示省 token，也更一致。
Subagents — 獨立 Context 的平行工人
Subagent 在獨立 context window 中執行任務，完成後只將結果摘要帶回主對話。
一個實用的模式是 Pipeline：第一個 subagent 設計 API 規格並寫入 docs/api-spec.md，第二個根據 spec 實作 backend，第三個寫整合測試。每個階段完成後才開始下一個。
但要注意：需要共享狀態的 subagent 會很混亂，兩個 subagent 編輯同一個檔案的結果是 last write wins。只在任務完全獨立時使用。
Hooks — 事件驅動的自動化
Hooks 在特定事件（工具呼叫前後、session 結束時）自動執行 shell 命令。用 Hooks，不要用 prompt，做任何「必須每次都執行」的事。
// ~/.claude/settings.json
{
"hooks": {
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{
"type": "command",
"command": "cd $CWD && npm test --bail 2>&1 | tail -10"
}]
}]
}
}
這個 hook 在每次檔案編輯後自動跑測試，輸出注入回 context，Claude 能立即看到是否破壞了什麼。其他常見用法包括 PreToolUse 攔截危險命令（像是 rm -rf）、PostToolUse 自動 Prettier 格式化、Stop Hook 完成時播放提示音。
MCP 伺服器：連接外部世界
MCP（Model Context Protocol）讓 Claude Code 連接外部服務。社群推薦幾個值得優先裝的 MCP：
| MCP 伺服器 | 用途 |
|---|---|
| Context7 | 為任何技術即時抓取最新文件，不用再手動複製貼上 |
| Playwright MCP | 讓 Claude 直接操作瀏覽器測試 UI |
| Gemini CLI fallback | Claude Code 的 WebFetch 無法存取部分網站時的備援方案 |
安裝 Playwright MCP 的指令：
claude mcp add -s user playwright npx @playwright/mcp@latest
一個要注意的地方：只載入需要的 MCP，避免上下文膨脹。加太多 MCP 伺服器反而會拖慢速度。
多 Session 平行開發
平行作業是進階使用者的生產力倍增器。
在 VS Code 中開多個 Claude Code pane，各自處理 codebase 的不同部分。確保它們操作不同檔案，避免衝突。
用 -p flag 可以跑 headless 批次模式：
for file in $(cat files-to-migrate.txt); do
claude -p "Migrate $file from class to hooks" \
--allowedTools "Edit,Bash(git commit *)" &
done
wait
Agent Teams 是比較新的實驗性功能，多個 parallel agent 各有獨立 context，透過共享任務清單互相協調。建議先從非 code 任務開始試（PR review、研究、debug 假設），等熟悉之後再用在實際開發上。
Auto Mode（Shift+Tab 切換）讓 Claude 在明確定義的任務上自主工作，無需逐步審批。適合信任度高的重複性工作。
高風險或長時間任務，可以用 tmux 在 Docker container 中跑另一個 Claude Code 實例，出錯了也不影響主環境。
每日效率 Top 15 技巧
這些是你每天都會用到的快捷操作：
| 技巧 | 說明 |
|---|---|
alias cc="claude --dangerously-skip-permissions" |
跳過權限確認，理解風險後再用 |
!git status |
用 ! 前綴直接執行命令，輸出進入 context |
Esc 中斷 / Esc+Esc 回溯 |
停止當前動作或開啟 checkpoint 回溯選單 |
--continue / --resume |
恢復最近對話或選擇特定 session |
| Pipe 組合 | git diff HEAD~1 | claude -p "寫摘要" |
Cmd+A 貼網頁全文 |
瀏覽器全選複製，直接貼回 Claude Code |
| 調高 max output tokens | 設定 CLAUDE_CODE_MAX_OUTPUT_TOKENS 環境變數 |
| Message Queuing | Claude 執行中繼續打字，它會依序處理 |
/cost |
追蹤當前 session 的 token 消耗與費用 |
/clone 或 /half-clone |
複製會話保持上下文乾淨 |
| Remote Control | 從手機或平板接續本地 session |
| Auto Memory | Claude 自動記錄它發現的模式和知識 |
--system-prompt |
精簡或完全覆蓋系統提示，節省 context |
| 語音輸入 | 用 SuperWhisper 等工具，說話速度是打字的 3 倍 |
| GitHub Codespaces | 在雲端環境跑 Claude Code，隨時切換機器 |
常見錯誤與避坑指南
根據社群經驗，這些是最容易踩到的坑：
所有東西塞進 CLAUDE.md。 把偶爾用的 workflow 移到 Skills。CLAUDE.md 應該只有真正每次都需要的規則。超過 200 行，是時候重構了。
不提供驗證回饋迴圈。 沒有測試、linter、截圖比對，Claude 只能產出「看起來對」的東西。加入驗證命令讓它自行檢查。
跳過 Plan 直接 Coding。 Claude 像一個過度熱情的 intern，什麼都想馬上做。複雜任務一定要先 Plan，避免解決錯誤的問題。
忽略 context window 管理。 不清除對話、不用 subagent、不監控 token 使用量。Context 滿了之後品質會明顯下降。
Checkpoint 不追蹤 bash 操作。 Esc+Esc 回溯只追蹤檔案編輯。database migration、bash 命令的副作用不會被 checkpoint 記錄。做破壞性操作前自己備份。
中途換模型。 這會破壞快取，社群建議一個 session 內不要切換模型。
最短可執行配置
如果你想快速開始，這是一個經過驗證的最小配置：
CLAUDE.md
- 專案目標
- 禁止事項
- 測試命令
- lint / typecheck 命令
- PR / branch 規則
- 常見坑
.claude/rules/
- frontend.md
- backend.md
- migrations.md
.claude/settings.json
- permissions allowlist
- PreToolUse hooks
- Notification hook
.claude/agents/
- reviewer.md
- security-reviewer.md
這種拆法符合官方的記憶、rules、hooks、subagents 設計，也最接近目前社群高效率的做法。
最值得立刻用的命令
/init # 初始化專案配置
/memory # 檢查載入的記憶規則
/permissions # 管理權限白名單
/hooks # 管理自動化 hooks
/context # 查看上下文占用狀態
/usage # 查看額度和 rate limit
/plan fix the auth bug # 進入 Plan Mode 處理特定問題
/effort medium # 設定思考力度
這些都是官方目前內建或推薦的核心入口，其中 /init、/memory、/permissions、/hooks、/context、/usage 直接對應能力上限的幾個槓桿：記憶、規則、上下文、權限、額度。
終極心法
把 Claude Code 當成一個非常快、記憶力完美、但需要明確方向的 intern。你負責方向和驗證，它負責探索和執行。你花在計劃和提供 context 的時間，會以十倍速度回報。
每次你發現自己在重複同樣的操作，停下來，把它變成一個 Skill、一個 Hook、或一個 Script。這就是從「使用 Claude Code」到「建構在 Claude Code 上」的轉變。
持續實踐加上迭代 CLAUDE.md，就是最大化 Claude Code 能力的最實在路徑。
快速上手四步驟
- 安裝 Claude Code，設定
cc別名，加上自訂 Status Line - 新專案運行
/init生成 CLAUDE.md - 任何複雜任務 → Plan Mode → 寫計劃 → 執行 + 測試循環
- 每週審視一次 CLAUDE.md 和 Skills，保持精簡
