Script para executar o Claude Code usando Telegram

Introdução

Este é um script em npx criado para usar em momentos de urgência (depois do trabalho, fora de casa), permitindo controlar o Claude Code pelo Telegram.

Recursos

• 1 sala de chat por projeto (caminho), com necessidade de um bot individual do Telegram para cada um
• Suporte a execução paralela, execução repetida (até dar certo) e definição de prioridade
• Possibilidade de verificar e cancelar tarefas

Instalação e uso

• Execute com npx cc-telegram, registre o token do bot e o chat id do Telegram seguindo as instruções, faça mais algumas configurações e estará pronto para usar.
• Depois disso, execute novamente com npx cc-telegram e envie uma nova solicitação no Telegram com o comando /new.
• No Telegram, a lista de comandos disponíveis aparece com o autocompletar de /. Para mais detalhes, consulte o link.

Breve histórico de desenvolvimento

Versão 1

A primeira versão usava um servidor intermediário e um programa agente capaz de definir vários caminhos no PC, permitindo usar projetos de vários caminhos por meio de uma única sala de chat.
Ao tentar gerenciar vários projetos em uma única sala, a complexidade só aumentou, então ela foi descartada após apenas 2 dias.

Versão 2

Na segunda versão, o servidor intermediário foi removido e o script passou a buscar mensagens do Telegram por polling.
Nessa fase, o sistema incluía subagentes dentro das funcionalidades; esses agentes analisavam as solicitações e executavam o trabalho e, quando não havia tarefas, propunham melhorias e as executavam automaticamente.
Depois de deixar isso rodando por 4 dias durante o feriado de fim de ano do ano passado, foi constatado que ele gerava uma grande quantidade de código lixo, então também foi descartado.

Versão 2.5

É a versão da segunda iteração sem a parte de sugestão de melhorias e execução automática. De algum jeito ela funcionava, mas...

Versão atual

Há pouco tempo descobri o plugin ralph-loop, experimentei usá-lo em cada projeto individualmente e concluí que a melhor abordagem é usar o modo de execução repetida junto com as configurações do Claude específicas de cada projeto.

O problema da segunda versão era que cada projeto tinha suas próprias configurações adequadas de subagentes, mas isso não era levado em conta; em vez disso, eram fornecidos subagentes integrados, o que, na minha avaliação, acabava até reduzindo o desempenho.

Quase todo o trabalho anterior foi descartado (foram reaproveitados apenas a parte de execução do Claude Code por sistema operacional e o código de integração com o Telegram), e a versão atual foi redesenhada praticamente do zero.
Pessoalmente, sinto que só agora surgiu a primeira versão realmente utilizável.

Se você testar, agradeço muito por impressões ou feedback.