Claude Code 完整指南：從安裝到多代理平行協作的實戰手冊

當 AI 不再只是回答問題，而是直接替你寫程式、執行部署、甚至在你睡覺時自我優化——這就是 Claude Code 真正改變遊戲規則的地方。

2024 年底，Anthropic 發布了 Claude Code，這個工具不只是另一個程式設計助手。它是一個本機 AI 代理（AI Agent），直接存在於你的終端機或 IDE 中，能夠自主讀寫本地檔案、執行 bash 指令、控制瀏覽器，甚至派遣子代理平行完成複雜任務。Vibe Coding 的概念隨之流行——你不再需要複製貼上 AI 輸出，Claude Code 自己幫你把程式碼寫進專案並部署上線。

本文綜合多個實戰案例與官方文件，提供從環境安裝到多代理協作的完整指南，幫助你真正發揮 Claude Code 的全部潛力。

Claude Code 是什麼？為什麼它不只是「AI 聊天」？

在理解 Claude Code 之前，必須先搞清楚一個關鍵概念：代理框架（Agent Harness）。

所有大型語言模型（LLM）本質上只是「文字輸入、文字輸出」的系統，它們存在於封閉的文字空間中，無法直接對現實世界採取行動。Claude Code 就是包裹在 Claude 模型外層的 Harness——它賦予 AI 操控真實電腦的能力：

graph TD
    A[使用者指令] --> B[Claude Code Harness]
    B --> C{工具選擇}
    C --> D[bash 終端機]
    C --> E[讀寫本地檔案]
    C --> F[網頁瀏覽]
    C --> G[MCP 外部工具]
    D --> H[實際執行結果]
    E --> H
    F --> H
    G --> H
    H --> I[任務完成 / 持續迭代]

這個架構的核心差異在於：ChatGPT 告訴你「應該這樣寫」，Claude Code 則直接幫你寫好、存好、跑好。開發者不再需要在 AI 對話框和編輯器之間反覆複製貼上，AI 已成為真正的合作開發夥伴。

環境安裝：三步驟上手 Claude Code

先決條件

使用 Claude Code 需要 Anthropic 的付費方案，免費方案不包含此功能。目前可用的方案包括 Pro、Max、Team 和 Enterprise，根據官方 claude.ai 定價頁，Pro 方案為一般個人使用者的入門選擇。

安裝方式一：終端機全域安裝（推薦）

# Mac / Linux
npm install -g @anthropic-ai/claude-code

# 或使用 curl（詳見官方文件）
curl -fsSL https://code.claude.ai/install.sh | sh

安裝完成後，在任意目錄輸入 claude 啟動，首次使用需輸入 /login 完成瀏覽器驗證。

安裝方式二：IDE 擴充套件（視覺化介面）

在 VS Code 或 Anti-gravity 的擴充套件市場搜尋 Claude Code，選擇帶有 Anthropic 官方藍勾勾的版本安裝。IDE 版本提供與終端機相同的功能，但有更直觀的視覺介面，適合不習慣純終端機操作的使用者。

flowchart LR
    A["安裝 Claude Code"] --> B{"選擇介面"}
    B --> C["終端機模式\nnpm install -g"]
    B --> D["IDE 擴充套件\nVS Code / Anti-gravity"]
    C --> E["輸入 claude 啟動"]
    D --> E
    E --> F["/login 驗證"]
    F --> G["開始使用 ✅"]

建立專案大腦：claude.md 的核心設計原則

claude.md 是 Claude Code 系統中最關鍵的單一文件。每次工作階段開始時，Claude 會自動載入它，在任何指令執行前就讀取這份「簡報文件」。

沒有 claude.md，就像每天早上聘請一位完全不記得昨天發生什麼事的承包商——你每次都要從頭解釋專案背景、規範和已試過但無效的方案，浪費大量時間與 Token。

使用 /init 自動生成

在新專案目錄中啟動 Claude Code 後輸入：

/init

Claude 會掃描整個程式碼庫，自動生成一份結構化的 claude.md，概述現有架構、技術棧和建議規則。這是全新專案的最佳起點。

claude.md 設計原則

有效規則範例：

# 專案規則（依重要性排序）

- 永遠不使用相對匯入路徑，只用絕對路徑
- 所有資料庫操作必須使用交易（transaction）
- 禁止刪除資料列，使用軟刪除（soft delete with deleted_at）
- CSS 統一使用 Tailwind，禁用 inline styles
- API 路由必須包含輸入驗證

開發自訂 Skills：讓 Claude 重複執行你的專屬工作流

Skills 是 Claude Code 最強大的功能之一，也是真正實現工作自動化的關鍵。Skill 就是把你日常重複性的知識工作封裝成可隨時調用的「可執行清單加腳本」的組合。

Skills 目錄結構

.claude/
└── skills/
    └── my-skill-name/
        ├── SKILL.md          # 觸發條件 + 執行步驟
        └── scripts/
            ├── main.py       # 主要邏輯腳本
            └── helpers.sh    # 輔助 Shell 腳本

