Slack

Claude Code in Slack

Claude Code'u doğrudan Slack çalışma alanınızdan kullanarak kodlama görevlerini devredebilirsiniz. @Claude ile bir kodlama talebi gönderdiğinizde, Claude otomatik olarak niyeti algılar ve web üzerinde bir Claude Code oturumu oluşturur. Bu sayede ekip sohbetlerinizden ayrılmadan geliştirme çalışmalarını başlatabilirsiniz.

Bu entegrasyon, mevcut Claude for Slack uygulaması üzerine inşa edilmiştir ve kodlama taleplerini Claude Code on the web'e yönlendiren akıllı bir yönlendirme katmanı ekler.

Kullanım alanları (Use cases)

• Hata inceleme ve düzeltme: Slack kanallarında raporlanan hataları anında inceleyip düzeltilmesini isteyin.
• Hızlı kod inceleme ve değişiklik: Ekip geri bildirimlerine dayanarak küçük özellikler ekleyin veya kod yeniden düzenlemesi yapın.
• İşbirlikçi hata ayıklama: Ekip tartışmaları hata tekrarlama adımları veya kullanıcı raporları gibi kritik bağlam sağladığında, Claude bu bilgiyi hata ayıklama yaklaşımını şekillendirmek için kullanabilir.
• Paralel görev yürütme: Slack üzerinden kodlama görevleri başlatırken siz başka işlerinize devam edin; tamamlandığında bildirim alın.

Ön koşullar (Prerequisites)

Slack'te Claude Code'u kurmak (Setting up Claude Code in Slack)

1. Claude Uygulamasını Slack'e yükleyin

Bir çalışma alanı yöneticisi, Claude uygulamasını Slack Uygulama Pazarı'ndan yüklemelidir. Slack App Marketplace sayfasını ziyaret edin ve "Add to Slack" butonuna tıklayarak kurulum sürecini başlatın.

2. Claude hesabınızı bağlayın

Uygulama yüklendikten sonra bireysel Claude hesabınızın kimliğini doğrulayın:

• Slack'te "Uygulamalar" bölümünden Claude uygulamasını açın
• "App Home" sekmesine gidin
• "Connect" butonuna tıklayarak Slack hesabınızı Claude hesabınıza bağlayın
• Tarayıcınızda kimlik doğrulama akışını tamamlayın

3. Claude Code on the web'i yapılandırın

Claude Code on the web'in doğru yapılandırıldığından emin olun:

• claude.ai/code adresini ziyaret edin ve Slack'e bağladığınız hesapla oturum açın
• GitHub hesabınızı bağlayın (henüz bağlı değilse)
• Claude'un çalışmasını istediğiniz en az bir deponun kimlik doğrulamasını yapın

4. Yönlendirme modunuzu seçin (Routing mode)

Hesaplarınızı bağladıktan sonra, Slack'teki Claude App Home sayfasına giderek "Routing Mode" ayarını yapılandırın.

Code + Chat modunda, Claude bir mesajı Chat'e yönlendirirse ancak siz kodlama oturumu istiyorsanız, "Retry as Code" butonuna tıklayarak bir Claude Code oturumu oluşturabilirsiniz. Benzer şekilde, Code'a yönlendirilmiş ancak Chat istiyorsanız, ilgili iş parçacığında bu seçeneği kullanabilirsiniz.

5. Claude'u kanallara ekleyin

Claude, kurulumdan sonra otomatik olarak hiçbir kanala eklenmez. Claude'u bir kanalda kullanmak için o kanalda /invite @Claude yazın. Claude yalnızca eklendiği kanallardaki @mention'lara yanıt verebilir.

Nasıl çalışır (How it works)

Otomatik algılama (Automatic detection)

Bir Slack kanalında veya iş parçacığında @Claude ile bahsettiğinizde, Claude mesajınızı otomatik olarak analiz eder ve kodlama görevi olup olmadığını belirler. Kodlama niyeti algılarsa, talebinizi normal bir sohbet asistanı yerine Claude Code on the web'e yönlendirir. Ayrıca, otomatik algılamasa bile bir talebi açıkça kodlama görevi olarak ele almasını söyleyebilirsiniz.

Not: Claude Code in Slack yalnızca kanallarda (genel veya özel) çalışır. Doğrudan mesajlarda (DM) çalışmaz.

Bağlam toplama (Context gathering)

• İş parçacıklarından: Bir iş parçacığında @Claude ile bahsettiğinizde, konuşmanın tamamını anlamak için o iş parçacığındaki tüm mesajlardan bağlam toplar.
• Kanallardan: Doğrudan bir kanalda bahsedildiğinde, ilgili bağlam için son kanal mesajlarına bakar.

