Configurer les channels de Claude Code avec Telegram

Ce que sont les channels

Un channel est un serveur MCP. Il envoie des événements dans une session Claude Code déjà lancée. Il peut fonctionner dans les deux sens. Claude lit le message, travaille, et répond dans le même chat. La documentation d’Anthropic cite Telegram, Discord et iMessage dans la research preview (code.claude.com/docs/en/channels, octobre 2026).

C’est différent de Remote Control. Remote Control vous permet de piloter votre session depuis l’app Claude. Les channels font entrer des messages d’autres plateformes, et aussi des webhooks, comme un run CI en échec.

Prérequis

• Claude Code connecté avec un compte claude.ai ou une clé API Console. Les channels ne fonctionnent pas sur Amazon Bedrock, Google Cloud ni Microsoft Foundry.
• Sur les offres Team et Enterprise, un administrateur doit d’abord activer les channels. Les utilisateurs Pro et Max sans organisation peuvent s’en servir directement. La documentation précise aussi que le déploiement se fait progressivement.
• Bun. Les plugins de channel sont des scripts Bun.
• Un jeton de bot Telegram obtenu auprès de BotFather, pour le channel Telegram.

Installer les éléments

Installez Claude Code et Bun avec leurs scripts officiels.

curl -fsSL https://claude.ai/install.sh | bash
curl -fsSL https://bun.com/install | bash

Dans Telegram, ouvrez BotFather et envoyez la commande newbot. Choisissez un nom et un nom d’utilisateur qui finit par bot. Copiez le jeton renvoyé. Installez ensuite le plugin. Dans Claude Code, c’est une commande slash.

/plugin install telegram@claude-plugins-official

Depuis un shell classique, la CLI des plugins fait la même chose. Si la marketplace manque, ajoutez-la d’abord.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install telegram@claude-plugins-official

Nous les avons lancées sur une machine macOS 26 hébergée par GitHub, le 2 octobre 2026, sans être connectés. L’installation a fonctionné. Voici ce qu’elle a affiché.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Connecter le bot et l’appairer

Dans Claude Code, enregistrez votre jeton. Il est stocké dans le dossier telegram, sous channels, dans votre dossier de config Claude.

/telegram:configure <token>

Quittez, puis relancez Claude Code depuis le shell avec l’option channel.

claude --channels plugin:telegram@claude-plugins-official

Envoyez n’importe quel message à votre bot. Il répond avec un code d’appairage. Approuvez le code dans Claude Code, puis limitez le bot à votre seul compte.

/telegram:access pair <code>
/telegram:access policy allowlist

Deux choses déroutent ici. L’option channel n’apparaît pas dans l’aide pendant la preview, mais elle fonctionne. Et le terminal affiche le message reçu et une note d’envoi, pas le texte de la réponse. La réponse apparaît dans Telegram.

Discord au lieu de Telegram

Les étapes Discord suivent le même schéma. Créez une application dans le Discord Developer Portal et copiez le jeton du bot. Activez Message Content Intent. Invitez le bot sur votre serveur avec le droit de voir les salons, d’envoyer des messages et de lire l’historique. Ensuite installez, configurez et appairez de la même façon. La ligne de redémarrage se lance dans le shell. Les autres lignes se lancent dans Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Vous pouvez passer plusieurs plugins à l’option channels, séparés par des espaces. Une seule session peut alors écouter les deux apps.

Garder la session ouverte jour et nuit

Les événements n’atteignent qu’une session ouverte. Fermez le terminal, laissez le Mac se mettre en veille ou redémarrez, et le bot se tait. Trois choses règlent ce problème. Désactivez la veille. Lancez Claude Code dans tmux. Démarrez cette session tmux à l’ouverture de session.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Ce LaunchAgent démarre une session tmux nommée channels avec Claude Code et le channel Telegram. Il vérifie chaque minute et ne fait rien si la session existe déjà. Enregistrez-le sous le nom dev.local.claude-channels.plist dans votre dossier LaunchAgents.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Installez d’abord tmux si vous ne l’avez pas. Chargez ensuite l’agent et attachez-vous à la session pour vérifier Claude.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Nous avons testé ce fichier exact sur une machine macOS 26 hébergée par GitHub, le 2 octobre 2026. Vingt secondes après son chargement, launchd avait créé la session dans le dossier personnel, avec Claude Code en attente à l’intérieur.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

La session démarre dans votre dossier personnel. Remplacez la variable du dossier personnel par le chemin de votre projet si vous voulez que Claude démarre là. La première fois, attachez-vous, répondez aux questions du premier lancement et connectez-vous.

Un autre blocage est à prévoir. Si Claude tombe sur une demande de permission pendant votre absence, la session vous attend. La documentation mentionne une option pour sauter les permissions sur les machines de confiance. Lisez faire tourner Claude Code sans surveillance en sécurité avant de l’utiliser.

Notes de sécurité

• Chaque channel garde une liste d’expéditeurs autorisés. Les messages de toute autre personne sont ignorés sans bruit.
• Toute personne de la liste peut piloter votre session. Si le plugin relaie les demandes de permission, elle peut aussi approuver l’usage d’outils. N’ajoutez que des personnes à qui vous confieriez votre machine.
• Votre jeton de bot est un mot de passe. S’il fuite, révoquez-le dans BotFather et configurez le nouveau.
• iMessage lit la base de données de Messages et demande l’accès complet au disque. Sur un Mac loué, cela veut dire connecter votre identifiant Apple à Messages sur un matériel qui n’est pas à vous. Telegram ou Discord évitent ce problème.

Le faire tourner sur un Mac MacRun

Notre offre Agent a déjà Claude Code installé. Vous le connectez avec votre propre abonnement Claude. Le Mac ne se met jamais en veille et sa session survit aux redémarrages. Vous ajoutez Bun et le plugin, ce qui prend quelques minutes. Vous pouvez ensuite fermer votre portable, et le bot répond toujours.

Qui n’en a pas besoin. Si vous voulez seulement piloter une session depuis votre téléphone, Remote Control dans l’app Claude le fait sans bot. Et si l’administrateur de votre offre Team n’a pas activé les channels, un nouveau Mac n’y changera rien.

Pour une vue d’ensemble, lisez faire tourner Claude Code 24/7 sur un Mac.