Comment connecter Claude Code Channels à Telegram et Discord?

Claude Code Channels connecte Claude Code à Telegram et Discord pour suivre vos agents IA sans rester devant un terminal. L’enjeu est simple : recevoir les notifications, répondre aux clarifications et garder une visibilité d’équipe sur les tâches longues, avec une configuration surtout déclarative.

Pourquoi suivre son agent IA ?

Quand Claude Code travaille plusieurs minutes, le vrai sujet n’est pas seulement d’éviter d’attendre devant un terminal. Le sujet, c’est de garder la main sur une exécution qui peut demander une décision, signaler une erreur ou produire un résultat important pendant que vous faites autre chose.

Claude Code Channels sert précisément à ça : déplacer le suivi de l’agent IA vers des canaux où vous êtes déjà présent, comme Telegram ou Discord. Un agent qui génère du code, analyse un dépôt, refactorise plusieurs fichiers, corrige des tests ou automatise une tâche peut rester actif longtemps. Pendant ce temps, il peut aussi poser une question de clarification : quel fichier modifier, quelle stratégie choisir, quelle contrainte respecter. Si cette question reste bloquée dans un terminal local, l’exécution ralentit ou s’arrête.

Le terminal est efficace pour lancer une commande, mais il a trois limites dès que la tâche dure. D’abord, votre attention se fragmente : vous devez revenir vérifier l’état manuellement. Ensuite, l’historique reste souvent local, donc peu lisible par les autres. Enfin, l’équipe n’a pas de visibilité immédiate sur ce que l’agent fait, ce qu’il demande ou ce qu’il vient de terminer.

Les notifications mobiles changent la dynamique. Avec Telegram, vous recevez une alerte sur votre téléphone quand Claude Code attend une réponse ou termine une tâche. C’est utile si vous êtes en déplacement, en réunion ou simplement loin de votre machine. Avec Discord, l’intérêt est plus collectif : un canal partagé permet à plusieurs personnes de suivre l’avancement, de comprendre les décisions prises et de réagir si nécessaire.

Ce suivi devient particulièrement utile dans trois situations :

• Quand l’agent demande une précision avant de modifier du code sensible.
• Quand une tâche longue se termine et que vous devez relire, tester ou valider.
• Quand l’agent part dans une mauvaise direction et qu’il faut le réorienter vite.

Que fait Claude Code Channels ?

Claude Code Channels sert de passerelle entre Claude Code et vos outils de messagerie. Je ne le vois pas comme un remplaçant du terminal, mais comme une couche de communication qui permet à l’agent IA de parler avec vous, ou avec votre équipe, pendant qu’il travaille.

Un agent IA est un programme capable d’exécuter une tâche avec un certain niveau d’autonomie, par exemple analyser un projet, modifier du code ou lancer une commande. Un canal désigne l’endroit où les messages circulent, comme une conversation Telegram ou un salon Discord. Un bot est le compte automatisé qui envoie et reçoit ces messages. Un token API est une clé secrète qui autorise ce bot à utiliser l’interface de Telegram ou Discord. Une variable d’environnement permet de stocker cette clé hors du code, par exemple dans la configuration du système ou du projet.

Concrètement, Claude Code Channels permet plusieurs usages utiles au quotidien :

• Envoyer un message depuis Claude Code vers Telegram ou Discord.
• Recevoir une réponse utilisateur pendant l’exécution d’une tâche.
• Notifier la fin d’une opération longue, comme une analyse de code ou une génération de correctif.
• Partager l’avancement dans un canal d’équipe, sans obliger tout le monde à regarder un terminal.
• Rediriger l’agent en cours d’exécution, par exemple en lui demandant de changer de priorité ou d’arrêter une piste.

Quelques limites méritent d’être gardées en tête. Les tokens doivent rester secrets, car une personne qui les récupère peut potentiellement contrôler le bot. L’agent ne doit être exposé qu’aux canaux nécessaires, pas à tout votre espace Discord ou à toutes vos conversations. Les droits du bot doivent aussi être minimisés : Lire et écrire dans le bon salon suffit souvent, inutile de lui donner des permissions d’administration.

Pour une mise en œuvre complète, les sources à vérifier sont la documentation officielle d’Anthropic sur Claude Code, la documentation Telegram Bot API et le Discord Developer Portal.

Quels prérequis préparer ?

Avant de connecter Claude Code Channels à Telegram ou Discord, mieux vaut vérifier les accès et les secrets. La configuration est simple, mais elle repose sur quelques éléments sensibles : un outil installé, un compte Anthropic actif, un bot ou un serveur administrable, puis des variables d’environnement correctement définies.

Claude Code doit d’abord être installé sur votre machine. Si Node.js et npm sont déjà disponibles, l’installation globale se fait avec :

npm install -g @anthropic-ai/claude-code

Il faut aussi un compte Anthropic avec accès à Claude Code. Sans cet accès, la connexion à Telegram ou Discord ne servira à rien : le canal recevra peut-être des messages, mais Claude Code ne pourra pas traiter les demandes côté Anthropic.

