CI/CD Patterns

Claude Code’u sadece interaktif geliştirme için değil, CI/CD pipeline’larında otomasyon aracı olarak da kullanabilirsiniz. İki temel yaklaşım var: claude -p ile headless mod ve GitHub Actions entegrasyonu.

Headless Mode: claude -p

claude -p (print mode), Claude Code’u non-interactive modda çalıştırır. Hook, LSP ve plugin yüklenmez, stdin’den girdi alır, stdout’a yazar:

# Basit kullanım
claude -p "Bu projedeki tüm TODO'ları listele"

# Pipe ile
cat build-error.txt | claude -p "Bu build hatasının kök nedenini kısaca açıkla" > fix.md

# JSON çıktı (CI/CD için)
claude -p --json "package.json'daki outdated dependency'leri listele"

Kullanım senaryoları:

GitHub Actions Entegrasyonu

Anthropic’in resmi GitHub Action’ı (claude-code-action), Claude Code’u doğrudan CI/CD pipeline’ında çalıştırır. PR’larda @claude ile tetiklenir.

Hızlı Kurulum

# Claude Code terminal'inde:
> /install-github-app

Bu komut GitHub App kurulumunu ve gerekli secret’ları adım adım yönlendirir.

Manuel Kurulum

1. Claude GitHub App‘u repository’ye kurun
2. ANTHROPIC_API_KEY‘i repository secret olarak ekleyin
3. Workflow dosyasını .github/workflows/ altına kopyalayın

Basic Workflow

@claude mention’larına yanıt veren temel workflow:

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: $

Otomatik PR Review

Her PR açıldığında otomatik code review:

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: $
          prompt: "Bu PR'ı kod kalitesi, doğruluk ve güvenlik açısından incele. Diff'i analiz et, bulgularını review comment olarak paylaş."
          claude_args: "--max-turns 5"

Zamanlanmış Rapor

Her gün sabah 9’da commit ve issue özeti:

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: $
          prompt: "Dünkü commit'leri ve açık issue'ları özetle"
          claude_args: "--model opus"

Action Parametreleri

*Bedrock/Vertex kullanımında gerekli değil

claude_args yaygın parametreler:

claude_args: "--max-turns 5 --model claude-sonnet-4-6 --allowedTools Bash,Read,Edit"

@claude Kullanım Örnekleri

Issue veya PR comment’lerinde:

@claude implement this feature based on the issue description
@claude fix the TypeError in the user dashboard component
@claude bu endpoint'e authentication ekle
@claude bu PR'daki güvenlik sorunlarını incele

Cloud Provider Entegrasyonu

AWS Bedrock

steps:
  - uses: aws-actions/configure-aws-credentials@v4
    with:
      role-to-assume: $
      aws-region: us-west-2

  - uses: anthropics/claude-code-action@v1
    with:
      use_bedrock: "true"
      claude_args: "--model us.anthropic.claude-sonnet-4-6 --max-turns 10"

Google Vertex AI

steps:
  - uses: google-github-actions/auth@v2
    id: auth
    with:
      workload_identity_provider: $
      service_account: $

  - uses: anthropics/claude-code-action@v1
    with:
      use_vertex: "true"
      claude_args: "--model claude-sonnet-4@20250514 --max-turns 10"
    env:
      ANTHROPIC_VERTEX_PROJECT_ID: $
      CLOUD_ML_REGION: us-east5

Maliyet Optimizasyonu

CLAUDE.md ile Davranış Özelleştirme

Repository kökündeki CLAUDE.md, GitHub Actions’daki Claude’un davranışını da yönlendirir. Code style, review kriterleri ve proje kurallarını buraya yazın:

# PR Review Kuralları
- Her PR'da test olmalı
- Güvenlik açıkları için OWASP Top 10 kontrol et
- Breaking change varsa BREAKING CHANGE label'ı ekle

Troubleshooting

Kaynaklar:

• Claude Code GitHub Actions Docs
• claude-code-action repo
• Workflow örnekleri