---
title: "Comment connecter Claude Code à Telegram"
seoTitle: "Connecter Claude Code à Telegram : la configuration native"
navTitle: "Claude Code + Telegram"
description: "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."
slug: how-to-connect-claude-code-to-telegram
lang: fr
date: 2026-06-08
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Claude Code a-t-il une intégration Telegram officielle ?"
    a: "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."
  - q: "Puis-je approuver les demandes de permission de Claude Code depuis Telegram ?"
    a: "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."
  - q: "Quelle est la différence entre Channels et Remote Control ?"
    a: "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."
  - q: "Le bot Telegram fonctionne-t-il quand Claude Code est fermé ?"
    a: "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."
---

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](https://code.claude.com/docs/en/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](https://bun.sh/) 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](https://t.me/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 :

```text
/plugin install telegram@claude-plugins-official
```

Si la marketplace n’est pas encore enregistrée, ajoutez-la puis réessayez :

```text
/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 :

```text
/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 :

```bash
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 :

```bash
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 :

```text
/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](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts)
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](https://code.claude.com/docs/en/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](/articles/claude-code-telegram-with-chatcode).
