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.
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:
- Inicie uma tarefa não destrutiva no browser.
- Feche o browser e confirme que a sessão continua no servidor.
- Acompanhe a atualização a partir do Telegram.
- Volte a abrir o browser e verifique que se trata da mesma sessão.
- 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.