Claude Code ve GitHub Actions ile iş akışınızı hızlandırmaya hazır mısınız? Pull request'leri inceleyen, hataları düzelten, hatta doğrudan GitHub deponuzda yeni özellikler yazan bir yapay zeka takım arkadaşınız olduğunu hayal edin. Sihir gibi geliyor, değil mi? Anthropic'in Claude Code'u, GitHub Actions ile sorunsuz bir şekilde entegre olarak, basit bir @claude bahsiyle görevleri otomatikleştirerek bunu gerçeğe dönüştürüyor. Bu mücevhere Anthropic'in belgelerinde ve GitHub deposunda rastladım ve geliştiriciler için oyunun kurallarını değiştiriyor. Bu eğitimde, Claude Code'u GitHub Actions'da kurma, PR'leri incelemek için bir iş akışı oluşturma ve yeteneklerini keşfetme konusunda size yol göstereceğim. Hadi dalalım ve deponuzu daha akıllı hale getirelim!
Neden Claude Code ve GitHub Actions Harika?
Claude Code, terminalinizde veya IDE'nizde yaşayan, kod tabanınızı bir profesyonel gibi anlayan Anthropic'in ajans kodlama aracıdır. GitHub Actions ile eşleştirildiğinde, kod incelemelerini otomatikleştiren, özellikleri uygulayan ve sorunları doğrudan deponuzda çözen sanal bir takım arkadaşı olur. Beta aşamasında (Mayıs 2025 itibarıyla), ancak şimdiden şunlar gibi görevler için parlıyor:
- Kod İncelemeleri: PR'leri hatalar, stil ve standartlar açısından analiz eder.
- Özellik Uygulaması: Sorun açıklamalarını çalışan koda dönüştürür.
- Hata Düzeltmeleri: Birleştirilmeye hazır PR'lerle hataları tespit eder ve düzeltir.
GitHub deposu anthropics/claude-code-action, @claude yorumlarında tetikleme yeteneğini vurgulayarak onu etkileşimli ve geliştirici dostu hale getiriyor. Hadi kuralım!
Claude Code'u GitHub Actions için Kurma
Deponuzu otomatikleştirmeden önce, ortamınızı hazırlayalım. Bu, yeni başlayanlar için uygundur ve hızlı tutacağım!
1. Gereksinimleri Kontrol Edin:
- GitHub Deposu: Sırları ve uygulamaları eklemek için yönetici erişimine ihtiyacınız var.
- Anthropic API Anahtarı: console.anthropic.com'dan bir tane alın. Ücretsiz hesaplar çalışır, ancak ücretli planlar (Pro/Max) daha fazla kullanım sunar.
- Sistem: Git ve bir terminal ile herhangi bir işletim sistemi (macOS, Linux, WSL2 ile Windows).
- Claude Code CLI (kurulum için isteğe bağlı):
npm install -g @anthropic-ai/claude-codearacılığıyla yükleyin.
2. Claude GitHub Uygulamasını Yükleyin:
- Terminalinizi açın ve şunu çalıştırın:
claude
/install-github-app
- Bu, sizi Claude GitHub Uygulamasını (github.com/apps/claude) deponuza yüklemeye yönlendirir. Deponuzu seçmek ve izinleri yetkilendirmek için istemleri izleyin.
- 404 hatası alırsanız,
ghbelirtecinizi yenileyin:gh auth refresh -h github.com -s workflowve tekrar deneyin. - Not: Bu hızlı başlangıç, Anthropic API kullanıcıları içindir. AWS Bedrock veya Google Vertex AI için, Anthropic'in belgelerinde manuel kurulumu inceleyin.
3. API Anahtarınızı Ekleyin:
- Yüklemeden sonra, CLI bir iş akışı dosyası (
.github/workflows/claude.yml) ile bir PR oluşturur. Birleştirmeden önce, Anthropic API anahtarınızı bir GitHub sırrı olarak ekleyin: - Deponuzun Ayarlar > Sırlar ve değişkenler > Eylemler bölümüne gidin.
- Anthropic konsolunuzdan anahtarınızla
ANTHROPIC_API_KEYadlı bir sır ekleyin. - İş akışını etkinleştirmek için PR'yi birleştirin.
Bunu bir test deposunda 10 dakikada kurdum; çok sorunsuz.
Not: API anahtarları için her zaman GitHub Sırlarını kullanın!
GitHub Actions'da bir Claude Code İş Akışı Oluşturma
Şimdi, Claude Code'un PR'leri otomatik olarak incelemesini sağlamak için bir GitHub Actions iş akışı oluşturalım. GitHub deposundan anthropics/claude-code-action'ı kullanacağız.
1. İş Akışı Dosyasını Oluşturun:
/install-github-appbunu oluşturmadıysa, deponuza manuel olarak.github/workflows/claude.ymlekleyin:
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Run Claude Code Review
uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
direct_prompt: |
Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.
- Bu, yeni veya güncellenmiş PR'lerde Claude Code'u tetikler, kodu kalite ve hatalar açısından inceler.
2. İş Akışını Test Edin:
- Bir dala değişiklik gönderin ve bir PR açın. Claude Code çalışacak, incelemesiyle ilgili bir yorum yayınlayacaktır (örneğin, "
main.py'de potansiyel bir null işaretçisi bulundu. Bir kontrol eklemeyi düşünün..."). - Bunu bir Python deposunda test ettim ve Claude eksik bir tür ipucunu yakaladı; nokta atışı!
3. Tetikleyiciyi Özelleştirin:
- Manuel kontrol mü istiyorsunuz? İş akışını yorumlarda tetiklenecek şekilde değiştirin:
on:
issue_comment:
types: [created]
jobs:
claude:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
- Şimdi, tetiklemek için
@claude review this PRyorumunu yapın.
Gelişmiş Görevler için Claude Code'u Kullanma
GitHub Actions'daki Claude Code sadece incelemeler için değil; özellikler uygulayabilir veya hataları düzeltebilir. İşte seviye atlama yolu:
1. Bir Özellik Uygulayın:
- Bir sorun oluşturun: "Giriş uç noktasına kullanıcı kimlik doğrulaması ekleyin."
- Yorum:
@claude implement this feature based on the issue description. - Claude sorunu analiz eder, kod yazar ve bir PR oluşturur. Bunu bir REST API için denedim ve temel bir JWT kimlik doğrulama kurulumu ekledi; etkileyici
2. Bir Hatayı Düzeltin:
- Bir sorunda, hatayı açıklayın: "
dashboard.js'de TypeError." - Yorum:
@claude fix the TypeError in the user dashboard component. - Claude sorunu bulur, bir düzeltme gönderir ve bir PR açar.
3. Proje Standartları Ekleyin:
- Kodlama standartlarını (örneğin, "Python için PEP 8 kullanın") tanımlamak için deponuzun kök dizininde bir
CLAUDE.mddosyası oluşturun. Claude, incelemeler ve uygulamalar sırasında bu yönergelere uyar.
Örnek uygulama:
1. İlk olarak, bir kullanıcı @Claude'u etiketleyen bir yorum bırakır ve geri bildirimi ele almasını ister, bu da GitHub Actions aracılığıyla Claude'un otomatik yanıtını tetikler.
2. Ardından Claude, yoruma otomatik olarak yanıt verir, istenen eylemleri gerçekleştirir (örneğin, API hata işleme, yinelenenleri kaldırma) ve tamamlanan görevlerin bir kontrol listesini sağlar.
3. Son olarak, bir gözden geçiren (örneğin, ön uç mühendisi) Claude tarafından yapılan değişiklikleri onaylar, çekme isteği başarıyla birleştirilir ve kapatılır, bu da Claude'un değişikliklerinin incelemeden geçtiğini gösterir.
Claude Code'un GitHub Actions Özelliklerini Keşfetme
Claude Code'u daha da ileriye taşımak mı istiyorsunuz? İşte bazı harika ipuçları:
- Görüntü Analizi: Bir yorumda bir ekran görüntüsü yükleyin (örneğin,
@claude fix this UI bug [screenshot]) ve Claude, düzeltmeler önermek için onu analiz eder. Görsel hatalar için harika - Özel Araçlar: Gelişmiş görevler için
Bash(git:*),GlobToolveya MCP (Model Control Protocol) sunucuları gibi araçları etkinleştirin (örneğin, veri getirme). Örnekler için GitHub deposuna bakın. - Daha Hızlı Çalıştırıcılar: GitHub'ın varsayılan çalıştırıcılarına kıyasla daha hızlı, daha ucuz yürütme için Depot çalıştırıcılarını (
runs-on: depot-ubuntu-latest) kullanın. - SDK Entegrasyonu: GitHub Actions'ın ötesindeki görevler için Claude Code SDK ile özel iş akışları oluşturun.
Bir CSS hatası için görüntü analiziyle deneme yaptım ve Claude düzeltmeyi yaptı; akıllara durgunluk veren!
Özet: Claude Code'u GitHub Actions ile Yönetin
Aferin! Kod incelemelerini otomatikleştirmek, özellikler uygulamak ve hataları gidermek için GitHub Actions'da Claude Code'un kilidini açtınız! GitHub Uygulamasını yüklemekten iş akışları oluşturmaya kadar, artık deponuzu bir üretkenlik güç merkezi haline getirmeye hazırsınız. MCP araçları eklemeyi, CLAUDE.md'yi ayarlamayı veya API'lerinizi APIdog ile belgelemeyi deneyin. Claude Code zaferlerinizi X veya Reddit'te paylaşın; PR'lerinizin parladığını görmek için heyecanlıyım! İyi kodlamalar!
