GitHub entegrasyonu

Claude Code, Claude’un GitHub Actions içinde çalışmasına olanak tanıyan resmi bir GitHub entegrasyonu sunar. Bu entegrasyon iki ana iş akışı sağlar: issue ve pull request’ler için mention desteği ve otomatik pull request review’ları.

Entegrasyonu Kurma

Başlamak için Claude’da /install-github-app çalıştırın. Bu komut sizi kurulum sürecinde yönlendirir:

• Claude Code app’ini GitHub’a yükleyin
• API anahtarınızı ekleyin
• Workflow dosyalarıyla otomatik olarak bir pull request oluşturun

Oluşturulan pull request, repository’nize iki GitHub Action ekler. Merge edildikten sonra workflow dosyalarınız .github/workflows dizininizde olacaktır.

Varsayılan GitHub Actions

Entegrasyon iki ana iş akışı sağlar:

Mention Action

Herhangi bir issue veya pull request’te @claude kullanarak Claude’u mention edebilirsiniz. Mention edildiğinde Claude:

• Talebi analiz eder ve bir görev planı oluşturur
• Codebase’inize tam erişimle görevi yürütür
• Sonuçlarla doğrudan issue veya PR’de yanıt verir

Pull Request Action

Bir pull request oluşturduğunuzda Claude otomatik olarak:

• Önerilen değişiklikleri inceler
• Değişikliklerin etkisini analiz eder
• Pull request’e ayrıntılı bir rapor gönderir

İş Akışlarını Özelleştirme

İlk pull request’i merge ettikten sonra workflow dosyalarını projenizin ihtiyaçlarına uyacak şekilde özelleştirebilirsiniz. İşte mention workflow’unu nasıl geliştireceğiniz:

Proje Kurulumu Ekleme

Claude çalışmadan önce ortamınızı hazırlamak için adımlar ekleyebilirsiniz:

- name: Project Setup
  run: |
    npm run setup
    npm run dev:daemon

Custom Instructions

Claude’a proje kurulumunuz hakkında context sağlayın:

custom_instructions: |
  The project is already set up with all dependencies installed.
  The server is already running at localhost:3000. Logs from it
  are being written to logs.txt. If needed, you can query the
  db with the 'sqlite3' cli. If needed, use the mcp__playwright
  set of tools to launch a browser and interact with the app.

MCP Server Konfigürasyonu

Claude’a ek yetenekler vermek için MCP server’lar yapılandırabilirsiniz:

mcp_config: |
  {
    "mcpServers": {
      "playwright": {
        "command": "npx",
        "args": [
          "@playwright/mcp@latest",
          "--allowed-origins",
          "localhost:3000;cdn.tailwindcss.com;esm.sh"
        ]
      }
    }
  }

Tool İzinleri

Claude’u GitHub Actions’ta çalıştırırken, izin verilen tüm tool’ları açıkça listelemeniz gerekir. Bu, özellikle MCP server’lar kullanırken önemlidir.

allowed_tools: "Bash(npm:*),Bash(sqlite3:*),mcp__playwright__browser_snapshot,mcp__playwright__browser_click,..."

Yerel geliştirmenin aksine, GitHub Actions’ta izinler için kısayol yoktur. Her MCP server’dan her tool ayrı ayrı listelenmelidir.

En İyi Uygulamalar

Claude’un GitHub entegrasyonunu kurarken:

• Varsayılan workflow’larla başlayın ve kademeli olarak özelleştirin
• Proje spesifik context sağlamak için custom instructions kullanın
• MCP server’lar kullanırken tool izinleri konusunda açık olun
• Karmaşık görevlerden önce workflow’larınızı basit görevlerle test edin
• Ek adımları yapılandırırken projenizin spesifik ihtiyaçlarını göz önünde bulundurun

GitHub entegrasyonu, Claude’u bir geliştirme asistanından, GitHub iş akışınız içinde doğrudan görevleri yürütebilen, kodu inceleyebilen ve içgörü sağlayabilen otomatik bir ekip üyesine dönüştürür.