管道组合 + 结构化输出：让 Claude 和 grep 并肩作战
系列第 2 篇 · 读完 6 分钟 · 前置：第 1 篇 Headless 入门
上篇说了claude -p单次调用。但这只是"问一句，答一句"。真正的威力在于把 Claude Code 串进 Unix 工具链——让它输出机器可读的 JSON，用jq解析，和grep、cat肩并肩。
Unix 管道 30 秒速成
终端里每个命令有三个"通道"：
stdin（标准输入） ↓ [ 命令进程 ] ↓ stdout（标准输出）管道|做的事很简单：把左边命令的 stdout 接到右边命令的 stdin：
lssrc/|greptsx# ↑ 管道左边输出的内容，变成右边读取的内容。
Claude Code 怎么接入管道
claude -p同时从两个来源读取信息：
- 管道 stdin：“对什么做”（数据/上下文，前置）
-p参数：“做什么”（任务指令，后置）
命令A 的 stdout -p "做这个操作" │ │ └──────────┬───────────────────────┘ ▼ ┌─────────────────┐ │ claude -p │ └────────┬────────┘ ▼ 终端输出 / 继续管道三种实战模式
模式一：喂数据进来
# git diff 的输出 → Claude 审查gitdiffHEAD~3 -- src/|claude-p"审查这些代码变更，列出问题"--allowed-tools"Read"拆解：git diff生成变更内容，|传给 Claude，Claude 读到 diff + 审查指令，输出问题列表。
模式二：拿结果出去
claude-p"列出所有 .tsx 文件的路径和用途"\--output-format json --allowed-tools"Bash,Read"|jq'.result'--output-format json保证输出 合法 JSON（不会带代码块标记），jq '.result'提取 Claude 的文本回复。
模式三：两头都接
cat/tmp/app.log|\claude-p"分析这些日志，输出所有错误。每条一行，格式：时间|类型|严重级别。纯文本，不要 Markdown 标记。"|\grep"high">critical-errors.txt整条链路：cat读文件 → Claude 分析 →grep筛严重错误 → 落盘。Claude Code 成了流水线里的一环。
重要约束：当 Claude 的输出要作为下一个命令的输入时，prompt 里必须明确要求“纯文本，不要 Markdown 标记”。否则 Claude 可能加 ```text 代码块标记，grep会筛出错误结果。
结构化输出：别让 Claude 写作文
我看到 3 个编译错误，分别在 IconCard.tsx、TimelineZone.tsx 里……这种文本脚本没法解析——程序分不清"3"是错误数量还是其他数字。
方法一：prompt 约束 JSON
claude-p"运行 npx tsc --noEmit，根据结果输出 JSON： {\"errors\": 错误数,\"files\": [有问题的文件名] } 只输出 JSON，不要任何其他文字。"--allowed-tools"Bash"--max-turns1五个约束技巧：
| 约束 | 写法 | 效果 |
|---|---|---|
| 固定字段名 | "errors","files" | 不会出随机 key |
| 固定类型 | <数量，数字类型> | 不会是字符串"3" |
| 禁止废话 | 不要输出 JSON 以外的文字 | 不会破坏 JSON 结构 |
| 枚举值 | true/false二选一 | 不会出现第三种值 |
| 防代码块 | 输出的第一个字符必须是 { 或 [ | 最关键的约束——阻止 Claude 加 Markdown 代码块标记（```json），加了 jq 直接报错 |
方法二：--json-schema
prompt 约束偶尔会失效。Claude Code 提供了原生 JSON Schema 校验——注意：仍需在 prompt 中要求输出 JSON，Schema 负责校验结构，不负责让 Claude 决定输出格式：
claude-p"检查编译错误，输出 JSON"\--json-schema'{"type":"object","properties":{"errors":{"type":"number"},"files":{"type":"array","items":{"type":"string"}}},"required":["errors","files"]}'\--allowed-tools"Bash"--max-turns1Schema 确保字段名、类型、必填项完全匹配你定义的规范——不会多字、不会少字、不会改 key 名。比纯 prompt 约束可靠得多。
技巧：Schema 手写麻烦时，让 Claude 帮你写：
claude-p"生成一个 JSON Schema，描述 TypeScript 编译结果：errors（数字）、files（字符串数组）、blocking（布尔）。只输出 Schema JSON。"方法三：--output-format json
如果同时需要业务数据 + session 元数据，用这个：
claude-p"检查编译错误"--output-format json --allowed-tools"Bash"--max-turns1输出是完整 session JSON，.result字段是 Claude 的文本回复
| prompt 约束 | --json-schema | --output-format json | |
|---|---|---|---|
| 可靠性 | 偶尔带"希望对你有帮助" | Schema 强制校验 | 合法 JSON |
| 业务数据 | 直接输出 | 直接输出 | 包在.result里 |
| 元数据 | 无 | 无 | 有 |
| 适用 | 简单的一次性脚本 | 需要保证字段结构的场景 | 需要监控/计费/调试 |
jq 五招保底
result='{"errors":3,"files":["a.tsx","b.tsx"],"blocking":true}'echo"$result"|jq'.errors'# 取值 → 3echo"$result"|jq-r'.errors'# 去引号 → 3echo"$result"|jq'.files[]'# 遍历数组echo"$result"|jq'.files | length'# 数组长度 → 2echo"$result"|jq'keys'# 所有字段名实战：编译检查 + 自动决策
#!/bin/bashresult=$(cd~/my-project&&\claude-p"运行 npx tsc --noEmit，输出 JSON 格式的编译结果"\--json-schema'{"type":"object","properties":{"errors":{"type":"number"},"blocking":{"type":"boolean"}},"required":["errors","blocking"]}'\--allowed-tools"Bash"--max-turns1)blocking=$(echo"$result"|jq-r'.blocking')if["$blocking"="true"];thenecho"❌ 编译有阻塞性错误，停止"exit1fiecho"✅ 通过，继续..."这里用
--json-schema而不是--output-format json：--json-schema让 Claude 直接把业务数据作为输出主体，下游jq直接解析.blocking，不需要从.result字符串里再取一层。同时 Schema 强约束了字段类型——errors一定是数字，blocking一定是布尔，不会有 prompt 约束那种"偶尔带废话"的风险。
现在你的脚本能根据 Claude 的分析结果做自动决策了。
下一篇：[多步流水线 + 脚本实战] —— 把复杂任务拆成多步，串成一条自动执行的流水线。
系列目录：共 4 篇，从零到把 Claude Code 嵌入自动化脚本。
