Anla Dene

Claude · Gelişmiş · 203 Ölçekle ve otomatikleştir · Konu 4 / 7

4.8 GitHub Actions ve Code Review

Tekrar eden işi, inceleme ve iş akışı yapılan yere, pull request'e taşı.

Bu sayfada ne öğreneceksin

Kısaca

Pull request (PR), incelemenin yapıldığı, değişikliklerin indiği ve tekrarlayan işin çoğunun biriktiği yerdir. Kurs, Claude'u burada çalıştırmanın iki yolu olduğunu söylüyor ve ikisinin farklı sorunları çözdüğünü vurguluyor. Birincisi açtığın yönetilen bir hizmet: Code Review. İkincisi kendin kurduğun bir GitHub Action.

Bu sayfa 3.9 Kod incelemesi sayfasının devamıdır. Orada yerel /code-review komutunu ve Code Review hizmetinin kısa tanıtımını gördün; burada hizmetin nasıl açıldığını, nasıl okunduğunu ve Action ile farkını görürsün.

Yönetilen yol: Code Review

Code Review, Claude GitHub uygulaması üzerinden pull request'lerini inceleyen, Anthropic'in barındırdığı bir hizmettir. Senin kuracağın ya da barındıracağın bir şey yoktur. Dokümana göre birden çok ajan her değişikliği çevresindeki kodla birlikte okur ve mantık hatası, güvenlik açığı ya da bozuk uç durumlar arar; bir doğrulama adımı bulguları raporlamadan önce kodla karşılaştırır. Bulgular ilgili satırlarda satır içi yorum olarak, önem derecesine göre sıralı gelir; ayrıca bir özet ve bir kontrol çalıştırması (check run) bırakılır. Kurs bulguların yinelenenlerinin ayıklandığını ve sıralandığını söylüyor: tek tek ufak şikâyet duvarı yerine ilgilenmeye değer birkaç gerçek sorun okursun.

Kim kullanabilir?

Doküman Code Review'ın Team ve Enterprise planları için olduğunu yazıyor. Kod barındıran yer olarak GitHub'ı destekliyor (GitHub Enterprise Server ve veri yerleşimli GitHub Enterprise Cloud dahil). Doküman ayrıca, Zero Data Retention etkin olan ya da HIPAA yapılandırması uygulanmış kuruluşlar için hizmetin kullanılamadığını yazıyor. Planın bu hizmeti içermiyorsa aynı işi /code-review ile kendi oturumunda, her planda yapabilirsin.

Kim açar, nasıl kurulur?

Kurs ve doküman aynı şeyi söylüyor: Claude kuruluşunun bir Owner'ı açar. Yol: claude.ai'da Admin settings > Claude Code (Yönetici ayarları > Claude Code) içindeki Code review bölümünde Allow code review anahtarı. Sonrasında:

Kurulumu doğrulamak için taslak olmayan bir test PR'ı aç: dokümana göre birkaç dakika içinde Claude Code Review adlı bir kontrol çalıştırması görünür.

Bulguları okumak

Her bulgu satır içi bir yorum olarak gelir ve üç önem düzeyinden biriyle işaretlenir:

İşaretDüzeyAnlamı
🔴ImportantBirleştirmeden önce düzeltilmesi gereken bir hata
🟡NitKüçük bir sorun; düzeltmeye değer ama engelleyici değil
🟣Pre-existingKod tabanında zaten var olan, bu PR'ın getirmediği bir hata

Bir bulguyu kapatmanın yolları (dokümana göre): kodu düzeltip push etmek (sonraki inceleme eski yorumu çözülmüş sayabilir), yorumun konuşma dizisini (thread) GitHub'da kendin çözmek (yalnız yanıt yazmak bulguyu kapatmaz) ya da yanıtla itiraz etmek (bir sonraki inceleme yanıtları okur). Aynı tür bulgu sürekli geliyorsa, bir bakımcıdan REVIEW.md dosyasına bir kural eklemesini iste.

Ne yapar, ne yapmaz?

Neyi işaretleyeceğini ayarla: REVIEW.md

Kök dizindeki REVIEW.md serbest biçimli bir Markdown dosyasıdır ve yalnız PR incelemesine özel kuralları taşır: neyin hangi önem düzeyinde işaretleneceği, nelerin atlanacağı. Genel proje kuralları ise CLAUDE.md'ye girer. Dokümana göre Code Review ikisini de okur; yerel /code-review komutu ise CLAUDE.md'yi okur, REVIEW.md'yi okumaz. Güvenlik açısından önemli: REVIEW.md PR'ın kendi değişikliklerinden değil, PR'ın taban ya da varsayılan dalından okunur. Yani bir PR kendi inceleme kurallarını gevşetemez; kural değişikliğini önce birleştirmen gerekir. Doküman varsayılan dalını korumanı öneriyor.

Kurgusal bir REVIEW.md örneği (dokümandaki yapıya benzer, kendi projene göre değiştir):

# Review instructions

## What Important means here

Reserve Important for findings that would break behavior, leak data,
or block a rollback. Style and naming suggestions are Nit at most.

## Do not report