漸進式揭露設計（Progressive Disclosure）

Skills 的設計採用三層載入機制，極度節省 Context Window：

graph LR
    A[第一層：YAML 標頭\n永遠載入\n~60 tokens] --> B[第二層：SKILL.md 主體\n被觸發時載入\n完整執行步驟]
    B --> C[第三層：外部腳本\n按需導航\n Python / Bash]

SKILL.md 範例結構：

---
name: scrape-leads
description: |
  當使用者需要抓取潛在客戶名單時使用。
  觸發詞：抓取名單、scrape leads、找潛在客戶
---

## 執行步驟

1. 讀取 .claude/skills/scrape-leads/scripts/scraper.py
2. 確認目標 URL 和篩選條件
3. 執行腳本並輸出至 output/leads-{date}.csv
4. 更新 leads-log.md 記錄此次抓取

與 MCP 工具相比，Skills 的成本模型截然不同：

MCP 整合：讓 Claude 連接外部世界

MCP（Model Context Protocol，模型上下文協議） 是讓 Claude Code 連接現實世界應用程式的萬能介面。透過安裝 MCP 伺服器，Claude 能直接操控幾乎所有主流軟體。

熱門 MCP 推薦

Chrome DevTools MCP 實戰範例

安裝 Chrome DevTools MCP 後，你可以這樣指示 Claude：

幫我去 calendly.com 預約 3 月 30 日下午 3 點，30 分鐘的會議
姓名：Wei-Chih，信箱：test@example.com

Claude 會自動開啟 Chrome，導航到 Calendly，填寫表單並完成預約——過去需要 1 分鐘的人工操作，現在 Claude 在背景完全自動執行。

# 安裝 NotebookLM MCP（零成本知識庫系統）
claude mcp add notebooklm npx notebooklm-mcp@latest

四大權限模式與上下文管理

權限模式切換（Shift + Tab）

stateDiagram-v2
    [*] --> AskBeforeEdits: 預設模式
    AskBeforeEdits --> EditAutomatically: 信任 Claude 自動執行
    EditAutomatically --> PlanMode: 需要先規劃架構
    PlanMode --> BypassPermissions: 批量重複性任務
    BypassPermissions --> AskBeforeEdits: 回到謹慎模式

Plan Mode 是省錢神器：在此模式下，Claude 只讀取、搜尋、推理，產生架構藍圖但不修改任何檔案。建錯的代價是建對的 10 倍，先規劃再動手是必要原則。

上下文管理三大指令

/cost      # 查看目前 Session 的 Token 花費（建議每 15 分鐘確認）
/clear     # 切換新任務時清空對話（最被低估的指令）
/compact   # 將冗長對話壓縮為高密度摘要，保留重要資訊

上下文空間管理：把 Context Window 想像成一個房間——系統工具是固定家具，claude.md 是你帶入的書架，MCP 工具是額外設備，對話是進入房間的人。人太多時開始推擠（auto-compaction），你的任務是保持房間盡量寬敞。

五大核心應用場景

1. 全端應用快速開發（Vibe Coding）

Claude Code 能在幾分鐘內建置帶有登入系統、Supabase 資料庫和 Stripe 金流的全端應用程式。典型的 Vibe Coding 流程如下：

sequenceDiagram
    participant U as 開發者
    participant C as Claude Code
    participant F as 檔案系統
    participant G as GitHub

    U->>C: 「建立一個提案生成平台，要有登入和 PDF 輸出」
    C->>C: Plan Mode - 規劃架構
    C->>U: 展示架構藍圖
    U->>C: 確認藍圖
    C->>F: 建立前端 / 後端 / 資料庫 Schema
    C->>C: 自動測試功能
    C->>G: git add & commit & push
    C->>U: 「完成，已部署至 Netlify」

截圖迴圈設計技法：給 Claude 一張你喜歡的網站截圖，讓它反覆截圖比對自己的產出並自動修正差距，最終達到 95% 以上的相似度。

2. 行銷自動化工作流

Claude Code 能接管整個行銷生產流程。建立以下 Skills 組合後，一條 YouTube 影片連結可以自動產生：

• LinkedIn 貼文（調整為平台原生語氣）
• 電子報草稿（品牌語調一致）
• Twitter/X 串文（精煉關鍵洞察）
• Nano Banana 品牌圖表（符合品牌配色的視覺圖像）

3. 多代理平行協作（Sub-agents & Agent Teams）

當任務規模龐大時，Claude 可作為主管代理（Orchestrator），平行分發任務給多個子代理，大幅提升處理速度：

graph TD
    O[主管代理 Orchestrator] --> A[代碼審查代理 x10\n尋找 Bug]
    O --> B[測試代理 x5\n執行測試套件]
    O --> C[研究代理 x3\n查閱 API 文件]
    A --> R[彙整報告]
    B --> R
    C --> R
    R --> O

三大核心子代理：

• Code Reviewer：自動審查所有拉取請求，識別潛在問題
• Researcher：查閱技術文件、API 規格，蒐集最新資訊
• QA Agent：執行測試套件，確認功能正常

