📅 3 Mayıs 2026 Lokasyon: --channels, plugin-based Anthropic docs ↗

Reference

Channels beta — Olayları çalışan bir oturuma itmek (Push events into a running session with channels)

Channels, Claude Code oturumunuza bir MCP sunucusu üzerinden mesaj, uyarı ve webhook itmenizi sağlar. CI sonuçlarını, sohbet mesajlarını ve izleme olaylarını iletin, böylece siz uzaktayken Claude tepki verebilir.

Not: Channels araştırma önizlemesi (research preview) aşamasındadır ve Claude Code v2.1.80 veya sonrasını gerektirir. Anthropic kimlik doğrulaması (claude.ai veya Console API anahtarı) gerektirir; Amazon Bedrock, Google Vertex AI veya Microsoft Foundry'de kullanılamaz. Takım ve Kurumsal organizasyonların özelliği açıkça etkinleştirmesi gerekir.

Bir kanal (channel), çalışan Claude Code oturumunuza olayları iten bir MCP sunucusudur. Böylece Claude, terminal başında olmadığınız zamanlarda gerçekleşen olaylara tepki verebilir. Kanallar çift yönlü olabilir: Claude olayı okur ve aynı kanal üzerinden yanıt verir (örneğin bir sohbet köprüsü gibi). Olaylar yalnızca oturum açıkken gelir; sürekli açık bir kurulum için Claude'u bir arka plan işlemi (background process) veya kalıcı terminalde çalıştırırsınız.

Bir kanalı eklenti (plugin) olarak kurar ve kendi kimlik bilgilerinizle yapılandırırsınız. Araştırma önizlemesinde Telegram, Discord ve iMessage desteklenmektedir. Claude bir kanal üzerinden yanıt verdiğinde, terminalde gelen mesajı değil, araç çağrısını ve bir onayı (örneğin "gönderildi") görürsünüz; gerçek yanıt diğer platformda görünür.

Bu sayfa şunları kapsar:

Kendi kanalınızı oluşturmak için Channels referansına bakın.


Desteklenen kanallar (Supported channels)

Desteklenen her kanal bir eklentidir ve Bun gerektirir. Gerçek bir platforma bağlanmadan önce eklenti akışını denemek için fakechat hızlı başlangıcını deneyin.

Telegram

  1. Telegram botu oluşturun: BotFather'da /newbot gönderin, bir görünen ad ve bot ile biten benzersiz bir kullanıcı adı verin. BotFather'ın döndürdüğü token'ı kopyalayın.
  2. Eklentiyi kurun: Claude Code'da /plugin install telegram@claude-plugins-official çalıştırın. Eklenti bulunamazsa, önce /plugin marketplace update claude-plugins-official veya /plugin marketplace add anthropics/claude-plugins-official ile marketi güncelleyin, ardından /reload-plugins ile etkinleştirin.
  3. Token'ı yapılandırın: /telegram:configure <token> komutunu çalıştırın. Bu, token'ı ~/.claude/channels/telegram/.env dosyasına kaydeder. Alternatif olarak, Claude Code'u başlatmadan önce TELEGRAM_BOT_TOKEN ortam değişkenini ayarlayabilirsiniz.
  4. Kanallar etkinken yeniden başlatın: Claude Code'u kapatın ve --channels bayrağıyla yeniden başlatın: claude --channels plugin:telegram@claude-plugins-official
  5. Hesabınızı eşleştirin: Telegram'da botunuza herhangi bir mesaj gönderin. Bot bir eşleştirme koduyla yanıt verir. Claude Code'da /telegram:access pair <code> çalıştırın. Ardından erişimi kısıtlamak için /telegram:access policy allowlist komutunu kullanın.

Discord

  1. Discord botu oluşturun: Discord Developer Portal'da "New Application" oluşturun, Bot bölümünde "Reset Token" ile token'ı kopyalayın.
  2. Message Content Intent'i etkinleştirin: Bot ayarlarında "Privileged Gateway Intents" altında "Message Content Intent"i açın.
  3. Botu sunucunuza davet edin: OAuth2 > URL Generator'da bot kapsamını seçin ve şu izinleri ekleyin: View Channels, Send Messages, Send Messages in Threads, Read Message History, Attach Files, Add Reactions. Oluşturulan URL'yi kullanarak botu sunucunuza ekleyin.
  4. Eklentiyi kurun: /plugin install discord@claude-plugins-official
  5. Token'ı yapılandırın: /discord:configure <token>
  6. Kanallar etkinken yeniden başlatın: claude --channels plugin:discord@claude-plugins-official
  7. Hesabınızı eşleştirin: Discord'da botunuza DM gönderin, eşleştirme kodunu alın, /discord:access pair <code> ile onaylayın ve /discord:access policy allowlist ile kısıtlayın.

