2026 社群精華版 · 持續更新中

Claude Code 完全攻略

集合 Anthropic 官方文件、GitHub 社群 50+ 技巧、開發者實戰心得,
助你將 Claude Code 從「好用的工具」升級為「開發操作系統」

135K+
每日 GitHub commits 來自 Claude Code
200K
標準 Context Window tokens
7
核心可擴充系統
$100
/月 Max Plan 無限使用
目錄
  1. 心智模型:理解 Claude Code 的七層架構
  2. Context Window 管理 — 最重要的資源
  3. CLAUDE.md 寫法精要
  4. 核心工作流:探索 → 計劃 → 實作 → 驗證
  5. Prompt 技巧:讓指令精準 10 倍
  6. Skills、Subagents、Hooks 進階系統
  7. MCP 伺服器:連接外部世界
  8. 平行開發與自動化模式
  9. 日常效率技巧 Top 15
  10. 常見錯誤與避坑指南
  11. 熱門資源總整理(2026 精選)

理解 Claude Code 的七層架構

Claude Code 不是聊天機器人,而是一個代理式開發環境。它能讀取檔案、執行命令、修改程式碼,甚至在你離開時自主完成工作。所有功能都建構在七個可擴充系統之上:

📋
CLAUDE.md
持久性規則與上下文
每次對話自動載入
Skills
按需載入的專業知識
支援自動或手動觸發
🔀
Subagents
獨立 context 的子代理
隔離執行、回傳摘要
🪝
Hooks
事件驅動的 Shell 命令
自動攔截與強制執行
🔌
MCP
連接外部服務
DB、GitHub、Sentry 等
📦
Plugins
打包分發
Skills + Subagents + Hooks

核心原則:CLAUDE.md 放持久規則,Skills 放可重複工作流,Hooks 做自動化強制執行,Subagents 做 context 隔離。 把所有東西塞進 CLAUDE.md 是最常見的錯誤 — 它會浪費每一輪對話的 token。

Context Window 管理

幾乎所有最佳實踐都回歸到一個約束:Context Window 滿得很快,效能會隨之下降。你的整段對話、讀取的每個檔案、每段命令輸出全部擠在同一個 200K token 的窗口裡。

1頻繁使用 /clear
每開始新任務就清除對話。不需要讓舊歷史吃掉 token,也不需要 Claude 花時間做 compaction 壓縮。
2自訂 Status Line 監控 token
執行 /statusline 設定底部狀態列,即時顯示 model、context 使用百分比、git branch、session 費用。社群推薦 ccstatuslineccusage 套件。
3用 Subagent 做探索性研究
讓 Claude 掃描 30 個檔案會把 main context 塞爆。改用 subagent 在獨立 context 中完成,只將結論摘要帶回。
4Skills 比 CLAUDE.md 更省 token
Skills 只在相關時載入;CLAUDE.md 每次對話都吃 context。把偶爾使用的 workflow 從 CLAUDE.md 搬到 Skills。

CLAUDE.md 寫法精要

CLAUDE.md 是 Claude Code 的「永久規則手冊」,每次 session 都會自動載入。好的 CLAUDE.md 是精煉的規則;壞的 CLAUDE.md 是一堆 copy-paste 的文件。

❌ 常見錯誤

把整份 API 文件貼進去

把所有 workflow 步驟全寫在裡面

超過 500 行的長篇大論

寫了但從不更新

✅ 正確做法

只放「每次都適用的規則」

偶爾用的 workflow → 移到 Skills

精簡、結構化、有層次

/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 會合併載入所有層級。

探索 → 計劃 → 實作 → 驗證

社群一致認為:在 Plan Mode 多花 2 分鐘,省下 20 分鐘的 refactor

1
探索 Explore

切換到 Plan Mode(Shift+Tab)。讓 Claude 只讀不寫,瞭解 codebase 結構。

2
計劃 Plan

要求建立 spec.md,包含需求、技術選型、milestone。用 Ctrl+G 在編輯器中直接修改計劃。

