Claude Code 的非交互模式一条命令当 grep 用有没有过这种感觉只是想问 Claude 一个简单问题结果它启动了全屏 TUI加载项目、读 CLAUDE.md、注入记忆……一套流程走完30 秒过去了。其实 Claude Code 还有另一个使用方法Headless 模式。一行命令直接出结果不走交互界面。5 秒体验打开终端敲claude-p用一句话解释什么是正则表达式看到回复直接打印在终端里——这就是 Headless 模式。没有全屏界面没有弹窗确认像grep或curl一样干净。再来一条有实际作用的claude-p统计当前目录下一共有多少个文件只回复数字--allowed-toolsBashClaude 自动执行ls | wc -l结果直接输出。终端里的两类程序类型特征例子CLI 工具执行 → 输出 → 结束ls、git、grepTUI 程序占全屏有光标/面板交互vim、htop、Claude CodeHeadless 模式让 Claude Code 退回到第一类。有什么区别——可以把它放进脚本里了。交互模式 vs Headless 模式交互claudeHeadlessclaude -p启动进入全屏 TUI瞬间返回结果对话多轮来回一问一答权限弹窗逐条确认用--allowed-tools白名单输出TUI 内渲染stdout 纯文本适合开发、调试、探索脚本、定时任务、CI/CD-p是--print的缩写核心意思就一个算完打印退出。四个必知参数--allowed-tools— 安全白名单Headless 没有弹窗让你确认工具调用所以必须预先声明claude-p搜索今天 AI 新闻--allowed-toolsWebSearch,WebFetchclaude-p审查代码--allowed-toolsRead,Bash只给任务需要的最小权限。--modelclaude-p统计 .ts 文件数量--modelhaiku --allowed-toolsBashclaude-p审查全部代码变更--modelopus --allowed-toolsRead,Bash简单分类/搜索 → haiku复杂分析/生成 → sonnet/opus。--max-turns— 别让它放飞claude-p搜新闻整理摘要--allowed-toolsWebSearch--max-turns3不加限制的话Headless 模式可能搜 → 读 → 分析 → 再搜好几轮下去。--max-turns 1适合单次查询。--continue— 接上回的话# 第一轮claude-p搜索 Claude Code Hooks 的 3 篇最佳实践--allowed-toolsWebSearch# 第二轮接着上一轮的上下文问claude-p把第三篇展开写 300 字摘要--continue--allowed-toolsWebFetch--continue加载你最近一次会话的完整对话历史——不只是 Headless交互模式也算。指定工作目录Claude Code 没有--cwd参数用cd 模式cd~/my-projectclaude-p运行 npx tsc --noEmit--allowed-toolsBash脚本里推荐用子 shell避免cd影响后续命令(cd ~/my-projectclaude-p运行 npx tsc --noEmit--allowed-toolsBash)退出码 ≠ 任务结果claude -p的退出码只表示 Claude Code进程本身是否正常退出不是你交给它的任务是否成功0→ 进程正常退出非0→ API 错误、网络超时、崩溃比如编译有 10 个错误Claude 正常分析并报告有 10 个错误退出码仍然是0。判断任务结果要解析输出内容——这是下一篇的内容。跑通三条# 1. 最简单的调用claude-p用一句话解释什么是 TypeScript--modelhaiku# 2. 让它读文件claude-p读取 package.json统计有多少个依赖包--allowed-toolsRead# 3. 管道喂数据ls~/your-project/src/|claude-p分析这个目录结构--allowed-toolsRead--modelhaiku三条都跑通你的 Headless 就入门了。