启动参数看官方文档在输出中包含部分流事件Syntax--include-partial-messages示例claude -p --output-format stream-json --include-partial-messages "query"全网调研整理典型场景构建实时流式 UI：在 agent 逐 token 生成文本时立即渲染，无需等待完整回复监控多步 agent 进度：通过 `content_block_start` 事件实时捕获正在执行的 Tool 名称并显示状态指示器CI/CD 脚本场景：配合 jq 流式过滤文本 delta，及时输出进度而非阻塞到任务结束调试 Tool 调用输入：流式捕获 `input_json_delta` 事件，观察 Tool 参数 JSON 的逐步构建过程自定义 API 重试处理：监听 `system/api_retry` 事件，实现自定义退避逻辑或向用户展示重试进度实用技巧必须三标志联用：`--output-format stream-json --verbose --include-partial-messages`，单独使用 `stream-json` 不会发出 partial 事件用 `jq -rj` 而非 `-r`：`-j` 不自动追加换行，可让 token 连续流出而不断行；完整过滤器：`select(.type=="stream_event" and .event.delta.type?=="text_delta") | .event.delta.text`兼容两种文本来源：`jq -j '(.event.delta.text? // empty), (.message.content[]?.text? // empty)'` 可同时处理 StreamEvent 和 AssistantMessage 两种格式搭配 `--bare` 减少 CI 启动开销：跳过 hooks/MCP/CLAUDE.md 发现，仅凭显式传入的标志运行，结果可重复SDK 中等效选项：Python 传 `include_partial_messages=True`，TypeScript 传 `includePartialMessages: true`，与 CLI flag 行为完全一致常见坑与 `--json-schema` 不兼容：即使启用本 flag，结构化 JSON 也只出现在最终 `ResultMessage.structured_output`，不会流式逐块输出（官方已关闭该功能请求）启用扩展思考模式（`max_thinking_tokens` / `maxThinkingTokens`）后 StreamEvent 不再发出，只收到完整 AssistantMessageNDJSON 朴素分块解析易崩溃：事件行可能跨 TCP 数据块边界，必须按换行符完整缓冲后再 `JSON.parse`，否则频繁遇到解析错误来源Stream responses in real-time - Claude Code Agent SDK DocsRun Claude Code programmatically (Headless / CLI -p)Parsing Claude Code stream-json output with jq — ytyng.comClaude Code stream-json: the output format that changes everything — Background Claude[Feature Request] Stream partial JSON tokens when using --json-schema · Issue #15511 · anthropics/claude-code创建于v1.0.109最近更新v1.0.109变化次数1新增 1变化时间线(按版本倒序)新增v1.0.109· 2025/09/09 · 2025/09/09新增 CLI flag 以支持 partial message streaming。上一个--ide回到命令字典下一个--init