【Vibe Coding】Claude Code 新功能 Subagents 教學：打造專屬 AI 助理，讓開發流程自動化再升級

Claude Code 團隊推出全新「Subagents」功能，讓開發者可以自訂 AI 子助理，指派特定任務如除錯、測試、程式碼審查等，實現模組化、自動化的開發流程。

本篇教學將介紹 Subagents 的運作原理、建立方式、範例設計，以及如何善用它們自動完成除錯、測試、分析等任務，協助你打造屬於自己的 AI 工具團隊。

若還不清楚 Claude Code 的朋友可以先去閱讀：

【Vibe Coding】Claude Code 教學｜怎麼用一句話串連資料庫、建立全端網站？

用一句話指令，Claude Code 幫我把前端網站升級成能連資料庫的全端應用，從安裝到部署一次教會你！

AI郵報Vicky Tsai

什麼是 Sub Agent？

Subagents 是 Claude Code 中的 任務導向型 AI 助理，可用來處理具體開發任務（如 code review、debug、SQL 分析等），每個 Subagent 具備以下能力：

• 專屬上下文（context window）：每個子代理有獨立記憶空間，不干擾主線任務。
• 獨立系統提示（system prompt）：行為模式與流程可完全自定。
• 自訂工具權限：可限制它能使用的工具範圍（如只能 Read 或 Bash）。
• 可重複使用與版本控管：Subagents 可跨專案重用、儲存在團隊 Git 儲存庫中。

Claude Code 會根據你的描述或上下文，自動選擇最適合的 Subagent 執行任務，也可透過指令手動呼叫。

官方介紹推文：

Sub Agent 有什麼好處？

快速建立你的第一個 Subagent

還想看更多嗎？完整內容只對註冊用戶開放喔！
點下方的免費 Subscribe，馬上加入我們～

Step 1：打開終端機進入 Claude Code

claude

Step 2：開啟 Subagents 管理介面

/agents

Step 3：選擇「Create New Agent」

可選擇建立在：

• 專案層（.claude/agents/）：僅作用於該專案
• 個人層（~/.claude/agents/）：全專案皆可用

Step 4：創建方法

• 推薦：與 Claude 共同生成（Generate with Claude）
• 或使用手動設定（Manual configuration）

Step 5：設定 Subagent

包含：

• 名稱（如：code-reviewer）
• 描述（何時使用此 Agent，例如「修改程式碼後主動執行審查」）
• 可使用工具（如：Read, Grep, Bash）
• 系統提示內容（明確說明行為邏輯與審查標準）

若選擇與 Claude 共同生成，只需提供任務描述，Claude 會產出完整範本供你修改。

Step 6：選擇工具權限

設定 Subagent 能夠使用的工具，可授權 Read、Write、Edit、Bash、Grep 等工具，建議只啟用任務所需項目。

Step 7：儲存後使用

Claude 會根據上下文自動指派 Subagent，或手動呼叫 (@<你的 agent>)：

> Use the @code-reviewer sub agent to check my recent changes

四、Sub Agent 實作範例：程式碼審查助理

你可以參考這份由社群貢獻的範例專案 iannuttall/claude-agents，裡面包含多種專業 Subagents 配置（例如 debugger.md, test-runner.md），以下為 Subagent 的設定範本：

---
name: code-reviewer
description: 每次修改程式碼後，自動啟用以檢查品質與安全性
tools: Read, Grep, Bash
---

你是一位資深程式碼審查專家。

請針對 git diff 修改的內容，從以下幾個面向進行檢查：
- 命名與可讀性
- 重複程式碼
- 錯誤處理與邏輯完整性
- API 金鑰與憑證是否外洩
- 測試覆蓋率與效能影響

請依據嚴重程度分為：
- Critical（必修）
- Warning（建議修正）
- Suggestion（可改善）

請舉例說明，並給出修正建議。

實用技巧與進階應用

明確描述任務

在 description 中使用「Use proactively」或「MUST BE USED」等詞，能提高自動啟用率：

description: Use proactively after each commit to check for security and style violations

串接多個 Subagents

可以鏈式執行多個任務：

> Use the linter sub agent first, then run test-runner to validate

工具限制建議

除非必要，建議僅開放該任務所需工具，例如 Debugger 可用 Read, Grep, Edit，而非全開。

使用心得：把一群 Subagents 帶進團隊，原來這就是當主管的感覺？

實際使用下來，Claude Code 的 Subagents 不只「能用」，是真的會自己動腦、主動分工。

我自己下載了社群提供的範例 agents 包括：

• code-refactorer.md
• content-writer.md
• frontend-designer.md
• prd-writer.md
• project-task-planner.md
• security-auditor.md
• vibe-coding-coach.md

每個 Subagent 都能自動在適當時機登場，把事情處理得妥妥當當。
我不需要每次都重複輸入角色 prompt、重寫行為說明，也不用擔心 Claude 偏離主題。

更驚喜的是——Claude 在呼叫 Subagent 時還會告訴你「現在是誰在上工」，整個流程清楚透明，讓人超有安全感。

原來這就是當主管的感覺：任務自動分派，每個人（Subagent）都各司其職，不吵不鬧還效率超高。

總結

Claude Code 的 Subagents 功能，讓 AI 編程邁向更模組化、分工化的發展。你可以打造一組高效率的 AI 助手團隊，自動接手審查、測試、除錯等日常任務，降低認知負擔，提升開發專注力。

Source

• 社群GitHub Sub Agent 模板集
• Sid Bidasaria X（原 Twitter）發布公告
• 官方 Subagents 文檔

想讓 AI 成為你團隊的一員？