iMessage

iMessage kanalı, Mesajlar veritabanınızı doğrudan okur ve AppleScript aracılığıyla yanıt gönderir. macOS gerektirir; bot token'ı veya harici servis gerekmez.

  1. Tam Disk Erişimi (Full Disk Access) verin: ~/Library/Messages/chat.db dosyası macOS tarafından korunur. İlk okumada macOS izin ister; "Allow"a tıklayın. İzin istemi gelmezse veya "Don't Allow"a tıkladıysanız, Sistem Ayarları > Gizlilik ve Güvenlik > Tam Disk Erişimi'nden terminalinizi ekleyin.
  2. Eklentiyi kurun: /plugin install imessage@claude-plugins-official
  3. Kanallar etkinken yeniden başlatın: claude --channels plugin:imessage@claude-plugins-official
  4. Kendinize mesaj atın: Herhangi bir cihazdan Mesajlar uygulamasında kendinize bir mesaj gönderin. Kendi kendine sohbet (self-chat) erişim kontrolünü atlar. Claude'un ilk yanıtı, macOS Otomasyon izni isteyebilir; "OK"e tıklayın.
  5. Diğer göndericilere izin verin: Varsayılan olarak yalnızca kendi mesajlarınız geçer. Başka bir kişiye izin vermek için: /imessage:access allow +15551234567 (telefon numarası + ülke kodu formatında) veya user@example.com (Apple ID e-postası).

Hızlı başlangıç (Quickstart)

Fakechat, resmi olarak desteklenen bir demo kanalıdır. Localhost'ta bir sohbet arayüzü çalıştırır; kimlik doğrulama veya harici servis yapılandırması gerektirmez. Kurup etkinleştirdikten sonra tarayıcıya yazdığınız mesaj Claude Code oturumunuza ulaşır; Claude yanıt verir ve yanıt tarayıcıda görünür.

Gereksinimler:

Adımlar:

  1. Eklentiyi kurun: /plugin install fakechat@claude-plugins-official
  2. Kanalla yeniden başlatın: claude --channels plugin:fakechat@claude-plugins-official (birden fazla eklenti boşlukla ayrılabilir)
  3. Mesaj gönderin: Tarayıcıda http://localhost:8787 adresini açın ve bir mesaj yazın (örneğin: hey, what's in my working directory?). Mesaj <channel source="fakechat"> olayı olarak gelir. Claude işi yapar ve yanıt sohbet arayüzünde görünür.

Not: Claude bir izin istemiyle karşılaşırsa ve siz terminalde değilseniz, oturum siz yanıt verene kadar bekler. Kanal sunucusu "permission relay" yeteneğini bildirirse, bu istemler size iletilebilir. Kesintisiz kullanım için --dangerously-skip-permissions bayrağı kullanılabilir (yalnızca güvenilir ortamlarda). Kanalları etkileşimsiz modda (-p) çalıştırırken, terminal girdisi gerektiren araçlar (çoktan seçmeli sorular, plan modu onayı) devre dışı bırakılır.


Güvenlik (Security)

Her onaylı kanal eklentisi bir gönderici beyaz listesi (sender allowlist) tutar: yalnızca eklediğiniz kimlikler mesaj gönderebilir; diğerleri sessizce reddedilir.

Ek olarak:


Kurumsal kontroller (Enterprise controls)

Yöneticiler, kullanıcıların geçersiz kılamayacağı iki yönetilen ayar ile kullanılabilirliği kontrol eder. Varsayılan, kimlik doğrulama yöntemine bağlıdır:

Ayar Amaç Varsayılan / Not
channelsEnabled Ana anahtar. true olmalı ki kanallar mesaj iletebilsin. claude.ai Takım/Kurumsal: kanallar engellenir. Console: varsayılan olarak izin verilir (organizasyon yönetilen ayar dağıtmıyorsa).
allowedChannelPlugins Hangi eklentilerin kayıt olabileceğini belirler. Ayarlanmazsa Anthropic varsayılan listesi kullanılır. channelsEnabled: true gerektirir.

Pro ve Max kullanıcıları (organizasyonsuz) bu kontrolleri atlar; kanallar kullanılabilir ve kullanıcılar oturum başına --channels ile seçim yapar.

Organizasyonunuz için kanalları etkinleştirme

Yöneticiler, claude.ai → Admin settings → Claude Code → Channels üzerinden veya channelsEnabled değerini true olarak ayarlayarak kanalları etkinleştirebilir. Etkinleştirildiğinde, kullanıcılar --channels ile kanal sunucularını oturumlarına ekleyebilir. Ayar kapalıysa veya ayarlanmamışsa, MCP sunucusu bağlanır ve araçları çalışır ancak kanal mesajları ulaşmaz; başlangıçta bir uyarı gösterilir.

