Claude Code 内置 Agent 对比:工具、权限与适用场景
27 May 2026
梳理 Claude Code 6 个内置 Agent 的核心属性、工具权限、模型和使用场景,并解释多 Agent 协作、Agent 核心概念,以及如何选择合适的 Agent。
- Claude Code 内置 Agent 对比表
Claude Code 内置 Agent 对比表
1. 概述
Claude Code 提供了 6 个功能各异的内置 Agent,每个 Agent 都是专门为处理特定类型任务而设计的智能助手。它们拥有不同的工具配置、权限模式和行为特征,能够高效地帮助用户完成各种开发工作。
2. 所有 Agent 共有的核心属性
| 属性名 | 类型 | 描述 |
|---|---|---|
agentType |
string | Agent 类型标识符 |
whenToUse |
string | Agent 适用场景描述 |
getSystemPrompt |
function | 返回该 Agent 的系统提示 |
source |
string | Agent 来源(固定为 ‘built-in’) |
baseDir |
string | 基础目录(固定为 ‘built-in’) |
3. 各 Agent 详细对比
| 属性 | GENERAL_PURPOSE_AGENT | CLAUDE_CODE_GUIDE_AGENT | EXPLORE_AGENT | PLAN_AGENT | VERIFICATION_AGENT | STATUSLINE_SETUP_AGENT |
|---|---|---|---|---|---|---|
| agentType | general-purpose | claude-code-guide | Explore | Plan | verification | statusline-setup |
| 工具配置 | ['*'] (允许所有工具) |
Bash、FileRead、WebFetch、WebSearch(含搜索工具) | 禁止编辑工具 | 禁止编辑工具 | 禁止编辑工具 | 未指定 |
| 禁止工具 | - | - | AgentTool、ExitPlanModeTool、FileEditTool、FileWriteTool、NotebookEditTool | AgentTool、ExitPlanModeTool、FileEditTool、FileWriteTool、NotebookEditTool | AgentTool、ExitPlanModeTool、FileEditTool、FileWriteTool、NotebookEditTool | - |
| 颜色 | - | - | - | - | red | - |
| 模型 | 未指定 (使用默认) | haiku | 继承 (Ant) / haiku (外部) | inherit | inherit | 未指定 |
| 权限模式 | 未指定 | dontAsk | 未指定 | 未指定 | 未指定 | 未指定 |
| 记忆功能 | - | - | - | - | - | - |
| 隔离模式 | - | - | - | - | - | - |
| 后台任务 | - | - | - | - | true | - |
| 省略 CLAUDE.md | - | - | true | true | - | - |
| 关键系统提醒 | - | - | - | - | 有 (实验功能) | - |
| 功能定位 | 通用任务处理 | Claude Code 使用指南 | 快速代码搜索分析 | 架构设计规划 | 实现验证检查 | 状态栏设置 |
| 使用场景 | 复杂多步骤任务、研究搜索 | 回答 Claude Code 相关问题 | 查找文件、搜索代码模式 | 规划任务实现策略 | 验证任务完成情况 | 配置状态栏 |
4. 详细工具配置说明
表格中的”工具配置”列提供了简化的描述,以下是详细说明:
GENERAL_PURPOSE_AGENT
- 工具配置: 允许所有工具
- 具体包括: 所有可用的 Claude Code 工具,无限制
CLAUDE_CODE_GUIDE_AGENT
- 工具配置: 仅允许特定工具
- 允许的工具: Bash、FileRead、WebFetch、WebSearch(根据环境动态选择搜索工具)
- 工具选择逻辑:
- 有嵌入式搜索工具时:使用 Bash 工具和
find/grep命令 - 无嵌入式搜索工具时:使用 Glob 和 Grep 工具
- 有嵌入式搜索工具时:使用 Bash 工具和
EXPLORE_AGENT
- 工具配置: 禁止编辑工具(只读模式)
- 允许的工具: 除编辑工具外的所有工具(如搜索、读取、Bash 等)
- 禁止的工具: AgentTool、ExitPlanModeTool、FileEditTool、FileWriteTool、NotebookEditTool
PLAN_AGENT
- 工具配置: 禁止编辑工具(只读模式)
- 允许的工具: 除编辑工具外的所有工具(如搜索、读取、Bash 等)
- 禁止的工具: AgentTool、ExitPlanModeTool、FileEditTool、FileWriteTool、NotebookEditTool
VERIFICATION_AGENT
- 工具配置: 禁止修改项目(验证模式)
- 允许的工具: 除编辑工具外的所有工具(如搜索、读取、Bash 等)
- 禁止的工具: AgentTool、ExitPlanModeTool、FileEditTool、FileWriteTool、NotebookEditTool
STATUSLINE_SETUP_AGENT
- 工具配置: 未明确指定
- 说明: 该 Agent 专门用于配置状态栏,工具使用可能根据具体任务动态调整
5. 权限模式说明
- 未指定: 使用默认权限模式(通常为 ‘acceptEdits’)
- dontAsk: 不询问用户权限,直接执行
- 其他模式: 如 ‘plan’(需要计划模式批准)、’auto’(自动判断)
6. 使用建议
| 任务类型 | 推荐 Agent |
|---|---|
| 快速搜索代码 | Explore |
| 规划架构设计 | Plan |
| 代码问题解答 | Claude Code Guide |
| 验证实现 | Verification |
| 通用任务处理 | General Purpose |
| 配置状态栏 | Statusline Setup |
7. 何时会使用多个Agent
在Claude Code中,会在以下情况下使用多个Agent协作完成任务:
1. 复杂任务分解
将大型任务分解为多个子任务,每个子任务由不同的Agent处理。例如:
- 需求分析 → 使用Explore Agent搜索相关代码
- 架构设计 → 使用Plan Agent制定实现计划
- 代码实现 → 使用General Purpose Agent编写代码
- 验证测试 → 使用Verification Agent验证实现
2. 专业任务处理
使用特定类型的Agent处理专业任务:
- 代码搜索分析 → Explore Agent
- 架构设计规划 → Plan Agent
- 代码问题解答 → Claude Code Guide Agent
- 实现验证检查 → Verification Agent
3. 异步任务处理
长时间运行的任务会在后台创建新的Agent:
- 持续集成测试
- 代码扫描分析
- 大型文件处理
4. 多Agent协作
通过Teams功能创建多个Agent协作完成任务:
- 团队成员间的任务分配
- 并行处理不同任务
- 任务结果的合并与汇总
8. Agent 核心概念
8.1 什么是 Agent?
在Claude Code中,Agent是具有特定行为准则、工具权限和性能特征的智能助手,专门用于处理特定类型任务。它是一个独立的工作实体,可以:
- 自主执行任务:根据用户输入和系统提示,决定使用哪些工具完成任务
- 具有特定专长:每个Agent都有明确的功能定位和行为准则
- 权限受限:只能使用配置允许的工具,防止不必要的风险
- 可配置:支持自定义模型、努力程度、权限模式等属性
从代码定义来看,Agent具有以下核心属性(BaseAgentDefinition):
export type BaseAgentDefinition = {
agentType: string; // Agent类型标识符
whenToUse: string; // 使用场景描述
tools?: string[]; // 允许使用的工具列表
disallowedTools?: string[]; // 禁止使用的工具列表
getSystemPrompt: () => string; // 返回Agent的行为准则
model?: string; // 使用的模型
permissionMode?: PermissionMode; // 权限模式
memory?: AgentMemoryScope; // 持久化内存范围
// ... 其他属性
}
8.2 Claude Code 是 AI Agent 吗?
简单来说,Claude Code不是单一的AI Agent,而是一个包含多个AI Agent的系统。
- Claude Code:是一个完整的CLI工具和交互式开发环境,提供运行Agent的基础设施
- Agent是系统组件:Claude Code包含多个内置Agent(如General Purpose、Explore、Plan等),每个Agent都是专门设计用于特定任务的智能助手
8.3 AI Agent 定义
根据行业标准定义,AI Agent是一个能够自主感知环境、做出决策并执行行动以实现特定目标的人工智能系统。AI Agent具有以下核心特征:
- 自主性(Autonomy):能够在没有持续人类干预的情况下执行任务
- 感知能力(Perception):能够获取和理解环境信息
- 决策能力(Reasoning):能够基于信息做出判断和决策
- 行动能力(Action):能够执行操作以改变环境或完成任务
- 目标导向(Goal-oriented):有明确的目标或任务要完成
Claude Code中的每个内置Agent都符合AI Agent的定义,它们可以独立执行特定任务,感知代码库信息,做出决策,并执行相应的操作来完成任务。
原文链接: Claude Code 内置 Agent 对比:工具、权限与适用场景 ,转载请注明来源!
– EOF –