无头模式与 Agent SDK
Claude Code 不只是交互式的。你可以无头运行它（非交互、可脚本化），还可以用 Agent SDK 在同一套底层底座上构建你自己的智能体。
无头模式
非交互地运行单条提示并捕获输出——非常适合脚本、提交前钩子和 CI：
claude -p "Review the staged diff and list any bugs as a Markdown checklist"
把输入用管道传入，把结果取出。配合设置为安全、非交互姿态的权限，使它永不挂起等待批准——并且锁紧它，让自动化运行无法触碰密钥（见加固自主运行）。
一个经典用法：一个让 Claude 审查每个拉取请求的 CI 作业——见 PR 审查实战演练。
Agent SDK
Claude Agent SDK（Python 和 TypeScript）让你在驱动 Claude Code 的同一个循环之上构建生产级智能体——工具使用、文件/shell 访问、权限、上下文管理——只不过接入到了你自己的应用里。
当你已经超出了单次 API 调用或手写循环的承载力，想要一个开箱即用的智能体运行时时，就该用它。关于各种选项的谱系——单次调用 → 工作流 → 自定义智能体 → 受管——见在 API 上构建智能体。
无头/SDK vs 交互式
| 模式 | 适用于 |
|---|---|
| 交互式 Claude Code | 有人参与回路的日常开发 |
无头（claude -p） | 脚本、提交前、CI 一次性任务 |
| Agent SDK | 嵌入到你软件中的生产级智能体 |