awesome-claude-code-subagents 是什么?

Awesome Claude Code Subagents 是 VoltAgent 社区维护的 Claude Code 子代理定义库。主分支把 161 个 Markdown 代理定义分到 10 个类别,每个定义用 YAML frontmatter 声明名称、触发描述、工具和模型,再用正文提供角色与工作步骤。它更像可挑选、可改写的提示词目录,而不是含独立执行引擎的多代理框架。

⭐ 23,136 Stars 🍴 2,701 Forks Shell MIT 作者: VoltAgent
来源:github.com/VoltAgent/awesome-claude-code-subagents;https://code.claud… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

Claude Code 已把自定义 subagent 做成正式配置能力,用户可以用独立上下文、工具权限和模型处理重复任务。这个仓库把常见开发角色预先整理成目录,降低从空白文件开始编写的成本。这些数字只用于判断持续搜索关注,不等同于独立访客。

来源:code.claude.com/docs/en/sub-agents;https://github.com/VoltAgent/aweso…

核心功能

161 个代理定义与 10 个分类

2026-09-23 按主分支目录树统计,10 个 categories 目录共有 161 个代理 Markdown 文件,不含各分类 README。范围覆盖核心开发、语言、基础设施、质量安全、数据与 AI、开发体验、垂直领域、业务产品、编排和研究。

来源:github.com/VoltAgent/awesome-claude-code-subagents/tree/main/categories
按类别安装或按文件挑选

README 推荐先添加仓库 marketplace,再安装 voltagent-lang、voltagent-infra 等类别插件;也支持把单个定义复制到项目级 .claude/agents/ 或用户级 ~/.claude/agents/。第一次使用更适合只选一两个代理,便于检查权限与效果。

来源:github.com/VoltAgent/awesome-claude-code-subagents
前置元数据控制角色

代理文件通常包含 name、description、tools 和 model。description 影响 Claude 何时委派,tools 限制可调用工具,model 决定模型选择;Markdown 正文则成为子代理的系统提示。

来源:github.com/VoltAgent/awesome-claude-code-subagents/blob/main/categori…
交互式安装脚本

install-agents.sh 可在全局和项目目录之间选择、浏览分类、安装或移除代理。脚本在远程模式调用 GitHub API 和 curl,并会复制或删除 .claude/agents 下的文件,因此运行前应先读脚本和待安装定义。

来源:github.com/VoltAgent/awesome-claude-code-subagents/blob/main/install-…

技术架构

仓库主体是静态内容:categories/01 到 categories/10 保存代理定义,每个分类还带一个 Claude Code 插件 manifest;根目录 marketplace.json 聚合这些分类插件。安装后,真正负责发现、委派、权限和模型调用的是 Claude Code。单个定义没有独立运行时,也不会自行实现数据库优化、安全扫描或研究流程,它只是把角色、检查步骤和工具范围交给底层模型执行。install-agents.sh 是辅助分发层,可把选中的 Markdown 文件写入用户级或项目级 agents 目录。

来源:github.com/VoltAgent/awesome-claude-code-subagents;https://github.com…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code Git 与基础文件复制工具(手动安装)Git 与基础文件… Bash 和 curl(交互式或远程安装脚本)Bash 和 curl(… 161 个代理定义与 10 个分类161 个代理定义与 10… 按类别安装或按文件挑选 前置元数据控制角色 交互式安装脚本 awesome-claude-code-… 项目本体 核心功能 关键依赖

技术栈

语言Markdown/YAML 代理定义与 Bash 安装脚本框架Claude Code custom subagents 与 plugin marketplace
Claude CodeGit 与基础文件复制工具(手动安装)Bash 和 curl(交互式或远程安装脚本)
代理定义安装到 .claude/agents/、~/.claude/agents/ 或插件范围;仓库采用 MIT 许可,本身不提供托管推理服务
来源:github.com/VoltAgent/awesome-claude-code-subagents;https://github.com…

快速上手

先从官方仓库选一个与任务直接相关的 .md 文件,检查 description、tools、model 和正文,再复制到当前项目的 .claude/agents/。重新进入 Claude Code 后,明确要求调用该代理做一个只读小任务,并核对它实际使用的工具和输出。确认有帮助后,再考虑 README 的 marketplace 命令:claude plugin marketplace add VoltAgent/awesome-claude-code-subagents,然后按类别运行 claude plugin install voltagent-lang。不要第一次就安装全部类别,也不要未经检查直接执行远程脚本。
来源:github.com/VoltAgent/awesome-claude-code-subagents

使用场景

适合为代码审查、后端开发、特定语言、基础设施或资料研究建立可复用的角色起点,也适合学习 Claude Code subagent 文件结构。对需要精确权限、组织级治理或可重复评测的团队,仓库定义只能当模板,还应删减工具、改写触发描述、加入项目约束并用真实任务评估。

