Comment utiliser Claude Code dans Telegram avec Chatcode
Installez Claude Code sur votre serveur avec le terminal web et la couche Telegram de Chatcode : compromis sur l’hôte, le relais, les identifiants et le plugin natif.
Chatcode fournit un terminal dans le navigateur et une interface Telegram complémentaire pour les sessions d’agents de codage qui tournent sur un serveur que vous contrôlez. Ce guide installe Claude Code et explicite la frontière qui compte le plus : le dépôt et le processus de l’agent restent sur votre hôte, mais le plan de contrôle de Chatcode relaie un trafic de terminal lisible entre cet hôte, le navigateur et Telegram.
Si vous avez seulement besoin d’un bot Telegram pour une session Claude en cours, le plugin officiel Channels d’Anthropic est un point de départ plus simple. Choisissez ce workflow quand le terminal complet dans le navigateur, un hôte persistant ou la prise en charge de plusieurs agents font partie de vos besoins.
Ce que contient l’installation
Browser / Telegram
↕
Chatcode control plane
↕ outbound TLS WebSocket
Your server + gateway
↕
Claude Code session
La passerelle n’a besoin d’aucun port entrant pour le trafic Chatcode normal. Elle lance les sessions d’agents sur la machine connectée et maintient une connexion sortante vers le plan de contrôle. Il reste utile de conserver SSH comme voie distincte d’administration et de secours.
1. Choisir l’hôte
Deux choix sont courants :
- Un serveur Linux toujours allumé. Connectez un VPS existant, ou utilisez le parcours DigitalOcean pour en provisionner un.
- Un Mac que vous utilisez déjà. Vous évitez un serveur de plus, mais la disponibilité dépend de l’alimentation, du réseau et de l’état de connexion du Mac.
Sur Linux, l’installation crée un utilisateur dédié vibe et utilise
/home/vibe/workspace. Sur macOS, la passerelle tourne sous votre utilisateur
actuel et utilise ~/workspace ; elle hérite donc des permissions de fichiers
de cet utilisateur. Lisez comment fonctionne la passerelle
avant de décider quel modèle de confiance convient à l’hôte.
2. Connecter la passerelle
Connectez-vous sur app.chatcode.dev, ajoutez un serveur et utilisez la commande d’installation générée. Elle contient un identifiant de passerelle et un token d’authentification : ne la collez donc pas dans une issue publique, une conversation ou un enregistrement de shell.
Le programme d’installation configure la passerelle comme service d’arrière-plan. Une fois qu’elle apparaît en ligne dans l’application, vérifiez l’hôte et le chemin de l’espace de travail avant d’ouvrir une session d’agent.
3. Ouvrir un espace de travail et authentifier Claude Code
Choisissez un répertoire de projet sous la racine d’espace de travail configurée, créez une session et sélectionnez Claude Code. Effectuez l’authentification propre à Claude dans le terminal de l’hôte, exactement comme vous le feriez en dehors de Chatcode.
Limitez les identifiants au strict nécessaire :
- utilisez si possible un token de dépôt propre au projet ;
- évitez de placer des secrets de production dans le répertoire personnel de l’utilisateur de la passerelle ;
- commencez sur une branche ou un worktree que vous pourrez relire et jeter ;
- choisissez le réglage de bac à sable de la session avant de demander l’exécution de commandes à large portée.
Sur Linux, l’utilisateur de la passerelle suit un modèle documenté
d’administration sans surveillance. Sur macOS, le sudo sans mot de passe
(facultatif) et les demandes d’autorisation de confidentialité du système
méritent un examen à part. La documentation de la passerelle
couvre ces détails.
4. Associer Telegram
Associez le compte Telegram depuis Chatcode, puis ouvrez la Mini App ou une conversation de session associée. Commencez par une instruction anodine en lecture seule et vérifiez qu’elle atteint bien la session affichée dans le navigateur.
Chaque surface a son rôle :
- Navigateur : interaction complète avec le terminal, commandes, sortie enrichie et administration des sessions.
- Telegram : continuité, notifications, interaction compacte, et vues de fichiers ou de sessions prises en charge.
Garder cette distinction en tête évite d’attendre d’un fil de messages Telegram qu’il se comporte comme une transcription complète du terminal.
5. Tester la persistance et la reprise
Avant de compter sur cette installation loin de votre bureau :
- Lancez une tâche non destructive dans le navigateur.
- Fermez le navigateur et vérifiez que la session côté serveur continue.
- Suivez l’avancement depuis Telegram.
- Rouvrez le navigateur et vérifiez qu’il s’agit bien de la même session.
- Testez l’accès SSH et repérez les logs de la passerelle pour disposer d’une voie de secours.
Un serveur toujours allumé améliore la disponibilité, mais il allonge aussi la durée pendant laquelle un agent et ses identifiants sont joignables. Appliquez les correctifs sur l’hôte, surveillez l’espace disque et supprimez les espaces de travail et les identifiants abandonnés.
Channels natif ou Chatcode ?
| Claude Code Channels | Chatcode | |
|---|---|---|
| Interface principale | Telegram | Terminal dans le navigateur et Telegram |
| Processus hôte | Claude Code avec le plugin activé | Service de passerelle et session d’agent |
| Demandes de permission | Les demandes prises en charge peuvent être relayées vers Telegram | Gérées via le terminal de l’agent et les réglages de sécurité de la session |
| Agents | Claude Code | Claude Code, Codex, Gemini et OpenCode |
| Dépendances de confiance | Plugin Anthropic et Telegram | Passerelle/plan de contrôle Chatcode et Telegram |
| Idéal pour | Une session Claude en cours dans Telegram | Un workflow de terminal persistant sur plusieurs appareils ou agents |
Channels est officiel, plus restreint et comporte moins de pièces mobiles. Chatcode offre une interface plus large, mais ajoute un plan de contrôle capable de lire le contenu du terminal qu’il relaie. Choisissez en fonction de l’interface et du modèle de confiance, sans partir du principe que « géré » signifie automatiquement « plus sûr ».
Pour la voie native, consultez Comment connecter Claude Code à Telegram.
Questions fréquentes
Chatcode nécessite-t-il un VPS ?
Non. Vous pouvez connecter un serveur Linux ou un Mac pris en charge que vous possédez déjà. Un VPS est utile quand la session doit rester disponible pendant que votre ordinateur personnel est en veille.
Telegram offre-t-il l’interface de terminal complète ?
Non. Le navigateur est le terminal principal. Telegram fournit des vues associées, des notifications, des aperçus de fichiers et la continuité autour de la même session côté serveur.
Puis-je plutôt utiliser le plugin Telegram officiel de Claude Code ?
Oui. Utilisez le plugin officiel Channels d’Anthropic si vous avez seulement besoin d’accéder depuis Telegram à une session Claude en cours. Chatcode devient plus pertinent si vous avez aussi besoin d’un terminal dans le navigateur, d’un hôte géré toujours allumé ou de plusieurs agents de codage.
Chatcode peut-il lire le trafic du terminal ?
Oui. Les connexions sont chiffrées en TLS sur chaque tronçon, mais le plan de contrôle de Chatcode est un relais de confiance et non un tunnel chiffré de bout en bout. Il traite le contenu du terminal pour la mise en forme Telegram, les aperçus, la transcription et les notifications.