---
title: "Come usare Claude Code su Telegram con Chatcode"
seoTitle: "Claude Code su Telegram con Chatcode: configurazione"
navTitle: "Claude Code su Telegram"
description: "Configura Claude Code sul tuo server con il terminale nel browser e Telegram di Chatcode: compromessi chiari su host, inoltro, credenziali e plugin nativo."
slug: claude-code-telegram-with-chatcode
lang: it
date: 2026-06-11
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Chatcode richiede un VPS?"
    a: "No. Puoi collegare un server Linux supportato o un Mac che possiedi già. Un VPS è utile quando la sessione deve restare disponibile mentre il tuo computer personale è in sospensione."
  - q: "Telegram è l'interfaccia completa del terminale?"
    a: "No. Il browser è il terminale principale. Telegram offre viste collegate, notifiche, anteprime dei file e continuità attorno alla stessa sessione sul server."
  - q: "Posso usare invece il plugin Telegram ufficiale di Claude Code?"
    a: "Sì. Usa il plugin ufficiale Channels di Anthropic quando ti serve solo l'accesso da Telegram a una sessione di Claude in esecuzione. Chatcode diventa più rilevante quando ti servono anche un terminale nel browser, un host gestito sempre acceso o più agenti di coding."
  - q: "Chatcode può leggere il traffico del terminale?"
    a: "Sì. Le connessioni sono cifrate con TLS su ogni tratta, ma il piano di controllo di Chatcode è un nodo di inoltro fidato, non un canale cifrato end-to-end. Elabora il contenuto del terminale per la formattazione su Telegram, le anteprime, la trascrizione e le notifiche."
---

Chatcode offre un terminale nel browser e un complemento su Telegram per le
sessioni degli agenti di coding che girano su un server che controlli tu.
In questa guida configuriamo Claude Code e chiariamo il confine che conta di
più: il
repository e il processo dell'agente restano sul tuo host, ma il piano di
controllo di Chatcode inoltra il traffico leggibile del terminale tra
quell'host, il browser e Telegram.

Se ti serve solo un bot Telegram per una sessione di Claude attiva, il plugin
ufficiale Channels di Anthropic è un punto di partenza più semplice. Usa questo
flusso di lavoro quando il terminale completo nel browser, un host persistente
o il supporto a più agenti fanno parte dei requisiti.

## Com'è fatta la configurazione

```text
Browser / Telegram
        ↕
Chatcode control plane
        ↕ outbound TLS WebSocket
Your server + gateway
        ↕
Claude Code session
```

Per il normale traffico di Chatcode il gateway non ha bisogno di una porta in
ingresso. Avvia le sessioni degli agenti sulla macchina collegata e mantiene una
connessione in uscita verso il piano di controllo. Vale comunque la pena tenere
SSH come via separata per l'amministrazione e il ripristino.

## 1. Scegli l'host

Ci sono due scelte comuni:

- **Un server Linux sempre acceso.** Collega un VPS esistente oppure usa la
  procedura DigitalOcean per crearne uno.
- **Un Mac che usi già.** Eviti un altro server, ma la disponibilità dipende
  dall'alimentazione, dalla rete e dallo stato di accesso del Mac.

L'installazione su Linux crea un utente dedicato `vibe` e usa
`/home/vibe/workspace`. Su macOS il gateway gira con il tuo utente attuale e
usa `~/workspace`, quindi eredita i permessi sui file di quell'utente. Leggi
[come funziona il gateway](/docs/gateway) prima di decidere quale modello di
fiducia si adatta all'host.

## 2. Collega il gateway

Accedi su [app.chatcode.dev](https://app.chatcode.dev), aggiungi un server e
usa il comando di installazione generato. Contiene un identificativo del
gateway e un token di autenticazione, quindi non incollarlo in una issue
pubblica, in una chat o in una registrazione della shell.

L'installer configura il gateway come servizio in background. Quando nell'app
risulta online, verifica l'host e il percorso del workspace prima di aprire una
sessione dell'agente.

## 3. Apri un workspace e autentica Claude Code

Scegli una directory di progetto sotto la radice del workspace configurata,
crea una sessione e seleziona Claude Code. Completa l'autenticazione di Claude
nel terminale dell'host, esattamente come faresti fuori da Chatcode.

Limita le credenziali al lavoro da fare:

- usa un token del repository specifico per il progetto, quando possibile;
- evita di mettere segreti di produzione nella home directory dell'utente del
  gateway;
- comincia da un branch o da un worktree che si possa rivedere e scartare;
- scegli l'impostazione sandbox della sessione prima di chiedere l'esecuzione
  di comandi su larga scala.

Su Linux, l'utente del gateway segue un modello documentato di
amministrazione senza supervisione. Su macOS, il `sudo` facoltativo senza
password e le richieste di autorizzazione per la privacy di sistema vanno
valutati a parte. La
[documentazione del gateway](/docs/gateway) tratta questi dettagli.

## 4. Collega Telegram

Collega l'account Telegram da Chatcode, poi apri la Mini App o una chat di
sessione collegata. Usa prima un prompt innocuo in sola lettura e verifica che
arrivi alla stessa sessione mostrata nel browser.

Le due superfici hanno compiti diversi:

- **Browser:** interazione completa con il terminale, comandi, output ricco e
  amministrazione delle sessioni.
- **Telegram:** continuità, notifiche, interazione compatta e viste supportate
  di file o sessioni.

Tenere presente questa distinzione evita di aspettarsi che una conversazione su
Telegram si comporti come una trascrizione completa del terminale.

## 5. Verifica persistenza e ripristino

Prima di affidarti alla configurazione lontano dalla scrivania:

1. Avvia un'attività non distruttiva nel browser.
2. Chiudi il browser e verifica che la sessione sul server continui.
3. Segui l'aggiornamento da Telegram.
4. Riapri il browser e verifica che sia la stessa sessione.
5. Prova l'accesso SSH e individua i log del gateway, così hai una via di
   ripristino.

Un server sempre acceso migliora la disponibilità, ma aumenta anche il tempo in
cui un agente e le sue credenziali sono raggiungibili. Tieni aggiornato l'host,
controlla l'uso del disco e rimuovi i workspace e le credenziali abbandonati.

## Channels nativo o Chatcode?

| | Claude Code Channels | Chatcode |
| --- | --- | --- |
| Interfaccia principale | Telegram | Terminale nel browser più Telegram |
| Processo sull'host | Claude Code con il plugin abilitato | Servizio gateway e sessione dell'agente |
| Richieste di permesso | Le richieste supportate possono essere inoltrate a Telegram | Gestite tramite il terminale dell'agente e le impostazioni di sicurezza della sessione |
| Agenti | Claude Code | Claude Code, Codex, Gemini e OpenCode |
| Dipendenze di fiducia | Plugin di Anthropic e Telegram | Gateway/piano di controllo di Chatcode e Telegram |
| Ideale per | Una sessione di Claude attiva su Telegram | Un flusso di lavoro persistente nel terminale tra dispositivi o agenti diversi |

Channels è ufficiale, più limitato e ha meno parti in movimento. Chatcode
offre un'interfaccia più ampia, ma aggiunge un piano di controllo che può
leggere il contenuto del terminale che inoltra. Scegli in base all'interfaccia
e al modello di fiducia, non partendo dal presupposto che «gestito» significhi
automaticamente più sicuro.

Per la strada nativa, segui
[Come collegare Claude Code a Telegram](/articles/how-to-connect-claude-code-to-telegram).
