登录

awesome-claude-code-subagents

VoltAgentMIT活跃维护

收录 100 多个 Claude Code 专用子代理，覆盖各类开发场景，可直接挑选使用，省去自己从零编写子代理配置的麻烦。

A collection of 100+ specialized Claude Code subagents covering a wide range of development use cases

暂无版本26,459star +54 / 7 天3,028fork同步于 2026-11-10 11:22 UTC
子代理Claude Code开发场景代理集合
对比 GitHub 官网ai-agent-frameworkai-agent-toolsai-agentsawesomeawesome-list

怎么上手

由 README 提炼，执行前请确认
原文 
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install voltagent-lang
硬件要求按 README 说明

README 未说明，仅需可运行 Claude Code 的环境

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

161+ 个 Claude Code 专用子代理合集，按开发场景分类，让 Claude 在具体任务上更专业

收录 100 多个 Claude Code 专用子代理，覆盖各类开发场景，可直接挑选使用，省去自己从零编写子代理配置的麻烦。

核心能力

  • 按 10 大类别收录 161+ 个子代理定义
  • 以 Claude Code 插件市场方式一键安装分类插件
  • 每个子代理用 frontmatter 声明工具权限与模型
  • 按任务自动路由 opus/sonnet/haiku 平衡质量与成本
  • 提供交互式安装脚本与 subagent-catalog 检索技能

容易踩的坑

插件安装需先添加 marketplace 再按分类名安装，直接 install 会失败；voltagent-meta 编排类代理需先装好其他分类才发挥效果；手动安装要自行复制文件到 ~/.claude/agents/ 或 .claude/agents/，项目级会覆盖同名全局代理

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

0 个版本
全部 release

暂无 release 数据（可能没有发版，或尚未同步）。

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    Awesome Subagent Count Last Update Discord Official MCP Servers

    Awesome Claude Code Subagents

    This repository serves as the definitive collection of Claude Code subagents, specialized AI assistants designed for specific development tasks.

    A note on contributions: We don't accept PRs whose primary purpose is to promote a product, company, or personal project. Subagents must be genuinely useful to Claude Code users and stay vendor-neutral in their content. If you'd like to get your project in front of this community, you can sponsor the repo instead — that's the supported way to surface your work here.

    Sponsors

    Crawlbase is web data infrastructure trusted by 70,000+ developers. Its Crawling API, MCP server, and integrations give AI agents live access to any webpage — with JavaScript rendering, proxy rotation, and anti-bot protection.
    SerpApi is a Web Search API for your AI apps. Available in Markdown and JSON for any integration.

    Installation

    As Claude Code Plugin (Recommended)

    claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install <plugin-name>

    Examples:

    claude plugin install voltagent-lang    # Language specialists
claude plugin install voltagent-infra   # Infrastructure & DevOps

    See Categories below for all available plugins.

    Note: The voltagent-meta orchestration agents work best when other categories installed.

    Option 1: Manual Installation

    1. Clone this repository
    2. Copy desired agent files to:
      • ~/.claude/agents/ for global access
      • .claude/agents/ for project-specific use
    3. Customize based on your project requirements

    Option 2: Interactive Installer

    git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
./install-agents.sh

    This interactive script lets you browse categories, select agents, and install/uninstall them with a single command.

    Option 3: Standalone Installer (no clone required)

    curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh

    Downloads agents directly from GitHub without cloning the repository. Requires curl.

    Option 4: Agent Installer (use Claude Code to install agents)

    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

    Then in Claude Code: "Use the agent-installer to show me available categories" or "Find PHP agents and install php-pro globally".

    📚 Categories

    01. Core Development

    Plugin: voltagent-core-dev

    Essential development subagents for everyday coding tasks.

    02. Language Specialists

    Plugin: voltagent-lang

    Language-specific experts with deep framework knowledge.

    03. Infrastructure

    Plugin: voltagent-infra

    DevOps, cloud, and deployment specialists.

    04. Quality & Security

    Plugin: voltagent-qa-sec

    Testing, security, and code quality experts.

    05. Data & AI

    Plugin: voltagent-data-ai

    Data engineering, ML, and AI specialists.

    06. Developer Experience

    Plugin: voltagent-dev-exp

    Tooling and developer productivity experts.

    07. Specialized Domains

    Plugin: voltagent-domains

    Domain-specific technology experts.

    08. Business & Product

    Plugin: voltagent-biz

    Product management and business analysis.

    09. Meta & Orchestration

    Plugin: voltagent-meta

    Agent coordination and meta-programming.

    10. Research & Analysis

    Plugin: voltagent-research

    Research, search, and analysis specialists.

    🤖 Understanding Subagents

    Subagents are specialized AI assistants that enhance Claude Code's capabilities by providing task-specific expertise. They act as dedicated helpers that Claude Code can call upon when encountering particular types of work.

    What Makes Subagents Special?

    Independent Context Windows
    Every subagent operates within its own isolated context space, preventing cross-contamination between different tasks and maintaining clarity in the primary conversation thread.

    Domain-Specific Intelligence
    Subagents come equipped with carefully crafted instructions tailored to their area of expertise, resulting in superior performance on specialized tasks.

    Shared Across Projects
    After creating a subagent, you can utilize it throughout various projects and distribute it among team members to ensure consistent development practices.

    Granular Tool Permissions
    You can configure each subagent with specific tool access rights, enabling fine-grained control over which capabilities are available for different task types.

    Core Advantages

    • Memory Efficiency: Isolated contexts prevent the main conversation from becoming cluttered with task-specific details
    • Enhanced Accuracy: Specialized prompts and configurations lead to better results in specific domains
    • Workflow Consistency: Team-wide subagent sharing ensures uniform approaches to common tasks
    • Security Control: Tool access can be restricted based on subagent type and purpose

    Getting Started with Subagents

    1. Access the Subagent Manager

    /agents

    2. Create Your Subagent

    • Choose between project-specific or global subagents
    • Let Claude generate an initial version, then refine it to your needs
    • Provide detailed descriptions of the subagent's purpose and activation triggers
    • Configure tool access (leave empty to inherit all available tools)
    • Customize the system prompt using the built-in editor (press e)

    3. Deploy and Utilize Your subagent becomes immediately available. Claude Code will automatically engage it when suitable, or you can explicitly request its help:

    > Have the code-reviewer subagent analyze my latest commits

    Subagent Storage Locations

    TypePathAvailabilityPrecedence
    Project Subagents.claude/agents/Current project onlyHigher
    Global Subagents~/.claude/agents/All projectsLower

    Note: When naming conflicts occur, project-specific subagents override global ones.

    📖 Subagent Structure

    Each subagent follows a standardized template:

    ---