3
實作 Implement

切回 Normal Mode,按照計劃寫 code。要求 Claude 寫測試、執行、修復失敗。

4
驗證 & Commit

讓 Claude commit、開 PR。裝 /install-github-app 後 Claude 會自動 review 你的 PR。

判斷何時跳過 Plan:如果你能用一句話描述 diff(改 typo、加 log line、rename variable),直接做。Plan 最適合不確定方向、多檔案改動、或不熟悉的 codebase。

讓指令精準 10 倍

5提供驗證標準(最高槓桿)
不要說「實作 email 驗證」。
要說「寫一個 validateEmail function,測試案例:[email protected] → trueinvalid → false。實作完後跑測試。」
社群共識:這是效果最大的單一技巧
6指向具體檔案和 pattern
不要說「加一個 calendar widget」。
要說「看 HotDogWidget.php 的實作 pattern,照著實作一個 calendar widget,支援月份選擇和前後翻頁。不要引入新 library。」
7用 "think hard" 觸發深度推理
think hard 是關鍵字,會將 effort 設為 high 並觸發 Opus 4.6 的 adaptive reasoning。適合架構決策、複雜 debug、多步驟推理。簡單任務則降低 effort 省 token。也可以用 /effort 永久設定。
8截圖驗證 UI 變更
「貼上截圖,實作這個設計,完成後截圖結果,與原始設計比對差異,列出差異後修復。」搭配 Chrome Extension 可自動化整個流程。
9用 Git History 回答「為什麼」
不要問「為什麼 ExecutionFactory 的 API 這麼奇怪?」
要說「看 ExecutionFactory 的 git history,摘要它的 API 是怎麼演變到現在的。」

Skills、Subagents、Hooks

這三個系統是 Claude Code 從「聊天工具」變成「開發操作系統」的關鍵。

Skills — 按需載入的專業知識

Skills 是 .claude/skills/ 目錄下的 Markdown 檔案。它們只在相關時才載入,不像 CLAUDE.md 每次都佔 context。

# .claude/skills/deploy-check/SKILL.md --- name: deploy-check description: Validate deployment readiness disable-model-invocation: true # 只能手動觸發 allowed-tools: [bash] --- 你的 skill 指令內容...
10Skill vs CLAUDE.md 的判斷法
規則幾乎每次都適用?→ CLAUDE.md。只有特定工作流才需要?→ Skill。越多「應該是 Skill」的東西被塞進 CLAUDE.md,每輪對話浪費的 token 越多。
11用 Plugin 安裝社群 Skills
執行 /plugin 瀏覽可用 plugin。推薦 dx plugin(含 clone、handoff、gha 等工具)和 Skills Toolkit。

Subagents — 獨立 Context 的平行工人

Subagent 在獨立 context window 中執行任務,完成後只將結果摘要帶回主對話。避免主 context 膨脹。

12Pipeline 模式:設計 → 實作 → 測試
「用 pipeline 建構這個功能:
1. 第一個 subagent:設計 API 規格,寫入 docs/api-spec.md
2. 第二個 subagent:根據 spec 實作 backend
3. 第三個 subagent:寫整合測試
每個階段完成後才開始下一個。」
13只用在獨立任務
需要共享狀態的 subagent 會很混亂。適合平行探索、讀文件、跑測試套件等互不依賴的工作。

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 能立即看到是否破壞了什麼。

MCP 伺服器

MCP(Model Context Protocol)讓 Claude Code 連接外部服務。社群推薦的關鍵 MCP:

14Context7 — 即時文件查詢
為任何技術即時抓取最新文件。不再需要 copy-paste 文件或指望 Claude 記得冷門的 React hook。
15Playwright MCP — 瀏覽器自動化
claude mcp add -s user playwright npx @playwright/mcp@latest。讓 Claude 直接操作瀏覽器測試 UI。
16用 Gemini CLI 當 fallback
Claude Code 的 WebFetch 無法存取 Reddit 等網站。建立一個 Skill,讓 Claude 用 tmux 操控 Gemini CLI 作為 fallback 抓取內容。