子代理的真正價值在於平行化：沒有子代理時，Claude 必須依序完成寫代碼→審查→測試→修正；有子代理時，審查和測試在寫代碼完成的瞬間同步啟動，速度呈倍數提升。

4. AutoResearch 自我進化系統

結合 Andrej Karpathy 開源的 AutoResearch 框架，可以讓 Claude Code 具備自我優化能力：

graph LR
    A[設定評分標準\n如：冷信回覆率] --> B[AI 執行 A/B 測試]
    B --> C[自動評分]
    C --> D{結果改善?}
    D --> |是| E[保留變更]
    D --> |否| F[捨棄並嘗試新方向]
    E --> B
    F --> B
    B --> |一夜運算| G[最佳化 Skill / 代碼]

實際案例：一位開發者設定網站載入速度為評分指標，AutoResearch 在 67 次測試後，將頁面載入時間從 1,100ms 降至 67ms，改善幅度 81.3%——全程無需人工介入。

5. 日常辦公與零成本知識庫（RAG）

個人法律助理：Claude Code 能在 60 秒內讀取整份合約 PDF，揪出高風險條款（如：客戶保留所有作品所有權的隱藏條款），並自動生成反提案文件。

NotebookLM RAG 系統：將大型技術文件（如 99,000 行的 N8N 文件）上傳至 Google NotebookLM，再透過 MCP 連接 Claude Code，就能在終端機直接查詢完整文件。這個方案完全免費，把繁重的 RAG 運算交給 Google 處理，每次查詢節省大量 Token。

Dispatch 遠端派遣：Anthropic 最新推出的 Dispatch 功能允許你直接在手機上的 Claude App發送文字訊息，觸發家中或辦公室實體電腦上的 Claude Code 在背景執行任務——即便你在健身房或通勤途中。

進階技巧：讓 Claude 更聰明的實用模式

Git Worktrees 平行開發

使用 Git Worktrees 讓多個 Claude Code 實例同時在不同功能分支工作，互不干擾：

# 建立新的工作樹
git worktree add ../feature-a feature-a
git worktree add ../feature-b feature-b

# 在各目錄分別啟動 Claude Code

漸進式 Compaction 策略

在長時間工作階段中，定期使用 /compact 附帶壓縮指令，告知 Claude 保留哪些資訊最為重要：

/compact 請保留：1) 所有已完成的功能清單 2) 待解決的 Bug 列表 3) 當前架構決策

評分驅動的提示詞優化

為 Skills 建立客觀評分指標（如：輸出準確率、執行速度），讓 AutoResearch 框架自動迭代最佳化 SKILL.md 的提示詞，隔天你就擁有更聰明的 Skill。

常見問答

Claude Code 適合非工程師使用嗎？ 完全適合。Claude Code 的核心價值之一就是讓非工程師也能透過自然語言描述需求並獲得實際產出。從文案撰寫到資料分析，只要能清楚描述你需要什麼，Claude Code 就能執行。

使用 Claude Code 花費高嗎？如何控制成本？ 成本取決於使用量。建議善用 /cost 指令監控花費、在切換任務時使用 /clear、善用 Plan Mode 避免反覆重構、以及用 Skills 取代部分 MCP 工具（前者更省 Token）。Claude Pro 方案每月固定費率，適合個人使用者。

子代理系統真的實用嗎？有風險嗎？ 子代理在複雜任務（如大型程式碼庫重構、多文件平行生成）時效果顯著，但在簡單任務上反而增加協調成本和出錯率。建議先以單一代理完成任務，確認能力邊界後再考慮加入子代理。

claude.md 應該加什麼最有效？ 三類規則最有價值：（1）不可違反的技術規範（如：禁用某套件、強制使用軟刪除）；（2）專案特定的路徑和慣例；（3）Claude 已犯過 2-3 次的錯誤。避免加入模糊規則或大段說明文字。

總結

Claude Code 代表了一個根本性的轉變：AI 不再是輔助工具，而是真正的程式設計夥伴。從安裝設定的五分鐘入門，到 claude.md 建構的專案大腦，再到 Skills 生態系的可重複自動化、MCP 協議的外部整合，以及多代理協作和 AutoResearch 自我進化——每一層都在擴展 AI 工作的邊界。

今天就能開始的三步驟：

1. 安裝 Claude Code（npm install -g @anthropic-ai/claude-code）
2. 在專案目錄執行 /init 生成 claude.md
3. 把一個重複性任務封裝成你的第一個 Skill

AI 代理時代已然到來，Claude Code 是目前最務實、最貼近真實工作流的入口。

參考資料

1. Claude Code 官方文件 — Anthropic
2. AutoResearch by Andrej Karpathy — GitHub
3. NotebookLM MCP 整合教學 — GitHub 社群
4. Claude Code Dispatch 功能說明 — Anthropic 官方部落格
5. V-JEPA 2 機器人規劃論文 — Meta AI Research