Watchtower: Um Proxy Local para Monitorar o Tráfego da API de Código Claude

O que o Watchtower Faz

Watchtower é um proxy HTTP local combinado com um painel web em tempo real. Ele intercepta todo o tráfego de API entre o Claude Code (ou o Codex CLI) e suas APIs de backend. Isso permite que desenvolvedores vejam cada requisição, fluxos de Eventos Enviados pelo Servidor (SSE), definição de ferramentas, prompt do sistema, uso de tokens e limite de taxa em tempo real.

Recursos Principais e Motivação

A ferramenta foi construída usando o próprio Claude Code. De acordo com o criador, o Claude Code normalmente envia 2-3 chamadas de API por mensagem do usuário: uma para verificações de cota, outra para contagens de tokens e então a requisição de streaming real. Ele também cria subagentes com prompts do sistema completamente diferentes e conjuntos menores de ferramentas. Apenas o prompt principal do sistema é relatado como tendo mais de 20.000 tokens. Normalmente, essa comunicação interna não é visível para o usuário.

Configuração e Uso

A instalação é feita via npm:

npm install -g watchtower-ai && watchtower-ai

Para usá-lo, execute o Claude Code apontando-o para o proxy definindo uma variável de ambiente:

ANTHROPIC_BASE_URL=http://localhost:8024 claude

A interface do painel abre no seu navegador em http://localhost:8025.

Detalhes do Projeto

O projeto inteiro—incluindo o servidor proxy, detecção de provedores, análise de SSE e a interface do painel—foi construído usando o Claude Code. Ele é lançado sob a licença MIT, é gratuito e de código aberto, e não possui níveis pagos ou requisitos de conta.

O criador afirma que esta ferramenta é útil para desenvolvedores que querem ver rastros de raciocínio, entender padrões de consumo de tokens, ou aprender como o sistema de agentes funciona para construir melhores agentes de IA por conta própria.