启动参数看官方文档通过 JSON 动态定义自定义子 agentSyntax--agents <json>示例claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'全网调研整理典型场景临时测试 agent 配置时使用，无需在磁盘上创建 .md 文件CI/CD 脚本或自动化管道中以编程方式动态注入 agent 定义单次会话中临时覆盖同名文件 agent（--agents 优先级高于 .claude/agents/）一次性定义多个协作 agent 组合，快速验证多 agent 工作流通过 SDK 调用时以代码形式传递 agent 配置，实现配置即代码实用技巧JSON 中用 `prompt` 字段替代 .md 文件的 markdown body 作为系统提示，两者完全等效单次 --agents 调用可定义多个 agent（JSON 多键），同时注入整套 agent 团队设置 `model: "haiku"` 可将探索类 agent 成本降到最低，Opus 留给安全审计加 `isolation: "worktree"` 让 agent 在临时 git worktree 中运行，防止污染当前工作区加 `background: true` 使 agent 始终以后台异步模式执行，结合 Ctrl+B 可在运行中切换description 中写 'Use proactively' 短语，Claude 会主动识别场景自动委托而无需手动触发常见坑CLI 定义的 agent 仅存在于当前会话，进程退出即消失，不适合团队共享或长期复用与文件 agent 同名时 --agents 会静默覆盖，调试时可能误以为文件版本在生效JSON 中列出 `hooks`、`mcpServers`、`permissionMode` 字段对 plugin subagent 无效（但对 --agents 直接定义有效）来源Create custom subagents - Claude Code Docs (EN)创建自定义 subagents - Claude Code Docs (ZH-CN)Claude Code Subagents: A 2026 Practical Guide - Tembo.ioClaude Code Cheat Sheet 2026 - blakecrosley.comClaude Code Async: Background Agents & Parallel Tasks - claudefa.st创建于v2.0.0最近更新v2.1.74变化次数2新增 1修复 1变化时间线(按版本倒序)修复v2.1.74· 2026/03/12 · 2026/03/12修复了full model IDs在agent frontmatter model:字段中被silently ignored的问题新增v2.0.0· 2025/09/29 · 2025/09/29新增启动参数，支持动态添加 subagents上一个--agent回到命令字典下一个--all