GitHub entegrasyonu

Claude Code’un GitHub’la üç entegrasyon yolu vardır. Her biri farklı kullanım için optimize edilmiştir.

1. Üç yol

Yol	Ne için	Yerel mi?
GitHub App (resmi)	PR/issue’larda @claude mention	Sunucu tarafı
gh CLI	Local Claude Code shell’inde komutlar	Yerel
GitHub MCP server	Local Claude Code içinde structured API erişim	Yerel

İkisi (veya üçü) aynı projede birlikte yaşayabilir.

2. GitHub App (resmi)

PR ve issue’larda @claude mention’ladığında otomatik çalışır. Kurulum:

claude /install-github-app

Bu komut:

1. Browser’da Anthropic’in GitHub App’ini açar
2. Hangi repo’lara izin vereceğini seçersin
3. App, repo’da bir workflow file oluşturur
4. Bittiğinde PR’lerde @claude çalışmaya başlar

Tipik kullanımlar

• Code review: @claude please review this PR
• Bug fix: Issue’da @claude can you fix this?
• Implementation: Issue’da spec → @claude implement this in a PR

PR yorumuna @claude yazdığında, GitHub Actions üzerinden ephemeral bir Claude Code instance açılır, görev yapılır, PR’e push ya da yeni PR olarak döner.

3. gh CLI — local’de

Yerel Claude Code shell’inde GitHub etkileşimi gerekirse gh CLI MCP’ye göre daha context-verimlidir.

gh pr view 123 ile PR'ı oku, ne değişmiş özetle.
gh pr checkout 123 ile branch'e geç, testleri çalıştır.

Claude Bash gh pr view 123 ile çağırır. Avantaj:

• MCP gibi tool tanımı yüklemez
• Tüm gh komutlarına erişim
• Authentication makinende kurulu — Claude paylaşır

4. GitHub MCP — yapısal erişim

gh çıktısı metindir; LLM her zaman doğru parse edemez. Yapısal veri istediğinde GitHub MCP server:

claude mcp add --scope project github "npx -y @anthropic-ai/mcp-server-github"

Sonra MCP tool’ları üzerinden:

• mcp__github__get_pull_request
• mcp__github__create_issue
• mcp__github__list_files

Karar matrisi:

İhtiyaç	Seçim
PR/issue okuma + basit etkileşim	gh CLI
Yapısal data işleme (büyük PR diff parse, otomasyon)	GitHub MCP
Asenkron / non-local çalıştırma	GitHub App

5. Yetkilendirme ve güvenlik

• GitHub App repo seviyesinde izin ister
• gh CLI senin kişisel token’ını kullanır
• MCP server token’ı genelde .env veya env var olarak gelir — repo’ya commit etme

Özet

• Resmi App: claude /install-github-app, PR’lerde @claude mention
• gh CLI: yerel ve context-verimli, çoğu işlem için yeterli
• GitHub MCP: yapısal data lazımsa
• Token’ları .mcp.json yerine env’de tut

Sırada ne var?

Modül 4’e geçiyoruz — Hooks: Claude Code’un yaşam döngüsündeki belirli noktalara kendi script’lerini takmak. Önce kavramsal giriş.