name: sub-agents
description: 创建和配置具有自定义提示、工具和模型的 Claude Code 子代理
allowed-tools: [Read, Write, Bash]
user-invocable: false
子代理参考
创建专门的 AI 代理，具有孤立上下文用于特定任务。
何时使用
- “如何创建子代理？”
- “配置代理工具”
- “有哪些内置代理？”
- “代理模型选择”
- “代理链式模式”
快速开始
交互式（推荐）
/agents
打开菜单以创建、编辑和管理代理。
手动创建
mkdir -p .claude/agents
cat > .claude/agents/reviewer.md << 'EOF'
---
name: reviewer
description: 代码审查专家。在代码更改后主动使用。
tools: Read, Grep, Glob, Bash
model: sonnet
---
您是一位专注于质量和安全的高级代码审查员。
## 审查清单
- 代码清晰度和命名
- 错误处理
- 安全漏洞
- 测试覆盖率
EOF
基于 CLI
claude --agents '{
"reviewer": {
"description": "代码审查员",
"prompt": "审查质量和安全",
"tools": ["Read", "Bash"],
"model": "sonnet"
}
}'
代理文件格式
---
name: agent-name
description: 何时/为何使用此代理
tools: Read, Edit, Bash # 可选，如果省略则继承所有
model: sonnet # sonnet, haiku, claude-opus-4-5-20251101, inherit
---
系统提示内容在此...
配置字段
| 字段 |
是否必需 |
选项 |
name |
是 |
小写，连字符 |
description |
是 |
何时使用 |
tools |
否 |
工具列表（如果省略则继承所有） |
model |
否 |
sonnet, haiku, claude-opus-4-5-20251101, inherit |
内置代理
| 代理 |
模型 |
工具 |
目的 |
| 通用目的 |
Sonnet |
全部 |
复杂多步骤任务 |
| 计划 |
Sonnet |
只读 |
计划模式研究 |
| 探索 |
Haiku |
只读 |
快速代码库搜索 |
模型选择
| 模型 |
速度 |
最佳用途 |
| Haiku |
最快 |
搜索，快速查找 |
| Sonnet |
快速 |
大多数任务（默认） |
| Opus |
较慢 |
复杂推理 |
工具组合
# 代码审查员（只读）
tools: Read, Grep, Glob, Bash
# 调试器
tools: Read, Edit, Bash, Grep, Glob
# 实现器
tools: Read, Write, Edit, Bash, Glob
示例代理
代码审查员
---
name: code-reviewer
description: 审查代码质量和安全。在代码更改后使用。
tools: Read, Grep, Glob, Bash
model: sonnet
---
审查代码以查找：
- 安全漏洞
- 代码质量问题
- 缺少错误处理
- 测试覆盖缺口
按优先级输出发现：关键 > 警告 > 建议
调试器
---
name: debugger
description: 调试错误和测试失败。
tools: Read, Edit, Bash, Grep, Glob
model: inherit
---
调试过程：
1. 捕获错误细节
2. 识别失败位置
3. 形成假设
4. 测试和验证
5. 实施修复
文件位置
| 类型 |
位置 |
优先级 |
| 项目 |
.claude/agents/ |
最高 |
| 用户 |
~/.claude/agents/ |
较低 |
高级模式
可恢复代理
[代理返回 agentId: "abc123"]
# 之后：恢复上下文
claude -r "abc123" "继续分析"
代理链式
使用代码分析器查找问题，
然后使用优化器修复它们
最佳实践
- 单一职责 - 每个代理有一个明确的目的
- 限制工具 - 仅授予所需工具
- 清晰描述 - 以行动为导向，包括“主动”
- 版本控制 - 将
.claude/agents/ 提交到 git