Côté messagerie, deux options sont possibles selon votre cible. Pour Telegram, vous avez besoin d’un compte Telegram afin de créer un bot via BotFather, l’outil officiel de Telegram qui génère le token du bot. Pour Discord, il faut un accès administrateur au serveur concerné, car la création d’une application, l’ajout d’un bot et la lecture des identifiants de salon demandent des permissions élevées.

Une aisance minimale avec le terminal est nécessaire. Vous devrez lancer des commandes, lire des logs et définir des variables d’environnement. Une variable d’environnement est une valeur lue par un programme au lancement. Elle sert notamment à éviter d’écrire un secret directement dans le code, par exemple un token Telegram, un token Discord ou une clé API.

Sur macOS et Linux, la syntaxe classique ressemble à ceci :

export TELEGRAM_BOT_TOKEN=valeur
export DISCORD_BOT_TOKEN=valeur
export ANTHROPIC_API_KEY=valeur

Sous Windows, la syntaxe diffère selon que vous utilisez PowerShell, l’invite de commandes ou WSL. Vérifiez donc le shell utilisé avant de copier-coller une commande.

Les tokens doivent être traités comme des mots de passe. Ne les publiez pas dans Git, ne les collez pas dans un ticket public, ne les partagez pas dans une conversation non sécurisée. Dès que l’usage devient professionnel, stockez-les dans un gestionnaire de secrets comme 1Password, Bitwarden, Doppler, Vault ou le gestionnaire de secrets de votre cloud.

• Installation : Claude Code est installé avec npm install -g @anthropic-ai/claude-code.
• Accès : Le compte Anthropic dispose bien de l’accès à Claude Code.
• Token : Le token Telegram ou Discord est généré et conservé hors du code.
• Identifiant : Le chat ID Telegram ou le channel ID Discord est récupéré.
• Test : Une commande simple permet de vérifier que la connexion répond avant d’automatiser.

Comment connecter Telegram ?

Telegram est le plus simple à brancher : vous créez un bot, vous récupérez son token, puis vous indiquez à Claude Code Channels dans quelle conversation envoyer les messages.

Commencez dans Telegram. Ouvrez une discussion avec @BotFather, le bot officiel de Telegram qui sert à créer et gérer vos propres bots. Envoyez la commande /newbot, puis choisissez deux éléments :

• Un nom d’affichage, visible par les utilisateurs, par exemple Claude Notifier.
• Un username unique qui se termine par bot, par exemple claude_project_notifier_bot.

BotFather vous renvoie ensuite un token API. C’est la clé secrète qui permet à Claude Code Channels d’envoyer des messages via votre bot. Gardez-la privée : toute personne qui la possède peut contrôler le bot.

Ensuite, ouvrez une conversation avec votre nouveau bot et envoyez-lui au moins un message, par exemple hello. Cette étape est obligatoire, car Telegram ne renvoie pas d’identifiant de conversation tant que le bot n’a reçu aucun message.

Récupérez maintenant le chat ID, c’est-à-dire l’identifiant numérique de la conversation Telegram où les notifications seront envoyées. Appelez l’endpoint officiel de la Telegram Bot API :

https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates

Remplacez YOUR_BOT_TOKEN par le token fourni par BotFather. Selon la documentation de la Telegram Bot API, getUpdates renvoie les messages reçus par le bot. Dans la réponse JSON, repérez le champ chat.id. C’est cette valeur qu’il faut transmettre à Claude Code Channels.

Définissez ensuite les variables d’environnement dans le terminal qui lancera Claude Code :

export CLAUDE_TELEGRAM_TOKEN=123456:ABC
export CLAUDE_TELEGRAM_CHAT_ID=123456789

Vous pouvez alors envoyer une demande à Claude avec le canal Telegram :

claude --channel telegram résume ce dossier et préviens-moi quand tu as terminé

Si rien n’arrive, les causes sont presque toujours les mêmes :

• Token invalide : Vérifiez qu’il vient bien de BotFather et qu’il n’a pas été tronqué.
• Conversation non initiée : Envoyez au moins un message au bot avant d’appeler getUpdates.
• Mauvais chat ID : Relisez la réponse JSON et prenez bien chat.id, pas message_id.
• Bot bloqué : Si vous avez bloqué le bot dans Telegram, il ne peut plus vous écrire.
• Variable non exportée dans le bon terminal : Les variables d’environnement ne sont disponibles que dans la session où elles ont été définies.

Comment connecter Discord ?

Discord demande un peu plus de préparation que Telegram, parce que tout passe par une application déclarée dans le Discord Developer Portal. L’idée reste simple : Créer une application, lui ajouter un bot, l’inviter dans le serveur, puis donner à Claude Code Channels les informations attendues par votre version installée.

Dans le Discord Developer Portal, créez une nouvelle application depuis Applications, puis ouvrez la section Bot et ajoutez un bot. Discord affiche ensuite un bot token. Ce jeton donne accès au bot : Traitez-le comme un mot de passe. Ne le collez pas dans un dépôt Git, ne le partagez pas dans un ticket, et régénérez-le immédiatement s’il a été exposé.

