Claude Code CI/CD 集成完全指南：从本地开发到自动化流水线的 AI 协作之道

# 分析一个文件
claude -p "分析 src/utils.ts 的代码质量，指出潜在问题"
 
# 管道输入
cat src/utils.ts | claude -p "审查这段代码"
 
# 分析 git diff
git diff main | claude -p "审查这些变更，指出潜在问题"

claude -p --output-format json "分析 src/utils.ts 的代码质量"

{
  "result": "分析结果文本...",
  "is_error": false,
  "total_cost_usd": 0.023,
  "session_id": "abc123"
}

# 只读模式：只允许读取和搜索，不能修改任何文件
claude -p --allowedTools "Read,Grep,Glob" "审查 src/ 目录下的所有 API 端点安全性"

# .github/workflows/claude-review.yml
name: Claude Code Review
 
on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            审查这个 PR 的代码变更。关注：
            1. 潜在的 bug 和逻辑错误
            2. 安全漏洞
            3. 性能问题
            4. 代码风格一致性
            请用中文回复。

name: Claude Code Review
 
on:
  pull_request:
    types: [opened, synchronize]
    paths:
      - 'src/**'
      - 'lib/**'
      - 'app/**'
 
jobs:
  review:
    runs-on: ubuntu-latest
    # 跳过 draft PR 和 bot 创建的 PR
    if: |
      github.event.pull_request.draft == false &&
      github.event.pull_request.user.login != 'dependabot[bot]'
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          model: claude-sonnet-4-6
          max_turns: 10
          prompt: |
            你是一个严格但友好的代码审查者。请审查这个 PR 的所有变更。
 
            审查重点：
            1. **正确性**：逻辑错误、边界条件、空值处理
            2. **安全性**：注入漏洞、敏感信息泄露、权限问题
            3. **性能**：不必要的循环、内存泄漏、N+1 查询
            4. **可维护性**：命名清晰度、函数复杂度、重复代码
 
            输出格式：
            - 🔴 必须修复：阻塞性问题
            - 🟡 建议修改：改进建议
            - 🟢 做得好：值得肯定的地方
 
            如果没有发现问题，直接说"LGTM"即可，不要硬凑问题。

name: Claude Auto Fix
 
on:
  issue_comment:
    types: [created]
 
jobs:
  auto-fix:
    # 只在 PR 评论中触发，且评论包含 /claude-fix
    if: |
      github.event.issue.pull_request &&
      contains(github.event.comment.body, '/claude-fix')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.issue.pull_request.head.ref }}
          fetch-depth: 0
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          max_turns: 20
          allowed_tools: "Read,Grep,Glob,Edit,Write,Bash"
          prompt: |
            根据这个 PR 的审查评论，修复所有提到的问题。
            修复后，用 git 提交变更。
            提交信息格式：fix: <修复内容的简要描述>

name: Claude Issue to PR
 
on:
  issues:
    types: [labeled]
 
jobs:
  implement:
    # 只在添加 "claude" 标签时触发
    if: github.event.label.name == 'claude'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          max_turns: 30
          prompt: |
            阅读 Issue #${{ github.event.issue.number }} 的内容。
            根据 Issue 描述：
            1. 创建一个新分支：claude/issue-${{ github.event.issue.number }}
            2. 实现 Issue 中描述的功能或修复
            3. 确保代码通过 lint 和测试
            4. 创建一个 PR，标题引用 Issue 编号
            5. 在 PR 描述中说明实现方案
 
            遵循项目的 CLAUDE.md 中的编码规范。

# .gitlab-ci.yml
claude-review:
  stage: review
  image: node:20
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  before_script:
    - npm install -g @anthropic-ai/claude-code
  script:
    - |
      git diff origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME...HEAD > /tmp/diff.txt
      REVIEW=$(claude -p --output-format text --max-turns 10 \
        --allowedTools "Read,Grep,Glob" \
        "审查以下代码变更，指出潜在问题：$(cat /tmp/diff.txt)")
      echo "$REVIEW"
      # 将审查结果发布为 MR 评论
      curl --request POST \
        --header "PRIVATE-TOKEN: ${GITLAB_TOKEN}" \
        --header "Content-Type: application/json" \
        --data "{\"body\": \"## Claude Code Review\n\n${REVIEW}\"}" \
        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/merge_requests/${CI_MERGE_REQUEST_IID}/notes"
  variables:
    ANTHROPIC_API_KEY: $ANTHROPIC_API_KEY

#!/bin/bash
# scripts/claude-review.sh
 
set -euo pipefail
 
# 1. 获取变更
DIFF=$(git diff origin/main...HEAD)
 
if [ -z "$DIFF" ]; then
  echo "没有代码变更，跳过审查"
  exit 0
fi
 
# 2. Claude Code 审查
REVIEW=$(echo "$DIFF" | claude -p \
  --output-format text \
  --max-turns 10 \
  --allowedTools "Read,Grep,Glob" \
  "审查这些代码变更。关注 bug、安全漏洞和性能问题。如果没有问题，回复 LGTM。")
 
# 3. 输出结果
echo "$REVIEW"
 
# 4. 检查是否有阻塞性问题（可选）
if echo "$REVIEW" | grep -q "🔴"; then
  echo "::error::Claude Code 发现了阻塞性问题"
  exit 1
fi

