启动参数看官方文档为当前会话指定一个 agent（覆盖默认设置）Syntax--agent <name>示例claude --agent my-custom-agent全网调研整理典型场景将整个会话切换为指定 subagent 的身份：系统提示、工具限制和模型一次性覆盖默认 Claude Code 配置在 CI/CD 脚本或自动化流水线中以特定专家角色（如 code-reviewer、debugger）非交互运行临时覆盖 .claude/settings.json 中已设置的 agent 默认值，无需修改配置文件通过 plugin 分发的 agent 出现同名冲突时，用 scoped 名称（如 my-plugin:security-reviewer）精确指定与 --bg 组合将整个专用 agent 会话作为后台任务异步运行实用技巧若要对项目的所有会话默认生效，在 .claude/settings.json 中设置 "agent": "<name>"；CLI 标志优先级高于该设置agent 定义文件中的 initialPrompt 字段会在 --agent 启动时自动作为第一轮用户消息提交，可免去手动输入固定指令plugin 子目录中的 agent 需要带完整子路径，例如 claude --agent my-plugin:review:security通过 --resume 恢复会话时，上次使用的 --agent 选择会持续生效，无需重复指定若 agent 定义的 mcpServers 字段含内联服务器，以 --agent 启动主会话时这些服务器也会在启动时连接，等同于本地 .mcp.json 中的配置结合 --bg 可以同时启动多个专用 agent 后台会话再用 claude agents 统一监控，实现并行工作流常见坑--agent 指定的 subagent 系统提示会完全替换默认 Claude Code 系统提示，包括工具指导和安全指令，若 agent 定义不完整可能导致行为缺失直接在磁盘编辑 agent markdown 文件后须重启会话才生效；通过 /agents 界面创建/修改的则立即生效plugin 来源的 agent 即使定义了 hooks、mcpServers、permissionMode 这三个 frontmatter 字段也会被忽略，需复制到 .claude/agents/ 才能使用来源创建自定义 subagents - Claude Code 官方文档（中文）CLI 参考 - Claude Code 官方文档（中文）Create custom subagents - Claude Code Docs (English)5 分钟上手 Claude 自定义 Subagents - 腾讯云开发者社区Claude Code Cheat Sheet 2026: Commands, Flags, Shortcuts创建于v2.0.59最近更新v2.1.143变化次数4新增 1改进 2修复 1变化时间线(按版本倒序)修复v2.1.143· 2026/05/16 · 2026/05/16修复无法找到未加 plugin: 前缀的插件贡献的 agent 的问题改进v2.1.119· 2026/04/24 · 2026/04/24现在遵守 agent 定义的 permissionMode改进v2.1.2· 2026/01/09 · 2026/01/09现在支持在 SessionStart hook 中填充 agent_type 字段新增v2.0.59· 2025/12/05 · 2025/12/05新增 CLI 参数覆盖当前会话的 agent 配置上一个--add-dir回到命令字典下一个--agents