GitHub Actions - Claude Code Integration

claude-code-action Nedir?

anthropics/claude-code-action@v1 GitHub Actions action'i. PR'lari otomatik review eder, issue'lardan otomatik fix olusturur. vibecosystem ile entegre calisir.

Kaynak: https://github.com/anthropics/claude-code-action

Kurulum

1. Secret Ayarlama

Repository Settings > Secrets and variables > Actions > New repository secret:

Name: ANTHROPIC_API_KEY
Value: sk-ant-... (Anthropic API key)

2. PR Review Workflow

Dosya: .github/workflows/claude-review.yml

yaml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize, reopened]

permissions:
  contents: read
  pull-requests: write
  issues: write

jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          review_comment_prefix: "vibecosystem-review"
          direct_prompt: |
            Review this PR for:
            1. Code quality and patterns
            2. Security vulnerabilities (OWASP Top 10)
            3. Performance issues
            4. Test coverage gaps
            5. Breaking changes

            Use vibecosystem's code-reviewer agent standards.
            Provide VERDICT: PASS | WARN | FAIL

Ne yapar: PR acildiginda, guncellediginde veya yeniden acildiginda otomatik review yapar. Review sonucunu PR comment olarak yazar.

3. Issue-to-Fix Workflow

Dosya: .github/workflows/claude-fix.yml

yaml
name: Claude Code Fix
on:
  issues:
    types: [labeled]

permissions:
  contents: write
  pull-requests: write
  issues: write

jobs:
  claude-fix:
    if: contains(github.event.label.name, 'claude-fix')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Code Fix
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Fix the issue described below.
            Follow TDD workflow: write test first, then implement fix.
            Create a PR with the fix.

            Issue: ${{ github.event.issue.title }}
            Body: ${{ github.event.issue.body }}

Ne yapar: Issue'ya claude-fix label'i eklendiginde otomatik fix olusturur ve PR acar.

Kullanim

PR Review

1. PR ac - otomatik review baslar
2. Review comment'inde VERDICT gorursun: PASS, WARN veya FAIL
3. FAIL varsa issue'lari duzelt, PR'i guncelle - tekrar review olur

Issue Fix

1. Issue ac, sorunu detayli yaz
2. claude-fix label'i ekle
3. Claude otomatik branch olusturur, fix yapar, PR acar
4. PR'i review et ve merge et

Workflow Customization

Review Scope Daraltma

Sadece belirli dosya tiplerini review et:

yaml
on:
  pull_request:
    types: [opened, synchronize, reopened]
    paths:
      - '**.ts'
      - '**.tsx'
      - '**.js'
      - '**.jsx'

Custom Review Prompt

vibecosystem agent standartlarina gore prompt'u genislet:

yaml
direct_prompt: |
  Review this PR using vibecosystem standards:

  ## Code Quality
  - Immutability: no mutations, use spread operator
  - File size: max 800 lines per file
  - Function size: max 50 lines
  - Nesting: max 4 levels
  - No console.log in production code
  - No hardcoded values

  ## Security (OWASP Top 10)
  - Input validation (use zod)
  - SQL injection prevention
  - XSS prevention
  - No hardcoded credentials
  - Rate limiting check

  ## Testing
  - Test coverage >= 80%
  - Edge cases covered
  - Error paths tested

  VERDICT: PASS | WARN | FAIL

Fix Workflow Ek Talimatlar

yaml
direct_prompt: |
  Fix the issue below.
  Rules:
  - TDD: write failing test first, then implement
  - Defensive code: try/catch, null checks, input validation
  - No mutations, use immutable patterns
  - Follow repository's existing code style
  - Run tests before creating PR

  Issue: ${{ github.event.issue.title }}
  Body: ${{ github.event.issue.body }}

Multiple Label Support

Farkli label'lar icin farkli davranislar:

yaml
jobs:
  claude-fix:
    if: contains(github.event.label.name, 'claude-fix')
    # ... standard fix

  claude-refactor:
    if: contains(github.event.label.name, 'claude-refactor')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Refactor the code described in this issue.
            Maintain all existing tests.
            Do not change external behavior.
            Issue: ${{ github.event.issue.title }}
            Body: ${{ github.event.issue.body }}

vibecosystem Entegrasyonu

CLAUDE.md ile Birlikte

Repository'de CLAUDE.md varsa claude-code-action onu otomatik okur. vibecosystem kurallarini CLAUDE.md'ye ekle:

markdown
# Project Rules
- Follow vibecosystem coding standards
- Use TDD workflow for all changes
- Security review required for auth/data code
- VERDICT format: PASS | WARN | FAIL

Agent Standarti

Review workflow'u vibecosystem'in code-reviewer agent standartlarini kullanir:

• Kod kalitesi (immutability, dosya boyutu, fonksiyon boyutu)
• Security (OWASP Top 10)
• Performance
• Test coverage
• Breaking changes

Fix workflow'u TDD workflow'unu kullanir:

• Onceki test yaz (RED)
• Fix implement et (GREEN)
• Refactor (IMPROVE)

Troubleshooting

| Sorun | Cozum | |-------|-------| | Review calismadi | ANTHROPIC_API_KEY secret ayarli mi? | | Permission hatasi | Workflow permissions blogu dogru mu? | | Fix PR acilmadi | claude-fix label dogru yazildi mi? | | Review cok uzun suruyor | fetch-depth: 1 ile sadece son commit'i al | | Rate limit | API key plan limitini kontrol et |