命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
会话内管理面板:列出本会话正在运行或已完成的 dynamic workflow,用于监控进度、查看结果、暂停、停止与重启。需 v2.1.154+。
/workflows/workflows 不是"创建命令",而是"查看/管理面板"。
它列出本 session 内正在跑或已完成的 dynamic workflow(动态工作流)—— 让你监控进度、读结果、暂停、停掉、重启。
Dynamic workflow = Claude 写的一段 JavaScript 脚本,由独立 runtime 在后台执行,可调度数十到上千个 subagent。脚本本身保管中间结果(不进会话上下文),完成后只把"最终报告"塞回 Claude。
需要 Claude Code v2.1.154+,所有付费计划(Pro/Max/Team/Enterprise)+ Anthropic API / Bedrock / Vertex / Foundry 都支持。Pro 用户需要在 /config 里手动打开 "Dynamic workflows" 开关。
/deep-research(最快上手)/deep-research What changed in the Node.js permission model between v20 and v22?
它在多个角度并行 web search → 交叉验证 → 投票剔除存疑论断 → 出一份带引用源的报告。
workflow 关键词Run a workflow to audit every API endpoint under src/routes/ for missing auth checks
workflow 这个词会被高亮,Claude 自动写一段脚本而非 turn-by-turn 干活。
Backspace 或 Alt+W 忽略本次/config → Workflow keyword trigger off/effort ultracode 让 Claude 自决/effort ultracode
之后所有实质性任务都会被自动拆成 workflow(一个理解代码、一个改动、一个验证)。每个请求耗 token 显著增加,routine 工作记得 /effort high 切回。仅在支持 xhigh effort 的模型上可用。
/workflows 监控 + 控制进入 session 后任何时刻输入:
/workflows
显示所有 run。用 ↑/↓ 选某个 run,Enter 进入进度视图 —— 看每个 phase 的 agent 数 / token 总量 / 已用时长。
| 键 | 动作 |
|---|---|
↑ ↓ | 选 phase / agent |
Enter / → | 钻入 phase,再钻入 agent 看 prompt + 工具调用 + 结果 |
Esc | 退一层 |
j k | 在 agent 详情里上下滚 |
p | 暂停 / 恢复整个 run |
x | 停掉选中的 agent;焦点在 run 时停掉整个 workflow |
r | 重启选中的(正在跑的)agent |
s | 保存这次 run 的脚本为可复用命令 |
输入框下方任务面板也有一行实时进度摘要,↓ 聚焦它再 Enter 展开。
跑出满意结果后:/workflows → 选中 → 按 s → Tab 切换保存位置:
.claude/workflows/(项目内,进 git,团队共享)~/.claude/workflows/(个人,所有项目可见)之后用 /<name> 跑同样的编排。项目同名优先于个人同名。
| 约束 | 原因 |
|---|---|
| 同时最多 16 个 agent(CPU 少的机器更少) | 限本机资源 |
| 单次 run 总共最多 1000 agents | 防失控循环 |
| run 中不能等用户输入(只有权限 prompt 能暂停) | 阶段间签字请拆多个 workflow |
| 脚本本身不能直接读 fs / 跑 shell | 由 agent 干活,脚本只编排 |
| 退出 Claude Code 后无法恢复正在跑的 workflow | 同一 session 内可 resume |
权限:run 启动时按你的 permission mode 弹一次大确认(default 每次问、auto 首次问、bypass / -p 永不问)。workflow 内的 agent 永远跑在 acceptEdits 模式,文件改动自动批准。Shell / WebFetch / MCP 不在 allowlist 的仍会 mid-run 弹窗 —— 长跑前先把命令加 allowlist。
| Subagents | Skills | Workflows | |
|---|---|---|---|
| 谁决定下一步 | Claude 逐回合 | Claude 按 prompt | 脚本 |
| 中间结果在哪 | 主上下文里 | 主上下文里 | 脚本变量(不污染上下文) |
| 可复用 | worker 定义 | 指令 | 整个编排 |
| 规模 | 每回合几个 | 同 subagent | 数十到上千 |
| 中断后 | 整个回合重启 | 整个回合重启 | 同 session 内可 resume(已完成 agent 走缓存) |
简单说:
/agents/batch(workflow 的兄弟,scope 不同)/deep-research 多源交叉验证后出带引用报告/model 看会不会切到大模型,routine 用 sonnet/haiku/effort 菜单上没有 ultracode 说明当前模型不支持 xhigh/config 里要先打开 Dynamic workflows 才能用/config → Dynamic workflows off(本机持久)~/.claude/settings.json 加 "disableWorkflows": trueCLAUDE_CODE_DISABLE_WORKFLOWS=1 环境变量关掉后,bundled workflow 命令消失、workflow 关键词不再触发、/effort 菜单去掉 ultracode。