Claude Code Agent 使用
SubAgent格式
- 文件名:
xxx.md(放在C:\Users\用户名\.claude\agents\下面,不需要建子文件夹) - 结构:最上面
---包裹 YAML 配置,---之后是系统提示词 - 示例
--- name: file-lister description: 文件扫描子Agent,只查找 .h .cpp 文件,只读,不修改文件 tools: Glob,Read mode: manual --- 你是文件扫描专员。收到指令后,使用 glob 工具搜索 .h 和 .cpp 文件,输出找到的文件清单。 不要修改任何文件,不要执行危险bash。每一步工具调用前简要说明你要做什么。
重点字段说明
name:调用时@file-lister用的名字,必须唯一,小写 + 横杠description:描述tools:可选,限定可用工具;不写默认继承主 Agent 全部工具mode:权限模式(manual /acceptEdits/auto /plan),独立于主 Agent---下面一大段 = 这个子 Agent 专属 system prompt
SubAgent调用
@file-lister 扫描当前目录,列出所有 .h 和 .cpp 文件
执行流程
- 主 Agent 识别
@file-lister,唤起这个子 Agent - 子 Agent 拿到它自己独立的提示词、工具白名单、manual 权限
- 它想要调用 Glob → 弹窗
Allow? [y/n] - 输入
y放行,拿到文件列表,整理结果返回给主 Agent 展示

查看可用的subagents
扫描 ~/.claude/agents 和 ./.claude/agents 目录,列出所有 subagent 的名字和简介

浙公网安备 33010602011771号