Comment connecter Claude Code à Telegram
Connectez Claude Code à Telegram avec le plugin officiel Channels : appairage du bot, demandes de permission à distance, limites de session et réglages plus sûrs.
Claude Code dispose d’une intégration Telegram officielle appelée Channels. Elle convient bien si vous voulez envoyer une tâche à une session déjà lancée, recevoir la réponse dans Telegram et traiter les validations d’outils courantes sans ouvrir votre portable.
La contrainte essentielle est simple : ce n’est pas Telegram qui exécute Claude Code. Un processus Claude Code sur votre ordinateur ou votre serveur fait toujours le travail, et ce processus doit rester en ligne.
Réponse rapide
Créez un bot privé avec BotFather dans Telegram, installez le plugin Telegram officiel dans Claude Code, configurez son token, lancez Claude avec le canal activé et appairez votre compte Telegram. Réservez le bot à une liste d’autorisation plutôt que de le rendre public.
L’intégration est actuellement en aperçu de recherche (research preview). Consultez la documentation de Channels d’Anthropic avant de l’automatiser sur une machine sensible, car les commandes et les capacités peuvent changer.
Ce qu’il vous faut
- Une installation récente de Claude Code, authentifiée avec un compte Anthropic pris en charge.
- Bun installé sur l’hôte : le plugin de canal officiel tourne sur Bun.
- Un compte Telegram et un token de bot obtenu auprès de @BotFather.
- Un terminal qui peut rester ouvert, ou une session persistante comme
tmux.
Traitez le token du bot comme un mot de passe. Ne le collez ni dans un dépôt, ni dans un historique de shell partagé avec d’autres utilisateurs, ni dans une capture d’écran.
1. Créer un bot Telegram privé
Ouvrez BotFather dans Telegram, envoyez /newbot et suivez ses instructions.
Le nom d’utilisateur du bot doit se terminer par bot. Copiez le token dans
un endroit temporaire et privé.
Rien ne justifie d’ajouter le bot à un groupe pour une session de codage personnelle. Des messages privés associés à une liste d’autorisation sont plus faciles à maîtriser.
2. Installer le plugin officiel
Dans Claude Code, installez le plugin Telegram :
/plugin install telegram@claude-plugins-official
Si la marketplace n’est pas encore enregistrée, ajoutez-la puis réessayez :
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
Utilisez le nom de la marketplace officielle plutôt qu’un paquet tiers au nom similaire.
3. Configurer le token du bot
Lancez la commande du plugin dans Claude Code :
/telegram:configure <BOT_TOKEN>
Le plugin enregistre le token dans la configuration locale du canal. Si le token est apparu dans des logs ou dans une conversation, révoquez-le via BotFather et configurez-en un nouveau.
4. Lancer Claude Code avec Telegram activé
Quittez la session en cours, puis relancez-la avec le canal :
claude --channels plugin:telegram@claude-plugins-official
Exécutez cette commande dans le dépôt sur lequel Claude doit travailler. Sur un
hôte toujours allumé, lancez-la dans une session tmux nommée pour qu’une
déconnexion SSH n’arrête pas le processus :
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
tmux préserve le processus ; il n’empêche pas un portable de se mettre en
veille et ne rétablit pas une connexion réseau coupée.
5. Appairer votre compte et l’inscrire sur la liste d’autorisation
Envoyez un message au bot. Il renvoie un code d’appairage. Dans le terminal Claude Code, approuvez ce code et gardez l’accès restreint :
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
Faites un test avec une requête en lecture seule, par exemple en demandant à Claude de résumer le répertoire courant. Vérifiez que le message arrive bien dans la session prévue avant d’accorder un accès plus large aux outils.
Comment fonctionnent désormais les demandes de permission
Les anciennes descriptions de Channels indiquent souvent que chaque demande de permission oblige à revenir au terminal. Ce n’est plus exact. La version actuelle du plugin Telegram officiel déclare la capacité de relais des permissions de Claude Code et peut envoyer les demandes d’outils prises en charge vers Telegram avec des boutons Allow et Deny.
Les validations à distance ne sont pas sans risque pour autant. Une petite carte de conversation peut masquer un contexte qui sauterait aux yeux dans un diff affiché dans le terminal. Lisez la commande et le chemin concerné, évitez les règles larges du type « always allow » et utilisez un compte aux privilèges limités pour une session toujours active. La confiance initiale accordée au projet, le consentement MCP et la configuration des plugins peuvent encore nécessiter une interaction dans le terminal local.
Les limites qui comptent en pratique
- Le processus hôte doit rester actif. Fermer Claude Code arrête le canal.
- Telegram est un flux d’événements, pas un stockage de session. La Bot API livre les nouvelles mises à jour ; elle ne fournit pas au plugin un historique complet et consultable.
- La réponse vit dans Telegram. Le terminal peut afficher l’événement entrant et son statut de livraison plutôt qu’une transcription identique à la conversation.
- C’est propre à Claude. Le plugin n’expose ni Codex ni d’autres agents.
- C’est un logiciel en préversion. Revérifiez la documentation officielle après chaque mise à jour et évitez de vous appuyer sur des comportements non documentés.
Channels ou Remote Control
Remote Control, d’Anthropic, est une option distincte. Elle permet à Claude sur le web ou dans l’app iOS/Android de piloter une session côté hôte. Les fichiers et les outils restent sur l’hôte, et le téléphone sert d’interface distante.
Choisissez Channels si Telegram est l’interface que vous voulez ou si des événements externes doivent atteindre une session. Choisissez Remote Control si vous voulez l’interface officielle de Claude et une vue plus directe de la session active. Dans les deux cas, tout repose sur le processus côté hôte.
Quand une autre couche distante se justifie
Le plugin natif est généralement la solution la plus simple pour une seule session Claude. Une autre configuration devient pertinente quand les besoins changent — par exemple un vrai terminal dans le navigateur, plusieurs agents de codage, ou un VPS toujours allumé et géré indépendamment d’un portable.
Chatcode est l’une de ces options : il relie un serveur à un terminal dans le navigateur et à Telegram, et peut faire tourner Claude Code aux côtés de Codex, Gemini et OpenCode. Cela ajoute un relais tiers et la responsabilité de gérer un serveur ; ce n’est donc pas une mise à niveau automatique. La configuration pratique et ses compromis sont détaillés dans Claude Code dans Telegram avec Chatcode.
Questions fréquentes
Claude Code a-t-il une intégration Telegram officielle ?
Oui. Claude Code Channels comprend un plugin Telegram officiel. Il connecte un bot Telegram inscrit sur une liste d’autorisation à une session Claude Code qui continue de tourner sur votre ordinateur ou votre serveur.
Puis-je approuver les demandes de permission de Claude Code depuis Telegram ?
Oui. La version actuelle du plugin Telegram officiel relaie les demandes de permission d’outils prises en charge sous forme de boutons Allow et Deny. La confiance initiale accordée au projet, le consentement aux plugins et une partie de la configuration locale passent toujours par le terminal.
Quelle est la différence entre Channels et Remote Control ?
Channels permet à Telegram ou à un autre service d’envoyer des événements dans une session Claude Code en cours. Remote Control expose la session via Claude sur le web ou sur mobile. Les deux reposent sur un processus Claude côté hôte, mais l’interface et le mode de déclenchement diffèrent.
Le bot Telegram fonctionne-t-il quand Claude Code est fermé ?
Non. Le serveur du canal tourne avec la session Claude Code. Gardez le processus actif dans un terminal persistant ou sur un hôte toujours allumé si vous avez besoin qu’il reste joignable.