来源:github.com/VoltAgent/awesome-claude-code-subagents;https://code.claud…

优势与局限

优势

  • 分类清楚,可从一个具体角色开始,而不必从空白 frontmatter 编写
  • 既能按文件安装,也提供分类插件和交互式脚本
  • 代理定义是纯文本,方便审查、删减工具和纳入版本控制
  • 主分支持续维护,MIT 许可允许按项目需求修改

局限

  • 代理主要是提示词和元数据,名称中的专家能力不等于经过独立测试的专业工具
  • 维护者明确说明不会审计或保证每个贡献的安全性与正确性,使用前必须逐文件审查
  • README 写 161+,目录树为 161 个定义,但 marketplace 元数据仍写 158,版本与数量口径没有完全同步
  • GitHub Releases 为空;各分类插件版本不同,不能用一个统一 release 判断所有内容
  • 当前 Claude Code 官方文档以插件 agents/ 目录说明插件代理,而仓库分类 manifest 使用显式 agents 文件列表;未实测时不能保证每个 Claude Code 版本都能正确注册
来源:github.com/VoltAgent/awesome-claude-code-subagents;https://github.com…

最新版本

2026-09-23 核对时 GitHub Releases 为空,不能给出统一的正式 release。主分支最新提交日期为 2026-09-21;marketplace 元数据版本是 1.0.4,但十个分类插件各自有版本号,当前范围从 1.0.1 到 1.1.1。更新时应查看目标分类的 plugin.json 和变更内容。

来源:github.com/VoltAgent/awesome-claude-code-subagents/releases;https://g…

实测与证据

status: docs_only_official_sources_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 核对 VoltAgent 官方仓库 README、目录树、marketplace.json、install-agents.sh、示例代理、CONTRIBUTING、LICENSE、GitHub API 与 Claude Code 官方 subagent 文档;未安装插件或代理。  |  limitations: 没有验证 claude plugin 命令、代理注册、自动委派、工具权限、模型费用、安装脚本回滚或任一代理在真实项目中的正确率。文中不会把 README 的角色描述当作实测能力。  |  observed_output: GitHub API 显示主分支最新提交为 2026-09-21、仓库未归档且 Releases 为空;递归目录树统计到 161 个分类代理定义。README 写 161+,marketplace 元数据版本 1.0.4 仍写 158,10 个分类插件版本介于 1.0.1 与 1.1.1。

来源:api.github.com/repos/VoltAgent/awesome-claude-code-subagents;https://…

同类项目对比

Claude Code 官方做法是自己在 .claude/agents/ 或 ~/.claude/agents/ 写一个范围明确的代理,只需 name 和 description,再按需收紧 tools、model 和权限;这样数量少、内容贴合项目。Awesome Claude Code Subagents 提供大量现成角色,选择更快,但每个定义都需要重新核对工具和提示词。频繁重复且边界清楚的任务适合自己写小代理;还不确定角色如何表达时,可从本仓库挑一个模板再删改。

来源:github.com/VoltAgent/awesome-claude-code-subagents;https://code.claud…

总结评价

这个仓库适合作为 Claude Code 子代理模板库保留。稳妥的使用方式是挑一个代理、删掉不需要的工具、补入项目规则,再用一个可检查的小任务验证;若只是因为角色名听起来专业就全量安装,既增加上下文和维护负担,也无法证明结果更可靠。

来源:github.com/VoltAgent/awesome-claude-code-subagents;https://code.claud…

常见问题

Awesome Claude Code Subagents 现在到底有 161 个还是 158 个?

2026-09-23 按主分支 categories 目录统计有 161 个代理 Markdown 文件,README 也写 161+;但根目录 marketplace.json 的描述仍写 158。两者更新时间没有同步,应以实际目录和具体分类 manifest 为准。

必须运行 install-agents.sh 才能使用吗?

不必。可以只把需要的定义复制到项目的 .claude/agents/ 或用户的 ~/.claude/agents/。手动安装更容易看清新增了哪些文件,也便于先测试一个代理。

安装了代理就能得到专业工具的准确结果吗?

不能保证。仓库主体是提示词与工具配置,不是独立的安全扫描器、数据库优化器或研究引擎。维护者也明确说明没有审计或保证每个贡献的安全与正确性。

插件安装成功但找不到代理怎么办?

先查看插件详情和 Claude Code 版本,再检查实际代理文件与官方文档要求。若分类插件没有注册,可先手动复制一个已审查的 .md 到 .claude/agents/,重启会话后用明确指令测试;本页没有本机复现插件兼容性。

这个仓库是否属于严重商业化项目?

官方 README 有赞助位和联系赞助入口,但仓库主体以 MIT 许可提供代理定义,没有发现充值、额度转售、订阅解锁或付费下载流程。赞助链接与代理定义仍应分别审查。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件