Comment contrôler Claude Code depuis votre téléphone via Telegram en 2026

Vous trouverez d’autres ressources sur la configuration des outils dans la documentation Ailoot.

Qu’est-ce que Claude Code Channels et pourquoi en avez-vous besoin ?#

Le 20 mars 2026, Anthropic a lancé Claude Code Channels, un plugin officiel qui connecte une session Claude aux applications de messagerie. Telegram, Discord et iMessage sont pris en charge. La fonctionnalité est en aperçu de recherche : la documentation se trouve à l’adresse code.claude.com/docs/en/channels, et le code source du plugin est disponible dans le dépôt ouvert anthropics/claude-plugins-official.

En bref, c’est un « pont de discussion » entre votre téléphone et votre session Claude Code. J’envoie un message au bot : « Continue de réécrire la grille tarifaire ; dans business/products/practicum/README.md, mets à jour les dates de la prochaine session », et le bot transmet le message à la session sur mon VPS. Claude récupère le contexte, modifie le fichier, valide les changements et répond sur Telegram : « C’est fait, vérifie le commit. » L’ordinateur portable reste fermé à la maison.

⚠️ La principale limite de l’aperçu de recherche : Channels est un pont MCP. La session doit être en cours d’exécution sur votre machine ou votre VPS. Lorsque la session est fermée, personne ne reçoit les messages. C’est pourquoi le fonctionnement 24 h/24 doit être configuré séparément (voir la section VPS ci-dessous).

En quoi Channels diffère des autres façons de travailler à distance

Dans sa documentation officielle, Anthropic fournit un tableau comparatif direct. En voici une adaptation :

La principale différence entre Channels et Remote Control : Remote Control, c’est « votre téléphone comme fenêtre sur le terminal » — vous voyez littéralement le curseur et appuyez sur des boutons. Channels, c’est un chatbot dont le cerveau est votre session Claude locale. Avec Remote Control, je regarde le terminal. Avec Channels, j’écris à quelqu’un qui lit mes fichiers.

Si vous avez besoin de tout contrôler à l’écran, utilisez Remote Control. Si vous voulez « envoyer une question, poursuivre votre journée et recevoir une réponse », utilisez Channels. J’utilise les deux : Remote Control quand je dois approuver des changements critiques, et Channels quand j’ai confiance dans la tâche et que je veux profiter de ma soirée.

Ce qu’il vous faut avant de commencer#

Avant de passer aux commandes, vérifiez cette liste :

1. Compte Anthropic. Il vous faut un abonnement Pro, Max, Team ou Enterprise. Channels n’est pas disponible avec l’offre gratuite. Une clé API Anthropic Console fonctionne aussi ; si l’organisation applique des réglages gérés, vérifiez que Channels y est activé.
2. Claude Code v2.1.80 ou version ultérieure. Vérifiez avec claude --version. Si la version est plus ancienne, mettez à jour avec claude update ou npm install -g @anthropic-ai/claude-code@latest.
3. Bun. Les plugins Channels sont des scripts Bun, pas des scripts Node. Vérifiez avec bun --version. S’il n’est pas installé, exécutez curl -fsSL https://bun.sh/install | bash, puis source ~/.bashrc.
4. Compte Telegram. N’importe quel compte convient ; l’essentiel est d’être connecté sur votre téléphone.
5. Si vous avez un abonnement Team/Enterprise, demandez à votre administrateur d’activer channelsEnabled dans les paramètres gérés ou via admin-settings/claude-code. Cette option est désactivée par défaut pour les organisations.

Ne vous inquiétez pas si c’est la première fois que vous entendez parler de Bun. Bun est un environnement d’exécution JavaScript alternatif, comme Node. Anthropic l’a choisi pour les plugins Channels parce qu’il démarre plus vite et se regroupe plus facilement dans un seul binaire. Installez-le une fois et n’y pensez plus.