- Anything CI already enforces: lint, formatting, type errors
- Generated files and any *.lock file

## Always check

- New API routes have an integration test
- Log lines don't include email addresses or request bodies

Kendin kur: GitHub Action

İş incelemenin ötesine geçtiğinde GitHub Action'a başvurursun: bir yorumdan değişiklik uygulamak, zamanlanmış rapor çalıştırmak, normalde bir workflow yazacağın her şey. Dokümana göre claude-code-action, Claude Code'u deponun workflow'ları içinde çalıştırır. Bir PR ya da issue yorumunda @claude yazarsan Claude kodu çözümler, değişiklik uygular ve commit push eder. Ayrıca herhangi bir GitHub olayında otomatik çalışacak bir prompt da verebilirsin. Kurs Action'ın PR yorumlarında, zamanlanmış işlerde ve her GitHub olayında ajan çalıştırdığını söylüyor.

Kurulum yolu

İki yol var ve ikisi için de depoda yönetici (admin) erişimi gerekir:

claude

Claude Code açıldıktan sonra istemde şunu yaz:

/install-github-app

Kimlik doğrulama için iki sır adı vardır: Claude Console'dan alınan API anahtarı için ANTHROPIC_API_KEY ve Claude aboneliğinle kimlik doğrulayan OAuth token'ı için CLAUDE_CODE_OAUTH_TOKEN (Pro, Max, Ultra, Team ve Enterprise planlarında; yerelde claude setup-token ile üretilir). Workflow'da API anahtarı anthropic_api_key girdisine, OAuth token'ı claude_code_oauth_token girdisine verilir. Kurs ayrıca Console'da bir hizmet hesabı üzerinden iş yükü kimlik federasyonuyla (workload identity federation) kimlik doğrulanabildiğini söylüyor; bu yolda saklanan bir sır olmaz.

Workflow: @claude'a yanıt veren

Aşağıdaki workflow dokümandaki örneğe uygundur. Dosya adı örnek olarak .github/workflows/claude.yaml; içindeki depo ve sır adları kurgusaldır, gerçek bir sır değeri yoktur:

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Kalıp olmayan kısımlar (dokümana göre): id-token: write Action'ın varsayılan GitHub uygulaması kimlik doğrulaması için gereklidir. actions: read Claude'un PR'lardaki CI sonuçlarını okumasını sağlar. actions/checkout Claude'a çalışacağı yerel bir kopya verir. if satırı, @claude geçmeyen yorumlarda çalıştırıcıların boşuna başlamasını önler.

Workflow yerinde olunca bir issue ya da PR yorumunda Claude'u çağırırsın. Claude aynı issue ya da PR'a yorumla yanıt verir ve çalışırken yorumunu günceller:

@claude implement this feature based on the issue description
@claude fix the TypeError in the user dashboard component

Dokümana göre prompt girdisi vermezsen Action etkileşimli çalışır: tetikleyici ifadeyi (@claude varsayılandır) bekler. prompt verirsen otomasyon moduna geçer ve bir mention beklemeden olayda çalışır. Hangisini istediğin, workflow'un prompt satırının olup olmamasından anlaşılır; eski sürümlerdeki mode girdisine gerek kalmamıştır.

Workflow: zamanlanmış

Aynı Action günlük bir özet için de çalışır: bir cron tetikleyicisi her gün dokuz UTC'de çalıştırır ve Claude sonucu yayınlar. Dokümana göre düz metin bir prompt'ta Claude'un kabuğu ve GitHub API erişimi yoktur; ihtiyacı olan araçları claude_args içinde --allowedTools ile ya da settings girdisindeki bir izin kuralıyla vermen gerekir. GitHub zamanlanmış workflow'ları yalnız varsayılan daldan çalıştırır ve herkese açık depolarda depoda etkinlik olmadan belli bir süre geçince zamanlamayı kapatır. Aşağıdaki örnekte --max-turns değeri yalnız bir örnektir:

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: |
            --max-turns 5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

Kurs ayrıca workflow_dispatch tetikleyicisi eklersen işi Actions sekmesinden elle başlatabileceğini söylüyor.

Girdiler

GirdiNe yapar
promptClaude'a talimat; düz metin ya da bir skill çağrısı. Verilmezse Action tetikleyici ifadeyi bekler.
claude_argsClaude Code'a doğrudan geçirilen CLI bağımsız değişkenleri
anthropic_api_keyClaude API anahtarı. claude_code_oauth_token ya da iş yükü kimlik federasyonu kullanmıyorsan gerekir.
claude_code_oauth_tokenClaude aboneliğinle kimlik doğrulamak için OAuth token'ı
github_tokenGitHub işlemleri için token. Vermezsen Action, kurduğun Claude GitHub uygulaması olarak kimlik doğrular.
trigger_phraseAction'ın yorumlarda dinlediği ifade; varsayılan @claude
use_bedrock, use_vertex, use_foundryÇalıştırmayı Claude API yerine Amazon Bedrock, Google Cloud'un Agent Platform'u ya da Microsoft Foundry üzerinden yönlendirir (bulut hesabınla OIDC kimlik federasyonu, API anahtarı değil)

