Claude Code 使用手册 · 第 10 章 CLI 与工程化

Claude Code 使用手册 · 第 10 章 CLI 与工程化

章节摘要:本章是 Claude Code 的"驾驶舱"章节。核心命令与标志:从 claude 交互 REPL 到 -p 打印模式、-c 继续、-r 恢复,再到模型选择(--model)、系统提示定制(--system-prompt)、工具权限(--allowedTools/--disallowedTools)、工作区(--add-dir)、会话管理(--fork-session)等标志的完整速查。输出与管道:--output-format text|json|stream-json 三种输出格式、--json-schema 结构化校验、8 个 jq 解析示例,把 Claude Code 变成可编程 API,接入 CI/CD 与脚本流水线。subagents 配置与环境变量:--agents JSON 定义自定义子代理、三级加载优先级、Agent View 多会话管理、关键环境变量分组(认证/禁用开关/预算限额)与故障排查。本章共 3 节。

解剖坐标

一句话主线:掌握"怎么启动"(命令)、"怎么输出"(格式)、"怎么定制"(配置),即可把 Claude Code 嵌入任何自动化流程。

学习目标

阅读完本章,你应当能够:

1. 说出 claude、-p、-c、-r 四种启动方式的分工与适用场景。
2. 说出三类输出格式(text/json/stream-json)的差异,以及 --json-schema 的用法。
3. 用 jq 对 Claude 的 JSON 输出做字段提取、过滤、CSV 转换与条件判断。
4. 说出 --agents JSON 的三个必填/选填字段与三级加载优先级。
5. 说出 5 个以上关键环境变量的作用,并会排查"命令找不到/认证失败/输出格式异常"三类故障。

子章节导航

01 核心命令与标志

启动方式四兄弟(REPL/-p/-c/-r);命令速查表(update/doctor/mcp/plugin/agents/install/purge 等);标志按功能分组:模型与配置、系统提示定制、工具与权限、工作区与目录、会话管理、高级功能;交互模式 vs 打印模式;模型选择与 opusplan 别名;Agent View 速览。

02 输出格式与 jq 管道

三种输出格式对比(text/json/stream-json);--input-format 与 --include-partial-messages;--json-schema 结构化输出;--max-budget-usd 预算上限;8 个 jq 解析示例(字段提取/过滤/CSV/条件/嵌套/统计/变形);三大工程场景:CI/CD 集成(GitHub Actions/Jenkins/ultrareview)、脚本管道(日志/代码/批量处理)、JSON API 集成。

03 subagents 配置、环境变量与故障排查

--agents JSON 格式(description/prompt 必填,tools/model 选填);三级加载优先级(CLI>项目>用户);自定义代理实战;关键环境变量分组速查:认证与模型、功能禁用开关、限额与防护、遥测与调试;settings.json 常用键;故障排查四问(命令找不到/认证失败/会话找不到/JSON 损坏)。

前置知识与后续延伸

前置知识:第 4 章子代理(--agents 是子代理的 CLI 形式)、第 6 章 MCP(--mcp-config 相关标志)、第 9 章权限模式(--permission-mode 与六模式对应)。

后续延伸:本章是全教程收尾——至此已覆盖会话、记忆、命令、子代理、MCP、Hooks、插件、检查点、CLI 全部主题,可回到总纲按"阅读建议"回炉复习。