Skip to main content

Claude Code 教程

從零到專家的 Claude Code 完整教學，包含多代理自動化進階內容。

🇹🇼 繁體中文

📚 本教程涵蓋內容​

本教程將帶您從零開始，逐步掌握 Claude Code（Anthropic 推出的 AI 程式碼助理）。您將透過 20 堂精心設計的課程，循序漸進地學習。

已更新至 Claude Code 2.1.33！

學習路徑​

┌─────────────────────────────────────────────────────────────┐
│                    階段 1：入門                              │
│  第 1 課：安裝與首次使用                                      │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                   階段 2：基礎                               │
│  第 2-4 課：基本操作、程式庫、權限                             │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                  階段 3：擴展                               │
│  第 5-7 課：技能、設定、MCP                                   │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                   階段 4：進階                               │
│  第 8-10 課：子代理、Git、整合式開發環境                       │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                    階段 5：精通                              │
│  第 11-13 課：工作流程、最佳實踐、參考資料                     │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                 階段 6：專家（v2.1+）                         │
│  第 14-17 課：多代理、工作樹、多 AI、生態系統                  │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│            階段 7：最前線技術（2.1.33 新增！）                  │
│  第 18-20 課：代理團隊、分叉情境、進階主題                      │
└─────────────────────────────────────────────────────────────┘

🚀 快速開始​

Claude Code 新手？​

  1. 閱讀本目錄 - 完整教程索引
  2. 從第 1 課：入門指南開始
  3. 按順序完成課程
  4. 使用範例專案練習

已有基礎？​

直接跳躍到專家課程：

📖 教程內容​

階段 1：入門​

  • 第 1 課： 安裝、設定和首次使用（20 分鐘）

階段 2：基礎技能​

  • 第 2 課： 聊天模式、讀取檔案、進行編輯（25 分鐘）
  • 第 3 課： 導覽程式庫、搜尋、重構（30 分鐘）
  • 第 4 課： 權限模式和計畫模式（25 分鐘）

階段 3：擴展工具組​

階段 4：進階功能​

  • 第 8 課： 子代理、背景任務、Hook（30 分鐘）
  • 第 9 課： Git 工作流程（25 分鐘）
  • 第 10 課： 整合式開發環境和桌面應用程式（20 分鐘）

階段 5：精通​

階段 6：專家級 ⭐ 新增！​

  • 第 14 課： 多代理自動化（45 分鐘）

    • 自動執行多個 Claude Code 實例
    • 代理協調和通訊
    • 自動任務分配
    • 衝突解決
    • 包含完整可運作系統！

  • 第 15 課： Git 工作樹（20 分鐘）

    • 在多個分支上並行開發
    • 無需切換情境的 hotfix
    • 多代理 worktree 工作流程
    • 最佳實踐和清理

  • 第 16 課： 多 AI 編排（30 分鐘）

    • 產生 Aider、Cursor、Gemini、Continue
    • 協調多個 AI 工具
    • 建構多 AI 工作流程
    • 與多代理系統結合

  • 第 17 課： 生態系統與市集（30 分鐘）

    • 探索社群技能與外掛
    • 尋找與安裝 MCP 伺服器
    • 分享您自己的貢獻
    • 發布的最佳實踐

階段 7：最前線技術（2.1.33 新增！）⭐​

  • 第 18 課： 代理團隊與隊友（40 分鐘）

    • 什麼是代理團隊及使用時機
    • 分割窗格協作（tmux、WezTerm、iTerm2）
    • 建立和管理代理團隊
    • 隊友通訊模式
    • spawnTeam 功能性

  • 第 19 課： 分叉情境與進階技能（35 分鐘）

    • 瞭解分叉子代理情境
    • 技能熱重載（2.1.x 自動！）
    • 技能 frontmatter 中的情境分叉
    • 回應語言設定
    • 進階技能組態
    • 技能中的代理指定

  • 第 20 課： 2.1.x 進階功能（40 分鐘）

    • 萬用字元權限模式：Bash(*)、Bash(npm *)
    • 增強的 hooks（技能、代理、指令）
    • 工作階段分叉與倒轉
    • 外部編輯器支援（Ctrl+G）
    • 增強的 vim 動作
    • 任務相依性與追蹤
    • WezTerm 對代理團隊的支援

📁 範例專案​

../examples/ 目錄包含實作專案：

1. Hello World​

位置： ../examples/hello-world/

  • 簡單的入門專案
  • 練習基本操作
  • 學習檔案權限

2. 範例專案​

位置： ../examples/sample-project/

  • 完整的專案結構
  • 計算機、API、工具程式
  • 包含測試套件
  • 練習導覽和重構

3. 多代理系統 ⭐ 新增！​

位置： ../examples/multi-agent/

  • 完整可運作的多代理系統
  • 編排腳本
  • 即時監控
  • 通訊協定
  • 準備好執行！
cd ../examples/multi-agent
./scripts/orchestrate.sh    # 啟動代理
./scripts/monitor.sh        # 觀看他們工作
./scripts/stop.sh           # 完成時停止

📊 教程統計​

  • 20 堂完整課程 - 從初學者到專家
  • 15,000+ 行 全面內容
  • 3 個範例專案 - 實作練習
  • 可運作腳本 - 真實的多代理與代理團隊系統
  • 12-14 小時 預估完成時間
  • 繁體中文翻譯 - 完整翻譯
  • 已更新至 2.1.33 - 涵蓋最新功能

🎯 您將學到什麼​

初學者（第 1-4 課）​

  • 安裝和設定 Claude Code
  • 基本檔案操作
  • 瞭解權限
  • 導覽程式庫

中級（第 5-7 課）​

  • 自訂技能
  • 設定管理
  • MCP 整合
  • 專案情境

