Claude Code CLI

怎么脚本化

你有没有发现，Claude Code 交互式很好用，但没法融入自动化流程？

两种模式

交互模式（默认）和打印模式（-p）

$ claude
$ claude "解释这个认证流程"

$ claude -p "这个函数做什么？"
$ cat error.log | claude -p "解释错误"

架构概览

CLI 如何连接终端、API 和输出

用户终端 → Claude Code CLI → REPL / 打印 / 恢复 → Claude API → 输出 → 终端|管道

核心标志

控制 CLI 行为的关键参数

扩展标志

初始化、维护与模式控制

命令速查

最常用的 CLI 命令

模型与配置

通过参数控制模型、推理强度、权限和执行方式

# 短名称
$ claude --model sonnet     # Sonnet（日常首选）
$ claude --model opus       # Opus（复杂任务）
$ claude --model haiku      # Haiku（快速任务）

# opusplan 别名：Opus 规划 + Sonnet 执行
$ claude --model opusplan "design and implement caching"

# 给会话命名
$ claude --session feature-auth

# 从 GitHub PR 恢复
$ claude --from-pr 42

# 恢复最近一次会话
$ claude --resume-last

# 强制开启新会话
$ claude --new-session

# 分叉会话做实验
$ claude --fork-session "尝试另一种方案"

# 解锁 auto mode
$ claude --enable-auto-mode

# 通过 CLI 定义 subagent
$ claude --agent reviewer "审查代码"

# 禁用会话保存（敏感任务）
$ claude -p --no-session-persistence "query"

Effort 级别

三种方式控制推理强度

# 级别选项：low / medium / high / max
$ claude --model opus --effort high "设计架构"

# 快速任务用 low
$ claude --model haiku --effort low -p "格式化 JSON"

MCP 配置

通过 CLI 管理外部工具接入

# 加载 GitHub MCP server
$ claude --mcp-config ./configs/github-mcp.json

# 严格模式：只允许指定的 server
$ claude --mcp-config ./configs/strict-mcp.json --mcp github

# 通过环境变量设置默认 MCP 配置
$ CLAUDE_MCP_CONFIG=~/.claude/mcp.json claude

高级参数

Checkpoint、模拟执行和安全控制

# 长任务建议启用 checkpoint
$ claude --enable-auto-checkpoints "重构整个模块"

# 预览执行效果
$ claude --dry-run "删除所有未使用的 import"

# 调试 API 调用
$ claude --verbose -p "diagnose this issue"

Subagents

通过 JSON 定义自定义角色分工

# agents.json 格式
{
  "code-reviewer": {
    "description": "Expert code reviewer",
    "prompt": "Focus on quality, security, best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist",
    "prompt": "Analyze errors, identify root causes.",
    "tools": ["Read", "Edit", "Bash", "Grep"],
    "model": "opus"
  }
}

# 使用方式
$ claude --agents ./configs/agents.json --agent reviewer
$ claude --agents '{"auditor":{"description":"security audit","prompt":"Find vulnerabilities.","tools":["Read","Grep"],"model":"opus"}}'

提示词定制

三种方式自定义 Claude 的行为

# 完整自定义人格
$ claude --system-prompt "你是一名资深安全工程师"

# 追加特定指令
$ claude --append-system-prompt "始终包含单元测试"

# 从文件加载（仅打印模式）
$ claude -p --system-prompt-file ./prompt.txt "review main.py"

输出控制

让 Claude 的输出可以被程序消费

# 纯文本（默认）
$ claude -p "解释这段代码"

# JSON 输出（供程序使用）
$ claude -p --output-format json "列出所有函数"

# 流式 JSON（实时处理）
$ claude -p --output-format stream-json "生成报告"

# Schema 验证的结构化输出
$ claude -p --json-schema '{"type":"object"}' "分析代码"

# 配合 jq 处理
$ claude -p --output-format json "find bugs" | \
  jq '.[] | select(.severity=="high")'

# 流式输入格式
$ claude -p --input-format stream-json

# 提取多个字段
$ claude -p --output-format json "analyze" | \
  jq '{summary, risk, recommendations}'

