在命令行里用 AI 写代码，已经是不少开发者的日常。但 Claude Code 这个 AI 编程助手（Anthropic 出品的终端工具，用自然语言指挥 AI 读写、运行、调试代码）默认只是个「通才」——什么都会一点，遇到特定技术栈时深度有限。GitHub 上的开源项目 awesome-claude-code-subagents 解决的正是这个问题：它把 158 个以上的 Claude Code 子代理收集成一份精选清单，按用途分成 10 大类，目前已有 2.5 万 star、2900 多个 fork。

子代理（subagent）是什么：可以理解成给 AI 助手配的「专科医生」。每个子代理是一份写好的角色定义——包含它在什么场景下被调用、用什么视角思考、按什么步骤执行。比如「Python 专家」子代理会按 Python 最佳实践写代码，「安全审计」子代理会用安全视角检查代码。开发者把子代理装进 Claude Code 后，遇到对应任务时即可调用。

适合谁用：正在用 Claude Code 写代码的开发者，尤其是想让 AI 在特定领域（前端、后端、运维、安全、数据）表现更稳定的人；团队可以把同一套子代理分发给成员，保证协作口径一致。

合集里有什么

158+ 个子代理分布在 10 个大类：

  • 核心开发：api-designer（接口设计）、backend-developer（后端）、frontend-developer（前端）、fullstack-developer（全栈）、mobile-developer（移动端）等；
  • 语言专家：python-pro、typescript-pro、golang-pro、rust-engineer、vue-expert 等 20 多个语言与框架专家；
  • 基础设施：kubernetes-specialist、docker-expert、terraform-engineer、network-engineer 等；
  • 质量与安全：security-auditor、code-reviewer、qa-expert、penetration-tester 等；
  • 数据与 AI：data-scientist、mlops-engineer、llm-architect、prompt-engineer 等；
  • 开发者体验：cli-developer、readme-generator、refactoring-specialist 等；
  • 专业领域：blockchain-developer、fintech-engineer、game-developer、healthcare-admin 等；
  • 业务与产品：product-manager、scrum-master、content-marketer 等；
  • 元与编排：multi-agent-coordinator、workflow-orchestrator 等，负责调度多个子代理协同；
  • 研究与分析：research-analyst、trend-analyst、competitive-analyst 等。

子代理靠四个机制提升效果

  • 独立上下文窗口：每个子代理的任务在自己的上下文空间里完成，细节不污染主对话，主对话也不会被任务细节挤爆；
  • 领域专属提示词：每个子代理自带为该领域打磨的指令，专业任务交给专业角色，效果比通才模式更稳定；
  • 团队共享：同一套子代理可以在团队内分发使用，保证不同成员的工作流一致；
  • 细粒度工具权限：可以按子代理类型分配工具——审计类只给只读和搜索权限，写代码类才给执行权限，降低误操作风险。

每个子代理还可以指定模型路由：opus 负责深度推理（架构评审、安全审计），sonnet 负责日常编码，haiku 负责快速小任务，成本与效果可按需平衡。

五种安装方式

  1. Claude Code 插件市场（推荐）：执行 claude plugin marketplace add VoltAgent/awesome-claude-code-subagents，再按需安装各分类插件，如 claude plugin install voltagent-lang；
  2. 手动复制：把选中的子代理文件复制到 ~/.claude/agents/（全局可用）或 .claude/agents/（仅当前项目）；
  3. 交互式安装脚本：克隆仓库后运行 ./install-agents.sh，浏览分类、勾选安装或卸载；
  4. 免 clone 独立安装：用 curl 直接下载脚本运行，不必克隆整个仓库；
  5. Agent 安装器：把 agent-installer.md 装进 ~/.claude/agents/，然后在 Claude Code 里直接说「用 agent-installer 展示可用分类」或「找 PHP 子代理并安装」，由 Claude Code 替你完成安装。

怎么在 158 个里找到想要的

仓库附带一个 subagent-catalog 检索工具，安装后在 Claude Code 里使用 /subagent-catalog:search <关键词> 按名称或描述搜索，/subagent-catalog:fetch <名字> 获取完整定义，/subagent-catalog:list 浏览全部分类。

合集有自己的收录纪律：只收对 Claude Code 用户真正有用、且内容保持厂商中立的子代理，不接受以推广自家产品为主要目的的项目；所有子代理以「原样」提供，使用前建议自己过一遍定义。

一句话总结

如果你正在用 Claude Code，这个 2.5 万 star 的合集花十分钟就能装好：一份清单集中了 158+ 个专科 AI 助手，按需启用、按分类管理，是让 AI 编程助手从「通才」变成「专家」的低成本路径。