Claude Code -p 无头模式：一个参数让 AI 变成自动化引擎

Claude Code 默认是交互式终端——改个 Bug 聊三轮，审个代码再聊五轮。但加上 -p 参数，整个聊天界面消失，AI 变成一个安静接单的命令行工具。这篇文章基于 Anthropic 官方文档，拆解无头模式的四个核心能力，帮你今晚就把 Claude Code 塞进自动化流水线。

发生了什么

Claude Code 提供了一个 -p（--print）参数，启用后进入无头模式。核心变化只有一个：去掉交互界面，AI 接收一行命令，独立执行，执行完把结果打印到标准输出。

这意味着 Claude Code 可以被当作普通的 CLI 工具使用。你可以把它写进 shell 脚本，放到 CI/CD 流水线里，用 cron 定时触发。Agent 能力、工具链、上下文管理——底层能力完全不变，只是交互方式从「坐在终端前一句一句聊」变成了「发一条命令，等结果回来」。

类比来说：同一家餐厅，菜品和厨师都没换，但开了外卖。你不用坐在店里一道一道点，打个电话说"老三样"，饭就送到家门口。

为什么重要

交互模式下，Claude Code 是一个强大的编程助手，但它被锁在「人坐在终端前」这个前提里。无头模式打破了这个限制，让 AI Agent 能力真正进入工程化场景。

对个人开发者：日常重复任务可以脚本化。每天自动审查新 PR、生成 commit message、跑代码质量检查——这些以前需要你打开终端手动操作的事情，现在一个 cron job 就能搞定。

对团队和基础设施：Claude Code 可以作为 CI/CD 的一个步骤嵌入。代码合并前自动审查、部署后自动验证、告警触发后自动诊断——AI 从「开发者的聊天伙伴」变成「流水线上的一个节点」。

关键在于门槛极低。不需要学新框架，不需要改现有代码。你已经会用命令行，那你已经会用无头模式。

技术细节

无头模式有四个核心能力值得重点掌握。

结构化输出。--output-format 参数支持三种格式：text（纯文本）、json（标准结构化数据）、stream-json（实时流式输出）。选 json 时，返回的是程序可直接解析的标准格式。更进一步，--json-schema 允许你指定输出的数据结构，AI 会严格按你的模板返回。

工具白名单。--allowedTools 让你精确控制 AI 能调用哪些工具。比如只让它执行 git 相关命令：Bash(git commit *) — 注意星号前的空格不能省略，它表示前缀匹配。这样 AI 能执行 git commit -m "..." 但碰不到别的东西。无人值守场景下，这是安全底线。

会话接续。--continue 接着上一次对话继续；--resume 加 session ID 可以回到任意历史会话。上下文不丢失，适合多步骤任务拆分执行。

自定义系统指令。--append-system-prompt 在保留 Claude Code 默认行为的基础上追加自定义规则，比如「所有回复用中文」「只修改 src 目录下的文件」。

一个典型调用：

claude -p "Summarize this project" --output-format json

你现在该做什么

1. 确认环境：确保已安装 Claude Code CLI，终端中能正常运行 claude 命令
2. 跑通第一次调用：claude -p "你的提示词" ，验证无头模式基本可用
3. 试结构化输出：加上 --output-format json，看看返回的 JSON 结构
4. 写第一个自动化脚本：挑一个日常重复任务（PR 审查、代码扫描、日志分析），用 shell 脚本 + -p 实现
5. 锁定权限：用 --allowedTools 限制工具范围，确保脚本在无人值守时也安全运行

无头模式的核心价值不在于新增了什么能力，而在于把已有能力从「手动触发」变成了「可编程调用」。一个 -p 参数，Claude Code 就从聊天工具变成了你脚本里的自动化引擎。

相关阅读：Claude Code 是什么 · AI Agent 概念解析

---

觉得有用？订阅 AI 简报，每天 5 分钟掌握 AI 动态。