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
- Yönetilen Code Review hizmeti ile GitHub Action arasındaki farkı ve hangisini ne zaman seçeceğini
- Kurulum yolunu:
/install-github-appkomutu ve workflow dosyasının yapısı @claudeile Claude'u çağırmayı ve sır ile izin konusunda nelere dikkat edeceğini
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:
- GitHub hesabını bağlarsın (Connect GitHub) ve Claude GitHub uygulamasını kurarsın (Install GitHub App). Uygulamayı kuran kişi GitHub kuruluşunun da owner'ı olmalı; değilse önce bir owner uygulamayı kurup bağlamalı.
- Hangi depoların izleneceğini seçersin. Depo eklemek için bağladığın GitHub hesabından o depoya yazma erişimin olmalı.
- İncelemenin ne zaman çalışacağına karar verirsin. Kursun ve dokümanın ortak seçenekleri: PR açıldığında bir kez (Once after PR creation), her push'ta (After every push) ya da yalnız biri
@claude reviewyorumu yazdığında (Manual). Dokümana göre yeni eklenen depo, her push'ta incelemeyle başlar; daha az inceleme istersen bunu değiştirirsin. - Dokümana göre ayrıca bir inceleme düzeyi (Quick, Standard, Deep) seçilir; daha kapsamlı inceleme daha pahalıdır. Maliyet ayrıntıları için Code Review costs and usage sayfasına bak; burada fiyat vermiyoruz.
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:
| İşaret | Düzey | Anlamı |
|---|---|---|
| 🔴 | Important | Birleştirmeden önce düzeltilmesi gereken bir hata |
| 🟡 | Nit | Küçük bir sorun; düzeltmeye değer ama engelleyici değil |
| 🟣 | Pre-existing | Kod 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?
- Hiçbir zaman onaylamaz ya da engellemez. Birleştirme kararı sende kalır. Kontrol çalıştırması hata (failure) olarak bitmez, bu yüzden zorunlu bir kontrolü kırmaz.
- Düzeltme push etmez. Hizmet yalnız bulguları yazar; kodu düzeltip push etmek senin işindir. Dokümana göre bir inceleme içinde deponun erişimi salt okunurdur ve inceleme kod derlemeden ya da çalıştırmadan, yalnız diff'i ve çevresindeki kodu okuyarak yapılır. Push etmeden önce kendi düzeltmeni denemek için terminalde
/code-reviewçalıştırabilirsin;--fixbayrağı o incelemenin bulgularını çalışma ağacına uygular. - Hata kaçırabilir. Doküman bulgusuz bir incelemenin kodun hatasız ya da güvenli olduğu anlamına gelmediğini açıkça yazıyor.
- Taslak PR'ları ve fork'lardan gelenleri otomatik incelemez. İkisi için de yorumla inceleme istersin.
- İncelemeyi yorum komutlarıyla çağırırsın. Yeni bir üst düzey PR yorumuna
@claude reviewyaz: tek bir inceleme başlatır.@claude review alwayssonraki push'lara da abone eder,@claude review stopaboneliği bitirir. Komutu yazanın depoya yazma erişimi olmalı ve PR açık olmalı.
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:
- Hızlı kurulum: deponun klasöründe
claudeaç ve/install-github-appkomutunu çalıştır. Komut Claude GitHub uygulamasını kurar, kimlik doğrulama sırrını depoya ekler ve workflow dosyalarını içeren bir PR hazırlar. Bu PR'ı oluşturup birleştirince@claudedepoda çalışır. Komut yalnız github.com depolarında çalışır ve GitHub CLI'ın (gh) kurulu vegh auth loginile giriş yapılmış olmasını bekler. - Elle kurulum: Claude GitHub uygulamasını kurarsın, bir sır eklersin ve örnek workflow dosyasını deponun
.github/workflows/klasörüne kopyalarsın. Komutun başarısız olduğunda, Claude Code'u yerelde çalıştırmadığında ya da workflow dosyalarının tam denetimini istediğinde bu yolu kullan.
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
| Girdi | Ne yapar |
|---|---|
prompt | Claude'a talimat; düz metin ya da bir skill çağrısı. Verilmezse Action tetikleyici ifadeyi bekler. |
claude_args | Claude Code'a doğrudan geçirilen CLI bağımsız değişkenleri |
anthropic_api_key | Claude API anahtarı. claude_code_oauth_token ya da iş yükü kimlik federasyonu kullanmıyorsan gerekir. |
claude_code_oauth_token | Claude aboneliğinle kimlik doğrulamak için OAuth token'ı |
github_token | GitHub işlemleri için token. Vermezsen Action, kurduğun Claude GitHub uygulaması olarak kimlik doğrular. |
trigger_phrase | Action'ı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 bulgular | Code Review (yönetilen). Aç, bulguları oku, kodu düzeltip push et. |
| Bir yorumdan değişiklik uygulatmak, PR'a commit push ettirmek | GitHub 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 istiyorsun | Yerel /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
- Sırlar GitHub Secrets'ta durur. Dokümandaki uyarı: API anahtarlarını ya da OAuth token'larını depoya hiçbir zaman commit etme; workflow'larda
${{ secrets.ANTHROPIC_API_KEY }}gibi başvur. Örneklerdeki sır adları yer tutucudur, gerçek bir değer içermez. - İzinleri daralt. Dokümana göre workflow'a yalnız gereken izinleri ver ve Claude'un değişikliklerini birleştirmeden önce gözden geçir. Yukarıdaki iki örnekte izinlerin farklı olduğuna dikkat et: rapor workflow'u yalnız okur.
- Kim tetikleyebilir? Dokümana göre Action, Claude başlamadan önce tetikleyen kişiyi denetler. Issue ve PR olaylarında tetikleyen kullanıcının depoya yazma erişimi olmalı; yazma erişimi olmayan belirli kullanıcılara izin vermek için
allowed_non_write_usersve kendigithub_tokengirdin gerekir. Ayrıca her olayda bot kullanıcılar,allowed_botsiçinde listelemediysen reddedilir; bu botların Claude'u döngüye sokmasını engeller. - Fork PR'larında sır yoktur. Dokümana göre herkese açık depolarda GitHub, fork PR'larının tetiklediği çalıştırmalardan sırları saklar; bu yüzden böyle bir inceleme workflow'u yalnız aynı depodaki dallardan gelen PR'larda çalışır.
- GitHub uygulaması geniş bir izin kümesi ister. Claude GitHub uygulaması Action, Code Review ve diğer özelliklerce paylaşıldığı için Action'ın kullanmadığı izinleri de içerir ve GitHub bir alt kümeyi kabul ettirmez. Yalnız Action'ın izinlerini isteyen bir kuruluş, Contents, Issues ve Pull requests izinleriyle özel bir GitHub uygulaması kurabilir (bu özel uygulama yalnız Action'ı kapsar; Code Review resmî uygulamayı ister).
- Maliyeti sınırla. Her çalıştırma GitHub Actions dakikası ve API belirteci tüketir. Dokümanın önerileri: net
@claudeistekleri yaz,CLAUDE.md'yi kısa tut,claude_argsiçinde--max-turnsayarla, workflow düzeyinde zaman aşımı koy, GitHub eşzamanlılık denetimlerini kullan. Fiyatlar için ilgili sayfalara bak; burada vermiyoruz.
Adım adım
- 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.
- 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-reviewkullan. - İnceleme sıklığını ayarla. Her depo için PR açılınca bir kez, her push'ta ya da yalnız
@claude reviewyorumunda çalışmasını seç. Beklenen sonuç: kontrol çalıştırmaları beklediğin sıklıkta görünür. - 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 reviewyaz. - Action için kur. Deponun klasöründe
claudeaç ve/install-github-appyaz. 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. - Kurulum PR'ını gözden geçir ve birleştir. Workflow dosyasını oku; izinler,
ifkoşulu ve sır adı beklediğin gibi mi bak. Beklenen sonuç: birleştirince@claudedepoda çalışır. - Test et. Bir issue ya da PR yorumuna küçük, net bir
@claudeisteği yaz. Beklenen sonuç: Actions sekmesinde workflow çalışır, Claude aynı konuşmaya yorumla yanıt verir. - İzinleri ve sınırları daralt. Workflow'un
permissionsbloğunu işe yetecek kadara indir,claude_argsiçine--max-turnsekle, zamanlanmış işte yalnız gereken araçları--allowedToolsile ver. Beklenen sonuç: Claude'un yapabileceği iş, ihtiyacın olandan fazla olmaz. - Sonucu doğrula. Claude'un commit'lerini ve yorumlarını birleştirmeden önce
git diffve/code-reviewile 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
- Code Review'ı PR'ı onaylayan bir araç sanmak. Hiçbir zaman onaylamaz ya da engellemez; bulgusuz inceleme kodun güvenli olduğu anlamına gelmez. Karar sende kalır.
- Code Review'ın düzeltme push edeceğini beklemek. Yalnız bulgu yazar. Düzeltme senin işindir ya da Action gerekir.
- Fork ve taslak PR'larda otomatik inceleme beklemek. İkisi atlanır; yorum komutuyla incelet.
- Action'ı da Code Review'ı da açıp aynı ifadeyi paylaşmak. Dokümana göre depoda Action etkileşimli modda varsayılan
@claudeifadesiyle çalışıyorsa bir@claude reviewyorumu Action'ı da başlatır. İkisini ayırmak için Action'ıntrigger_phrasegirdisini farklı bir ifadeye çevir. - Sırrı workflow dosyasına yazmak. Anahtarı ve token'ı depoya commit etme; GitHub Secrets kullan.
- Herkese yazma izni vermek. Workflow'a gereken izinleri ver ve Claude'un değişikliklerini birleştirmeden önce oku.
- GitHub'ın varsayılan
GITHUB_TOKEN'ınıgithub_tokenolarak geçirmek. Dokümana göre GitHub, bu token'la yapılan commit'ler için workflow tetiklemez; Claude'un push'larında CI çalışmaz. Girdiyi kaldır ya da özel bir uygulama token'ı ver. - Sınırsız çalıştırmak.
--max-turns, zaman aşımı ve eşzamanlılık denetimi koymazsan hem dakika hem belirteç harcanır. - Eski
@betasürümünü kullanmak. Doküman workflow'larınıanthropics/claude-code-action@v1'e yükseltmeni,modegirdisini kaldırmanı vedirect_promptyerinepromptyazmanı söylüyor.
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
- Anthropic Academy, Claude Code in action: GitHub Actions and Code Review (yönetilen Code Review, Owner kurulumu, Action ve
/install-github-app, girdiler, @claude ve zamanlanmış workflow, claude_args) - Claude Code dokümanı: Code Review (hizmet, Team ve Enterprise planları, nasıl çalışır, ne yapar ve yapmaz, seçeneklerin karşılaştırması)
- Claude Code dokümanı: Set up Code Review (Admin settings > Claude Code, Allow code review, GitHub uygulaması, inceleme düzeyi ve sıklığı)
- Claude Code dokümanı: Read and request reviews on a pull request (önem düzeyleri, bulgulara yanıt, yorum komutları, taslak ve fork)
- Claude Code dokümanı: Customize Code Review (
REVIEW.md,CLAUDE.md, hangi daldan okunduğu) - Claude Code dokümanı: Claude Code GitHub Actions (kurulum, workflow örnekleri, girdiler, kim tetikleyebilir, sırlar, maliyet, sorun giderme, beta'dan yükseltme)
- Claude Code dokümanı: Review locally with /code-review (
--fixbayrağı, planın Code Review'ı içermediği durum)
Son doğrulama: 2026-11-12