⚠️ Channels ne fonctionne pas encore avec les environnements d’entreprise Bedrock / Google Vertex / Azure Foundry. Il fonctionne uniquement avec l’authentification claude.ai ou Anthropic Console.

Étape 1. Créer un bot Telegram avec BotFather#

BotFather fait tout le travail pour vous — vous n’avez qu’à appuyer cinq fois. Voici les étapes :

1. Ouvrez @BotFather dans Telegram (vous pouvez utiliser votre téléphone ; le reste de la configuration peut aussi se faire sur votre téléphone).
2. Appuyez sur « Start » si c’est la première fois.
3. Envoyez la commande /newbot.
4. BotFather vous demandera : « Alright, a new bot. How are we going to call it? » Saisissez le nom affiché, par exemple Mon assistant - Claude Code.
5. Ensuite, il vous demandera un nom d’utilisateur. Celui-ci doit être unique sur Telegram et se terminer par bot. Par exemple, my_claude_bot ou my_dev_bot.
6. BotFather répondra avec un message comme celui-ci :

Done! Congratulations on your new bot. You will find it at
'<OFFICIAL_URL>'.

Use this token to access the HTTP API:
1234567890:AAHzlAU...

Keep your token secure and store it safely, it can be used by anyone to control your bot.

Copiez le jeton. Vous en aurez besoin dans deux minutes.

⚠️ Sécurité du jeton. Le jeton du bot en donne le contrôle total. S’il fuite, n’importe qui pourra écrire en tant que bot et (potentiellement) intercepter les messages que vous envoyez à Claude. Ne le publiez pas dans des dépôts, ne le collez pas dans du code et ne l’envoyez pas dans des conversations. Je stocke les jetons dans ~/.claude/channels/telegram/.env ; le plugin les y placera à l’étape suivante.

Étape 2. Installer le plugin Telegram dans Claude Code#

Ouvrez un terminal dans le dossier où vous travaillez habituellement avec Claude, puis exécutez :

claude

Saisissez la commande slash dans la session :

/plugin install telegram@claude-plugins-official

Si Claude répond « Plugin not found in any marketplace », votre client ne connaît pas le marketplace officiel. Ajoutez-le :

/plugin marketplace add anthropics/claude-plugins-official

Ou mettez-le à jour si vous l’aviez déjà ajouté :

/plugin marketplace update claude-plugins-official

Après l’installation, rechargez les plugins pour activer leurs commandes :

/reload-plugins

Vous devriez maintenant disposer de commandes slash telles que /telegram:configure et /telegram:access. Pour vérifier, saisissez /help ; la liste doit inclure une section Telegram.

Étape 3. Associer le jeton au plugin#

Dans la session Claude :

/telegram:configure 1234567890:AAHzlAU...

La commande placera le jeton dans ~/.claude/channels/telegram/.env. Le fichier est accessible uniquement à votre utilisateur (chmod 600), vous n’avez donc pas à vous en inquiéter.

Vous pouvez aussi définir le jeton avec une variable d’environnement. C’est utile si vous déployez Claude avec systemd ou Docker et ne voulez pas utiliser de commandes interactives :

export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official

⚠️ En production, j’utilise toujours des variables d’environnement plutôt qu’un fichier .env dans mon répertoire personnel, ~/. Cela facilite la gestion des secrets avec systemd (Environment=TELEGRAM_BOT_TOKEN=...) et évite d’intégrer accidentellement ~/.claude/ au dépôt.

Étape 4. Redémarrer Claude avec le flag --channels#

C’est le point le plus important, et celui qui piège tout le monde au premier lancement. Installer le plugin ne suffit pas. Pour que le bot commence réellement à recevoir des messages, vous devez lancer Claude avec un flag explicite :

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

Sans ce flag, la session fonctionne comme d’habitude, mais le plugin Telegram est inactif. Avec le flag, Claude démarre le serveur MCP du plugin, commence à interroger l’API Telegram et répond aux messages envoyés au bot.

