자동화, CI/CD, 비대화형 활용법

대화형 도구를 파이프라인의 한 단계로 확장해

-p, --allowedTools, --output-format json을 함께 쓰면 Claude Code는 사람이 지켜보는 터미널 도구를 넘어 자동화 파이프라인의 한 단계가 돼. CI에서 PR을 검토하고, 밤마다 release notes를 만들고, 오류를 먼저 분류할 수 있어.

실전에서는 실패하는 테스트를 먼저 만들고 구현과 리팩터링을 잇는 TDD 흐름, git diff main...HEAD | claude -p로 하는 변경 검토, JSON 결과를 jq로 읽어 다음 단계를 결정하는 방식이 자주 쓰여. 자동화에서는 Claude가 쓸 수 있는 도구를 필요한 만큼만 미리 허용해야 해.

일반적인 PR 자동화는 anthropics/claude-code-action@v1으로 시작할 수 있어. 정형화된 경우를 벗어나면 같은 기본 단위를 셸과 CI에서 직접 조합해. 핵심은 자유 텍스트를 억지로 파싱하지 않고 구조화 결과와 최소 권한으로 연결하는 거야.

직접 확인할 항목: @claude.

Code

셸에서 비대화형 검토 실행하기·bash

#!/bin/bash
# scripts/ai-review.sh
set -euo pipefail

DIFF=$(git diff origin/main...HEAD)
[ -z "$DIFF" ] && { echo "no changes"; exit 0; }

REVIEW=$(echo "$DIFF" | claude -p \
  "Review this diff. Format: [SEVERITY: HIGH|MEDIUM|LOW] desc (file:line)" \
  --output-format text \
  --allowedTools "Read,Bash(git log *)")

echo "$REVIEW" > "review-$(date +%Y%m%d-%H%M%S).md"
echo "$REVIEW"

# Gate the pipeline
if echo "$REVIEW" | grep -q "SEVERITY: HIGH"; then
  echo "high-severity findings, blocking"
  exit 1
fi

GitHub Action으로 PR 검토하기·yaml

# .github/workflows/claude-review.yml
name: Claude PR Review
on:
  pull_request:
    types: [opened, synchronize]

permissions:
  contents: read
  pull-requests: write

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }

      - uses: actions/setup-node@v4
        with: { node-version: '22' }

      - run: npm install -g @anthropic-ai/claude-code

      - name: Run Claude review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          git diff origin/main...HEAD | claude -p \
            "Review for bugs, security, missing tests. Markdown output." \
            --output-format text \
            --allowedTools "Read,Bash(git log *),Bash(git show *)" \
            > review.md

      - uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: '## Claude Code Review\n\n' + review
            });

대화형 도구를 파이프라인의 한 단계로 확장해

Code

External links

Exercise

Progress

댓글 0