用 Subagent 分工：创建你的第一个审查助手

不是任务大就要拆。这些情况适合用 Subagent：

• 要读很多文件，但你只需要结论
• 需要一个独立视角，比如审查刚写完的代码
• 想限制权限，比如只能读、不能改

小改动和一两步能完成的事，直接在主对话里做更快。

Subagent 是一个 Markdown 文件。放在项目的 .claude/agents/ 里，只有这个项目可用；放在 ~/.claude/agents/ 里，所有项目都能用。

新建 .claude/agents/code-reviewer.md：

---
name: code-reviewer
description: 审查最近的代码改动，查找 bug、安全问题和可读性问题。完成代码修改后使用。
tools: Read, Glob, Grep, Bash
model: sonnet
---

你是一名严谨的代码审查员。

1. 运行 git diff 查看改动
2. 只检查改动涉及的代码
3. 按严重程度列出问题，每条写清文件、行号和修改建议
4. 没有问题就直接说明，不要为了凑数提意见

你只负责审查，不要修改任何文件。

配置里 name 和 description 是必填项，文件正文就是这个助手的工作说明。tools 用来限制它能用的工具。

新建的文件一般几秒内就会生效。如果 agents 文件夹是在会话中途新建的，就重启一次 Claude Code。

可以直接用自然语言调用：

用 code-reviewer 审查我刚才的改动

也可以用 @ 提及它。如果 description 写得准确，Claude 也会在合适时自动派给它。

Subagent 看不到主对话的全部内容，所以任务说明要完整。一份好的说明包括：

• 要做什么
• 看哪些文件或目录
• 结果用什么格式交回来

看几次结果后，再调整它的说明：

• 废话太多：要求只列确实存在的问题
• 总漏同一类问题：把检查项写进说明
• 成本太高：简单任务换用更轻量的模型

资料来源

• 核对自 Claude Code Subagents 文档↗
• “默认自己做，有理由才派出去”的思路参考了 夙愿学长 在 X 上的分享↗