Pour inviter le bot, utilisez la section OAuth2, puis le générateur d’URL. Sélectionnez le scope bot, puis limitez les permissions au strict nécessaire. Pour un usage de notification, les permissions typiques sont View Channel, pour voir le salon, et Send Messages, pour envoyer des messages. Copiez l’URL générée, ouvrez-la dans le navigateur, choisissez le serveur Discord cible, puis validez l’invitation avec un compte qui possède les droits suffisants.

Il faut ensuite récupérer l’identifiant du salon Discord. Activez le mode développeur dans Discord depuis les paramètres avancés, puis faites un clic droit sur le salon concerné et choisissez Copy Channel ID. Cet identifiant est une suite numérique, différente du nom visible du salon.

Côté Claude Code Channels, ne devinez pas les noms de variables. Renseignez le token Discord, l’identifiant du salon et les autres paramètres exactement comme votre version de Claude Code Channels les attend, d’après sa documentation ou son aide en ligne de commande. Les noms peuvent changer selon la version, le mode d’installation ou le fichier de configuration utilisé.

Pour tester, lancez Claude Code sur une tâche courte, par exemple une demande de résumé ou de modification simple. Vérifiez que le message arrive dans le bon salon Discord. Lancez ensuite une tâche volontairement ambiguë et répondez à la demande de clarification depuis Discord, si votre configuration prend en charge les réponses entrantes.

Et maintenant, quel canal allez-vous brancher ?

Claude Code Channels rend Claude Code plus simple à piloter quand les tâches prennent du temps. Telegram convient très bien au suivi personnel, aux alertes mobiles et aux échanges rapides. Discord devient plus intéressant dès qu’une équipe doit voir l’avancement, relire l’historique ou intervenir dans un salon partagé. La configuration reste surtout déclarative : créer un bot, récupérer un token, identifier le bon chat ou canal, exporter les variables, puis tester. Le point critique reste la sécurité des tokens et la limitation des permissions. Bien configuré, ce branchement vous fait gagner du temps, de la visibilité et du contrôle sur vos agents IA.

FAQ

• À quoi sert Claude Code Channels ?
  Claude Code Channels sert à connecter Claude Code à des messageries comme Telegram ou Discord. L’objectif est de recevoir des notifications, suivre l’avancement d’une tâche, répondre à une clarification et garder une trace des échanges sans surveiller le terminal en continu.
• Faut-il coder pour connecter Telegram à Claude Code ?
  Pas vraiment. La configuration est principalement déclarative : vous créez un bot avec BotFather, récupérez un token API, trouvez le chat ID avec l’endpoint getUpdates de Telegram, puis renseignez les variables d’environnement attendues par Claude Code Channels.
• Quelle est la différence entre Telegram et Discord pour cet usage ?
  Telegram est pratique pour un suivi individuel, mobile et rapide. Discord est plus adapté à un usage d’équipe, car les messages peuvent arriver dans un salon partagé où plusieurs personnes suivent l’avancement de l’agent et interviennent si nécessaire.
• Quels secrets faut-il protéger ?
  Les tokens de bot Telegram et Discord doivent être protégés. Ils donnent accès au bot et ne doivent pas être publiés dans un dépôt Git, envoyés dans un canal public ou copiés dans une documentation partagée sans contrôle d’accès.
• Que vérifier si aucun message n’arrive ?
  Vérifiez d’abord le token, le chat ID ou channel ID, puis assurez-vous que la conversation Telegram a bien été initiée ou que le bot Discord est présent dans le bon serveur avec les permissions nécessaires. Contrôlez aussi que les variables d’environnement sont chargées dans le terminal qui lance Claude Code.

A propos de l’auteur

Je suis Franck Scandolera, responsable de l’agence webAnalyste et de l’organisme Formations Analytics. J’accompagne les entreprises sur le tracking avancé server-side, l’Analytics Engineering, l’automatisation No/Low Code avec n8n, l’intégration de l’IA dans les process métiers et le SEO/GEO. J’ai travaillé pour des acteurs comme Logis Hôtel, Yelloh Village, BazarChic, la Fédération Française de Football ou Texdecor. Si vous voulez connecter vos outils, vos données et vos agents IA de façon propre et mesurable, contactez-moi.

Franck Scandolera

⭐ Analytics engineer, Data Analyst et Automatisation IA indépendant ⭐

Ref clients : Logis Hôtel, Yelloh Village, BazarChic, Fédération Football Français, Texdecor…

Mon terrain de jeu :

Data Analyst & Analytics engineering : tracking avancé (GTM server, e-commerce, CAPI, RGPD), entrepôt de données (BigQuery, Snowflake, PostgreSQL, ClickHouse), modèles (Airflow, dbt, Dataform), dashboards décisionnels (Looker, Power BI, Metabase, SQL, Python).
Automatisation IA des taches Data, Marketing, RH, compta etc : conception de workflows intelligents robustes (n8n, App Script, scraping) connectés aux API de vos outils et LLM (OpenAI, Mistral, Claude…).
Engineering IA pour créer des applications et agent IA sur mesure : intégration de LLM (OpenAI, Mistral…), RAG, assistants métier, génération de documents complexes, APIs, backends Node.js/Python.