Bu bağlam, Claude'un sorunu anlamasına, uygun depoyu seçmesine ve göreve yaklaşımını şekillendirmesine yardımcı olur.

Uyarı: @Claude Slack'te çağrıldığında, Claude talebinizi daha iyi anlamak için konuşma bağlamına erişir. Claude, bağlamdaki diğer mesajlardan gelen yönergeleri takip edebilir, bu nedenle kullanıcılar Claude'u yalnızca güvenilir Slack konuşmalarında kullanmalıdır.

Oturum akışı (Session flow)

1. Başlatma: @Claude ile kodlama talebinde bulunursunuz
2. Algılama: Claude mesajınızı analiz eder ve kodlama niyetini algılar
3. Oturum oluşturma: claude.ai/code üzerinde yeni bir Claude Code oturumu oluşturulur
4. İlerleme güncellemeleri: Claude, çalışma ilerledikçe Slack iş parçacığınıza durum güncellemeleri gönderir
5. Tamamlama: İş bittiğinde, sizi @mention ile etiketler ve bir özet ile eylem butonları sunar
6. İnceleme: "View Session" ile tam transkripti görebilir veya "Create PR" ile bir çekme isteği açabilirsiniz

Kullanıcı arayüzü öğeleri (User interface elements)

App Home

App Home sekmesi, bağlantı durumunuzu gösterir ve Claude hesabınızı Slack'ten bağlamanıza veya bağlantıyı kesmenize olanak tanır.

Mesaj eylemleri (Message actions)

Depo seçimi (Repository selection)

Claude, Slack konuşmanızdaki bağlama göre otomatik olarak bir depo seçer. Birden fazla depo uygulanabilirse, Claude doğru olanı seçmeniz için bir açılır menü gösterebilir.

Erişim ve izinler (Access and permissions)

Kullanıcı düzeyinde erişim (User-level access)

Çalışma alanı düzeyinde erişim (Workspace-level access)

Slack çalışma alanı yöneticileri, Claude uygulamasının çalışma alanlarında kullanılabilir olup olmadığını kontrol eder:

Kanal tabanlı erişim kontrolü (Channel-based access control)

Claude, kurulumdan sonra otomatik olarak hiçbir kanala eklenmez. Kullanıcılar, Claude'u kullanmak istedikleri kanallara açıkça davet etmelidir:

• Davet gerekli: Claude'u bir kanala eklemek için /invite @Claude yazın
• Kanal üyeliği erişimi kontrol eder: Claude yalnızca eklendiği kanallardaki @mention'lara yanıt verebilir
• Kanallar aracılığıyla erişim denetimi: Yöneticiler, Claude'un hangi kanallara davet edildiğini ve bu kanallara kimlerin erişebildiğini yöneterek Claude Code kullanımını kontrol edebilir
• Özel kanal desteği: Claude hem genel hem de özel kanallarda çalışır, bu da ekiplere görünürlük kontrolünde esneklik sağlar

Bu kanal tabanlı model, ekiplerin Claude Code kullanımını belirli kanallarla sınırlamasına olanak tanır ve çalışma alanı düzeyindeki izinlerin ötesinde ek bir erişim kontrol katmanı sağlar.

