Tutorial completo

VPS + Telegram
24/7

Setup completo: conecte seu Claude Code a uma VPS e controle tudo pelo Telegram, rodando sem parar.

Fase 1
Setup VPS
1
Acessar a VPS via SSH
Copie o comando SSH do seu painel (EasyPanel, Hostinger, etc.)
ssh SEU_USUARIO@SEU_IP_AQUI
O usuário varia conforme o provedor: ubuntu (Ubuntu/AWS), root (Hostinger, Vultr…), debian, etc. Se não for root, os comandos apt-get precisam de sudo.
2
Gerar token de acesso no GitHub
a. GitHub → Settings → Developer settings
b. Personal access tokens → Generate new token
c. Copie o token gerado
3
Clonar o repositório do projeto
Cole seu token e o link do repositório:
git clone https://TOKEN@github.com/user/repo.git
cd repo
4
Instalar Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
sudo apt-get install -y nodejs
5
Instalar Claude Code
npm install -g @anthropic-ai/claude-code
Claude Code instalado
Fase 2
Telegram Plugin
1
Instalar o Bun runtime
Pré-requisito: O Bun precisa do unzip para instalar. Se ainda não tiver, rode o comando abaixo antes de prosseguir.
sudo apt-get install -y unzip
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc
2
Logar no Claude Code
Execute claude e siga o fluxo de login no navegador.
3
Instalar o plugin do Telegram
/plugin install telegram@claude-plugins-official
4
Selecionar escopo de instalação
Clique em: Install for you (user scope)
5
Sair e reiniciar com channels
/exit
claude --channels plugin:telegram@claude-plugins-official
Fase 3
Criar e conectar o bot
1
Criar bot no Telegram
a. Abra o @BotFather no Telegram
b. Envie /newbot
c. Escolha um nome e um username (ex: meu_aiox_bot)
d. Copie o token que o BotFather retorna
2
Configurar o token no Claude
Cole no terminal do Claude Code:
/telegram:configure SEU_TOKEN_AQUI
3
Recarregar plugins
/reload-plugins
4
Parear com o Telegram
Mande qualquer mensagem pro bot no Telegram. Ele vai responder com um código de 6 dígitos. Cole no terminal:
/telegram:access pair XXXXXX
Agora você controla o Claude Code pelo Telegram.
Fase 4
Permanência (rodar 24/7)
1
Configurar permissões automáticas
Após logar no Claude Code, insira:
/permissions
2
Selecionar modo "ask"
Escolha a opção ask quando solicitado.
3
Colar as regras de permissão
Bash(*) Edit(*) Write(*) mcp__*
4
Selecionar escopo
Escolha: Project settings
5
Sair e iniciar sessão permanente com tmux
/exit
Cole o nome do seu projeto:
tmux new-session -s claude -c ~/nome_do_projeto 'claude --channels "plugin:telegram@claude-plugins-official"' \; set remain-on-exit on
Claude Code rodando 24/7. Feche o terminal tranquilo — o tmux mantém a sessão viva.
Se quiser ver o que está acontecendo:
tmux attach -t claude
Fase 5
Configurar via Telegram
Depois que tudo estiver rodando, baixe os dois arquivos abaixo e envie cada um pro chat do seu bot no Telegram. Ele vai ler e configurar tudo sozinho.
1
Registrar comandos "/" no bot
Baixe o arquivo e envie como documento pro bot no Telegram. Ele registra todos os 72 agentes no menu autocomplete.
telegram-setup-comandos.md
Configura o menu "/" com todos os agentes AIOX
BAIXAR
Depois de enviar, feche e reabra o chat. Digite / e o autocomplete aparece.
2
Configurar indicador de status (olhinho)
Baixe e envie pro bot. Configura o 👀 que aparece quando está processando e some quando termina.
telegram-setup-emoji-status.md
Configura o 👀 como indicador de processamento
BAIXAR
Como funciona: Quando você manda mensagem, o bot reage com 👀. Quando termina, o 👀 some e a resposta chega.
Setup completo! Seu Claude Code está rodando 24/7 com comandos e status visual.