進階（第 8-10 課）​

  • 子代理（Explore、Plan、Bash）
  • 背景任務
  • Git 工作流程
  • IDE 整合

專家（第 11-16 課）​

  • 真實工作流程
  • 效能最佳化
  • 多代理自動化 ⭐
  • Git 工作樹工作流程 ⭐
  • 多 AI 編排 ⭐
  • 生產環境模式

🌟 主要特色​

漸進式學習​

每堂課都建立在先前知識上，具有清楚的目標和先決條件。

實作練習​

每堂課都包含「親手試試看」練習，使用真實程式碼。

真實範例​

從 bug 修正到功能開發，範例反映實際工作。

完整參考​

第 13 課提供完整的指令參考。

多代理系統 ⭐ 新增！​

第 14-16 課包含完整可運作的系統：

  • 協調多個 Claude Code 實例
  • 使用 git worktree 進行並行開發
  • 編排多個 AI 工具

🎓 適合不同學習者​

自學者​

  • 從第 1 課開始，按順序學習
  • 完成每個練習
  • 使用範例專案練習

培訓師​

  • 使用學習目標進行課程規劃
  • 使用範例專案示範
  • 使用測驗檢查知識

團隊​

  • 標準化共同工作流程
  • 建立團隊專屬技能
  • 設定共享配置

🔧 先決條件​

  • 終端機/命令列 - 基本熟悉度
  • 程式碼編輯器 - VS Code、JetBrains 或類似工具
  • API 帳號 - Anthropic 帳號用於驗證

📂 檔案結構​

cc-tutorial/
├── README.md                    # 英文版主頁
├── docs/
│   ├── README.md                # 英文教程索引
│   ├── 01-getting-started.md    # 第 1 課
│   ├── ...
│   └── examples/                # 範例專案
├── docs-zh-tw/                  # 繁體中文版 ← 您在這裡
│   ├── README.md                # 教學索引（本檔案）
│   ├── 01-getting-started.md    # 第 1 課
│   ├── ...
│   ├── 14-multi-agent-automation.md  # ⭐ 新增：多代理系統
│   ├── 15-git-worktree.md            # ⭐ 新增：Git worktree
│   ├── 16-multi-ai-orchestration.md  # ⭐ 新增：多 AI 協作
│   └── 17-ecosystem-marketplace.md   # ⭐ 新增：社群與市集
│   └── examples/                # 與英文版共用的範例
│       ├── hello-world/         # 簡單入門
│       ├── sample-project/      # 完整專案
│       └── multi-agent/         # ⭐ 新增：可運作系統
│           ├── scripts/         # 編排腳本
│           └── claude-agents.json

🚀 快速指令​

開始學習​

# 閱讀主頁
cat README.md

# 閱讀第 1 課
cat 01-getting-started.md

嘗試多代理系統​

cd ../examples/multi-agent
./scripts/orchestrate.sh         # 啟動代理
./scripts/monitor.sh             # 監控進度
./scripts/stop.sh                # 停止代理

執行範例​

# Hello World
cd ../examples/hello-world
python hello.py

# 範例專案
cd ../examples/sample-project
python src/calculator.py
pytest tests/

💡 成功秘訣​

  1. 按順序學習 - 每堂課都建立在先前內容上
  2. 動手練習 - 實作練習是必要的
  3. 自由實驗 - 嘗試範例的變化
  4. 提出問題 - 使用 Claude Code 本身來探索
  5. 經常參考 - 第 13 課是您的查詢指南

🆕 新增內容​

專家課程（第 14-16 課）​

最先進的 Claude Code 內容：

第 14 課：多代理自動化

  • 自動執行多個代理
  • 基於檔案、MCP 和 HTTP 通訊
  • 即時監控儀表板
  • 衝突解決策略
  • 生產環境就緒模式

第 15 課：Git 工作樹

  • 在多個分支上並行開發
  • 無需切換情境的 hotfix
  • 多代理 worktree 工作流程
  • 分支之間的完全隔離

第 16 課：多 AI 編排

  • 產生其他 AI 工具（Aider、Cursor、Gemini）
  • 自動協調多個 AI 工具
  • 建構多 AI 工作流程
  • 與多代理系統結合

第 17 課：生態系統與市集（新增！）

  • 探索社群技能與外掛
  • MCP 伺服器註冊表
  • 分享您自己的技能
  • 貢獻到社群

第 17 課：生態系統與市集（新增！）

  • 探索社群技能與外掛
  • MCP 伺服器註冊表
  • 分享您自己的技能
  • 貢獻到社群

第 18 課：代理團隊與隊友（2.1.33 新增！） ⭐

  • tmux、WezTerm、iTerm2 分割窗格協作
  • spawnTeam 功能
  • 隊友通訊模式
  • 已修正可靠的訊息傳遞

第 19 課：分叉情境與進階技能（2.1.33 新增！） ⭐

  • 技能熱重載（自動！）
  • 分叉子代理情境
  • 語言設定
  • 進階技能 frontmatter

第 20 課：2.1.x 進階功能（2.1.33 新增！） ⭐

  • 萬用字元權限：Bash(*)、Bash(npm *)
  • 增強的 hooks（技能、代理、指令）
  • 工作階段分叉與倒轉
  • 外部編輯器（Ctrl+G）
  • 增強的 vim 動作
  • WezTerm 支援

🌏 語言支援 / Language Support​

完整繁體中文教程！

繁體中文：

📚 其他資源​

🤝 貢獻​

發現錯字或有建議？歡迎貢獻！請開啟 issue 或 pull request。

📝 授權​

本教程僅供教育目的使用。

準備開始了嗎？ 從第 1 課：入門指南開始。

English? Please switch to the English version of the documentation.

已經是專家了？ 深入專家課程：

想要最新的 2.1.33 功能？