claude_args ince ayarın yapıldığı yerdir. Kursun ve dokümanın öne çıkardığı ayarlar: --max-turns ajan döngüsüne sert bir üst sınır koyar ve sonsuza dek çalışmasını önler; gözetimsiz bir işte kimse yanıt veremeyeceği için izin modunu soru sormayacak şekilde seçersin; araç iznini işin gerektirdiği kadarına daraltırsın (rapor için salt okunur). --model ve --mcp-config de aynı yerden geçirilir.

Hangisini seçmeli?

İşSeçim
PR incelemesi, kurmadan, satır içi bulgularCode Review (yönetilen). Aç, bulguları oku, kodu düzeltip push et.
Bir yorumdan değişiklik uygulatmak, PR'a commit push ettirmekGitHub Action, @claude workflow'u
Zamanlanmış rapor ya da herhangi bir GitHub olayında özel işGitHub Action, prompt ve cron
Planın Code Review'ı içermiyor, yine de inceleme istiyorsunYerel /code-review ya da Action ile kendi inceleme workflow'un

Kursun tavsiyesi: yönetilen hizmetle başla. Claude'un CI'da yorum yazmanın ötesinde gerçekten bir şey yapması gerektiği anda Action'a geç.

Güvenlik

Adım adım

  1. Hangisine ihtiyacın var, karar ver. Yalnız PR incelemesi istiyorsan Code Review; Claude'un yorumdan değişiklik yapmasını ya da özel iş çalıştırmasını istiyorsan GitHub Action. Beklenen sonuç: hangi yoldan gideceğin belli olur.
  2. Code Review'ı Owner'a açtır. Kuruluşunun Owner'ı claude.ai'da Admin settings > Claude Code > Code review > Allow code review anahtarını açar, GitHub'ı bağlar, Claude GitHub uygulamasını kurar ve depoları seçer. Beklenen sonuç: seçilen depolar listelenir ve kurulum tamamlanır. Planın Team ya da Enterprise değilse bu adımı atla ve yerel /code-review kullan.
  3. İnceleme sıklığını ayarla. Her depo için PR açılınca bir kez, her push'ta ya da yalnız @claude review yorumunda çalışmasını seç. Beklenen sonuç: kontrol çalıştırmaları beklediğin sıklıkta görünür.
  4. Test PR'ı aç. Taslak olmayan küçük bir PR aç. Beklenen sonuç: kısa sürede Claude Code Review kontrol çalıştırması ve varsa satır içi bulgular çıkar. Hiç kontrol çalıştırması görünmüyorsa Manual modda olabilirsin; PR'a @claude review yaz.
  5. Action için kur. Deponun klasöründe claude aç ve /install-github-app yaz. Komutu yönergelerle bitir. Beklenen sonuç: GitHub uygulaması kurulur, sır eklenir ve workflow dosyalarını içeren, oluşturmaya hazır bir PR hazırlanır.
  6. Kurulum PR'ını gözden geçir ve birleştir. Workflow dosyasını oku; izinler, if koşulu ve sır adı beklediğin gibi mi bak. Beklenen sonuç: birleştirince @claude depoda çalışır.
  7. Test et. Bir issue ya da PR yorumuna küçük, net bir @claude isteği yaz. Beklenen sonuç: Actions sekmesinde workflow çalışır, Claude aynı konuşmaya yorumla yanıt verir.
  8. İzinleri ve sınırları daralt. Workflow'un permissions bloğunu işe yetecek kadara indir, claude_args içine --max-turns ekle, zamanlanmış işte yalnız gereken araçları --allowedTools ile ver. Beklenen sonuç: Claude'un yapabileceği iş, ihtiyacın olandan fazla olmaz.
  9. Sonucu doğrula. Claude'un commit'lerini ve yorumlarını birleştirmeden önce git diff ve /code-review ile oku (bkz. 4.6). Beklenen sonuç: "Claude yaptı" bir inançtan çıkar, kanıta dayanır.

Hazır prompt

Bir issue'dan işe başlatmak için PR yorumu (kopyala, kendi işine göre doldur):

@claude [issue numarası ya da özet] ile ilgili işi yap: [yapılacak şey]. Önce hangi dosyalara dokunacağını yaz. Testleri çalıştır ve komutu ile çıktısını yoruma ekle. Kapsam dışında bir dosyayı değiştirme.

Bir PR'ı elle incelettirmek için (Code Review açıksa) yorum:

@claude review

Zamanlanmış bir raporun prompt satırı için (kendi deponun adlarıyla):

Dünkü commit'lerin ve açık issue'ların kısa bir özetini çıkar. Yalnız okuma yap, hiçbir dosyayı değiştirme. Bulguları madde madde yaz ve her maddenin yanına kaynağını (commit ya da issue numarası) ekle.

Sık yapılan hata

Claude'un workflow dosyaları ve girdi adları hakkında verdiği bilgiler değişebilir. Dosyayı kullanmadan önce GitHub Actions dokümanıyla karşılaştır ve Claude'dan kaynağını iste.

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-11-12

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik