用途
Awesome Claude Code Subagents 是一个精选集合，包含 130 多个专用 Claude Code 子代理，按 9 个类别组织。每个子代理是一个 Markdown 文件，用于为 Claude 配置某个特定领域（语言、框架、基础设施、安全等）的专家知识。安装子代理可以增强 Claude 在针对性开发任务中的能力。
主要能力
集合按类别提供不同方向的专家代理，资料中明确列出的类别与代表性代理包括：
- 01 核心开发：api-designer、backend-developer、frontend-developer、fullstack-developer、microservices-architect、mobile-developer。
- 02 语言专家：python-pro、typescript-pro、golang-pro、rust-engineer、nextjs-developer、react-specialist、django-developer、fastapi-developer、laravel-specialist、spring-boot-engineer，以及 sql-pro、node-specialist、flutter-expert、swift-expert 等。
- 03 基础设施：terraform-engineer、kubernetes-specialist、docker-expert、devops-engineer、cloud-architect、azure-infra-engineer、sre-engineer。
- 04 质量与安全：code-reviewer、security-engineer、penetration-tester、qa-engineer、debugger、compliance-auditor。
- 其他类别中还提到 05 文档内容（documentation-writer）、06 数据集成（git-specialist）、09 元编排（agent-installer）。
这些代理以独立 Markdown 文件形式提供，具有 name 和 description 等 frontmatter 字段。
使用方式
安装方法
方法一：单独安装代理文件。将特定代理文件复制到 Claude 代理目录，例如全局安装：
curl -o ~/.claude/agents/python-pro.md \
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
或按项目安装：
mkdir -p .claude/agents
curl -o .claude/agents/terraform-engineer.md \
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
方法二：交互式安装器（推荐）。
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
chmod +x install-agents.sh
./install-agents.sh
其功能包括：按类别浏览、按关键词搜索代理、全局或按项目安装/卸载、查看代理描述。
方法三：独立安装器（无需克隆）。
curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh
方法四：元代理安装器。安装 agent-installer 子代理，通过 Claude 管理其他代理：
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
随后可用自然语言，例如“Show me available Python subagents”“Install the FastAPI developer agent globally”“What infrastructure agents are available?”。
调用子代理
安装后，可在提示词中以 @ 方式引用代理，例如：
@python-pro help me optimize this data processing pipeline
@terraform-engineer review this AWS infrastructure code
@code-reviewer analyze this pull request for potential issues
也可组合多个子代理：
@frontend-developer create a React component for the dashboard
@typescript-pro ensure type safety
@accessibility-tester verify WCAG compliance
创建自定义子代理
可复制现有代理作为模板并编辑 frontmatter 与指令：
cp ~/.claude/agents/python-pro.md ~/.claude/agents/my-custom-agent.md
vim ~/.claude/agents/my-custom-agent.md
基本结构示例：
---
name: my-custom-agent
description: Custom agent for specific task
---
# My Custom Agent
You are an expert in [domain]. Your role is to [purpose].
## Key Responsibilities
- Responsibility 1
- Responsibility 2
## Expertise
- Area 1
- Area 2
## Best Practices
- Practice 1
- Practice 2
目录结构
~/.claude/ # Global agents
agents/
python-pro.md
terraform-engineer.md
code-reviewer.md
project-root/ # Project-specific agents
.claude/
agents/
nextjs-developer.md
sql-pro.md
代理可引用环境变量获取凭据，例如：
export OPENAI_API_KEY="your-key-here"
export ANTHROPIC_API_KEY="your-key-here"
export GITHUB_TOKEN="your-token-here"
适用场景
资料给出按用例组织常见模式，例如：
后端 API 开发：安装 api-designer、fastapi-developer、sql-pro。
curl -o .claude/agents/api-designer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
curl -o .claude/agents/fastapi-developer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/fastapi-developer.md
curl -o .claude/agents/sql-pro.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/sql-pro.md
云基础设施：安装 terraform-engineer、kubernetes-specialist、cloud-architect。
curl -o .claude/agents/terraform-engineer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
curl -o .claude/agents/kubernetes-specialist.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
curl -o .claude/agents/cloud-architect.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/cloud-architect.md
移动开发：安装 mobile-developer、flutter-expert、swift-expert。
curl -o .claude/agents/mobile-developer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/mobile-developer.md
curl -o .claude/agents/flutter-expert.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/flutter-expert.md
curl -o .claude/agents/swift-expert.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/swift-expert.md
此外还提供项目特定设置、全局工具安装、按类别批量安装，以及基于项目检测的动态代理加载和代理更新脚本示例；并可用 workflow 模板组合多代理，如综合代码审查工作流包含 code-reviewer、security-engineer、accessibility-tester。
限制与注意事项
资料中的故障排查内容指出：若代理未被识别，需确认文件存在且文件名与引用一致（如 @python-pro 对应 python-pro.md）；若行为不符，可检查文件完整性、frontmatter YAML 格式及是否存在同名冲突；若安装脚本报错，可赋予执行权限、检查 curl 依赖或使用 bash -x 运行；下载大量代理可能触发 GitHub API 速率限制，可使用 GITHUB_TOKEN 认证或一次克隆仓库后本地安装。
关于收费、价格、平台支持范围与具体效果，资料未提供，暂未提供。