---
title: "Como ligar o Claude Code ao Telegram"
seoTitle: "Ligar o Claude Code ao Telegram: configuração nativa"
navTitle: "Claude Code + Telegram"
description: "Ligue o Claude Code ao Telegram com o plugin oficial Channels: emparelhamento do bot, pedidos de permissão remotos, limites da sessão e opções mais seguras."
slug: how-to-connect-claude-code-to-telegram
lang: pt-PT
date: 2026-06-08
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "O Claude Code tem uma integração oficial com o Telegram?"
    a: "Sim. Os Channels do Claude Code incluem um plugin oficial para o Telegram, que liga um bot do Telegram com lista de permissões a uma sessão do Claude Code que continua a correr no seu computador ou servidor."
  - q: "Posso aprovar pedidos de permissão do Claude Code a partir do Telegram?"
    a: "Sim. A versão atual do plugin oficial do Telegram retransmite os pedidos de permissão de ferramentas suportados sob a forma de botões Allow e Deny. A confiança inicial no projeto, o consentimento do plugin e parte da configuração local continuam a exigir o terminal."
  - q: "Qual é a diferença entre os Channels e o Remote Control?"
    a: "Os Channels permitem que o Telegram ou outro serviço envie eventos para uma sessão do Claude Code em execução. O Remote Control expõe a sessão através do Claude na web ou no telemóvel. Ambos usam um processo do Claude na máquina anfitriã, mas a interface e o modelo de acionamento são diferentes."
  - q: "O bot do Telegram funciona com o Claude Code fechado?"
    a: "Não. O servidor do canal corre juntamente com a sessão do Claude Code. Mantenha o processo ativo num terminal persistente ou numa máquina sempre ligada se precisar que continue acessível."
---

O Claude Code tem uma integração oficial com o Telegram chamada **Channels**. É
uma boa opção quando quer enviar uma tarefa para uma sessão que já tem a correr,
receber a resposta no Telegram e tratar das aprovações de ferramentas habituais
sem abrir o portátil.

A restrição importante é simples: o Telegram não executa o Claude Code. Quem
faz o trabalho continua a ser um processo do Claude Code no seu computador ou
servidor, e esse processo tem de se manter online.

## Resposta rápida

Crie um bot privado com o BotFather do Telegram, instale o plugin oficial do
Telegram no Claude Code, configure o respetivo token, inicie o Claude com o
canal ativado e emparelhe a sua conta do Telegram. Mantenha o bot restrito a
uma lista de permissões em vez de o tornar público.

