Pousser des événements vers une session en cours via des canaux

• Les Channels de Claude Code permettent de transmettre directement à une session en cours des messages, notifications ou webhooks provenant de systèmes externes, afin que Claude réagisse immédiatement
• Les événements sont échangés via un serveur MCP et n’arrivent que tant que la session reste ouverte, ce qui nécessite un environnement d’exécution persistant
• Telegram et Discord sont pris en charge nativement en aperçu de recherche, et une connexion à claude.ai est obligatoire ; l’authentification par clé API n’est pas possible
• Chaque canal est fourni sous forme de plugin basé sur Bun, avec possibilité de test local via fakechat
• Cette fonctionnalité sert à relier directement des événements externes à une session locale, comblant ainsi le vide entre Slack, MCP, Remote Control et les autres fonctions existantes

---

Fonction Channels pour pousser des événements vers une session en cours

• Les Channels de Claude Code permettent de transmettre directement à une session en cours les messages, alertes, webhooks, etc. provenant de systèmes externes, afin que Claude réagisse immédiatement
• Les événements sont transmis via un serveur MCP, que Claude peut lire puis utiliser pour répondre sur le même canal
• Les événements n’arrivent que tant que la session reste ouverte ; pour un usage continu, il faut donc exécuter Claude dans un processus en arrière-plan ou un terminal persistant
• Telegram et Discord sont pris en charge nativement au stade d’aperçu de recherche, avec connexion à claude.ai obligatoire
• Ni Console ni l’authentification par clé API ne sont prises en charge ; pour les organisations Team/Enterprise, un administrateur doit activer explicitement la fonctionnalité

Canaux pris en charge

• Chaque canal est fourni comme plugin basé sur Bun, et peut être testé en local via fakechat
• Canaux pris en charge : Telegram, Discord

• Procédure de configuration de Telegram

  • Créer un bot avec la commande /newbot dans BotFather, puis copier le token
  • Installer le plugin dans Claude Code avec la commande /plugin install telegram@claude-plugins-official
  • Configurer le token avec /telegram:configure <token>
  • Activer le canal avec claude --channels plugin:telegram@claude-plugins-official
  • Envoyer un message au bot dans Telegram pour recevoir un code d’appairage, puis se connecter avec /telegram:access pair <code>
  • Restreindre les comptes autorisés avec /telegram:access policy allowlist

• Procédure de configuration de Discord

  • Créer une nouvelle application dans le Discord Developer Portal, puis copier le token du bot
  • Activer Message Content Intent
  • Dans OAuth2 > URL Generator, accorder le scope bot et les autorisations liées aux messages, puis inviter le bot sur le serveur
  • Installer le plugin avec /plugin install discord@claude-plugins-official
  • Configurer le token avec /discord:configure <token>
  • Lancer le canal avec claude --channels plugin:discord@claude-plugins-official
  • Envoyer un DM au bot pour recevoir un code d’appairage, puis se connecter avec /discord:access pair <code>
  • Restreindre l’accès avec /discord:access policy allowlist
  • Il est aussi possible de développer un canal personnalisé pour les systèmes sans plugin direct

Démarrage rapide

• Fakechat est le canal de démonstration officiel, exécutable en local sans authentification ni configuration externe
• Claude Code et Bun doivent être installés, et pour les utilisateurs Team/Enterprise, un administrateur doit activer la fonctionnalité Channels
• Installer avec /plugin install fakechat@claude-plugins-official, puis lancer avec claude --channels plugin:fakechat@claude-plugins-official
• Ouvrir http://localhost:8787 dans le navigateur puis saisir un message pour le transmettre à la session Claude Code
• Les réponses de Claude s’affichent dans l’interface du navigateur ; si une demande d’autorisation survient, elle doit être approuvée dans le terminal
• En exécution sans supervision, l’option --dangerously-skip-permissions permet d’ignorer les confirmations d’autorisation (usage recommandé uniquement dans un environnement de confiance)

Sécurité

• Chaque plugin de canal maintient une liste d’expéditeurs autorisés (allowlist) ; seuls les identifiants enregistrés peuvent envoyer des messages
• Telegram et Discord initialisent cette liste via un code d’appairage
  1. Envoyer un message au bot
  2. Le bot renvoie un code d’appairage
  3. Approuver le code dans la session Claude Code
  4. L’identifiant de l’expéditeur est ajouté à la liste d’autorisation
• Lors du lancement de la session, les serveurs à activer doivent être spécifiés avec --channels ; dans les offres Team/Enterprise, l’usage est contrôlé par le paramètre d’organisation channelsEnabled

Contrôles entreprise

• Le paramètre channelsEnabled permet de gérer la fonctionnalité Channels
  • Pro/Max (utilisateurs individuels) : disponible par défaut, activation session par session avec --channels
  • Team/Enterprise : désactivé par défaut ; un administrateur doit l’activer explicitement

• Activer Channels dans une organisation

  • Configuration possible via claude.ai → Admin settings → Claude Code → Channels
  • Ou en définissant channelsEnabled: true dans les paramètres d’administration
  • Une fois activé, les utilisateurs peuvent ajouter des serveurs de canal à des sessions individuelles avec l’option --channels
  • À l’état désactivé, la connexion au serveur MCP reste maintenue, mais les messages de canal ne sont pas transmis

Aperçu de recherche

• Channels est une fonctionnalité en aperçu de recherche, en cours de déploiement progressif
• La syntaxe du flag --channels et le protocole peuvent évoluer selon les retours
• Pour le moment, seuls les plugins figurant sur la liste d’autorisation gérée par Anthropic peuvent être utilisés
• Si un plugin non officiel est indiqué, Claude Code s’exécute normalement mais le canal n’est pas enregistré
• Pour tester un canal en cours de développement, utiliser l’option --dangerously-load-development-channels
• Les problèmes ou retours peuvent être soumis dans le dépôt GitHub Claude Code

Comparaison entre Channels et les autres fonctionnalités

Fonctionnalité	Rôle	Cas d’usage adapté
Claude Code on the web	Exécuter du travail dans un nouveau sandbox cloud cloné depuis GitHub	Délégation de tâches asynchrones et indépendantes
Claude in Slack	Créer une session web quand @Claude est invoqué dans un canal ou un fil	Démarrer immédiatement un travail dans le contexte d’une conversation d’équipe
Serveur MCP	Claude interroge si nécessaire, sans push d’événements vers la session	Consultation de données système ou accès en lecture seule
Remote Control	Contrôler une session locale depuis claude.ai ou l’app mobile	Manipuler à distance une session en cours

• Les Channels** comblent l’espace entre ces fonctionnalités** en transmettant directement des événements externes à une session locale

  • Pont de chat : poser des questions à Claude via Telegram ou Discord, puis consulter les réponses dans la même conversation
  • Récepteur de webhooks : Claude peut recevoir immédiatement dans une session ouverte les webhooks de services externes comme la CI, les outils de suivi d’erreurs ou les pipelines de déploiement

Étapes suivantes

• Développer directement un canal pour un système sans plugin
• Utiliser Remote Control pour piloter la session à distance au lieu de simplement transmettre des événements
• Mettre en place une automatisation par sondage périodique avec Scheduled tasks