Guia

Como usar o Claude Code no Telegram com o Chatcode

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.

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

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 antes de decidir que modelo de confiança é adequado para a máquina.

2. Ligue o gateway

Inicie sessão em 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 cobre esses detalhes.

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.

Perguntas frequentes

O Chatcode exige um VPS?

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.

O Telegram é a interface de terminal completa?

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.

Posso usar antes o plugin oficial do Claude Code para o Telegram?

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.

O Chatcode consegue ler o tráfego do terminal?

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.

Partilhe este guia