启动参数看官方文档为打印模式指定输出格式Syntax--output-format <format>示例claude -p "query" --output-format json全网调研整理典型场景在 CI/CD 流水线中用 --output-format json 获取可解析的结构化结果,再用 jq 提取字段构建自动化脚本时需要 total_cost_usd / duration_ms / num_turns 等元数据进行成本监控用 --output-format stream-json 实时捕获 tool_use / tool_result 中间事件,监控 agent 执行步骤配合 --json-schema 强制 Claude 返回符合特定 schema 的 JSON 结构化输出将 Claude Code 嵌入脚本或 supervisor 进程,替代人工交互操作实用技巧json 格式输出单个 JSON 对象,字段包括 result / session_id / total_cost_usd / duration_ms / num_turns / is_error,可直接 jq '.result' 提取正文stream-json 是 NDJSON 格式(每行一个 JSON 事件),需用 while read line 逐行处理,不能直接 jq 整体解析组合 --input-format stream-json + --output-format stream-json 可构建双向流式 agent harness在自动化场景中同时加 --max-budget-usd 限制单次调用花费:claude -p "..." --output-format json --max-budget-usd 2.00stream-json 的事件类型有 text / tool_use / tool_result,可过滤 .type=="tool_use" 监控工具调用详情常见坑--output-format 仅在 -p(print/非交互)模式下生效,在交互式会话中无效stream-json 输出多个独立 JSON 对象而非数组,直接 jq . 会报 parse error,必须逐行读取该 flag 只改变输出格式,不影响 Claude 的推理过程,不能用来让 Claude "思考得更结构化"来源CLI reference - Claude Code DocsClaude Code: 10 CLI flags you probably aren't using - mager.coClaude Code CLI: The Definitive Technical Reference | Introl BlogClaude Code CLI Commands & Flags | Full Reference Guide - CodingNomadsClaude Code CLI Cheatsheet - Shipyard最早记录ⓘ≤v0.2.66最近更新v2.1.161变化次数3改进 2修复 1变化时间线(按版本倒序)修复v2.1.161· 2026/06/03 · 2026/06/03修复与 -p 一起使用时后台子智能体输出损坏 stdout 的问题改进v2.1.111· 2026/04/16 · 2026/04/16stream-json 格式现在在 init 事件中包含 plugin_errors改进v0.2.66· 2025/04/09 · 2025/04/09Print mode (-p) 现在支持通过 --output-format=stream-json 实现流式输出上一个--no-browser回到命令字典下一个-p