Après le lancement, vous devriez voir quelque chose comme ceci dans le terminal :

✻ Welcome to Claude Code 2.1.80
  Channels: telegram@claude-plugins-official (active)
  Polling for messages...

Si aucune ligne ne mentionne channels, le flag n’a pas été pris en compte. Vérifiez que Claude Code est en version 2.1.80+ et que le plugin est bien installé (/plugin list dans la session).

⚠️ Conseil pratique. J’ai ajouté un alias dans ~/.zshrc :

alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"

Ensuite, il me suffit d’exécuter claude-tg. Vous pouvez passer plusieurs plugins séparés par des espaces : --channels plugin:telegram@... plugin:discord@....

Étape 5. Associer le compte et bloquer tous les autres#

Cette étape concerne la sécurité. Un expéditeur approuvé peut demander des actions sur les fichiers et outils accessibles. Associez seulement le compte prévu et verrouillez sa politique avant de compter sur le bot.

Étapes :

1. Ouvrez votre bot dans Telegram. Trouvez-le avec le nom d’utilisateur @my_claude_bot ou le lien fourni par BotFather. Appuyez sur « Start ».
2. Envoyez n’importe quel message au bot. Par exemple, hi.
3. Le bot répondra avec un code d’association. Il ressemblera à ceci :

Hi! To pair this account, run in your Claude Code session:
/telegram:access pair 847291

This code is valid for 5 minutes.

4. Retournez au terminal. Dans votre session Claude, saisissez la commande indiquée dans la réponse :

/telegram:access pair 847291

Claude répondra : « Account paired. » Votre compte Telegram peut maintenant envoyer des commandes.

5. Activez la politique de liste d’autorisations. Cela bloque tous les comptes qui n’ont pas déjà été associés :

/telegram:access policy allowlist

Ensuite, les messages des autres comptes seront ignorés sans aucun avis. Ils n’apparaîtront pas dans le terminal, et le bot ne répondra pas — comme s’ils n’avaient jamais existé.

⚠️ Il est très important d’activer la liste d’autorisations juste après l’association. Ne remettez pas cela à plus tard. N’approuvez aucune association inconnue pendant la configuration et ne prenez pas une réponse réussie pour preuve de la politique d’expéditeurs. La première fois, mon bot a fonctionné dix minutes sans liste d’autorisations, et deux utilisateurs Telegram inconnus ont réussi à envoyer « hi » pendant ce temps. Heureusement, je ne laissais pas les commandes écrire dans des fichiers à ce moment-là.

Si vous devez ajouter quelqu’un d’autre (par exemple, un partenaire de projet) :

/telegram:access pair <code du compte de cette personne>

Cette personne doit d’abord écrire au bot, obtenir un code et vous le transmettre. C’est la seule façon de l’ajouter.

Vous trouverez d’autres guides dans la documentation Ailoot.

Comment faire fonctionner Claude 24 h/24 sur votre propre VPS#

Si vous voulez que le bot soit « actif jour et nuit » plutôt que de « rouvrir l’ordinateur pendant une heure pour le solliciter », la session doit rester en cours d’exécution. En local, vous pouvez utiliser tmux, mais un VPS est plus simple et plus fiable.

Une configuration d’exemple utilise un VPS Coolify qui héberge aussi un site web (détails dans le guide sur la publication via Coolify). Vous pouvez utiliser le même serveur — Claude consomme peu de mémoire. Si vous n’avez pas de VPS, prenez le moins cher, à 4–5 euros par mois, par exemple Hetzner CX11 / Yandex Cloud / Selectel.

Étape 1 : Installer le système sur le VPS

Créez d’abord compte Unix dédié et workspace comme administrateur. Ne réutilisez un compte existant qu’après vérification de son home et de ses propriétaires :

sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude

Continuez dans ce shell de connexion claude, pas dans le home root. Installez Bun officiellement et Claude Code par le parcours natif :

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

