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:
- Desteklenen kanallar: Telegram, Discord ve iMessage kurulumu
- Hızlı başlangıç:
fakechatile bir kanal kurma ve çalıştırma (localhost demo) - Kimler mesaj gönderebilir: gönderici beyaz listesi (sender allowlist) ve eşleştirme (pairing)
- Kurumsal kontroller: Takım, Kurumsal veya Console organizasyonu yönetiyorsanız kanalları etkinleştirme
- Karşılaştırma: Kanalların web oturumları, Slack, MCP ve Remote Control ile karşılaştırması
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
- Telegram botu oluşturun: BotFather'da
/newbotgönderin, bir görünen ad vebotile biten benzersiz bir kullanıcı adı verin. BotFather'ın döndürdüğü token'ı kopyalayın. - Eklentiyi kurun: Claude Code'da
/plugin install telegram@claude-plugins-officialçalıştırın. Eklenti bulunamazsa, önce/plugin marketplace update claude-plugins-officialveya/plugin marketplace add anthropics/claude-plugins-officialile marketi güncelleyin, ardından/reload-pluginsile etkinleştirin. - Token'ı yapılandırın:
/telegram:configure <token>komutunu çalıştırın. Bu, token'ı~/.claude/channels/telegram/.envdosyasına kaydeder. Alternatif olarak, Claude Code'u başlatmadan önceTELEGRAM_BOT_TOKENortam değişkenini ayarlayabilirsiniz. - Kanallar etkinken yeniden başlatın: Claude Code'u kapatın ve
--channelsbayrağıyla yeniden başlatın:claude --channels plugin:telegram@claude-plugins-official - 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 allowlistkomutunu kullanın.
Discord
- Discord botu oluşturun: Discord Developer Portal'da "New Application" oluşturun, Bot bölümünde "Reset Token" ile token'ı kopyalayın.
- Message Content Intent'i etkinleştirin: Bot ayarlarında "Privileged Gateway Intents" altında "Message Content Intent"i açın.
- Botu sunucunuza davet edin: OAuth2 > URL Generator'da
botkapsamı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. - Eklentiyi kurun:
/plugin install discord@claude-plugins-official - Token'ı yapılandırın:
/discord:configure <token> - Kanallar etkinken yeniden başlatın:
claude --channels plugin:discord@claude-plugins-official - 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 allowlistile 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.
- Tam Disk Erişimi (Full Disk Access) verin:
~/Library/Messages/chat.dbdosyası 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. - Eklentiyi kurun:
/plugin install imessage@claude-plugins-official - Kanallar etkinken yeniden başlatın:
claude --channels plugin:imessage@claude-plugins-official - 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.
- 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) veyauser@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:
- Claude Code kurulu ve
claude.aihesabı veya Console API anahtarı ile kimlik doğrulaması yapılmış - Bun kurulu (
bun --versionile kontrol edin; yoksa Bun'u kurun) - Takım/Kurumsal/Console organizasyonu: yöneticiniz kanalları etkinleştirmiş olmalı
Adımlar:
- Eklentiyi kurun:
/plugin install fakechat@claude-plugins-official - Kanalla yeniden başlatın:
claude --channels plugin:fakechat@claude-plugins-official(birden fazla eklenti boşlukla ayrılabilir) - Mesaj gönderin: Tarayıcıda
http://localhost:8787adresini 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.
- Telegram ve Discord: Eşleştirme (pairing) ile beyaz liste oluşturulur: botunuza mesaj gönderin → bot eşleştirme kodu döndürür → Claude Code'da kodu onaylayın → kimliğiniz beyaz listeye eklenir.
- iMessage: Kendinize mesaj atmak otomatik olarak geçer; diğer kişileri
/imessage:access allowile eklersiniz.
Ek olarak:
- Hangi sunucuların etkin olduğunu her oturumda
--channelsile kontrol edersiniz. - Organizasyonunuz,
claude.aiüzerindechannelsEnabledayarı ile kullanılabilirliği kontrol eder. - Bir sunucunun
.mcp.jsoniçinde olması mesaj itmek için yeterli değildir; ayrıca--channelsiçinde adlandırılması gerekir. - Beyaz liste, kanalın "permission relay" yeteneğini de kapsar. Kanal üzerinden yanıt verebilen herkes, oturumunuzdaki araç kullanımını onaylayabilir veya reddedebilir; bu nedenle beyaz listeye yalnızca güvendiğiniz göndericileri ekleyin.
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" }
]
}
allowedChannelPluginsayarlandığında, Anthropic listesini tamamen değiştirir; yalnızca listelenen eklentiler kayıt olabilir.- Boş dizi (
[]) tüm kanal eklentilerini engeller, ancak--dangerously-load-development-channelsyerel test için bunu aşabilir. - Kanalları
--dangerously-load-development-channelsdahil tamamen engellemek içinchannelsEnabledayarını boş bırakın. - Kullanıcı izin verilmeyen bir eklentiyi
--channelsile geçirirse, Claude Code normal başlar ancak kanal kaydolmaz ve başlangıç bildirimi nedeni açıklar.
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.
- Sohbet köprüsü: Telefonunuzdan Telegram, Discord veya iMessage aracılığıyla Claude'a bir şey sorun; yanıt aynı sohbette gelir, iş makinenizde gerçek dosyalarınız üzerinde çalışır.
- Webhook alıcısı: CI, hata izleyiciniz, dağıtım hattı veya başka bir harici servisten gelen webhook, Claude'un dosyalarınızın zaten açık olduğu ve neyi debug ettiğinizi hatırladığı yere ulaşır.
Sonraki adımlar (Next steps)
Bir kanal çalıştırdıktan sonra şu ilgili özellikleri keşfedin:
- Kendi kanalınızı oluşturun (henüz eklentisi olmayan sistemler için)
- Remote Control — olayları oturuma iletmek yerine telefonunuzdan yerel oturumu yönlendirin
- Zamanlanmış görevler — itilen olaylara tepki vermek yerine zamanlayıcıyla yoklama yapın
Ö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.
- Geliştirici, Telegram'da BotFather ile bir bot oluşturur ve token'ı alır.
- Claude Code'da
/plugin install telegram@claude-plugins-officialile Telegram eklentisini kurar. /telegram:configure <token>ile bot token'ını yapılandırır.- Claude Code'u
claude --channels plugin:telegram@claude-plugins-officialile yeniden başlatır. - Telegram'da botuna "merhaba" yazar; bot eşleştirme kodu döndürür.
- Claude Code'da
/telegram:pair <code>ile hesabını eşleştirir ve/telegram:access policy allowlistile erişimi kısıtlar. - 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". - 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:45satırındatokenExpiredkontrolü eklenmeli." şeklinde yanıt verir. - Geliştirici, telefonda bu yanıtı görür ve düzeltmeyi yapmak üzere bilgisayarına döner.