VoltAgent 子代理大全：怎麼挑、怎麼裝 Claude Code Subagent

154+ 個分門別類的 Claude Code 子代理任你挑。這篇教你怎麼從 10 大分類裡選對角色、寫對 description（觸發的關鍵）、放對目錄，讓 Claude Code 自動把任務委派給專家。

[ Log in to see the full prompt ]

## 這是什麼／解決什麼痛點 Claude Code 的子代理威力來自「把對的任務交給對的專家」，但從零寫一個好代理（角色、工具權限、觸發條件）有門檻，而且容易重造輪子。VoltAgent/awesome-claude-code-subagents 是一份精選清單（awesome-list），收錄 154+ 個現成、分門別類的 Claude Code 子代理，讓你「先挑、再小改」而不是從白紙開始。本篇把它整理成一套「怎麼挑＋怎麼裝」的方法，並附一份可直接填空的標準子代理範本。 ## 為什麼這個來源值得用 VoltAgent 是 AI agent 框架的活躍開源組織，這份清單採 MIT 授權（可商用），按 10 大分類整理：① Core Development ② Language Specialists ③ Infrastructure ④ Quality & Security ⑤ Data & AI ⑥ Developer Experience ⑦ Specialized Domains ⑧ Business & Product ⑨ Meta & Orchestration ⑩ Research & Analysis。每個子代理都遵循 Claude Code 官方的「YAML frontmatter + Markdown 系統提示」格式，所以挑到後幾乎是即插即用。對新手來說，它同時是「目錄」也是「寫法教材」。 ## 怎麼挑（選型四問） 1. 任務屬於哪個分類？先用上面 10 類定位（要審安全→Quality & Security；要寫某語言→Language Specialists）。 2. 觸發條件清楚嗎？看該代理 frontmatter 的 `description`——這段就是 Claude Code 自動委派的依據，描述越貼近你的實際情境越好。 3. 工具權限是否最小化？`tools:` 只給必要的（純審查就別給 Write/Edit），這是安全控制也是品質控制。 4. 模型路由合理嗎？慣例是 opus 用於重推理（架構、安全）、sonnet 用於日常編碼、haiku 用於快速小任務。 ## 怎麼裝 - 全域（所有專案）：放進 `~/.claude/agents/<name>.md`。 - 專案專屬：放進 `.claude/agents/<name>.md`，同名時專案版會覆蓋全域版。 - 安裝途徑多元：直接複製檔案、用倉庫提供的安裝腳本、或透過 Claude Code 插件市集。 - 用法：放好後 Claude Code 會依 description 自動委派；要手動就說「用 <name> 子代理處理這件事」。子代理在獨立上下文窗執行，不會污染主對話。 ## 何時用 剛開始建立自己的子代理庫時（先抄精選、再客製）、想為某個反覆出現的任務（DB migration 審查、API 設計、文件生成）找現成專家時、或想學「一個好子代理長怎樣」時。 📎 來源：VoltAgent/awesome-claude-code-subagents（作者 VoltAgent，MIT 授權）— 本篇為繁中改寫整理，範本為依官方格式重寫的填空版，非逐字搬運倉庫條目，原始清單見上方連結。