# Jenkins, CircleCI, Azure DevOps, etc.
- run: bash scripts/claude-review.sh
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

# .claude/Dockerfile
FROM node:20-slim
RUN npm install -g @anthropic-ai/claude-code
ENTRYPOINT ["claude"]

# 在 CI 中使用
steps:
  - run: |
      docker build -t claude-code -f .claude/Dockerfile .
      git diff main | docker run -i \
        -e ANTHROPIC_API_KEY=${{ secrets.ANTHROPIC_API_KEY }} \
        claude-code -p --max-turns 10 "审查这些变更"

# 只读审查（最安全）
- uses: anthropics/claude-code-action@v1
  with:
    allowed_tools: "Read,Grep,Glob"
    prompt: "审查代码变更"
 
# 可修复（需要写权限）
- uses: anthropics/claude-code-action@v1
  with:
    allowed_tools: "Read,Grep,Glob,Edit,Write"
    disallowed_tools: "Bash"
    prompt: "修复 lint 错误"
 
# 完整权限（谨慎使用）
- uses: anthropics/claude-code-action@v1
  with:
    disallowed_tools: "WebFetch,WebSearch"
    prompt: "实现这个功能"

# 不要直接拼接用户输入到 prompt
# ❌ 危险
prompt: "审查这个 PR：${{ github.event.pull_request.title }}"
 
# ✅ 安全：让 Claude Code 自己读取 PR 信息
prompt: "审查当前 PR 的代码变更，关注安全和正确性"

# 根据任务选择模型
- uses: anthropics/claude-code-action@v1
  with:
    model: claude-sonnet-4-6  # Code Review 用 Sonnet
    max_turns: 10
 
# 简单任务用 Haiku
- uses: anthropics/claude-code-action@v1
  with:
    model: claude-haiku-4-5
    max_turns: 5

on:
  pull_request:
    types: [opened, synchronize]
    paths:
      # 只审查源代码变更，忽略文档、配置等
      - 'src/**'
      - 'lib/**'
      - 'app/**'
      - '!**/*.md'
      - '!**/*.mdx'
 
jobs:
  review:
    # 跳过 draft PR
    if: github.event.pull_request.draft == false
    # 跳过 bot PR
    if: github.event.pull_request.user.login != 'dependabot[bot]'

# 使用 JSON 输出获取成本信息
- name: Claude Review
  id: review
  run: |
    RESULT=$(claude -p --output-format json --max-turns 10 "审查代码变更")
    COST=$(echo "$RESULT" | jq -r '.total_cost_usd')
    echo "cost=$COST" >> $GITHUB_OUTPUT
    echo "Claude Code 审查成本: \$$COST"
 
# 可以设置成本告警
- name: Cost Alert
  if: steps.review.outputs.cost > 1.0
  run: echo "::warning::Claude Code 单次审查成本超过 $1.0"

# CLAUDE.md
 
## CI/CD 规则
 
当在 CI 环境中运行时（检测到 CI=true 环境变量）：
 
### Code Review
- 只关注本次 PR 变更的文件，不要审查未修改的代码
- 审查结果分三级：🔴 必须修复、🟡 建议修改、🟢 做得好
- 如果没有问题，直接回复 "LGTM"，不要硬凑问题
- 不要建议重构未修改的代码
 
### 自动修复
- 只修复明确的问题（lint 错误、类型错误），不要顺便重构
- 每次修复后运行相关测试确认没有破坏
- 提交信息格式：fix: <简要描述>
 
### 安全
- 不要在输出中包含任何环境变量的值
- 不要读取 .env 文件
- 不要执行网络请求

# .github/workflows/claude-pr-pipeline.yml
name: Claude PR Pipeline
 
on:
  pull_request:
    types: [opened, synchronize]
    paths:
      - 'src/**'
      - 'lib/**'
      - 'app/**'
  issue_comment:
    types: [created]
 
jobs:
  # Job 1: 自动审查
  review:
    if: |
      github.event_name == 'pull_request' &&
      github.event.pull_request.draft == false
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          model: claude-sonnet-4-6
          max_turns: 10
          allowed_tools: "Read,Grep,Glob"
          timeout_minutes: 10
          prompt: |
            审查这个 PR 的代码变更。
 
            审查重点：
            1. 正确性：逻辑错误、边界条件、空值处理
            2. 安全性：注入漏洞、敏感信息泄露
            3. 性能：不必要的循环、内存泄漏
            4. 可维护性：命名、复杂度、重复代码
 
            输出格式：
            - 🔴 必须修复（附具体文件和行号）
            - 🟡 建议修改
            - 🟢 做得好
 
            没有问题就说 LGTM。
 
  # Job 2: 自动修复（评论触发）
  auto-fix:
    if: |
      github.event_name == 'issue_comment' &&
      github.event.issue.pull_request &&
      contains(github.event.comment.body, '/claude-fix')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.issue.pull_request.head.ref }}
          fetch-depth: 0
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          model: claude-sonnet-4-6
          max_turns: 20
          allowed_tools: "Read,Grep,Glob,Edit,Write,Bash"
          disallowed_tools: "WebFetch,WebSearch"
          prompt: |
            阅读这个 PR 的所有审查评论，修复提到的问题。
            修复后：
            1. 运行 lint 确认通过
            2. 运行测试确认没有破坏
            3. 提交变更，信息格式：fix: <描述>