启动参数看官方文档打印响应而不使用交互模式Syntax--print示例claude -p "query"别名-p全网调研整理典型场景在 CI/CD 流水线中无需交互地执行代码审查、测试修复等自动化任务将 Claude 嵌入 shell 脚本或 Makefile，用 pipe 传入文件内容并将响应重定向到文件作为 pre-commit hook 对 git diff 自动做 lint、拼写检查或安全扫描夜间批量脚本或定时任务中处理大量文件，配合 --max-turns 和 --max-budget-usd 控制资源多步骤对话脚本：配合 --resume $session_id 将多个 -p 调用串联为连续多轮任务链实用技巧搭配 --bare 可跳过本地 hooks/MCP/CLAUDE.md 加载，加快 CI 启动并保证跨机器结果一致搭配 --output-format json | jq -r '.result' 精准提取响应，彻底避免 regex 解析人类可读文本搭配 --json-schema 强制输出符合特定结构的 JSON，结果在 .structured_output 字段，适合 PR 标注工具搭配 --output-format stream-json --verbose --include-partial-messages 可实时流式接收 token，并通过 system/api_retry 事件感知重试状态allowedTools 使用前缀匹配语法 Bash(git commit *) 精确限定允许的子命令，空格后加 * 才是前缀匹配，否则不生效常见坑不指定 --allowedTools 或 --permission-mode 时，无人值守遇到工具调用会挂起等待确认，导致流水线卡死pipe stdin 超过 10MB 会直接报错退出（v2.1.128+），大内容应改写为文件路径在 prompt 中引用-p 模式下 skill（如 /code-review）和内置 /命令全部不可用，需改为自然语言描述任务来源Run Claude Code programmatically - Claude Code DocsCLI reference - Claude Code DocsHeadless Claude Code — the -p flag, end to endClaude Code: 10 CLI flags you probably aren't using - mager.co最早记录ⓘ≤v0.2.117最近更新v2.1.119变化次数4改进 2修复 2变化时间线(按版本倒序)改进v2.1.119· 2026/04/24 · 2026/04/24现在遵守 agent 的 tools: 和 disallowedTools: frontmatter修复v2.1.83· 2026/03/25 · 2026/03/25修复 claude.ai MCP 连接器在单轮模式下不可用的问题修复v2.1.71· 2026/03/07 · 2026/03/07修复了配置 team agents 时 `--print` 无限 hang 的问题。改进v0.2.117· 2025/05/18 · 2025/05/18--print JSON 输出格式现返回嵌套的消息对象上一个--plugin-url回到命令字典下一个--remote-control