Hangi kanal eklentilerinin çalışabileceğini kısıtlama

Varsayılan olarak, Anthropic tarafından yönetilen beyaz listedeki herhangi bir eklenti kanal olarak kayıt olabilir. Takım ve Kurumsal plan yöneticileri, allowedChannelPlugins ayarını kullanarak bu listeyi kendi listeleriyle değiştirebilir. Örnek yapılandırma:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

Araştırma önizlemesi (Research preview)

Channels, araştırma önizlemesi aşamasındadır. Kullanılabilirlik kademeli olarak yayılmaktadır ve --channels bayrak sözdizimi ile protokol sözleşmesi geri bildirime göre değişebilir.

Önizleme sırasında --channels yalnızca Anthropic tarafından yönetilen beyaz listedeki veya yönetici tarafından allowedChannelPlugins ile belirlenen eklentileri kabul eder. claude-plugins-official içindeki kanal eklentileri varsayılan onaylı kümedir. İzin verilmeyen bir eklenti geçirilirse, Claude Code normal başlar ancak kanal kaydolmaz ve başlangıç bildirimi nedeni açıklar.

Kendi kanalınızı test etmek için --dangerously-load-development-channels kullanın. Geliştirme aşamasındaki özel kanalları test etme hakkında bilgi için Channels referansına bakın.

Sorunları veya geri bildirimleri Claude Code GitHub deposuna bildirin.


Kanallar nasıl karşılaştırılır (How channels compare)

Birkaç Claude Code özelliği, terminal dışındaki sistemlere bağlanır; her biri farklı bir iş türü için uygundur:

Özellik Ne yapar Ne zaman iyi
Claude Code on the web GitHub'dan klonlanmış taze bir bulut sanal alanında görev çalıştırır Kendi kendine yeten, eşzamansız işleri devretmek ve sonra kontrol etmek
Claude in Slack Bir kanal veya konuşmadaki @Claude bahsinden web oturumu başlatır Görevleri doğrudan takım sohbet bağlamından başlatmak
Standart MCP sunucusu Claude bir görev sırasında sorgular; oturuma hiçbir şey itilmez Claude'a isteğe bağlı okuma/sorgulama erişimi vermek
Remote Control claude.ai veya Claude mobil uygulamasından yerel oturumunuzu yönlendirirsiniz Devam eden bir oturumu masa başında değilken yönlendirmek
Channels Claude dışı kaynaklardan gelen olayları halihazırda çalışan yerel oturuma iter Sohbet köprüsü (Telegram/Discord/iMessage üzerinden) veya webhook alıcısı (CI, hata izleyici, dağıtım hattı)

Kanallar, bu listedeki boşluğu doldurur: Claude dışı kaynaklardan gelen olayları halihazırda çalışan yerel oturuma iterler.


Sonraki adımlar (Next steps)

Bir kanal çalıştırdıktan sonra şu ilgili özellikleri keşfedin:


Örnek kullanım senaryosu

Senaryo: Bir yazılım geliştiricisi, CI hattı başarısız olduğunda Telegram üzerinden anında bildirim almak ve Claude'un hatayı otomatik olarak analiz etmesini istiyor.

  1. Geliştirici, Telegram'da BotFather ile bir bot oluşturur ve token'ı alır.
  2. Claude Code'da /plugin install telegram@claude-plugins-official ile Telegram eklentisini kurar.
  3. /telegram:configure <token> ile bot token'ını yapılandırır.
  4. Claude Code'u claude --channels plugin:telegram@claude-plugins-official ile yeniden başlatır.
  5. Telegram'da botuna "merhaba" yazar; bot eşleştirme kodu döndürür.
  6. Claude Code'da /telegram:pair <code> ile hesabını eşleştirir ve /telegram:access policy allowlist ile erişimi kısıtlar.
  7. CI sistemi (GitHub Actions), başarısız bir build sonrası Telegram botuna bir mesaj gönderecek şekilde yapılandırılır: "Build failed: main branch, test suite error in auth module".
  8. Mesaj, Claude Code oturumuna <channel source="telegram"> olayı olarak ulaşır. Claude, çalışma dizinindeki logları ve test çıktılarını okur, hatayı analiz eder ve Telegram üzerinden "Hata, JWT token doğrulamasında zaman aşımından kaynaklanıyor. auth.go:45 satırında tokenExpired kontrolü eklenmeli." şeklinde yanıt verir.
  9. Geliştirici, telefonda bu yanıtı görür ve düzeltmeyi yapmak üzere bilgisayarına döner.