创建子代理

Claude Code 内置了子代理功能，但您也可以创建自定义子代理。这些定制子代理专精于特定任务——例如代码审查、测试编写或文档检查。它们被定义为带有YAML前置元数据的Markdown文件，用于告知Claude何时使用该子代理以及其行为方式。

创建子代理

最简单的创建方式是使用/agents斜杠命令。这会打开管理子代理的主界面，选择创建新代理即可开始。

首先需要选择子代理的作用范围：

• 项目级——仅限当前项目使用
• 用户级——可在您机器上的所有项目中共享

接下来选择创建方式。虽然可以手动编写配置，但推荐让Claude为您生成。只需描述期望子代理执行的任务，Claude就会根据输入生成名称、描述和系统提示。

自定义工具

创建过程中可以定制子代理可访问的工具类别：

• 只读工具
• 编辑工具
• 执行工具
• MCP工具
• 其他工具

需考虑子代理的实际需求。例如代码审查代理可能不需要编辑工具——它应该阅读分析代码而非修改代码。但可以保留执行工具以便识别待处理变更。

选择模型与颜色

配置工具后，需选择驱动子代理的Claude模型：

• Haiku——适合快速轻量任务
• Sonnet——速度与深度的平衡选择
• Opus——适合复杂分析场景
• Inherit——继承主会话当前使用的模型

最后选择显示颜色。这个UI标识能帮助您快速识别活跃的子代理，虽然是小细节，但在多子代理运行时特别实用。

配置文件

创建完成后，子代理配置文件会保存至项目目录（通常位于. claude/agents/your-agent-name. md）。典型配置示例如下：

各字段说明：

• name——子代理的唯一标识符。通过直接告知Claude或在消息中输入@agent code-quality-reviewer来引用
• description——控制Claude决定使用子代理的条件（如需换行请使用转义字符\n）。可包含示例对话帮助Claude理解何时适合委派
• tools——列出子代理可访问的工具，可随时编辑
• model——指定使用的Claude模型：sonnet、opus、haiku或inherit
• color——子代理的UI标识颜色

系统提示

Markdown文件主体部分（YAML元数据下方）是系统提示。在此处编写子代理的指令：关注重点、分析方式和结果反馈机制。

精心编写的系统提示是区分子代理是否实用的关键。需明确说明检查重点和输出结构。

实现自动委派

若希望Claude自动委派任务而不需明确要求，请在描述字段包含"proactively"字样。例如：

还可在描述中添加示例对话，帮助Claude理解特定触发场景。示例越具体，Claude的委派决策就越精准。

测试子代理

创建完成后，可通过修改代码并让Claude审查来进行测试。

如果子代理未在预期场景激活，请检查描述字段。添加更多具体示例和触发条件能帮助Claude更好地理解任务委派时机。