shotX33/claude-code-telegram

O que claude-code-telegram faz?

Permite acesso contínuo ao Claude Code via Telegram para obter ajuda de codificação natural e consciente do contexto, edição e notificações de projetos de qualquer dispositivo.

Visão Geral

Esta skill integra o Claude Code com o Telegram, permitindo que você interaja com seus projetos de codificação por meio de mensagens de texto do Telegram. Você pode enviar comandos, solicitar revisões de código, editar arquivos e receber notificações de status do projeto, tudo sem sair do seu aplicativo de mensagens.

Como Funciona

1. Um bot do Telegram escuta suas mensagens.
2. As mensagens são encaminhadas para o Claude Code, que as processa como comandos de codificação.
3. O Claude Code executa as ações solicitadas (ex.: editar um arquivo, executar um comando, revisar código).
4. A resposta é enviada de volta para você no Telegram.

Pré-requisitos

• Conta no Telegram.
• Acesso ao Claude Code (via terminal ou plataforma compatível).
• Um bot do Telegram criado (via BotFather).

Instalação

1. Clone o repositório:

   git clone https://github.com/shotX33/claude-code-telegram.git
   cd claude-code-telegram
   

2. Instale as dependências:

   pip install -r requirements.txt
   

3. Configure as variáveis de ambiente:

   Crie um arquivo .env e adicione:

   TELEGRAM_BOT_TOKEN=seu_token_aqui
   CLAUDE_API_KEY=sua_chave_api_claude
   PROJECT_PATH=/caminho/para/seu/projeto
   

4. Execute o bot:

   python main.py
   

Uso

• Envie /start para iniciar o bot.
• Envie comandos de codificação diretamente, como:
  • Crie uma função que calcule o fatorial
  • Revise o arquivo app.js
  • Execute npm test``
• O bot responderá com o resultado ou ações do Claude Code.

Configuração Avançada

Você pode personalizar o comportamento do bot editando o arquivo config.py:

• COMMAND_PREFIX: Prefixo para comandos especiais (padrão: /).
• TIMEOUT: Tempo máximo de espera para respostas do Claude Code (padrão: 30 segundos).
• WHITELIST_USERS: Lista de IDs de usuários autorizados (opcional).

Limitações

• O bot requer que o Claude Code esteja em execução ou acessível via API.
• Comandos muito longos podem exceder o limite de tamanho de mensagem do Telegram.
• A segurança depende da configuração do token do bot e da chave da API.

Contribuição

Contribuições são bem-vindas! Abra uma issue ou envie um pull request no repositório GitHub.

Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

Nota: Esta skill não é oficialmente afiliada ao Claude Code ou ao Telegram.