Ouvrez un nouveau shell du même utilisateur pour appliquer PATH, puis vérifiez identité et exécutables :

whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude

whoami doit afficher claude, HOME /home/claude. Notez les chemins absolus de command -v : le vrai chemin Claude sert à ExecStart et le dossier Bun doit figurer dans PATH du service. Arrêtez si un exécutable manque.

Étape 2 : Authentifier, installer et associer comme utilisateur du service

Dans cette même session interactive, terminez l’authentification puis répétez les étapes 2 à 5 précédentes : plugin Telegram en portée utilisateur, jeton, redémarrage avec --channels, association du compte Telegram et policy allowlist. Vérifiez message et réponse avant le service. Ne copiez pas la configuration ni les identifiants root dans ce home.

Connexion d’abonnement claude.ai et clé Anthropic Console sont prises en charge. Team/Enterprise exigent l’activation d’organisation ; une Console gérée doit aussi respecter ses réglages Channels. Console facture l’API séparément de l’abonnement claude.ai. Gardez compte et authentification identiques entre shell et service.

Étape 3 : Configurer la session avec systemd

Quittez le shell du service et créez l’unité comme administrateur. Elle suppose les chemins vérifiés /home/claude/.local/bin/claude et /home/claude/.bun/bin/bun ; adaptez-les aux vraies sorties s’ils diffèrent. Fournissez même authentification et jeton, gardez le fichier lisible seulement par son administrateur et ne commitez aucun secret. Créez le service de démarrage et de redémarrage :

cat > /etc/systemd/system/claude-code.service <<'EOF'
[Unit]
Description=Claude Code with Telegram channel
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=claude
WorkingDirectory=/home/claude/workspace
Environment="HOME=/home/claude"
Environment="TELEGRAM_BOT_TOKEN=1234567890:AAH..."
Environment="PATH=/home/claude/.local/bin:/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/claude/.local/bin/claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable claude-code
systemctl start claude-code

Voici les paramètres que j’ai activés :

• Type=simple — mode simple ; systemd considère que le processus a démarré dès son lancement.
• User=claude — le processus s’exécute sous un utilisateur distinct, pas sous root. C’est plus sûr.
• WorkingDirectory=/home/claude/workspace — workspace préparé et possédé par l’utilisateur du service. Placez-y le dépôt avant démarrage ; ne laissez ni clone appartenant à root ni exécution depuis son home.
• Environment=TELEGRAM_BOT_TOKEN=... — le jeton est transmis directement au processus. Aucun fichier .env n’est nécessaire.
• --dangerously-skip-permissions — indispensable pour un fonctionnement sans surveillance. Sans ce flag, Claude attend un « oui/non » dans le terminal avant chaque action, et la session reste bloquée. La liste identifie les expéditeurs sans rendre leurs commandes sûres. N’utilisez ce contournement que dans un environnement isolé aux fichiers, identifiants et accès réseau volontairement limités.
• Restart=on-failure — si le processus plante (Claude plante ou le réseau tombe), systemd le redémarre au bout de 10 secondes.

Pour afficher les journaux :

journalctl -u claude-code -f

En cas de problème, journalctl -u claude-code -n 100 affiche les 100 dernières lignes.

Étape 4 : Vérifier que le bot est actif

Ne démarrez le service qu’après une vraie réponse Telegram obtenue en interactif. Envoyez alors un message inoffensif au même bot depuis le compte associé et vérifiez réponse et journaux. Si seul systemd échoue, comparez utilisateur Unix, HOME, workspace, exécutable, PATH et authentification.

Pour une association ultérieure, arrêtez le service, lancez sudo -iu claude, entrez dans /home/claude/workspace et ouvrez le même canal en interactif. Associez et activez la liste, quittez puis redémarrez le service. Ne lancez pas deux pollers du même bot simultanément. journalctl lit des journaux sans fournir de prompt Claude interactif.

