---
title: "Como usar o Claude Code no Telegram com o Chatcode"
seoTitle: "Claude Code no Telegram com o Chatcode: configuração"
navTitle: "Claude Code no Telegram"
description: "Configure o Claude Code no seu servidor com o terminal no browser e o Telegram do Chatcode: contrapartidas de máquina, intermediário, credenciais e plugin nativo."
slug: claude-code-telegram-with-chatcode
lang: pt-PT
date: 2026-06-11
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "O Chatcode exige um VPS?"
    a: "Não. Pode ligar um servidor Linux ou um Mac suportado que já tenha. Um VPS é útil quando a sessão tem de continuar disponível enquanto o seu computador pessoal está em suspensão."
  - q: "O Telegram é a interface de terminal completa?"
    a: "Não. O browser é o terminal principal. O Telegram oferece vistas associadas, notificações, pré-visualizações de ficheiros e continuidade em torno da mesma sessão no servidor."
  - q: "Posso usar antes o plugin oficial do Claude Code para o Telegram?"
    a: "Sim. Use o plugin oficial Channels da Anthropic quando só precisar de acesso pelo Telegram a uma sessão do Claude em execução. O Chatcode faz mais sentido quando também precisa de um terminal no browser, de uma máquina gerida sempre ligada ou de vários agentes de programação."
  - q: "O Chatcode consegue ler o tráfego do terminal?"
    a: "Sim. As ligações são encriptadas com TLS em cada troço, mas o plano de controlo do Chatcode é um intermediário de confiança e não um canal encriptado ponta a ponta. Processa o conteúdo do terminal para a formatação no Telegram, as pré-visualizações, a transcrição e as notificações."
---

O Chatcode disponibiliza um terminal no browser e um complemento no Telegram
para sessões de agentes de programação que correm num servidor controlado por
si. Este guia mostra como configurar o Claude Code e deixa clara a fronteira que
mais importa: o repositório e o processo do agente ficam na sua máquina, mas o plano
de controlo do Chatcode retransmite tráfego de terminal legível entre essa
máquina, o browser e o Telegram.

Se só precisa de um bot do Telegram para uma sessão do Claude em direto, o
plugin oficial Channels da Anthropic é um ponto de partida mais simples. Use
este fluxo de trabalho quando o terminal completo no browser, uma máquina
persistente ou o suporte para vários agentes fizerem parte dos requisitos.

## O que inclui a configuração

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

O gateway não precisa de uma porta de entrada aberta para o tráfego normal do
Chatcode. Inicia as sessões dos agentes na máquina ligada e mantém uma ligação
de saída ao plano de controlo. Continua a valer a pena manter o SSH como via
separada de administração e recuperação.

## 1. Escolha a máquina

Há duas escolhas comuns:

- **Um servidor Linux sempre ligado.** Ligue um VPS que já tenha ou use o fluxo
  da DigitalOcean para aprovisionar um.
- **Um Mac que já usa.** Evita mais um servidor, mas a disponibilidade depende
  da alimentação, da rede e do estado de início de sessão do Mac.

A instalação em Linux cria um utilizador dedicado `vibe` e usa
`/home/vibe/workspace`. No macOS, o gateway corre com o seu utilizador atual e
usa `~/workspace`, pelo que herda as permissões de ficheiros desse utilizador.
Leia [como funciona o gateway](/docs/gateway) antes de decidir que modelo de
confiança é adequado para a máquina.

## 2. Ligue o gateway

Inicie sessão em [app.chatcode.dev](https://app.chatcode.dev), adicione um
servidor e use o comando de instalação gerado. Este contém um identificador do
gateway e um token de autenticação, por isso não o cole numa issue pública, numa
conversa nem numa gravação da shell.

O instalador configura o gateway como um serviço em segundo plano. Quando este
aparecer online na aplicação, verifique a máquina e o caminho do espaço de
trabalho antes de abrir uma sessão de agente.

## 3. Abra um espaço de trabalho e autentique o Claude Code

Escolha um diretório de projeto dentro da raiz do espaço de trabalho
configurada, crie uma sessão e selecione o Claude Code. Conclua a autenticação
do próprio Claude no terminal da máquina, tal como faria fora do Chatcode.

Limite as credenciais ao trabalho em causa:

- use um token de repositório específico do projeto sempre que possível;
- evite colocar segredos de produção no diretório pessoal do utilizador do
  gateway;
- comece num branch ou numa worktree que possa rever e descartar;
- escolha a definição de sandbox da sessão antes de pedir a execução de
  comandos com permissões amplas.

Em Linux, o utilizador do gateway segue um modelo documentado de administração
sem supervisão. No macOS, o `sudo` opcional sem palavra-passe e os pedidos de
privacidade do sistema merecem uma análise à parte. A
[documentação do gateway](/docs/gateway) cobre esses detalhes.

## 4. Associe o Telegram

Associe a conta do Telegram a partir do Chatcode e abra a Mini App ou uma
conversa de sessão associada. Comece com um prompt inofensivo, só de leitura, e
confirme que chega à mesma sessão apresentada no browser.

Cada interface tem a sua função:

- **Browser:** interação completa com o terminal, comandos, saída rica e
  administração das sessões.
- **Telegram:** continuidade, notificações, interação compacta e vistas de
  ficheiros ou de sessões suportadas.

Ter esta distinção presente evita esperar que uma conversa no Telegram se
comporte como uma transcrição completa do terminal.

## 5. Teste a persistência e a recuperação

Antes de depender desta configuração longe da secretária:

1. Inicie uma tarefa não destrutiva no browser.
2. Feche o browser e confirme que a sessão continua no servidor.
3. Acompanhe a atualização a partir do Telegram.
4. Volte a abrir o browser e verifique que se trata da mesma sessão.
5. Teste o acesso SSH e localize os registos do gateway, para ter uma via de
   recuperação.

Um servidor sempre ligado melhora a disponibilidade, mas também aumenta o tempo
durante o qual um agente e as respetivas credenciais estão acessíveis. Mantenha
a máquina atualizada, monitorize a utilização do disco e remova espaços de
trabalho e credenciais abandonados.

## Channels nativos ou Chatcode?

| | Claude Code Channels | Chatcode |
| --- | --- | --- |
| Interface principal | Telegram | Terminal no browser e Telegram |
| Processo na máquina | Claude Code com o plugin ativado | Serviço do gateway e sessão do agente |
| Pedidos de permissão | Os pedidos suportados podem ser retransmitidos para o Telegram | Geridos através do terminal do agente e das definições de segurança da sessão |
| Agentes | Claude Code | Claude Code, Codex, Gemini e OpenCode |
| Dependências de confiança | Plugin da Anthropic e Telegram | Gateway/plano de controlo do Chatcode e Telegram |
| Ideal para | Uma sessão do Claude em execução no Telegram | Fluxo de trabalho persistente no terminal, entre dispositivos ou agentes |

Os Channels são oficiais, mais limitados e têm menos peças móveis. O Chatcode
oferece uma interface mais ampla, mas acrescenta um plano de controlo que
consegue ler o conteúdo do terminal retransmitido. Escolha com base na interface
e no modelo de confiança, e não no pressuposto de que um serviço gerido é
automaticamente mais seguro.

Para o caminho nativo, consulte
[Como ligar o Claude Code ao Telegram](/articles/how-to-connect-claude-code-to-telegram).
