无头模式
用 codebuddy -p 在脚本和 CI 中以编程方式运行，多轮对话、文本 / JSON / 流式 JSON 输出与结构化输出。
无头模式让你通过命令行脚本和自动化工具以编程方式运行 CodeBuddy Code，不需要交互界面。主命令是 codebuddy（或 cbc），加 --print（-p）进入非交互模式，可使用所有 CLI 选项。
- 多轮对话：继续最近的对话、按会话 ID 恢复特定对话，非交互模式下也可恢复；
- 输出格式：默认文本；
--output-format json返回带元数据的结构化数据；stream-json在收到每条消息时流式输出；用异步的后台任务事件（task_started、task_progress、task_updated、task_notification）追踪后台命令、工作流和子代理； - 结构化输出：
--output-format json配合--json-schema得到符合指定 JSON Schema 的输出，再用jq提取； - 输入格式：默认文本（参数或 stdin）；流式 JSON 输入通过 stdin 提供消息流，每条消息代表一个用户轮次，可在不重启进程的情况下持续对话（含图片）；
- 会话回退：
--print家族启动时可用命令行 flag 把文件回退到某条用户消息之前的状态并退出，也可仅预览不改磁盘。
非交互下遇到项目级 MCP 服务器的审批无法弹框，需要提前允许所有或特定的项目 MCP 服务器（见 MCP 一节）；权限用 --permission-mode（如 dontAsk、auto）控制。另有 Python 和 TypeScript SDK、HTTP API（Beta）、Daemon 模式、定时任务与 Goal 等自动化能力，见官方对应页面。