/agents
管理子代理(Subagent)配置。
/agents 涉及的是子代理(subagents):Claude 用来委派子任务的独立配置。自 2.1.198 版本起,该命令不再打开专门的界面,而只是显示一段提示,建议直接让 Claude 创建或管理子代理,或者自行编辑 .claude/agents/ 或 ~/.claude/agents/。在 2.1.197 及更早版本中,/agents 会打开一个交互式界面,其中一个标签页显示正在运行的子代理,另一个标签页用于创建、编辑和删除定义。
这次调整并没有改变子代理文件本身、它们的 frontmatter 字段以及两个存放位置:项目级子代理位于 .claude/agents/,只在对应仓库中可用;个人子代理位于 ~/.claude/agents/,可跨项目使用。新建的文件会在几秒钟内被自动识别,无需重启。
✅ 什么时候用?
让 Claude 创建一个新的子代理配置
执行 /agents,然后说:“帮我在 ~/.claude/agents/ 中创建一个用于数据库迁移的个人子代理。”
在当前项目中调整之前,先查看已有的子代理定义
执行 /agents,让系统提示 .claude/agents/ 或 ~/.claude/agents/ 的位置,然后直接在编辑器中打开对应的 Markdown 文件。
⛔ 什么时候不该用?
期望出现带有运行中/库标签页的交互式管理界面
从 2.1.198 版本起,/agents 只会显示一段提示文字,而不再是以前的交互式界面
更好的选择: 直接在编辑器中编辑 .claude/agents/ 或 ~/.claude/agents/,或者使用 2.1.197 及更早的版本
想在团队或组织范围内强制统一使用某个子代理
通过 .claude/agents/ 或 ~/.claude/agents/ 创建的子代理只是项目级或个人子代理,对其他人没有强制约束力
更好的选择: 由组织管理员通过 .claude/agents/ 的托管设置目录(Managed Settings)方式发布托管子代理(Managed Subagents)
来源
- Claude Code 文档(官方) ↗ code.claude.com
更多命令 · Claude Code