5 pièges sur un serveur de production et comment les éviter#

1. Bun n’est pas dans le PATH de systemd

systemd démarre les processus avec un environnement minimal : il ne voit pas les variables de ~/.bashrc. Si Bun n’est installé que dans le home root alors que le service utilise User=claude, ce dernier n’hérite ni de cette installation ni du PATH shell de root.

Solution. Installez Bun à l’échelle du système (/usr/local/bin/bun) ou indiquez explicitement PATH :

Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"

2. La session perd sa connexion TCP à l’API Telegram après une longue période d’inactivité

Après 6–12 heures d’inactivité, le bot peut « se taire » : les messages sont envoyés à Telegram, mais le plugin ne les reçoit pas. C’est une particularité du long polling.

Solution. Ajoutez un redémarrage régulier à systemd (toutes les 24 heures) :

Restart=always
RuntimeMaxSec=86400

Ou configurez une tâche cron : 0 5 * * * systemctl restart claude-code (redémarrage à 5 h du matin).

3. Les limites Claude Max sont atteintes au milieu de la journée

Si vous utilisez beaucoup Claude via Telegram, avec un forfait Max 5x (~$100/mois), vous pouvez atteindre la limite en 4–6 heures. Les requêtes Telegram ne diffèrent pas de celles effectuées dans un terminal ordinaire ; elles sont déduites du même quota.

Solution. Programmez un rappel : « Le bot ne répond pas — vérifier /stats. » Si vous atteignez la limite, attendez sa réinitialisation ou passez à Max 20x ($200/mois). Le guide pour économiser des tokens et le guide comparant les modèles Sonnet et Opus peuvent vous aider.

4. --dangerously-skip-permissions est dangereux même avec une liste d’autorisations

Ce flag désactive toutes les confirmations. Toute commande que vous envoyez sur Telegram sera exécutée sans question : supprimer des fichiers, envoyer des requêtes externes, n’importe quoi. Un jour, j’ai demandé à Claude de « supprimer les instructions console.log inutiles » et, dans son zèle de nettoyage, Claude a effacé la moitié des journaux de débogage d’un script de production. Je les ai restaurés avec git, mais le mal était fait.

Solution. N’activez pas --dangerously-skip-permissions si vous travaillez sur un projet critique. Utilisez plutôt Remote Control pour lancer les sessions : les demandes d’autorisation arrivent sur votre téléphone et vous les approuvez manuellement. Channels avec --dangerously-skip-permissions convient aux brouillons, au refactoring et aux tests.

5. La liste d’autorisations « cesse de fonctionner » après une réinstallation

La liste d’autorisations est stockée dans ~/.claude/channels/telegram/. Si vous passez à un nouveau VPS, réinstallez Claude ou changez d’utilisateur, les anciennes données d’association ne seront pas récupérées. L’ancienne liste d’expéditeurs est absente ; ne supposez pas que cette instance a conservé sa politique d’accès.

Solution. Avant de migrer, sauvegardez ~/.claude/channels/telegram/. Ensuite, remettez le dossier en place. Ou refaites l’association juste après la réinstallation et ne laissez pas passer une seule minute entre le lancement du bot et l’activation de policy allowlist.

Channels ou Remote Control : que choisir ?#

Anthropic a lancé les deux fonctionnalités presque en même temps : Remote Control le 25 février 2026 et Channels le 20 mars 2026. Elles ne font pas double emploi ; elles répondent à des besoins différents.

Voici comment je les répartis pour moi : Channels pour le travail asynchrone lorsque je suis loin de mon ordinateur portable, les notifications CI et les intégrations. Remote Control lorsque je dois voir ce que fait Claude ou approuver une étape risquée.

Vous pouvez utiliser les deux en même temps. Le bot Telegram vous donne un canal rapide pour « poser une question et obtenir une réponse » ; Remote Control permet de « contrôler les opérations critiques ». Les deux utilisent le même quota Claude.

