Cómo usar Claude Code en Telegram con Chatcode
Configura Claude Code en tu servidor con el terminal en el navegador y la capa de Telegram de Chatcode: host, intermediario, credenciales y plugin nativo.
Chatcode ofrece un terminal en el navegador y un complemento en Telegram para sesiones de agentes de programación que se ejecutan en un servidor que tú controlas. Esta guía configura Claude Code y deja claro el límite que más importa: el repositorio y el proceso del agente se quedan en tu host, pero el plano de control de Chatcode retransmite tráfico legible del terminal entre ese host, el navegador y Telegram.
Si lo único que necesitas es un bot de Telegram para una sesión de Claude en directo, el plugin oficial de Channels de Anthropic es un punto de partida más sencillo. Usa este flujo de trabajo cuando el terminal completo en el navegador, un host persistente o la compatibilidad con varios agentes formen parte de los requisitos.
Qué incluye la configuración
Browser / Telegram
↕
Chatcode control plane
↕ outbound TLS WebSocket
Your server + gateway
↕
Claude Code session
El gateway no necesita un puerto de entrada para el tráfico normal de Chatcode. Inicia las sesiones de los agentes en la máquina conectada y mantiene una conexión saliente con el plano de control. Aun así, merece la pena conservar SSH como vía aparte de administración y recuperación.
1. Elige el host
Hay dos opciones habituales:
- Un servidor Linux siempre encendido. Conecta un VPS que ya tengas o usa el flujo de DigitalOcean para aprovisionar uno.
- Un Mac que ya usas. Te ahorras otro servidor, pero la disponibilidad depende de la alimentación, la red y el estado de inicio de sesión del Mac.
La instalación en Linux crea un usuario dedicado vibe y usa
/home/vibe/workspace. En macOS el gateway se ejecuta con tu usuario actual y
usa ~/workspace, así que hereda los permisos de archivos de ese usuario. Lee
cómo funciona el gateway antes de decidir qué modelo de
confianza le conviene al host.
2. Conecta el gateway
Accede en app.chatcode.dev, añade un servidor y usa el comando de instalación generado. Contiene un identificador del gateway y un token de autenticación, así que no lo pegues en una issue pública, en un chat ni en una grabación de la shell.
El instalador configura el gateway como servicio en segundo plano. Cuando aparezca en línea en la app, verifica el host y la ruta del espacio de trabajo antes de abrir una sesión de agente.
3. Abre un espacio de trabajo y autentica Claude Code
Elige un directorio de proyecto dentro de la raíz de espacios de trabajo configurada, crea una sesión y selecciona Claude Code. Completa la autenticación propia de Claude en el terminal del host, igual que harías fuera de Chatcode.
Limita las credenciales al trabajo que hay que hacer:
- usa un token de repositorio específico del proyecto cuando sea posible;
- no pongas secretos de producción en el directorio personal del usuario del gateway;
- empieza en una rama o un worktree que se pueda revisar y descartar;
- elige el ajuste de sandbox de la sesión antes de pedir una ejecución amplia de comandos.
En Linux, el usuario del gateway tiene un modelo documentado de administración
desatendida. En macOS, el sudo sin contraseña opcional y los avisos de
privacidad del sistema requieren una valoración aparte. La
documentación del gateway cubre esos detalles.
4. Vincula Telegram
Vincula la cuenta de Telegram desde Chatcode y abre la Mini App o un chat de sesión vinculado. Usa primero un prompt inofensivo de solo lectura y confirma que llega a la misma sesión que ves en el navegador.
Cada superficie tiene su función:
- Navegador: interacción completa con el terminal, comandos, salida enriquecida y administración de sesiones.
- Telegram: continuidad, notificaciones, interacción compacta y vistas compatibles de archivos o sesiones.
Tener clara esa diferencia evita esperar que un hilo de mensajes de Telegram se comporte como una transcripción completa del terminal.
5. Prueba la persistencia y la recuperación
Antes de depender de esta configuración cuando no estés en tu mesa:
- Inicia una tarea no destructiva en el navegador.
- Cierra el navegador y confirma que la sesión del servidor continúa.
- Sigue la actualización desde Telegram.
- Vuelve a abrir el navegador y verifica que es la misma sesión.
- Prueba el acceso SSH y localiza los registros del gateway para tener una vía de recuperación.
Un servidor siempre encendido mejora la disponibilidad, pero también alarga el tiempo durante el que un agente y sus credenciales están accesibles. Aplica parches al host, vigila el uso del disco y elimina los espacios de trabajo y las credenciales abandonados.
¿Channels nativo o Chatcode?
| Claude Code Channels | Chatcode | |
|---|---|---|
| Interfaz principal | Telegram | Terminal en el navegador más Telegram |
| Proceso en el host | Claude Code con el plugin activado | Servicio del gateway y sesión del agente |
| Solicitudes de permiso | Las solicitudes compatibles pueden retransmitirse a Telegram | Se gestionan desde el terminal del agente y los ajustes de seguridad de la sesión |
| Agentes | Claude Code | Claude Code, Codex, Gemini y OpenCode |
| Dependencias de confianza | Plugin de Anthropic y Telegram | Gateway/plano de control de Chatcode y Telegram |
| Mejor encaje | Una sesión de Claude en marcha en Telegram | Flujo de trabajo persistente en el terminal entre dispositivos o agentes |
Channels es oficial, más limitado y tiene menos piezas en juego. Chatcode ofrece una interfaz más amplia, pero añade un plano de control que puede leer el contenido del terminal que retransmite. Elige según la interfaz y el modelo de confianza, no dando por hecho que lo gestionado sea automáticamente más seguro.
Para la vía nativa, usa Cómo conectar Claude Code a Telegram.
Preguntas frecuentes
¿Chatcode necesita un VPS?
No. Puedes conectar un servidor Linux compatible o un Mac que ya tengas. Un VPS es útil cuando la sesión debe seguir disponible mientras tu ordenador personal está en suspensión.
¿Es Telegram la interfaz de terminal completa?
No. El navegador es el terminal principal. Telegram aporta vistas vinculadas, notificaciones, vistas previas de archivos y continuidad en torno a la misma sesión del servidor.
¿Puedo usar en su lugar el plugin oficial de Telegram de Claude Code?
Sí. Usa el plugin oficial de Channels de Anthropic cuando solo necesites acceder desde Telegram a una sesión de Claude en marcha. Chatcode tiene más sentido cuando además necesitas un terminal en el navegador, un host gestionado siempre encendido o varios agentes de programación.
¿Puede Chatcode leer el tráfico del terminal?
Sí. Las conexiones van cifradas con TLS en cada salto, pero el plano de control de Chatcode es un intermediario de confianza, no un canal cifrado de extremo a extremo. Procesa el contenido del terminal para darle formato en Telegram, generar vistas previas, transcribir y enviar notificaciones.