启动参数看官方文档获取与JSON Schema匹配的验证JSON输出Syntax--json-schema <schema>示例claude -p --json-schema '{"type":"object",...}' "query"全网调研整理典型场景将 Claude 接入 CI/CD 流水线时，用 schema 约束输出格式，无需编写防御性解析代码自动化 PR review：按固定字段（title/risk/annotations）生成结构化审查报告供 dashboard 消费代码分析数据提取：从源文件中抽取函数名、类名等，直接输出为可消费的 JSON 数组测试失败归因：将失败分类为 { test_name, root_cause, suggested_fix, confidence } 供下游系统处理发布健康检查：生成包含 status/checks/action_required 的结构化报告用于发布门控实用技巧结构化结果在 `structured_output` 字段而非 `result`，须用 `jq '.structured_output'` 提取搭配 `--bare` 跳过本地 hooks/MCP/CLAUDE.md，确保 CI 环境结果与本地一致可复现schema 文件纳入版本控制，传入前用 `jq -c . schema.json` 压缩为单行，避免 shell 换行符问题在 schema 中对枚举字段加 `enum` 约束（如 `"level": {"enum":["error","warning","notice"]}`），进一步减少模型自由发挥schema 即接口契约：字段名和类型直接决定下游消费者逻辑，变更 schema 需同步更新调用方常见坑必须同时传 `--output-format json`，单独使用 `--json-schema` 不会生效，输出不含 `structured_output` 字段schema 验证发生在模型输出完成后（非推理时约束），schema 过于复杂时仍可能验证失败不适合低延迟场景（pre-commit hook、编辑器实时补全），结构化输出需额外处理时间来源Run Claude Code programmatically (Headless / Agent SDK)CLI reference - Claude Code DocsClaude Code: 10 CLI flags you probably aren't usingStructured CLI Output as Pipeline Glue | Self-Testing AI Agents--json-schema: Definition & Claude SA Exam Reference最早记录ⓘ≤v2.1.84最近更新v2.1.205变化次数3修复 3变化时间线(按版本倒序)修复v2.1.205· 2026/07/09 · 2 天前修复了 schema 无效时 silently 产生非结构化输出，以及使用 format keyword 的 schema 被拒绝的问题修复v2.1.187· 2026/06/24 · 17 天前修复了模型可在成功调用后无限重新调用 StructuredOutput 的问题修复v2.1.84· 2026/03/26 · 2026/03/26修复外部会话使用标志且子代理也指定 schema 时的 API 400 错误上一个--json回到命令字典下一个--maintenance