Claude Code 打印模式 (-p) — 非交互式单任务最佳实践

# 最基本用法
claude -p "你的任务描述"

# 带长选项
claude --print "解释 src/main.py 中的核心逻辑"

# 指定工作目录
claude -p "分析项目结构" --cwd /path/to/project

# 指定模型
claude -p "优化这段代码" --model claude-opus-4-20250514

# 示例 1: 代码解释
claude -p "解释以下代码的功能和潜在问题" \
  --file src/auth.py \
  > explanation.txt

# 示例 2: 代码重构
claude -p "将以下函数重构为异步版本" \
  --file src/data_loader.py \
  --file src/data_processor.py \
  > refactored.py

# 示例 3: 文档生成
claude -p "为以下模块生成 API 文档" \
  --file src/api/routes.py \
  --format markdown \
  > API_DOCS.md

claude -p "列出所有 Python 文件并统计行数" --format text

claude -p "生成 README 文档" --format markdown > README.md

claude -p "分析代码质量" --format json > report.json

claude -p "生成代码审查报告" --format html > report.html

{
  "type": "result",
  "success": true,
  "output": {
    "text": "分析完成...",
    "tool_calls": [
      {
        "tool": "Read",
        "input": { "path": "src/main.py" },
        "output_preview": "import os\n..."
      }
    ]
  },
  "metadata": {
    "model": "claude-sonnet-4-20250514",
    "usage": {
      "input_tokens": 1250,
      "output_tokens": 450,
      "cache_creation_tokens": 0,
      "cache_read_tokens": 0
    },
    "duration_ms": 3200,
    "cost_usd": 0.0042
  }
}

# 使用 jq 提取关键信息
claude -p "分析代码" --format json | jq '.output.text'

# 提取工具调用记录
claude -p "分析代码" --format json | jq '.output.tool_calls[].tool'

# 提取 token 用量
claude -p "分析代码" --format json | jq '.metadata.usage'

# 提取成本信息
claude -p "分析代码" --format json | jq '.metadata.cost_usd'

#!/bin/bash
# batch-review.sh — 批量代码审查

FILES=$(find src/ -name "*.py" -type f)
RESULTS=()

for file in $FILES; do
  echo "🔍 审查: $file"
  result=$(claude -p "审查以下代码的安全性、性能和可读性问题" \
    --file "$file" \
    --format json 2>/dev/null)

  issues=$(echo "$result" | jq -r '.output.text')
  cost=$(echo "$result" | jq '.metadata.cost_usd')

  RESULTS+=("{\"file\": \"$file\", \"issues\": $(echo "$issues" | jq -Rs .), \"cost\": $cost}")
done

# 汇总报告
echo "${RESULTS[@]}" | jq -s '{
  total_files: length,
  total_cost: (map(.cost) | add),
  results: .
}' > review-summary.json

echo "✅ 审查完成! 详见 review-summary.json"

# 管道输入
cat src/main.py | claude -p "这段代码有什么问题？如何改进？"

# 多文件管道
find src/ -name "*.py" -exec cat {} + | claude -p "找出所有潜在的内存泄漏"

# Git diff 管道
git diff HEAD~1 | claude -p "审查这些变更，指出潜在问题"

# 实时写入文件（适用于长时间任务）
claude -p "生成完整的项目文档" --stream > docs.md

# 同时显示和保存
claude -p "分析项目架构" | tee architecture-analysis.md

# 先提取代码，再审查，最后生成报告
git diff --name-only HEAD~1 \
  | xargs -I {} cat {} \
  | claude -p "审查代码变更" \
  | claude -p "将上述审查结果整理为结构化报告，包含：问题分类、严重程度、修复建议" \
  > final-review.md

# 设置超时时间（秒）
claude -p "分析整个项目架构" --timeout 300

# 超时后的行为
# 默认: 返回已生成的内容
# 使用 --strict-timeout: 超时即失败
claude -p "深度分析" --timeout 60 --strict-timeout

#!/bin/bash
# safe-claude.sh — 带错误处理的封装脚本

set -euo pipefail

TIMEOUT=${CLAUDE_TIMEOUT:-120}
RETRIES=${CLAUDE_RETRIES:-3}

run_claude() {
  local prompt="$1"
  local attempt=1

  while [ $attempt -le $RETRIES ]; do
    echo "⏳ 尝试 $attempt/$RETRIES..."

    if claude -p "$prompt" \
      --timeout $TIMEOUT \
      --format json \
      --output "claude-result.json" 2>claude-error.log; then
      echo "✅ 成功"
      return 0
    fi

    echo "❌ 失败，错误信息:"
    cat claude-error.log

    if [ $attempt -lt $RETRIES ]; then
      delay=$((attempt * 5))
      echo "⏱️ 等待 ${delay}s 后重试..."
      sleep $delay
    fi

    attempt=$((attempt + 1))
  done

  echo "💥 所有重试均失败"
  return 1
}

# 使用示例
run_claude "审查 src/ 目录下所有文件的代码质量"

claude -p "执行任务"
exit_code=$?

case $exit_code in
  0) echo "成功" ;;
  2) echo "认证失败，请运行 claude auth login" ;;
  3) echo "超时，请增加 --timeout 参数" ;;
  4) echo "权限被拒绝，检查 dangerously-skip-permissions" ;;
  5) echo "API 限流，请稍后重试" ;;
  *) echo "未知错误: $exit_code" ;;
esac

name: Claude Code Review
on:
  pull_request:
    branches: [main]

jobs:
  code-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Get Changed Files
        id: changes
        run: |
          echo "files=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.sha }} | tr '\n' ',')" >> $GITHUB_OUTPUT

      - name: Run Claude Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "
            作为高级代码审查员，审查以下变更文件:
            ${{ steps.changes.outputs.files }}

            请按以下格式输出:
            1. 🟢 优点
            2. 🔴 问题（按严重程度排序）
            3. 💡 改进建议
            4. 📊 总体评分（1-10）
          " --format json > review.json

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const review = JSON.parse(require('fs').readFileSync('review.json', 'utf8'));
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: review.output.text
            });

# .gitlab-ci.yml
claude-review:
  image: node:20
  stage: review
  variables:
    ANTHROPIC_API_KEY: $ANTHROPIC_API_KEY
  script:
    - npm install -g @anthropic-ai/claude-code
    - |
      claude -p "审查本次 MR 的所有变更" \
        --format json \
        --timeout 180 \
        > review-result.json
    - |
      python3 -c "
      import json
      with open('review-result.json') as f:
        data = json.load(f)
      with open('review.md', 'w') as f:
        f.write(data['output']['text'])
      "
  artifacts:
    paths:
      - review.md
    reports:
      codequality: review-result.json