Kalite kapılarıyla Claude Code pull request incelemesi
Matt · · Son güncelleme · 9 dk okuma · Kılavuzlar
Claude Code'un işini MCP üzerinden kapı denetimli AI CodeOps oturumlarına yönlendirin, pull request'te yayın kapısı kontrolünü zorunlu kılın ve onu atlayan push'ları durdurun.
Bu sayfada
Claude Code'un pull request'lerini kalite kapılarının arkasına almak için Claude Code'un değişikliği kendisinin yazıp push etmesi yerine MCP sunucusu üzerinden AI CodeOps oturumları başlatmasını sağlayın, ardından AI CodeOps yayın kapısını pull request'te zorunlu bir kontrol yapın. Oturum değişikliği test eder ve inceler, ikinci bir kişi onaylar; zorunlu kontrol de kapı izin verene kadar merge düğmesini kilitli tutar.
Sorun: hızlı ajan PR'ları, yavaş insan incelemesi
Claude Code bir cümleyi diff'e dönüştürmekte çok iyidir. O diff ile ana branch'iniz arasında duran şey genellikle "bir geliştiricinin göz gezdirmesi"dir ve bu, hacim artana kadar idare eder. Bir ajan bir sabahta, bir ekibin bir günde dikkatle okuyabileceğinden fazla pull request açabilir ve ilk kesilen şey de o dikkatli okuma olur.
Kapı yorulmaz ama değişikliği görmesi gerekir. Burada kesin olmakta fayda var, çünkü bunu yanlış anlamak size sahte bir güvenlik hissi verir.
AI CodeOps yayın kapısı, kendi kaydettiği kanıta göre karar verir: değişikliği yazan oturum, diff'inin yapay zekâ incelemesi, sandbox'ındaki test çalıştırması ve onay. Bu kanıtı, oturumun açtığı pull request üzerinden bulur. Kapı, başka bir yerde açılan pull request'ler için repolarınızı izlemez. Yani Claude Code dizüstü bilgisayarınızda bir değişiklik yazar, siz de onu push edip bir pull request açarsanız AI CodeOps'un bundan haberi olmaz. Kapıya o pull request'i sorarsanız "No workflow runs found for …" mesajıyla allowed: false yanıtını verir. Doğru yanıt da budur. Değerlendirecek bir şeyi yoktur, bu yüzden reddeder.
Tasarımı bu belirler. Claude Code'un işini kapının arkasına almak istiyorsanız iş bir AI CodeOps oturumundan geçmelidir. Claude Code, yazdığınız arayüz olarak kalır. Yazma, test ve inceleme işini platformda oturum yapar; pull request'i de oturum açar.
Kurulum: repoyu bağlayın, kapıları seçin, kontrolü zorunlu kılın
Repoyu bağlayın. AI CodeOps'ta GitHub hesabınızı Configure → Settings → Git Providers altında bağlayın (GitHub kurulumu) ve Plan → Projects altında reponun URL'siyle bir proje oluşturun. O projedeki oturumlar reponun bir anlık görüntüsü üzerinde yazar ve pull request'lerini orada açar. AI CodeOps'un repoyla ne yaptığını GitHub entegrasyonu sayfası anlatıyor.
Kapıları seçin. Varsayılan olarak yayın kapısı bir değişikliği şu durumlarda reddeder: yüksek (high) veya kritik (critical) önem derecesinde bir bulgu hâlâ açıksa, bir test çalıştırması başarısız olduysa, kod değiştiren bir oturumun sayılar içeren bir test sonucu yoksa, bağlı olduğu bir iş akışı başarısız olduysa ya da onun hiçbir çalıştırması tamamlanmadıysa veya yapay zekâ incelemesi tamamlanmadıysa. CI çağrısında blockingSeverity, requiredWorkflows ve minCoveragePct ekleyebilirsiniz. Kapsam alt sınırı bir kapsam değerine ihtiyaç duyar: değişiklikteki hiçbir test çalıştırması kapsam bildirmediyse kapı reddeder, çünkü alt sınırı kontrol edemez. Kuralların tamamı kalite kapıları sayfasında.
AI CodeOps kontrolünü zorunlu kılın. Kapıya Claude Code'dan sormak işe yarar ama yalnızca tavsiye niteliğindedir: biri yine de Merge düğmesine basabilir. Yaptırım Git platformunda olmalıdır. GitHub için hâli aşağıda; sade bir iş akışı, yüklenecek ek bir Action yok:
# .github/workflows/aicodeops-gate.yml
name: AI CodeOps gate
on:
pull_request:
permissions:
contents: read
jobs:
gate:
if: startsWith(github.head_ref, 'codeops/run-')
runs-on: ubuntu-latest
steps:
- name: Ask the AI CodeOps release gate
env:
AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
PR_URL: ${{ github.event.pull_request.html_url }}
run: |
jq -n --arg pr "$PR_URL" '{pullRequestURL: $pr}' > request.json
curl -sS --fail-with-body -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $AICODEOPS_API_KEY" \
-H "Content-Type: application/json" \
--data @request.json -o gate.json
jq -r '.summary' gate.json
jq -r '.reasons[]' gate.json
jq -e '.allowed == true' gate.json > /dev/null
Anahtarı AICODEOPS_API_KEY adlı bir repo secret'ı olarak ekleyin. CI için düzenleyicinizdekinden ayrı bir anahtar kullanın. Kontrol yalnızca workspace:read gerektirir; planınızda anahtar kapsamı sınırlama varsa anahtarı yayın kapısı kontrolüyle sınırlayabilirsiniz.
Burada birkaç ayrıntı önemli:
- Durum kodunu değil,
allowedalanını okuyun. Uç nokta her iki karar için de200döndürür. Son satır,alloweddeğeritrueolmadıkça adımı başarısız kılar. - Hata durumunda kapalı kalır. Eksik veya yanlış bir anahtar 401 ya da 403 alır ve
--fail-with-bodybunu başarısız bir adıma çevirir. Değerlendirmenin kendisi bozulursa API "Evaluation failed" mesajıylaallowed: falseyanıtını verir. Çalışma alanı dakikada 60'tan fazla kontrol yaparsa 429 alır; bu da adımı başarısız kılar, o durumda adımı yeniden çalıştırın. jqvecurlzaten orada. GitHub'ınubuntu-latestrunner imajı ikisini de içerir; yüklenecek bir şey yok.
if: satırı, bilerek vermeniz gereken bir karardır. Kapıyı yalnızca AI CodeOps'un açtığı branch'lerde çalıştırır. GitHub'ın zorunlu kontroller için sorun giderme sayfası, iş düzeyindeki bir koşulla atlanan bir işin "Success" raporladığını söyler. Böylece bir insanın pull request'i normal kurallarınıza göre merge edilmeye devam eder, bir AI CodeOps pull request'i ise kapı geçene kadar merge edilemez. if: satırını on: altındaki bir branch filtresiyle değiştirmeyin. Aynı sayfaya göre branch veya yol filtrelemesiyle atlanan kontroller "Pending" durumunda kalır ve merge işlemini engeller.
if: satırını tamamen kaldırırsanız her pull request'in arkasında bir AI CodeOps oturumu olması gerekir. Bu, yalnızca ajanların değiştirmesi gereken bir repo için geçerli bir politikadır; ama her insan pull request'ini engeller, o yüzden bu kararı bilinçli verin.
Son olarak kontrolü zorunlu kılın. main için tanımlı branch koruması kuralında veya ruleset'te durum kontrollerinin geçmesini zorunlu kılın ve gate kontrolünü seçin. Merge öncesinde bir pull request'i de zorunlu kılın; böylece hiçbir şey bir pull request'ten geçmeden main branch'ine ulaşmaz. Ruleset'in geri kalanını Yapay zekâ ajanları için GitHub ruleset'leri yazısı anlatıyor.
Claude Code'dan AI CodeOps MCP sunucusunu kullanın
AI CodeOps, https://console.aicodeops.dev/mcp adresinde uzak bir MCP sunucusu çalıştırır. Sunucu Streamable HTTP aktarımını kullanır ve Bearer token olarak bir çalışma alanı API anahtarı alır.
Configure → API Keys altında bir anahtar oluşturun. Anahtar sk- ile başlar ve yalnızca bir kez gösterilir. İki araç okuma erişiminden fazlasını gerektirir ve kapsamı sınırlanmamış bir anahtar bunları varsayılan olarak almaz:
start_sessionmodel bütçesi harcar; bu yüzden yalnızca kapsamında bu araç listelenen bir anahtarla çalışır. Anahtarda Scope seçeneğini seçin ve Start sessions from the MCP server (/mcp) kutusunu işaretleyin.get_evidence_packdenetim kaydını dışa aktarır; bu yüzden Evidence packs from the MCP server (/mcp) kutusunun da işaretlenmesi gerekir.
Diğer yedi araç (list_projects, get_session, check_release_gate, list_findings, list_builds, get_build, list_saved_builds) yalnızca okur. Bir anahtar her zaman onu oluşturan üye olarak, o üyenin mevcut rolüyle hareket eder. Viewer rolündeki bir üyenin anahtarı, kapsamı ne derse desin yalnızca okuyabilir.
Ardından sunucuyu ekleyin. Aşağıdaki komut MCP sunucusu kılavuzundaki komuttur ve Claude Code'un MCP dokümantasyonunun başlık içeren uzak bir HTTP sunucusu için verdiği sözdizimiyle yazılmıştır (24 Ekim 2026'da kontrol edildi):
claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \
--header "Authorization: Bearer $AICODEOPS_API_KEY"
Bu komut sunucuyu varsayılan yerel kapsamda, ~/.claude.json içinde ve yalnızca mevcut proje için saklar. Bir ekip için repoda proje kapsamlı bir .mcp.json daha iyidir, çünkü Claude Code uzak bir sunucunun url ve headers alanlarındaki ortam değişkenlerini genişletir. Herkes aynı dosyayı commit eder ve kendi anahtarını kendi shell'inde tutar:
{
"mcpServers": {
"aicodeops": {
"type": "http",
"url": "https://console.aicodeops.dev/mcp",
"headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
}
}
}
Claude Code, .mcp.json içindeki proje kapsamlı sunucuları kullanmadan önce her kişiden onay ister. Claude Code içinde /mcp komutunu çalıştırın; aicodeops dokuz araçla bağlı görünmelidir.
Adım adım: prompt'tan merge'e tek bir pull request
Diyelim ki şunu yazdınız: "api projesindeki login uç noktasına istek limiti ekle, sonra PR merge'e hazır olduğunda bana haber ver." Araç araç olanlar şöyle.
list_projects çalışma alanının projelerini ve repolarını döndürür. Claude Code, api için proje kimliğini seçer.
start_session görevinizle ve o projeyle bir oturum başlatır. workflow argümanı verilmezse plan-build-review-test çalışır. Başka bir iş akışının adını da verebilirsiniz; örneğin security-sensitive-change, değişiklikten önce bir risk analizi, sonrasında da diff'in denetimini ekler. Çağrı bir oturum kimliği ve konsolda oturuma giden bir bağlantı döndürür. Oturum ayrıca, tarayıcıda başlatılan bir oturumla tamamen aynı şekilde, çalışma alanı bütçesinden ve ajanların devam eden iş limitinden düşer.
Bundan sonra iş dizüstü bilgisayarınızda değil, platformda yürür:
- Ajanlar değişikliği planlar ve reponun bir anlık görüntüsü üzerinde yazar; her adım çıktısını bir sonrakine devreder (devir teslimleri çok ajanlı kalıplar rehberi anlatıyor).
- verify adımı (doğrulama), projenizin kendi testlerini önerilen kod ağacı üzerinde yalıtılmış bir sandbox içinde çalıştırır. Önce reponun mevcut bağımlılıkları yüklenir. Ardından sandbox'ın ağ bağlantısı kesilir ve yapay zekânın düzenlemeleri ancak bundan sonra yazılıp çalıştırılır. Sandbox'ın çevrimdışı olduğu doğrulanamazsa değişiklik hiç çalıştırılmaz. Değişiklik bir bağımlılık manifest'ine dokunduysa yükleme, ağ hâlâ kapalıyken yeniden çalışır; böylece önceden orada olmayan bir paket indirilemez ve test paketi çalıştırılmış değil, atlanmış olarak kaydedilir.
- Bir yapay zekâ inceleyicisi diff'i okur ve bulguları bir önem derecesiyle kaydeder. Okunabilir bir liste olmayan bir yanıt başarısız inceleme sayılır ve kapı değişikliği bekletir.
- Review & Gate → Approvals altında bir onay açılır.
get_session, Claude Code'un düzenli aralıklarla sorguladığı araçtır. Durumu, adımları ve oluştuklarında pull request'i ve değişiklik kaydını döndürür.
Onay, insanların başka kurulumlarda atladığı adımdır; bu yüzden açık açık anlatmaya değer. Oturum sizin anahtarınızla başlatıldı, yani oturumu başlatan kişi sizsiniz. Çalışma alanında başka bir onaylayıcı varsa onay, oturumu başlatan kişiden başka birinden gelmelidir: sizin onayınız sayılmaz, diff'e başka birinin bakması gerekir. O kişi onayladığında AI CodeOps değişikliği kalite kapısına göre kontrol eder ve pull request'i codeops/run-<id> adlı bir branch üzerinde açar. Reddetmeye her zaman izin verilir ve tek bir ret değişikliği durdurur.
check_release_gate, pull request'in yayına alınıp alınamayacağını gerekçeleriyle birlikte yanıtlar. Yukarıdaki CI iş akışıyla aynı kontroldür; varsayılanları ve seçenekleri de aynıdır.
get_evidence_pack değişikliğin imzalı kaydını döndürür: prompt, model, çalıştırmalar, bulgular, testler ve onaylar; hepsi Ed25519 ile imzalanmıştır ve /evidence/verify adresinde doğrulanabilir. Dışa aktarma işleminin kendisi de denetim günlüğüne yazılır.
İşin özü şu: Claude Code, testlerin geçtiğine inandığı için geçtiklerini söylemek yerine size gerçek gerekçelerle "kapı hayır diyor, nedeni şu" diyebilir.
İpuçları
Yerel ajanın kapıyı dolanmasını engelleyin. Son açık, Claude Code'un kendisidir. Dizüstü bilgisayarınızdaki sıradan bir oturumda o da sizin gibi git push ve gh pr create çalıştırabilir. Çalıştırırsa, bu kurulumun önlemek için var olduğu kapı denetimsiz pull request'in ta kendisini elde edersiniz.
Claude Code'un izin kuralları bu komutları reddedebilir. Repoda şunu .claude/settings.json dosyasına commit edin:
{
"permissions": {
"deny": ["Bash(git push *)", "Bash(gh pr create *)", "Bash(gh pr merge *)"]
}
}
Dokümantasyona göre kurallar önce deny, sonra ask, sonra allow sırasıyla değerlendirilir ve herhangi bir ayar dosyasındaki bir deny, başka herhangi bir dosyadaki bir allow'a üstün gelir. Paylaşılan proje dosyasındaki deny kuralları da her kişinin klasöre güvenmesini beklemeden hemen geçerli olur.
Bunun ne olduğu konusunda net olun (dokümantasyon 24 Ekim 2026'da kontrol edildi). Aynı dokümantasyona göre bir Bash kuralı Claude'un yazdığı komut metniyle eşleşir; yani Bash(git push *), git -C . push ile eşleşmez. Dokümantasyon böyle bir kural için açıkça “programın etrafında bir güvenlik sınırı değildir” der. Deny listesini yaygın durum için bir emniyet kemeri olarak görün. Sınır Git platformundadır: korumalı bir main, zorunlu bir pull request, insan pull request'leri için zorunlu incelemeler ve AI CodeOps pull request'leri için zorunlu gate kontrolü.
Bu kurulumun neyi yapmadığını bilin.
- AI CodeOps'un açmadığı pull request'leri incelemez. Claude Code ile yerelde yazıp kendiniz push ettiğiniz bir değişiklik sizin değişikliğinizdir. Ona normal insan incelemeniz uygulanır ve kapının bu konuda bir görüşü yoktur.
- Commit trailer'larını bir sinyal olarak kullanmaz. Claude Code commit'lere ve pull request'lere bir atıf satırı ekleyebilir, ancak ayarı bu satırı değiştirebilir veya gizleyebilir. Bir trailer'a dayanan kural, bir ajanın kapatabileceği bir kuraldır.
- Yapay zekâ incelemesini yanılmaz kılmaz. İnceleme, bir diff'i okuyan bir modeldir. Gerçek test çalıştırmalarının ve ikinci bir kişinin yerine değil, yanında durmasının nedeni de budur.
CI için ikinci bir anahtar kullanın. Düzenleyicideki anahtar oturum başlatabilir; CI anahtarının ise yalnızca kapıyı okuması gerekir. Biri sızarsa diğerini bozmadan onu iptal edersiniz.
Diğer yön, yani kendi MCP sunucularınızı oturumlara bağlamak, MCP entegrasyonu sayfasında anlatılıyor.
Önemli çıkarımlar
- AI CodeOps kapısı yalnızca bir AI CodeOps oturumunun yaptığı değişiklikleri değerlendirir; bu yüzden Claude Code'un işini MCP üzerinden oturumlara yönlendirin.
- Yayın kapısını
mainüzerinde zorunlu bir kontrol yapın ve iş düzeyinde birif:ile yalnızcacodeops/run-branch'lerinde çalıştırın. - Kapının yanıtında HTTP durum kodunu değil
allowedalanını okuyun ve her hatanın adımı başarısız kılmasına izin verin. - Başka biri inceleyebildiği anda, oturumu başlatan kişi oturumu tek başına onaylayamaz.
- Claude Code'un deny kuralları bir emniyet kemeridir; sınır, branch koruması ve zorunlu kontroldür.
Sık sorulan sorular
AI CodeOps, Claude Code'un dizüstü bilgisayarımdan push ettiği bir pull request'i kapıdan geçirebilir mi?
Hayır. Yayın kapısı AI CodeOps oturumlarından gelen kanıtı değerlendirir; bu yüzden hiçbir oturumun açmadığı bir pull request, "No workflow runs found" mesajıyla allowed false yanıtı alır. Claude Code'un değişikliği kendisinin push etmesi yerine bir oturum başlatmasını sağlayın.
Claude Code'un pull request'lerini yine bir insan inceliyor mu?
Evet. Çalışma alanında başka bir onaylayıcı varsa onay, oturumu başlatan kişiden başka birinden gelmelidir; böylece pull request açılmadan önce diff'i başka biri okur.
Claude Code deny kuralları her git push komutunu durdurur mu?
Hayır. Bir Bash kuralı Claude'un yazdığı komut metniyle eşleşir; bu yüzden push komutunun başka bir yazımı eşleşmez. Deny listesini bir emniyet kemeri olarak görün, sınır olarak ise branch korumasına ve zorunlu kontrole güvenin.