非交互模式：-p、--continue、--resume 与程序调用

交互式会话适合需要来回澄清的复杂工作；非交互模式（headless）则适合一次性查询、脚本调用、流水线集成与批量任务。本节讲清调用方式、输出格式、权限参数与会话恢复，避免在无人值守场景误用交互逻辑。

一、基本调用：claude -p

# 一次性纯文本查询
claude -p "说明这个项目的主要职责"

# 结构化 JSON 输出，便于程序解析
claude -p "列出所有对外接口" --output-format json

# 逐行流式 JSON 事件
claude -p "分析这份日志" --output-format stream-json --verbose

• -p（等同 --print）以非交互方式运行：不进入提示循环，执行完毕即输出并结束。
• 运行默认仍会生成一个可恢复会话；若不需要持久化历史，可加 --no-session-persistence 关闭会话落盘。
• 输入可来自标准输入、结果写到标准输出，因此能与 shell 管道串联；错误与诊断信息按各自通道呈现，便于脚本区分。

二、三种输出格式对比

格式	形态	适用场景
默认纯文本	结果直接输出到 stdout	人工查看、简单文本管道、说明性任务
--output-format json	单个 JSON 对象，结果在 result 字段	脚本读取、下游程序消费、需要结构化判定
--output-format stream-json --verbose	每行一个 JSON 事件，init 事件开头	实时处理、长任务进度观测、流式流水线

三、无人值守下的权限参数

参数	行为	建议用途
--permission-mode plan	以计划方式只读调研，不落改动	自动收集方案、影响分析、代码库扫描
--permission-mode dontAsk	拒绝一切需要交互批准的动作	无人值守批处理，遇到越界动作即收敛，而非卡住等待
--permission-mode auto	由安全分类模型预审常规动作、拦截高风险动作	授权清晰、常规类型的自动执行
--allowedTools	预先批准明确工具集合，例如 Edit,Bash(git commit *)	把可执行范围收窄到任务必需，其余不开放

四、会话恢复：--continue 与 --resume

• 交互会话可用 /rename 给工作流命名，便于追溯；会话按项目本地保存。
• claude --continue 直接接续最近一次会话；claude --resume 列出历史会话供选择。适合跨多次落座完成同一主题。
• headless 单次任务追求无状态、可重放；需要延续上下文的长期工作流，优先命名并恢复显式会话，而不是在一次性命令里堆叠过多历史。

五、何时不用 headless

• 需求不明确、需要多轮追问澄清时：先在交互模式定方案，再把确定后的步骤交给 headless 执行。
• 依赖视觉/人工界面确认的改动：headless 结果仍需真实构建、测试或人工验收兜底。
• 缺少稳定验收命令的任务：无人值守无法自行判定对错，应先建立可运行检查（测试、构建、退出码）再自动化。