Awesome Claude Code Subagents 中文教程：先挑一个代理，再决定要不要装整类
这个仓库不是一个新的多代理运行框架。它收集的是 Claude Code 子代理定义：YAML frontmatter 负责名称、触发描述、工具和模型，后面的 Markdown 负责角色与步骤。真正发现代理、分配上下文和调用工具的是 Claude Code。
1. 先判断这个代理是不是你需要的
十个分类覆盖开发、语言、基础设施、安全、数据、开发体验、垂直领域、产品、编排和研究。不要只看名称。打开具体的 .md，先回答三个问题：description 是否准确描述你的触发场景，tools 是否超过任务所需，正文是否包含能检查的步骤。
例如官方仓库里的 backend-developer 默认声明 Read、Write、Edit、Bash、Glob 和 Grep。若你的第一次测试只是评审 API 设计，可以先移除写入与命令执行能力。角色名叫“后端专家”，不代表它拥有独立的编译器、数据库或安全扫描能力。
2. 第一次用手动安装，改动最清楚
先克隆官方仓库，再只复制一个已经读过的代理定义：
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd your-project
mkdir -p .claude/agents
cp ../awesome-claude-code-subagents/categories/01-core-development/backend-developer.md \
.claude/agents/backend-developer.md项目级 .claude/agents/ 便于和代码一起审查。Claude Code 官方文档还支持用户级 ~/.claude/agents/，但那会影响所有项目。若这个 agents 目录是会话启动后才新建的，官方文档建议重启 Claude Code 再测试。
3. 用一个可核对的小任务验证
明确要求调用刚安装的代理，例如让它只读检查一个 API 路由文件，并输出引用到的文件、发现的问题和不确定项。检查会话里是否真的出现该 subagent、是否只用了允许的工具、结论能否由代码复核。一次输出好看，不足以证明这个角色长期可靠。
4. 确认有用后再考虑分类插件
README 推荐的 marketplace 路径是：
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install voltagent-lang十个分类插件的版本并不一致，当前 marketplace 清单范围从 1.0.1 到 1.1.1，仓库也没有 GitHub Release。升级时应看目标分类的 plugin.json 与提交内容，不能只记一个总版本。
当前 Claude Code 官方文档把插件代理描述为位于插件的 agents/ 目录；这个仓库的分类 manifest 使用显式 agents 文件列表。这里没有做本机插件兼容性测试。若插件显示安装成功但没有注册代理，先查看插件详情和版本，再用前面的手动复制方式验证单个文件。
5. install-agents.sh 会改哪些地方
官方脚本支持全局 ~/.claude/agents/ 和项目级 .claude/agents/，能安装和删除文件；远程模式还会调用 GitHub API 与 curl。README 也提供直接下载脚本的方式。更稳妥的流程是先把脚本保存到本地、阅读目标路径和删除逻辑，再运行交互界面。
6. 和 Claude Code 官方自建代理怎么选
相比这个大型模板库，Claude Code 官方文档允许直接写一个只有 name、description 和短提示词的代理，再按需增加 tools、model、权限、技能或隔离。自己写的优势是范围贴合项目、数量容易控制。这个仓库的优势是角色多，可以更快找到起稿模板。实际选择很简单：需求已经清楚，就写一个小代理；还不知道如何组织定义，就从目录挑一个并大幅删改。
7. 验证状态与商业化判断
GitHub API 显示主分支最新提交日期为 2026-09-21，Releases 为空。README 有赞助位和联系赞助入口，但仓库主体以 MIT 许可公开代理定义，没有发现充值、额度转售、订阅解锁或付费下载流程，因此不属于本轮需要隔离的严重商业化项目。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
Claude Code 已把自定义 subagent 做成正式配置能力，用户可以用独立上下文、工具权限和模型处理重复任务。这个仓库把常见开发角色预先整理成目录，降低从空白文件开始编写的成本。这些数字只用于判断持续搜索关注，不等同于独立访客。
适合谁用
适合为代码审查、后端开发、特定语言、基础设施或资料研究建立可复用的角色起点，也适合学习 Claude Code subagent 文件结构。对需要精确权限、组织级治理或可重复评测的团队，仓库定义只能当模板，还应删减工具、改写触发描述、加入项目约束并用真实任务评估。
采用建议
这个仓库适合作为 Claude Code 子代理模板库保留。稳妥的使用方式是挑一个代理、删掉不需要的工具、补入项目规则，再用一个可检查的小任务验证；若只是因为角色名听起来专业就全量安装，既增加上下文和维护负担，也无法证明结果更可靠。
原教程未展开的系统信息
核心功能
前置元数据控制角色
代理文件通常包含 name、description、tools 和 model。description 影响 Claude 何时委派，tools 限制可调用工具，model 决定模型选择；Markdown 正文则成为子代理的系统提示。
架构与数据流
仓库主体是静态内容：categories/01 到 categories/10 保存代理定义，每个分类还带一个 Claude Code 插件 manifest；根目录 marketplace.json 聚合这些分类插件。安装后，真正负责发现、委派、权限和模型调用的是 Claude Code。单个定义没有独立运行时，也不会自行实现数据库优化、安全扫描或研究流程，它只是把角色、检查步骤和工具范围交给底层模型执行。install-agents.sh 是辅助分发层，可把选中的 Markdown 文件写入用户级或项目级 agents 目录。
技术栈和运行条件
语言
Markdown/YAML 代理定义与 Bash 安装脚本
框架
Claude Code custom subagents 与 plugin marketplace
关键依赖
- Claude Code
- Git 与基础文件复制工具（手动安装）
- Bash 和 curl（交互式或远程安装脚本）
运行环境
代理定义安装到 .claude/agents/、~/.claude/agents/ 或插件范围；仓库采用 MIT 许可，本身不提供托管推理服务
常见问题
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 许可提供代理定义，没有发现充值、额度转售、订阅解锁或付费下载流程。赞助链接与代理定义仍应分别审查。