FAQ#

Puis-je connecter plusieurs bots en même temps ?

Oui. Le flag --channels accepte une liste séparée par des espaces : --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Une session Claude répond dans les deux conversations.

Que se passe-t-il si je ferme le terminal ?

La session se ferme, le plugin s’arrête et le bot devient silencieux. Sur un VPS, systemd maintient la session en cours d’exécution. Sur une machine locale, fermez le capot de l’ordinateur portable et claude se déconnectera avec SIGHUP au bout de quelques secondes.

Puis-je recevoir des notifications de CI ou Sentry ?

Oui. Channels est un canal bidirectionnel. Vous pouvez écrire votre propre plugin pour transmettre les webhooks à la session en suivant la référence Channels. Claude verra les événements en temps réel et répondra.

Telegram est-il plus limité que Discord d’une quelconque façon ?

Les capacités de base sont identiques. Discord exige l’activation de Message Content Intent dans les paramètres du bot. iMessage fonctionne uniquement sous macOS et lit directement la base de données ~/Library/Messages/chat.db. Telegram fonctionne partout.

Que dois-je faire si j’ai un forfait Team ?

L’administrateur de l’organisation doit activer channelsEnabled: true dans les paramètres gérés ou via admin-settings/claude-code. Sinon, le plugin se connectera, mais les messages ne seront pas transmis — un avertissement apparaîtra au démarrage dans le terminal.

Que peut voir Claude depuis mon téléphone — la conversation Telegram elle-même ?

Non. Claude voit uniquement le message que vous avez envoyé au bot. L’historique de vos conversations Telegram, votre liste de discussions et vos contacts ne sont pas accessibles. Le plugin MCP ne lit que les messages envoyés au bot via l’API Telegram Bot.

Puis-je utiliser Claude via Channels sans abonnement Pro/Max ?

Oui, une clé API Anthropic Console est aussi prise en charge, avec facturation à cette organisation. L’offre gratuite claude.ai n’est pas le parcours d’abonnement décrit. Team/Enterprise et Console gérée doivent respecter l’activation Channels.

Et ensuite ?#

Une fois le bot opérationnel de manière fiable, voici quelques étapes pour tirer le meilleur parti de Channels :

1. Connectez des webhooks de CI. Si vous utilisez GitHub Actions / GitLab CI, vous pouvez configurer le plugin Channels pour transmettre directement les résultats de compilation à la session. Claude verra « test échoué » juste après un push et suggérera une correction. Consultez la documentation channels-reference.
2. Associez-le à Routines. Vous pouvez exécuter Routines dans la même session pour les tâches régulières. Le matin, le bot envoie de lui-même « Bonjour, voici le résumé du projet », et vous répondez depuis votre téléphone : « fais un rapport sur le chiffre d’affaires ».
3. Configurez un moniteur pour le bot. Si le bot devient silencieux, je veux le savoir. Un petit script cron sur le VPS envoie un ping au bot Telegram toutes les heures. Si le bot ne répond pas, le script envoie une alerte dans un canal distinct. Sans cela, le bot pourrait s’arrêter à 4 h du matin sans que vous le sachiez avant midi.
4. Pensez aux hooks. Les hooks réagissent aux événements Claude (outil démarré, message terminé). Les hooks associés à Channels permettent d’envoyer automatiquement des notifications Telegram telles que « Claude a terminé la tâche N ».

N’ajoutez pas Channels partout. C’est un moyen pratique de prendre des nouvelles d’une tâche lorsque vous êtes en déplacement ou dans un café. Quand vous devez vraiment réfléchir, ouvrez votre ordinateur portable et installez-vous. Channels vous libère l’esprit de cette pensée : « Oh, il faut encore que je lui demande ça, je dois ouvrir mon ordinateur », lorsque vous êtes en déplacement.

Pour d’autres ressources sur l’utilisation des outils, consultez la documentation Ailoot.