awesome-claude-code-subagents
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAwesome Claude Code Subagents
优秀Claude Code子Agent集合
What It Is
是什么
A curated collection of 130+ specialized Claude Code subagents organized into 9 categories. Each subagent is a markdown file that configures Claude with expert knowledge in a specific domain (language, framework, infrastructure, security, etc.). Installing subagents enhances Claude's capabilities for targeted development tasks.
这是一个经过精心整理的集合,包含130+个专业Claude Code子Agent,分为9个类别。每个子Agent都是一个markdown文件,为Claude配置了特定领域(语言、框架、基础设施、安全等)的专业知识。安装子Agent可增强Claude在针对性开发任务中的能力。
Installation Methods
安装方法
Method 1: Individual Agent Installation
方法1:单独安装Agent
Copy specific agent files to your Claude agents directory:
bash
undefined将特定Agent文件复制到你的Claude agents目录:
bash
undefinedGlobal installation (available in all projects)
全局安装(所有项目可用)
curl -o ~/.claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
curl -o ~/.claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
Project-specific installation
项目专属安装
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
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
undefinedmkdir -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
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
undefinedMethod 2: Interactive Installer (Recommended)
方法2:交互式安装器(推荐)
bash
undefinedbash
undefinedClone and run interactive installer
克隆并运行交互式安装器
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
chmod +x install-agents.sh
./install-agents.sh
The installer provides:
- Browse by category
- Search agents by keyword
- Install/uninstall globally or per-project
- View agent descriptionsgit clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
chmod +x install-agents.sh
./install-agents.sh
该安装器提供以下功能:
- 按类别浏览
- 通过关键词搜索Agent
- 全局或按项目安装/卸载
- 查看Agent描述Method 3: Standalone Installer (No Clone)
方法3:独立安装器(无需克隆)
bash
undefinedbash
undefinedDownload and run installer directly
直接下载并运行安装器
curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh
undefinedcurl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh
undefinedMethod 4: Meta Agent Installer
方法4:元Agent安装器
Install the agent-installer subagent to manage others through Claude:
bash
curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md \
-o ~/.claude/agents/agent-installer.mdThen use natural language:
- "Show me available Python subagents"
- "Install the FastAPI developer agent globally"
- "What infrastructure agents are available?"
安装agent-installer子Agent,通过Claude管理其他Agent:
bash
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?"
Categories and Key Agents
类别与核心Agent
01. Core Development (categories/01-core-development/
)
categories/01-core-development/01. 核心开发(categories/01-core-development/
)
categories/01-core-development/Essential development subagents:
bash
undefined基础开发子Agent:
bash
undefinedAPI development
API开发
curl -o ~/.claude/agents/api-designer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
curl -o ~/.claude/agents/api-designer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
Full-stack development
全栈开发
curl -o ~/.claude/agents/fullstack-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/fullstack-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/fullstack-developer.md
**Key agents**: api-designer, backend-developer, frontend-developer, fullstack-developer, microservices-architect, mobile-developercurl -o ~/.claude/agents/fullstack-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/fullstack-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/fullstack-developer.md
**核心Agent**:api-designer, backend-developer, frontend-developer, fullstack-developer, microservices-architect, mobile-developer02. Language Specialists (categories/02-language-specialists/
)
categories/02-language-specialists/02. 语言专家(categories/02-language-specialists/
)
categories/02-language-specialists/Language and framework experts:
bash
undefined语言与框架专家:
bash
undefinedPython specialist
Python专家
curl -o ~/.claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
curl -o ~/.claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
TypeScript specialist
TypeScript专家
curl -o ~/.claude/agents/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
curl -o ~/.claude/agents/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
Framework specialists
框架专家
curl -o ~/.claude/agents/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
**Key agents**: python-pro, typescript-pro, golang-pro, rust-engineer, nextjs-developer, react-specialist, django-developer, fastapi-developer, laravel-specialist, spring-boot-engineercurl -o ~/.claude/agents/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
**核心Agent**:python-pro, typescript-pro, golang-pro, rust-engineer, nextjs-developer, react-specialist, django-developer, fastapi-developer, laravel-specialist, spring-boot-engineer03. Infrastructure (categories/03-infrastructure/
)
categories/03-infrastructure/03. 基础设施(categories/03-infrastructure/
)
categories/03-infrastructure/DevOps and cloud specialists:
bash
undefinedDevOps与云服务专家:
bash
undefinedTerraform expert
Terraform专家
curl -o ~/.claude/agents/terraform-engineer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
curl -o ~/.claude/agents/terraform-engineer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
Kubernetes specialist
Kubernetes专家
curl -o ~/.claude/agents/kubernetes-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
**Key agents**: terraform-engineer, kubernetes-specialist, docker-expert, devops-engineer, cloud-architect, azure-infra-engineer, sre-engineercurl -o ~/.claude/agents/kubernetes-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
**核心Agent**:terraform-engineer, kubernetes-specialist, docker-expert, devops-engineer, cloud-architect, azure-infra-engineer, sre-engineer04. Quality & Security (categories/04-quality-security/
)
categories/04-quality-security/04. 质量与安全(categories/04-quality-security/
)
categories/04-quality-security/Testing and security experts:
bash
undefined测试与安全专家:
bash
undefinedCode reviewer
代码评审员
curl -o ~/.claude/agents/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
curl -o ~/.claude/agents/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
Security specialist
安全专家
curl -o ~/.claude/agents/penetration-tester.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/penetration-tester.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/penetration-tester.md
**Key agents**: code-reviewer, security-engineer, penetration-tester, qa-engineer, debugger, compliance-auditorcurl -o ~/.claude/agents/penetration-tester.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/penetration-tester.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/penetration-tester.md
**核心Agent**:code-reviewer, security-engineer, penetration-tester, qa-engineer, debugger, compliance-auditorUsage Patterns
使用模式
Pattern 1: Project-Specific Setup
模式1:项目专属配置
Install agents relevant to your tech stack:
bash
undefined安装与技术栈匹配的Agent:
bash
undefinedNext.js + TypeScript + PostgreSQL project
Next.js + TypeScript + PostgreSQL项目
mkdir -p .claude/agents
mkdir -p .claude/agents
Frontend
前端
curl -o .claude/agents/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
curl -o .claude/agents/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
curl -o .claude/agents/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md
curl -o .claude/agents/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/typescript-pro.md
Database
数据库
curl -o .claude/agents/sql-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/sql-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/sql-pro.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
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/sql-pro.md
Infrastructure
基础设施
curl -o .claude/agents/docker-expert.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/docker-expert.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/docker-expert.md
undefinedcurl -o .claude/agents/docker-expert.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/docker-expert.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/docker-expert.md
undefinedPattern 2: Global Utilities
模式2:全局工具
Install universal helpers globally:
bash
undefined安装通用辅助Agent:
bash
undefinedCode quality
代码质量
curl -o ~/.claude/agents/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
curl -o ~/.claude/agents/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md
Documentation
文档
curl -o ~/.claude/agents/documentation-writer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/05-documentation-content/documentation-writer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/05-documentation-content/documentation-writer.md
curl -o ~/.claude/agents/documentation-writer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/05-documentation-content/documentation-writer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/05-documentation-content/documentation-writer.md
Git workflows
Git工作流
curl -o ~/.claude/agents/git-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/06-data-integration/git-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/06-data-integration/git-specialist.md
undefinedcurl -o ~/.claude/agents/git-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/06-data-integration/git-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/06-data-integration/git-specialist.md
undefinedPattern 3: Batch Category Installation
模式3:批量类别安装
Install entire categories with a script:
bash
undefined通过脚本安装整个类别:
bash
undefinedInstall all language specialists
安装所有语言专家Agent
CATEGORY="02-language-specialists"
BASE_URL="https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories"
mkdir -p ~/.claude/agents
for agent in python-pro typescript-pro golang-pro rust-engineer; do
curl -o ~/.claude/agents/${agent}.md
${BASE_URL}/${CATEGORY}/${agent}.md done
${BASE_URL}/${CATEGORY}/${agent}.md done
undefinedCATEGORY="02-language-specialists"
BASE_URL="https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories"
mkdir -p ~/.claude/agents
for agent in python-pro typescript-pro golang-pro rust-engineer; do
curl -o ~/.claude/agents/${agent}.md
${BASE_URL}/${CATEGORY}/${agent}.md done
${BASE_URL}/${CATEGORY}/${agent}.md done
undefinedWorking with Subagents
子Agent使用指南
Activating a Subagent
激活子Agent
Once installed, reference agents in your prompts:
@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安装完成后,在提示词中引用Agent:
@python-pro help me optimize this data processing pipeline@terraform-engineer review this AWS infrastructure code@code-reviewer analyze this pull request for potential issuesCombining Multiple Subagents
组合多个子Agent
@frontend-developer create a React component for the dashboard
@typescript-pro ensure type safety
@accessibility-tester verify WCAG compliance@frontend-developer create a React component for the dashboard
@typescript-pro ensure type safety
@accessibility-tester verify WCAG complianceCreating Custom Subagents
创建自定义子Agent
Use existing agents as templates:
bash
undefined以现有Agent为模板:
bash
undefinedCopy an existing agent
复制现有Agent
cp ~/.claude/agents/python-pro.md ~/.claude/agents/my-custom-agent.md
cp ~/.claude/agents/python-pro.md ~/.claude/agents/my-custom-agent.md
Edit the frontmatter and instructions
编辑前置元数据和指令
vim ~/.claude/agents/my-custom-agent.md
Basic agent structure:
```markdown
---
name: my-custom-agent
description: Custom agent for specific task
---vim ~/.claude/agents/my-custom-agent.md
基础Agent结构:
```markdown
---
name: my-custom-agent
description: Custom agent for specific task
---My Custom Agent
My Custom Agent
You are an expert in [domain]. Your role is to [purpose].
You are an expert in [domain]. Your role is to [purpose].
Key Responsibilities
Key Responsibilities
- Responsibility 1
- Responsibility 2
- Responsibility 1
- Responsibility 2
Expertise
Expertise
- Area 1
- Area 2
- Area 1
- Area 2
Best Practices
Best Practices
- Practice 1
- Practice 2
undefined- Practice 1
- Practice 2
undefinedConfiguration
配置
Agent Directory Structure
Agent目录结构
~/.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~/.claude/ # 全局Agent
agents/
python-pro.md
terraform-engineer.md
code-reviewer.md
project-root/ # 项目专属Agent
.claude/
agents/
nextjs-developer.md
sql-pro.mdEnvironment Variables
环境变量
Agents may reference environment variables for credentials:
bash
undefinedAgent可能会引用环境变量获取凭证:
bash
undefined.env or shell profile
.env或shell配置文件
export OPENAI_API_KEY="your-key-here"
export ANTHROPIC_API_KEY="your-key-here"
export GITHUB_TOKEN="your-token-here"
undefinedexport OPENAI_API_KEY="your-key-here"
export ANTHROPIC_API_KEY="your-key-here"
export GITHUB_TOKEN="your-token-here"
undefinedTroubleshooting
故障排查
Agent Not Found
Agent未找到
Issue: Claude doesn't recognize the agent reference
bash
undefined问题:Claude无法识别Agent引用
bash
undefinedVerify agent exists
验证Agent是否存在
ls ~/.claude/agents/
ls .claude/agents/
ls ~/.claude/agents/
ls .claude/agents/
Check agent filename matches reference
检查Agent文件名是否与引用匹配
Reference: @python-pro
引用:@python-pro
File should be: python-pro.md (not python_pro.md or pythonpro.md)
文件应为:python-pro.md(而非python_pro.md或pythonpro.md)
undefinedundefinedAgent Not Working as Expected
Agent工作异常
Issue: Agent behavior doesn't match description
- Check file integrity:
bash
undefined问题:Agent行为与描述不符
- 检查文件完整性:
bash
undefinedEnsure file downloaded completely
确保文件完整下载
wc -l ~/.claude/agents/python-pro.md
wc -l ~/.claude/agents/python-pro.md
Re-download if needed
必要时重新下载
curl -o ~/.claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
2. **Verify frontmatter format**:
```bashcurl -o ~/.claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md
2. **验证前置元数据格式**:
```bashFirst few lines should be YAML
前几行应为YAML格式
head -10 ~/.claude/agents/python-pro.md
3. **Check for conflicts**:
```bashhead -10 ~/.claude/agents/python-pro.md
3. **检查冲突**:
```bashMultiple agents with same name can conflict
同名Agent可能产生冲突
find ~/.claude .claude -name "python-pro.md"
undefinedfind ~/.claude .claude -name "python-pro.md"
undefinedInstallation Script Errors
安装脚本错误
Issue: fails
install-agents.shbash
undefined问题:执行失败
install-agents.shbash
undefinedMake script executable
确保脚本可执行
chmod +x install-agents.sh
chmod +x install-agents.sh
Check dependencies
检查依赖
which curl # Required for downloading agents
which curl # 下载Agent需要该工具
Run with verbose output
开启详细输出运行
bash -x ./install-agents.sh
undefinedbash -x ./install-agents.sh
undefinedRate Limiting
速率限制
Issue: GitHub API rate limiting when downloading many agents
bash
undefined问题:下载大量Agent时触发GitHub API速率限制
bash
undefinedUse authenticated requests (higher rate limit)
使用认证请求(更高速率限制)
export GITHUB_TOKEN="your-personal-access-token"
export GITHUB_TOKEN="your-personal-access-token"
Or download repository once and install locally
或先下载仓库再本地安装
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
./install-agents.sh
undefinedgit clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
./install-agents.sh
undefinedAdvanced Usage
高级用法
Dynamic Agent Loading
动态加载Agent
Load agents programmatically based on project detection:
bash
#!/bin/bash根据项目类型自动加载Agent:
bash
#!/bin/bashauto-install-agents.sh
auto-install-agents.sh
Detect project type and install relevant agents
检测项目类型并安装对应Agent
if [ -f "package.json" ]; then
Node.js project
curl -o .claude/agents/node-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/node-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/node-specialist.md
Check for Next.js
if grep -q "next" package.json; then
curl -o .claude/agents/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md fi fi
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md fi fi
if [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
Python project
curl -o .claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md fi
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md fi
if [ -f "Cargo.toml" ]; then
Rust project
curl -o .claude/agents/rust-engineer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/rust-engineer.md fi
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/rust-engineer.md fi
undefinedif [ -f "package.json" ]; then
Node.js项目
curl -o .claude/agents/node-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/node-specialist.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/node-specialist.md
检查是否为Next.js项目
if grep -q "next" package.json; then
curl -o .claude/agents/nextjs-developer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md fi fi
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/nextjs-developer.md fi fi
if [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
Python项目
curl -o .claude/agents/python-pro.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md fi
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/python-pro.md fi
if [ -f "Cargo.toml" ]; then
Rust项目
curl -o .claude/agents/rust-engineer.md
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/rust-engineer.md fi
https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/rust-engineer.md fi
undefinedAgent Updates
Agent更新
Keep agents updated with latest improvements:
bash
#!/bin/bash保持Agent为最新版本:
bash
#!/bin/bashupdate-agents.sh
update-agents.sh
AGENTS_DIR="$HOME/.claude/agents"
BASE_URL="https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main"
for agent in "$AGENTS_DIR"/*.md; do
agent_name=$(basename "$agent")
Find agent in repository structure
This is simplified - actual implementation would need category lookup
curl -o "$agent" "${BASE_URL}/categories/*/${agent_name}" 2>/dev/null ||
echo "Could not update $agent_name" done
echo "Could not update $agent_name" done
undefinedAGENTS_DIR="$HOME/.claude/agents"
BASE_URL="https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main"
for agent in "$AGENTS_DIR"/*.md; do
agent_name=$(basename "$agent")
在仓库结构中查找Agent
此处为简化版,实际实现需查找对应类别
curl -o "$agent" "${BASE_URL}/categories/*/${agent_name}" 2>/dev/null ||
echo "Could not update $agent_name" done
echo "Could not update $agent_name" done
undefinedMulti-Agent Workflows
多Agent工作流
Create workflow templates combining multiple agents:
bash
undefined创建组合多个Agent的工作流模板:
bash
undefined.claude/workflows/code-review.md
.claude/workflows/code-review.md
name: comprehensive-code-review agents: [code-reviewer, security-engineer, accessibility-tester]
name: comprehensive-code-review agents: [code-reviewer, security-engineer, accessibility-tester]
Comprehensive Code Review Workflow
全面代码评审工作流
- @code-reviewer: Analyze code quality and patterns
- @security-engineer: Check for security vulnerabilities
- @accessibility-tester: Verify accessibility compliance
- Generate consolidated report
undefined- @code-reviewer: Analyze code quality and patterns
- @security-engineer: Check for security vulnerabilities
- @accessibility-tester: Verify accessibility compliance
- Generate consolidated report
undefinedCommon Patterns by Use Case
按场景分类的常见模式
Backend API Development
后端API开发
bash
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.mdbash
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.mdCloud Infrastructure
云基础设施
bash
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.mdbash
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.mdMobile Development
移动开发
bash
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.mdbash
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