Repolode
Enviar
liaohch3

liaohch3/claude-tap

Proxy local e visualizador de traces que captura o tráfego de API de agentes de programação com IA, como Claude Code e Codex CLI, para inspecionar prompts, chamadas de ferramentas e uso de tokens.

Ver no GitHub
Estrelas
3,293
Forks
284
Issues abertas
40
Último commit
há 24 horas

O que é?

claude-tap executa o CLI de um agente de programação com IA por meio de um proxy local ou monitora transcrições locais de clientes que não podem usar proxy, registrando o tráfego real de API. Cada trace mostra prompts de sistema, histórico da conversa, schemas de ferramentas, chamadas de ferramentas, respostas em streaming, uso de tokens e diferenças entre requisições consecutivas.

A ferramenta oferece suporte a vários clientes, incluindo Claude Code, Codex CLI, Gemini CLI, Kimi CLI, OpenCode, Pi, Hermes Agent e Cursor CLI, com modos de proxy reverso ou direto, conforme o cliente. Cabeçalhos de autenticação comuns são ocultados antes da gravação, e os traces ficam armazenados localmente, sem exigir um dashboard hospedado.

O visualizador é um arquivo HTML independente que pode ser exportado e compartilhado para revisão ou arquivamento. Ele inclui diffs estruturais, busca, detalhamento de tokens, visualização ao vivo no navegador durante uma execução e modo de incorporação em iframe.

Recursos principais

  • 01Captura requisições e respostas de API em streaming dos CLIs de agentes de programação compatíveis.
  • 02Exibe prompts de sistema, definições e chamadas de ferramentas e uso de tokens por requisição.
  • 03Compara requisições consecutivas para destacar alterações em mensagens, prompts ou parâmetros.
  • 04Exporta cada sessão como um visualizador HTML independente ou um pacote compacto de traces.
  • 05Oculta cabeçalhos de autenticação comuns e mantém todos os dados dos traces na máquina local.

Casos de uso

  • Investigar por que um agente de programação mudou de comportamento entre interações.
  • Auditar quais ferramentas e prompts de sistema um agente envia ao modelo.
  • Comparar o uso de tokens e o crescimento do contexto entre sessões de agentes.
  • Arquivar ou compartilhar um trace reproduzível da execução de um agente para revisão.

Início rápido

  1. 1

    Instale claude-tap com uv (recomendado)

    uv tool install claude-tap
  2. 2

    Execute o Claude Code pelo claude-tap

    claude-tap
  3. 3

    Ou faça o tracing do Codex CLI

    claude-tap --tap-client codex

Antes de usar

  • É necessário instalar separadamente o Python 3.11 ou superior e o cliente do agente que você quer rastrear.
  • Alguns clientes, como o AWS Bedrock nativo, precisam de configuração extra, como o modo de proxy de encaminhamento.

Tópicos

#agent-observability#llm-proxy#api-debugging#trace-viewer#claude-code#codex-cli#llm#developer-tools#agent-debugging#ai-agents

Perguntas frequentes

O que é claude-tap?
Proxy local e visualizador de traces que captura o tráfego de API de agentes de programação com IA, como Claude Code e Codex CLI, para inspecionar prompts, chamadas de ferramentas e uso de tokens. claude-tap executa o CLI de um agente de programação com IA por meio de um proxy local ou monitora transcrições locais de clientes que não podem usar proxy, registrando o tráfego real de API. Cada trace mostra prompts de sistema, histórico da conversa, schemas de ferramentas, chamadas de ferramentas, respostas em streaming, uso de tokens e diferenças entre requisições consecutivas.
claude-tap é gratuito? Qual é a licença?
claude-tap é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-tap ainda é mantido?
Manutenção ativa. O último commit de claude-tap foi em 19 de out. de 2026.
Para que posso usar claude-tap?
Investigar por que um agente de programação mudou de comportamento entre interações. Auditar quais ferramentas e prompts de sistema um agente envia ao modelo. Comparar o uso de tokens e o crescimento do contexto entre sessões de agentes. Arquivar ou compartilhar um trace reproduzível da execução de um agente para revisão.
Como instalar claude-tap?
Instale claude-tap com uv (recomendado): uv tool install claude-tap Execute o Claude Code pelo claude-tap: claude-tap Ou faça o tracing do Codex CLI: claude-tap --tap-client codex
Onde consigo claude-tap?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/liaohch3/claude-tap

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados