VoltAgent/awesome-claude-code-subagents · 上手攻略

• 仓库：VoltAgent/awesome-claude-code-subagents
• 链接：https://github.com/VoltAgent/awesome-claude-code-subagents
• 分类：skill
• 作者：Tom
• 更新：2026-07-09

是什么

VoltAgent/awesome-claude-code-subagents 是 154+ 个 Claude Code 专业化子代理（Subagent）的精选合集，按 10 个类别组织，涵盖从前端开发到基础设施、从语言专家到合规审查的完整开发场景。

Subagent 是 Claude Code 的核心扩展机制：一个子代理本质上是一个带有特定角色指令（system prompt）的专用 AI 助手，可以处理特定领域的任务。Claude Code 用户可以在单个会话中调用多个 subagent，实现专业化分工——比如让 typescript-pro 处理类型问题，让 aws-architect 设计云架构，让 security-auditor 做代码安全审查。

这些 subagent 可以通过三种方式安装： - Claude Plugin（推荐）：一行命令安装整个分类插件 - Git Clone：选择性复制到本地 agents 目录 - 交互式脚本：运行 ./install-agents.sh 浏览并安装

解决什么问题

Claude Code 默认是一个通用编码助手，但在实际项目中会遇到：

1. 专业深度不足：让通用模型写 Kubernetes YAML 或 Swift 并发代码，质量不如专门调校的专家。
2. 多角色协作难：一个会话里要兼顾 API 设计、数据库 Schema、前端组件，来回切换上下文很麻烦。
3. 团队规范难统一：不同成员定义的 agent 行为不一致，无法标准化。
4. 快速启动成本高：每次开新项目都要从头写 system prompt、定义工具集。

VoltAgent subagents 通过预制的专业角色 prompt + 明确的工具规范 + 即装即用解决以上问题。

快速安装

方式一：Claude Plugin（推荐，3 秒搞定一个分类）

# 安装 voltagent-core-dev（核心开发类）
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents

# 安装其他分类
claude plugin install voltagent-lang           # 语言专家
claude plugin install voltagent-infra           # 基础设施 & DevOps
claude plugin install voltagent-security       # 安全审查
claude plugin install voltagent-testing        # 测试专家

前提：已安装 Claude Code（macOS/Windows：claude.ai/download，Linux：npm install -g @anthropic-ai/claude-code）

方式二：Git Clone + 交互式安装脚本

git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
chmod +x install-agents.sh
./install-agents.sh    # 交互式界面，选择分类和具体 subagent 安装

脚本支持：浏览分类 → 选择要安装的 subagent → 安装/卸载管理。

方式三：零 clone 直接下载单个 agent

# 用 curl 直接下载单个 agent 文件（无需 clone 整个仓库）
curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md \
  -o ~/.claude/agents/agent-installer.md

# 然后在 Claude Code 中对 agent-installer 说：
# "Show me available categories" 或 "Find and install php-pro globally"

方式四：手动复制文件

# 全局安装（所有项目可用）
cp categories/01-core-development/typescript-pro.md ~/.claude/agents/

# 项目级安装
mkdir -p ./.claude/agents
cp categories/01-core-development/typescript-pro.md ./.claude/agents/

核心用法

调用已安装的 Subagent

安装后在 Claude Code 会话中直接调用 agent 名称即可：

@typescript-pro
请帮我重构这个模块的类型定义，重点处理泛型的协变性问题。

分类速查表

组合使用示例

# 在 Claude Code 中连续调用多个 subagent 协作
@backend-developer
设计一个 FastAPI 微服务的目录结构，包含认证、中间件和数据库层。

@postgres-expert
为上述服务设计 PostgreSQL Schema，包含用户表、角色表和审计日志表。

@security-auditor
审查刚生成的代码，关注 SQL 注入和 JWT 安全问题。

@docker-pro
为整个服务写 Dockerfile 和 docker-compose.yml，包含健康检查和资源限制。

Meta Orchestration Agent（进阶）

agent-installer 是一个元级 subagent，可以在 Claude Code 内对话安装其他 agent，无需记住具体的安装命令：

"Find me PHP subagents and install php-pro globally"
"Show all security-related agents"
"List agents in the infra category"

典型适用场景

坑与注意

1. 需要 Claude Code 最新版：部分 subagent 功能依赖 Claude Code 最新版本（如 MCP 集成），建议保持 claude --version 为最新稳定版。2026 年初的版本不支持某些新的 plugin 接口。

2. Plugin 安装需网络：claude plugin marketplace add 需要访问 GitHub，网络不稳定时可能失败，可改用 curl 方式手动下载。

3. Agent 质量参差不齐：154 个 subagent 并非全部出自 VoltAgent 官方维护，质量依赖社区贡献者；建议重要任务先在小范围测试 agent 输出再大规模使用。

4. 上下文竞争：在单个 Claude Code 会话中同时激活多个 subagent 可能导致上下文竞争，建议按"一个任务 → 一个 subagent → 完成后切换"的方式使用。

5. 与 MCP Server 的区别：MCP（Model Context Protocol）扩展的是 Claude Code 的工具能力（让 AI 能调用外部 API/数据库），而 Subagent 扩展的是角色/专业能力（让 AI 更专业地完成某类任务）。两者可叠加使用。

6. VoltAgent 主仓库补充：该 awesome 集合只是 VoltAgent 生态的入口，真正的框架实现在 VoltAgent 主仓库，如果你要构建自己的 subagent 框架，需要看那里。

7. 不接受商业推广 PR：repo 明确说明不以推广产品为目的提交 PR，vendor-neutral 是核心原则，这是好事——但意味着某些商业工具的 subagent 可能缺失。

与同类对比

VoltAgent subagents 最适合：已经在用 Claude Code、希望专业化分工、提升团队协作效率的开发者或团队。

一句话推荐结论

如果你用 Claude Code，花 3 分钟装一个 voltagent 插件，你会发现它突然从"通用代码助手"进化成了"能调用 154 个领域专家的智能团队"——按需安装、按任务切换，值得今天就试试。