# 转成 CSV
$ claude -p --output-format json "list files" | \
  jq -r '.files[] | [.name,.size] | @csv'

# 条件处理
$ claude -p --output-format json "check" | \
  jq 'if .ok then "pass" else "fail" end'

# 提取嵌套值
$ claude -p --output-format json "inspect" | \
  jq '.details.metrics.coverage'

# 统计数组长度
$ claude -p --output-format json "find todos" | \
  jq '.todos | length'

# 转换输出结构
$ claude -p --output-format json "review" | \
  jq '{issues: [.issues[]|{file,line,msg}]}'

工具与权限

通过参数精确控制 Claude 能用哪些工具

# 只读安全审计
$ claude --tools "Read,Grep,Glob" -p "审查代码库"

# 允许特定 git 命令无需提示
$ claude --allowedTools "Bash(git status:*)" "Bash(git log:*)"

# 阻止危险操作
$ claude --disallowedTools "Bash(rm -rf:*)" "Bash(git push --force:*)"

# 限制自主操作 + 高级模型
$ claude --permission-mode plan --model opus "设计认证系统"

实战场景

七种最值得掌握的 CLI 用法

$ claude -p --output-format json \
  "run tests and summarize failures"

$ cat error.log | claude -p "解释错误"
$ git log --oneline -20 | claude -p "总结方向"

$ claude --permission-mode plan \
  -p "audit this repository"

$ find src -name "*.ts" | \
  xargs -I{} claude -p "review {}"

$ claude --session feature-auth
$ claude --resume feature-auth
$ claude --fork-session "尝试另一种方案"

$ claude --agents ./agents.json \
  --agent reviewer "审查代码"

$ result=$(claude -p \
  --output-format json "summarize")
$ echo "$result" | jq '.summary'

与项目结构

CLI 的工作目录决定了 Claude 加载哪些配置

project/                   ← 工作目录（--working-directory）
├── CLAUDE.md              [自动加载]
├── .claude/
│   ├── settings.json      [自动加载]
│   ├── skills/            [自动发现]
│   ├── agents/            [自动发现]
│   └── commands/          [自动发现]
└── src/
    └── CLAUDE.md          [按目录加载]

# 多目录协作
$ claude --working-directory ~/projects/app --add-dir ~/projects/shared

# 极简模式（跳过所有扩展）
$ claude --bare "简单提问"

环境变量

通过环境变量设置默认值，适合团队统一配置

# 示例：环境变量配置
$ CLAUDE_MODEL=opus CLAUDE_EFFORT=high claude "设计架构"

快速参考

最常用命令和参数组合模式

# 交互式会话
$ claude

# 快速提问
$ claude -p "explain this repo"

# 继续上次对话
$ claude -c

# 为脚本输出 JSON
$ claude -p --output-format json "list classes"

# 只读审查
$ claude --permission-mode plan -p "review"

# 高级模型 + JSON
$ claude --model opus -p --output-format json \
  "analyze architecture"

# 自定义目录 + MCP
$ claude --working-directory ./backend \
  --mcp-config ./mcp.json

排错指南

动手练习

用 CLI 生成一份结构化的代码审查报告

1. 使用打印模式
2. 输出 JSON 格式
3. 结果保存到文件
4. 限制最大花费 2 美元

参考答案

# 基本命令
$ claude -p --output-format json \
  --max-budget-usd 2.00 \
  "审查 src/ 目录下的所有 Java 文件，找出：
   - 潜在的安全漏洞
   - 代码质量问题
   - 性能风险
   每个问题包含：severity, file, line, description, suggestion" \
  > code-review-report.json

# 配合 jq 提取高危问题
$ cat code-review-report.json | \
  jq '.[] | select(.severity == "high")'

# CI/CD 中使用
$ claude -p --output-format json \
  --permission-mode plan \
  --max-budget-usd 1.00 \
  "审查本次 PR 的改动，返回审查结论" \
  >> pr-review-results.json

课程回顾

十章走完，从入门到工程化

延伸阅读