name: subagent-name
description: When this agent should be invoked
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---

You are a [role description and expertise areas]...

[Agent-specific checklists, patterns, and guidelines]...

## Communication Protocol
Inter-agent communication specifications...

## Development Workflow
Structured implementation phases...

    Tool Assignment Philosophy

    Smart Model Routing

    Each subagent includes a model field that automatically routes it to the right Claude model — balancing quality and cost:

    ModelWhen It's UsedExamples
    opusDeep reasoning — architecture reviews, security audits, financial logicsecurity-auditor, architect-reviewer, fintech-engineer
    sonnetEveryday coding — writing, debugging, refactoringpython-pro, backend-developer, devops-engineer
    haikuQuick tasks — docs, search, dependency checksdocumentation-engineer, seo-specialist, build-engineer

    You can override any agent's model by editing the model field in its frontmatter. Set model: inherit to use whatever model your main conversation is using.

    Tool Assignment Philosophy

    Each subagent's tools field specifies Claude Code built-in tools, optimized for their role:

    • Read-only agents (reviewers, auditors): Read, Grep, Glob - analyze without modifying
    • Research agents (analysts, researchers): Read, Grep, Glob, WebFetch, WebSearch - gather information
    • Code writers (developers, engineers): Read, Write, Edit, Bash, Glob, Grep - create and execute
    • Documentation agents (writers, documenters): Read, Write, Edit, Glob, Grep, WebFetch, WebSearch - document with research

    Each agent has minimal necessary permissions. You can extend agents by adding MCP servers or external tools to the tools field.

    🧰 Tools

    subagent-catalog

    Claude Code skill for browsing and fetching subagents from this catalog.

    CommandDescription
    /subagent-catalog:search <query>Find agents by name, description, or category
    /subagent-catalog:fetch <name>Get full agent definition
    /subagent-catalog:listBrowse all categories
    /subagent-catalog:invalidateRefresh cache

    Installation:

    cp -r tools/subagent-catalog ~/.claude/commands/

    AI Design + Build Ecosystem Tools

    You ship products with AI, but every launch still dies quietly because nobody posts about it. EveryFeed plugs your AI assistant into a social workspace that drafts, schedules, and publishes across 35+ channels — no agency, no marketing hire.

    🤝 Contributing

    We welcome contributions! See CONTRIBUTING.md for guidelines.

    • Submit new subagents via PR
    • Improve existing definitions
    • Report issues and bugs

    Contributor ♥️ Thanks

    Contributors

    📄 License

    MIT License - see LICENSE

    This repository is a curated collection of subagent definitions contributed by both the maintainers and the community. All subagents are provided "as is" without warranty. We do not audit or guarantee the security or correctness of any subagent. Review before use, the maintainers accept no liability for any issues arising from their use.

    If you find an issue with a listed subagent or want your contribution removed, please open an issue and we'll address it promptly.

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    ECC
    affaan-m·JavaScript

    为 Claude Code、Codex、Cursor 等编码智能体提供技能、直觉、记忆与安全防护的性能优化层，让 AI 编程助手更稳定高效地干活。

    智能体框架+4Agent 框架
    300458+173144kv2.2.32026-11-09 04:56 UTC
    deepseek-harness
    deepseek-ai·TypeScript

    DeepSeek 开源的 Agent 编排框架，把模型、工具、记忆等所有能力都做成可插拔插件，方便按需拼装和扩展智能体。

    Agent 框架+3Agent 框架
    277877+267734kdsh-v0.2.2-rc.12026-11-04 13:06 UTC
    hermes-agent
    NousResearch·Python

    一个可随使用不断成长的 AI Agent 框架，支持接入 Claude、ChatGPT 等多种大模型，用于搭建和编排自主智能体。

    Agent 框架+3Agent 框架
    262224+94458kv0.23.02026-11-10 11:16 UTC
    firecrawl
    firecrawl·TypeScript

    把任意网页抓取并转成干净 Markdown 或结构化数据，直接喂给 LLM 和 AI Agent，省去自己写爬虫和清洗的麻烦。

    网页抓取+4Agent 框架
    200323+98411kv2.11.02026-11-10 11:12 UTC