多 Session 平行開發

17多 pane 平行作業
在 VS Code 中開多個 Claude Code pane,各自處理 codebase 的不同部分。確保它們操作不同檔案,避免衝突(last write wins)。
18Non-interactive 批次模式
-p flag 跑 headless 模式,搭配 --allowedTools 限定工具範圍:
for file in $(cat files-to-migrate.txt); do claude -p "Migrate $file from class to hooks" \ --allowedTools "Edit,Bash(git commit *)" & done wait
19Agent Teams(實驗性)
多個 parallel agent 各有獨立 context,透過共享任務清單互相協調。一個當 team lead,其他當 teammate。先從非 code 任務開始試(PR review、研究、debug 假設)。
20Auto Mode 全自動執行
Shift+Tab 切換到 Auto Mode,Claude 可在明確定義的任務上自主工作,無需逐步審批。在 VS Code 設定中先啟用。
21Container 沙箱中的 Worker
用 tmux 在 Docker container 中跑另一個 Claude Code 實例,執行高風險或長時間任務。出錯了也不影響主環境。本地 Claude Code 最後把結果拉回來。

每日使用 Top 15 技巧

22cc alias + 跳過權限
~/.zshrc 加入 alias cc="claude --dangerously-skip-permissions"。每次開 session 不用再手動按同意。(理解風險後再用)
23! 前綴直接執行命令
輸入 !git status!npm test,命令立即執行,輸出也會進入 context。比叫 Claude 幫你跑更快。
24Esc 中斷 / Esc+Esc 回溯
Esc 停止 Claude 當前動作但保留 context。Esc+Esc(或 /rewind)開啟 checkpoint 回溯選單,可恢復程式碼、對話或兩者。
25--continue / --resume
claude --continue 恢復最近對話。claude --resume 開啟 session picker 選擇恢復。
26Pipe 組合工作流
git diff HEAD~1 | claude -p "寫一段 Slack 更新摘要"
claude -p "分析架構" | claude -p "轉成 3 點 onboarding 摘要"
27Cmd+A 貼網頁全文
瀏覽器 Cmd+A 全選複製,貼回 Claude Code。Gmail 可先按「Print All」展開所有信件;YouTube 按「Show transcript」。
28調高 max output tokens
預設上限 32K token。大型 refactor 或分析不夠用時,設定環境變數 CLAUDE_CODE_MAX_OUTPUT_TOKENS 提高(Sonnet 4.5 支援到 64K)。
29Message Queuing 排隊輸入
Claude 執行中時繼續打字輸入多個 prompt,它會依序處理。不用等一個完成才打下一個。
30/cost 追蹤花費
隨時用 /cost 查看當前 session 的 token 消耗與費用。搭配 effort level 調整:簡單任務降低 effort,複雜任務用 think hard。
31GitHub Codespaces 雲端環境
在 Codespace 中跑 Claude Code,用 Codespace Secrets 管理 API key 和環境變數,還能隨時切換高效能機器。
32Remote Control 遠端接續
從手機、平板或任何瀏覽器接續本地 Claude Code session。出門也能繼續 review。
33Auto Memory 自動記憶
Claude Code 會在工作過程中自動記錄它發現的模式和知識。不像你寫的 CLAUDE.md,這是 Claude 寫給自己的筆記。
34自訂 Spinner 文字
告訴 Claude:「把我的 spinner verbs 換成哈利波特咒語」。純粹好玩但能讓開發更有樂趣。
35--system-prompt 精簡提示
--system-prompt flag 完全覆蓋系統提示,或用社群技巧縮減預設系統提示長度,節省 context。
36語音輸入加速溝通
本地語音轉文字模型即使有 typo,Claude 也夠聰明理解你的意思。比打字快得多,像跟同事講電話一樣自然。

常見錯誤與解決方案