De momento, a integração é uma research preview (uma pré-visualização para
investigação). Consulte a
[documentação dos Channels](https://code.claude.com/docs/en/channels) da
Anthropic antes de a automatizar numa máquina sensível, porque os comandos e as
capacidades podem mudar.

## O que precisa

- Uma instalação atual do Claude Code, autenticada com uma conta da Anthropic
  suportada.
- O [Bun](https://bun.sh/) instalado na máquina anfitriã; o plugin oficial do
  canal corre sobre o Bun.
- Uma conta do Telegram e um token de bot obtido através do
  [@BotFather](https://t.me/BotFather).
- Um terminal que possa ficar aberto, ou uma sessão persistente como o `tmux`.

Trate o token do bot como uma palavra-passe. Não o cole num repositório, num
histórico da shell partilhado com outros utilizadores nem numa captura de ecrã.

## 1. Crie um bot privado do Telegram

Abra o BotFather no Telegram, envie `/newbot` e siga as instruções. O nome de
utilizador do bot tem de terminar em `bot`. Copie o token para um sítio
temporário e privado.

Numa sessão de programação pessoal, não há motivo para adicionar o bot a um
grupo. Com mensagens diretas e uma lista de permissões, é mais fácil perceber
o que se passa.

## 2. Instale o plugin oficial

No Claude Code, instale o plugin do Telegram:

```text
/plugin install telegram@claude-plugins-official
```

Se o marketplace ainda não estiver registado, adicione-o e tente novamente:

```text
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
```

Use o nome do marketplace oficial e não um pacote de terceiros com um nome
parecido.

## 3. Configure o token do bot

Execute o comando do plugin dentro do Claude Code:

```text
/telegram:configure <BOT_TOKEN>
```

O plugin guarda o token na configuração local do canal. Se o token tiver
aparecido em registos ou numa conversa, revogue-o através do BotFather e
configure um novo.

## 4. Inicie o Claude Code com o Telegram ativado

Saia da sessão atual e volte a iniciá-la com o canal:

```bash
claude --channels plugin:telegram@claude-plugins-official
```

Execute o comando dentro do repositório em que o Claude deve trabalhar. Numa
máquina sempre ligada, inicie-o numa sessão `tmux` com nome, para que uma
desconexão do SSH não termine o processo:

```bash
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
```

O `tmux` preserva o processo; não impede um portátil de entrar em suspensão nem
repõe uma ligação de rede que falhou.

## 5. Emparelhe a sua conta e adicione-a à lista de permissões

Envie uma mensagem ao bot. Este responde com um código de emparelhamento. No
terminal do Claude Code, aprove esse código e mantenha o acesso restrito:

```text
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
```

Faça um teste com um pedido só de leitura, como pedir ao Claude que resuma o
diretório atual. Confirme que a mensagem aparece na sessão pretendida
antes de conceder um acesso mais amplo às ferramentas.

## Como funcionam agora os pedidos de permissão

Descrições mais antigas dos Channels dizem muitas vezes que cada pedido de
permissão obriga a voltar ao terminal. Isso já não é verdade. A versão atual do
[plugin oficial do Telegram](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts)
declara a capacidade de retransmissão de permissões do Claude Code e pode
enviar pedidos de ferramentas suportados para o Telegram com os botões
**Allow** e **Deny**.

Isso não torna as aprovações sem supervisão isentas de risco. Um pequeno cartão
numa conversa pode esconder contexto que seria óbvio num diff no terminal. Leia
o comando e o caminho afetado, evite regras amplas do tipo «permitir sempre» e
use uma conta com poucos privilégios numa sessão sempre ligada. A confiança
inicial no projeto, o consentimento MCP e a configuração do plugin podem
continuar a exigir interação no terminal local.

## Limites que contam na prática

- **O processo na máquina anfitriã tem de se manter ativo.** Se fechar o
  Claude Code, o canal deixa de funcionar.
- **O Telegram é um fluxo de eventos, não um armazenamento de sessões.** A Bot
  API entrega as atualizações novas; não dá ao plugin um histórico completo e
  pesquisável.
- **A resposta fica no Telegram.** O terminal pode mostrar o evento recebido e o
  estado da entrega, em vez de uma transcrição idêntica à conversa.
- **É exclusivo do Claude.** O plugin não expõe o Codex nem outros agentes.
- **É software em pré-visualização.** Volte a consultar a documentação oficial
  depois de cada atualização e evite depender de comportamentos não
  documentados.

## Channels vs. Remote Control

O
[Remote Control](https://code.claude.com/docs/en/remote-control) da Anthropic é
uma opção à parte. Permite que o Claude na web ou na aplicação para iOS/Android
comande uma sessão na máquina anfitriã. Os ficheiros e as ferramentas ficam na
máquina anfitriã e o telemóvel funciona como interface remota.

Escolha os **Channels** quando o Telegram for a interface que quer ou quando
houver eventos externos que devam chegar a uma sessão. Escolha o **Remote
Control** quando quiser a interface oficial do Claude e uma visão mais próxima
da sessão ativa. Ambos continuam a depender do processo na máquina anfitriã.

## Quando faz sentido outra camada remota

O plugin nativo é normalmente a resposta mais simples para uma sessão do Claude.
Uma configuração diferente torna-se relevante quando os requisitos mudam – por
exemplo, um terminal completo no browser, vários agentes de programação ou um
VPS sempre ligado e gerido separadamente de um portátil.

O Chatcode é uma dessas opções: liga um servidor a um terminal no browser e ao
Telegram e pode executar o Claude Code a par do Codex, do Gemini e do OpenCode.
Isso acrescenta um intermediário de terceiros e a responsabilidade de gerir um
servidor, por isso não é uma melhoria automática. A configuração prática e as
contrapartidas estão descritas em
[Claude Code no Telegram com o Chatcode](/articles/claude-code-telegram-with-chatcode).