Nerede neye erişilir (What's accessible where)

Slack'te: Durum güncellemeleri, tamamlama özetleri ve eylem butonlarını görürsünüz. Tam transkript korunur ve her zaman erişilebilirdir.

Web'de: Tam Claude Code oturumu; tüm konuşma geçmişi, tüm kod değişiklikleri, dosya işlemleri ve oturuma devam etme veya çekme isteği oluşturma yeteneği.

Enterprise ve Team hesapları için, Slack'ten oluşturulan oturumlar otomatik olarak organizasyon tarafından görülebilir. Daha fazla bilgi için Claude Code on the Web paylaşım dokümantasyonuna bakın.

En iyi uygulamalar (Best practices)

Etkili talepler yazmak (Writing effective requests)

• Spesifik olun: İlgili dosya adlarını, fonksiyon adlarını veya hata mesajlarını ekleyin
• Bağlam sağlayın: Konuşmadan net değilse depo veya projeden bahsedin
• Başarıyı tanımlayın: "Tamamlandı"nın ne anlama geldiğini açıklayın — test yazmalı mı? Dokümantasyon güncellemeli mi? PR oluşturmalı mı?
• İş parçacıklarını kullanın: Hataları veya özellikleri tartışırken iş parçacıklarında yanıtlayın ki Claude tam bağlamı toplayabilsin

Slack vs. web ne zaman kullanılır (When to use Slack vs. web)

Slack'i kullanın: Bağlam zaten bir Slack tartışmasında mevcutsa, bir görevi asenkron olarak başlatmak istiyorsanız veya görünürlüğe ihtiyaç duyan ekip arkadaşlarınızla işbirliği yapıyorsanız.

Web'i doğrudan kullanın: Dosya yüklemeniz gerekiyorsa, geliştirme sırasında gerçek zamanlı etkileşim istiyorsanız veya daha uzun, daha karmaşık görevler üzerinde çalışıyorsanız.

Sorun giderme (Troubleshooting)

Oturumlar başlamıyor

• Claude hesabınızın Claude App Home'da bağlı olduğunu doğrulayın
• Claude Code on the web erişiminizin etkin olduğunu kontrol edin
• Claude Code'a en az bir GitHub deposu bağladığınızdan emin olun

Depo görünmüyor

• Depoyu claude.ai/code adresinde Claude Code on the web'e bağlayın
• GitHub izinlerinizi kontrol edin
• GitHub hesabınızın bağlantısını kesip yeniden bağlamayı deneyin

Yanlış depo seçildi

• Farklı bir depo seçmek için "Change Repo" butonuna tıklayın
• Daha doğru seçim için talebinize depo adını ekleyin

Kimlik doğrulama hataları

• App Home'da Claude hesabınızın bağlantısını kesip yeniden bağlayın
• Tarayıcınızda doğru Claude hesabına giriş yaptığınızdan emin olun
• Claude planınızın Claude Code erişimi içerdiğini kontrol edin

Oturum süresi doldu

• Oturumlar web'de Claude Code geçmişinizde erişilebilir durumda kalır
• claude.ai/code adresinden geçmiş oturumlara devam edebilir veya bunlara başvurabilirsiniz

Mevcut sınırlamalar (Current limitations)

• Yalnızca GitHub: Şu anda yalnızca GitHub'daki depoları destekler
• Her seferde bir PR: Her oturum bir çekme isteği oluşturabilir
• Hız sınırları geçerli: Oturumlar, bireysel Claude planınızın hız sınırlarını kullanır
• Web erişimi gerekli: Kullanıcıların Claude Code on the web erişimi olmalıdır; olmayanlar yalnızca standart Claude sohbet yanıtları alır

İlgili kaynaklar (Related resources)

• Claude Code on the web — Claude Code on the web hakkında daha fazla bilgi
• Claude for Slack — Genel Claude for Slack dokümantasyonu
• Slack App Marketplace — Claude uygulamasını Slack Pazarı'ndan yükleyin
• Claude Help Center — Ek destek alın

Örnek kullanım senaryosu

Senaryo: Bir yazılım ekibi, Slack kanalında canlı ortamda bir hata raporu alır. Ekip üyesi Ali, hatayı Slack'te #backend kanalında şöyle bildirir: "Kullanıcı profili güncelleme API'si 500 hatası döndürüyor, user_id parametresi eksik görünüyor."

Adımlar:

1. Takım lideri Ayşe, #backend kanalında iş parçacığı oluşturur ve @Claude'a şu mesajı yazar: "@Claude user-service reposunda kullanıcı profili güncelleme API'sindeki 500 hatasını incele. Hata user_id parametresi eksik olduğunda oluşuyor. Hatayı düzelt ve bir PR oluştur."

2. Claude, mesajı analiz eder ve kodlama niyeti algılar. claude.ai/code üzerinde yeni bir oturum başlatır.

3. Slack iş parçacığında Claude'dan bir durum güncellemesi gelir: "🔍 user-service reposunu analiz ediyorum, updateProfile fonksiyonunda user_id doğrulaması eksik."

4. Birkaç dakika sonra Claude, Ayşe'yi @mention ile etiketler ve bir özet gönderir: "✅ Hata düzeltildi. updateProfile fonksiyonuna user_id doğrulaması eklendi. fix-missing-user-id-validation dalında değişiklikler hazır."

5. Ayşe, mesajdaki "View Session" butonuna tıklayarak web'de tam oturum transkriptini açar ve yapılan değişiklikleri inceler.

6. Değişikliklerden memnun kalırsa "Create PR" butonuna tıklayarak doğrudan bir çekme isteği oluşturur.

7. Ekip üyeleri, Slack'teki iş parçacığından PR bağlantısını görür ve incelemeye başlar.