!所有東西塞進 CLAUDE.md
把偶爾用的 workflow 移到 Skills。CLAUDE.md 應該只有真正每次都需要的規則。如果 CLAUDE.md 超過 200 行,是時候重構了。
!不提供驗證回饋迴圈
沒有測試、linter、截圖比對,Claude 只能產出「看起來對」的東西。加入驗證命令讓 Claude 自行檢查。
!跳過 Plan 直接 Coding
Claude 像一個過度熱情的 intern — 什麼都想馬上做。複雜任務一定要先 Plan,避免解決錯誤的問題。
!忽略 context window 管理
不清除對話、不用 subagent、不監控 token 使用量。Context 滿了之後 Claude 的品質會明顯下降。
!Checkpoint 不追蹤 bash 操作
Esc+Esc 回溯只追蹤檔案編輯。database migration、bash 命令的副作用不會被 checkpoint 記錄。做破壞性操作前自己備份。
!Subagent 共享狀態
兩個 subagent 編輯同一個檔案 → last write wins。只在任務完全獨立時使用 subagent。

終極心法

把 Claude Code 當成一個非常快、記憶力完美、但需要明確方向的 intern。你負責方向和驗證,它負責探索和執行。你花在計劃和提供 context 的時間,會以十倍速度回報。

每次你發現自己在重複同樣的操作 — 停下來,把它變成一個 Skill、一個 Hook、或一個 Script。這就是從「使用 Claude Code」到「建構在 Claude Code 上」的轉變。

2026 最熱門 Claude Code 資源

以下是社群公認最有價值的資源,按類別整理,星數為 2026 年 4 月快照。

🏛️ 官方文件與工具

Claude Code 官方文件
code.claude.com/docs
安裝、設定、Best Practices、Skills、Hooks、Subagents、MCP、Agent SDK 全部涵蓋。文件更新頻率極高,是最權威的第一手來源。
必讀
Claude Code GitHub Repo ⭐ 55K
github.com/anthropics/claude-code
官方 CLI 原始碼。Issues 是挖掘 edge case 解法的寶庫。
Claude Skills 官方倉庫 ⭐ 37.5K
github.com/anthropics/skills
Agent Skills 公共倉庫,包含 Anthropic 官方 Skills 和社群精選。遵循開放標準,可跨工具使用(Claude Code、Cursor、Gemini CLI、Codex)。
Claude Code Python SDK ⭐ 4K
github.com/anthropics/claude-code-sdk-python
用 Python 程式化控制 Claude Code,適合自動化工作流整合。
Claude Code Security Review ⭐ 2.8K
github.com/anthropics/claude-code-security-review
AI 驅動的安全審查 GitHub Action,自動分析 code changes 中的安全漏洞。

📚 社群精選指南

1awesome-claude-code
github.com/hesreallyhim/awesome-claude-code
精選 Skills、Hooks、Slash Commands、Agent Orchestrators、Plugins 的策展清單。社群維護,持續更新。
Awesome List
2claude-code-best-practice ⭐ 高人氣
github.com/shanraisshan/claude-code-best-practice
收錄所有 Boris Cherny(Claude Code 創建者)和 Thariq、Cat 等 Anthropic 工程師的推文、文章、影片,按時間排序。從創建者視角理解設計意圖的最佳入口。
創建者視角
3Claude Code Ultimate Guide
github.com/FlorianBruniaux/claude-code-ultimate-guide
從入門到 Power User 的完整文件站。含生產就緒模板、Agentic Workflow 指南、互動測驗、Cheatsheet。CC BY-SA 4.0 授權。
最完整
4claude-code-tips ⭐ 3K
github.com/ykdojo/claude-code-tips
YK Dojo 的 45+ 技巧合集。同時也是 dx Plugin — 安裝後可用 /dx:clone/dx:handoff/dx:gha 等指令。含自訂 status line 腳本、Reddit fallback skill。
Plugin 即裝即用
5awesome-claude-skills
github.com/ComposioHQ/awesome-claude-skills
Composio 維護的 Skills 策展清單。涵蓋前端設計、D3 視覺化、iOS Simulator、Playwright 自動化、TDD、Git Worktrees 等數十種 Skills。
Skills 百科
6Claude Code CLI Guide(41K 字)
blakecrosley.com/guides/claude-code
210 分鐘閱讀的深度參考手冊。覆蓋 Settings、Env Vars、Hooks、MCP、Permissions、Subagents,含預設值與 Gotchas。2026 年 4 月更新。
深度參考

