Claude Code CLI 可以通过标准输入(stdin)接收上游命令的内容。使用 -p(或 --print)启动非交互任务后,Claude 会处理输入、输出结果并退出。

1. 把命令输出传给 Claude

基本格式如下:

1
上游命令 | claude -p "任务说明"

例如,总结项目说明,或根据暂存区改动生成提交信息:

1
2
cat README.md | claude -p "用三句话总结这个项目"
git diff --staged | claude -p "根据这些改动生成一条 commit message"

也可以将结果输出为 CLI 的 JSON 格式,供后续工具处理:

1
cat error.log | claude -p --output-format json "提取严重错误" | jq .

注意:CLI 的 JSON 输出格式不等于模型正文一定是纯 JSON。下游工具需要特定字段时,应先确认实际返回结构。

2. 为单次任务指定模型

通过 --model 指定此次命令使用的模型,不会直接修改另一个正在运行的交互会话:

1
2
cat app.py | claude -p --model haiku "检查这段代码是否有语法错误"
git diff | claude -p --model opus "审查这些代码改动"

主会话可以继续使用 Sonnet,而独立的 claude -p 命令使用另一模型。模型别名通常更简洁;完整模型 ID 则应确认当前 Claude Code 和 API 网关都支持。

3. 通过 Magpie 调用 Gemini

使用 Magpie 等网关时,--model 的值需要能被当前 Claude Code 和网关识别。网关界面中的显示名称不一定就是可用于命令行的模型 ID。

例如,先从网关确认可用的模型标识,再测试:

1
2
3
GEMINI_MODEL_ID='填入网关提供且当前 CLI 可识别的模型标识'
printf '1+1 等于几?\n' |
  claude -p --model "$GEMINI_MODEL_ID" "只给出答案"

如果返回 unrecognized_model,就不要只靠给显示名称加引号来处理。应确认模型的实际标识,并检查网关是否已通过 Claude Code 支持的模型发现机制暴露该模型,或配置了可用模型别名的映射。若网关提供请求日志,也可以据此确认请求是否到达预期路由。

例如,只有在网关已明确把 haiku 映射到目标 Gemini 路由时,下面的命令才会按预期转发:

1
printf '1+1 等于几?\n' | claude -p --model haiku "只给出答案"

使用时的注意事项

  • 管道中的日志、diff 等内容会发送到当前配置的 API 提供商或网关;包含密钥或个人信息时,先确认数据处理策略并做好脱敏。
  • 如果任务需要 Claude 使用本地工具,只显式授权完成任务所需的工具,避免不必要的宽泛授权。