🔌 必裝 Plugins & Skills

1Context7 — 即時文件查詢
claude plugin install context7
Claude 寫程式碼時自動抓取任何技術的最新文件。不再依賴 training data 中可能過時的 API。
社群票選 #1 MCP
2Frontend Design Skill ⭐ 277K+ 安裝
Anthropic 官方 Skill
引導 Claude 在寫任何 UI 程式碼前先確立大膽的設計方向,避免千篇一律的 AI 美學(Inter 字體 + 紫色漸層)。
最多人裝的官方 Skill
3Superpowers Plugin
/plugin marketplace add obra/superpowers-marketplace
完整的 Agentic 開發工作流框架:brainstorm → design spec → implementation plan → subagent 執行 → review → merge。
全流程框架
4claude-hud ⭐ 2.7K
Claude Code HUD Plugin
即時視覺化 Dashboard — context 使用率、活躍工具、執行中 agent、todo 進度。比純文字 status line 更直覺。
5Google Workspace CLI (gws) ⭐ 4.9K
npm install -g @googleworkspace/cli
一行指令讓 Claude Code 存取 Google Drive、Gmail、Calendar、Sheets。內建 MCP server,3 天內衝到 4.9K stars。
3 天破 4.9K stars
6Security Guidance Plugin
claude plugin install security-guidance
自動掃描 OWASP Top 10、驗證漏洞、硬編碼 secret、不安全配置。DevOps 和後端工程師必裝。

🎥 影片 & Podcast

Boris Cherny 系列訪談
Claude Code 創建者 Boris Cherny 在 Y Combinator、Lenny's Podcast、The Pragmatic Engineer 等頻道的深度訪談。了解設計哲學和發展方向的最佳來源。
創建者親述
Ado 的 Advent of Claude 系列
Anthropic DevRel Ado 在 2025 年 12 月發布的每日 Claude Code 技巧系列。目前持續在 X 上分享新技巧。追蹤 @adocomplete。
官方 DevRel
Everything We Got Wrong About Research-Plan-Implement
MLOps Community 2026 年 3 月的演講,由 Dex 主講,反思 Plan Mode 的常見誤用。理解「何時該跳過計劃」的最佳影片。

💬 社群

💬Reddit 社群
r/ClaudeAI · r/ClaudeCode · r/Anthropic
即時問題排解、workflow 分享、新功能討論的主要陣地。
💬Agentic Coding Substack — YK Dojo
agenticcoding.substack.com
YK Dojo 持續發布的 Claude Code 深度技巧文章,從基礎到進階,含完整程式碼範例。
💬scriptbyai.com — 資源大全
scriptbyai.com/claude-code-resource-list
100+ 精選資源的策展清單,按 GitHub stars 排序,持續更新。類別涵蓋 Agents、Skills、Plugins、Subagents、Workflows。
100+ 精選

⚡ 快速安裝清單

# 必裝 Plugin claude plugin install context7 claude plugin install security-guidance # Playwright MCP(瀏覽器自動化) claude mcp add -s user playwright npx @playwright/mcp@latest # Google Workspace(Drive, Gmail, Calendar, Sheets) npm install -g @googleworkspace/cli gws mcp -s drive,gmail,calendar,sheets # dx Plugin(社群工具組合包) # 含 clone、handoff、gha、review-claudemd、reddit-fetch # 見 github.com/ykdojo/claude-code-tips # Superpowers 全流程框架 /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace # HUD 視覺化儀表板 # 見 github.com/jhchabran/claude-hud