Repolode
Enviar
liaohch3

liaohch3/claude-tap

Proxy local y visor de trazas que captura el tráfico de API de agentes de programación con IA, como Claude Code y Codex CLI, para inspeccionar prompts, llamadas a herramientas y uso de tokens.

Ver en GitHub
Estrellas
3,293
Forks
284
Issues abiertos
40
Último commit
hace 24 horas

¿Qué es?

claude-tap ejecuta la CLI de un agente de programación con IA a través de un proxy local o, para clientes que no admiten proxy, observa las transcripciones locales y registra el tráfico real de API. Cada traza muestra los prompts del sistema, el historial de la conversación, los esquemas de las herramientas, las llamadas a herramientas, las respuestas transmitidas en streaming, el uso de tokens y las diferencias entre solicitudes consecutivas.

Es compatible con una amplia variedad de clientes, entre ellos Claude Code, Codex CLI, Gemini CLI, Kimi CLI, OpenCode, Pi, Hermes Agent y Cursor CLI, con modos de proxy inverso o directo según el cliente. Antes de registrar la información, oculta los encabezados de autenticación habituales, y guarda las trazas localmente sin necesidad de un dashboard alojado.

El visor es un archivo HTML autónomo que se puede exportar y compartir para revisarlo o archivarlo. Incluye diferencias estructurales, búsqueda, desgloses del uso de tokens, una vista en vivo en el navegador durante la ejecución y un modo para incrustarlo en un iframe.

Funciones clave

  • 01Captura solicitudes y respuestas de API en streaming de las CLI de agentes de programación compatibles.
  • 02Muestra los prompts del sistema, las definiciones y llamadas de herramientas, y el uso de tokens de cada solicitud.
  • 03Compara solicitudes consecutivas para destacar los mensajes, prompts o parámetros que han cambiado.
  • 04Exporta cada sesión como un visor HTML autónomo o un paquete de trazas compacto.
  • 05Oculta los encabezados de autenticación habituales y conserva todos los datos de las trazas en el equipo local.

Casos de uso

  • Investigar por qué un agente de programación cambió su comportamiento entre turnos.
  • Auditar qué herramientas y prompts del sistema envía un agente al modelo.
  • Comparar el uso de tokens y el crecimiento del contexto entre sesiones del agente.
  • Archivar o compartir una traza reproducible de una ejecución del agente para revisarla.

Inicio rápido

  1. 1

    Instala claude-tap con uv (recomendado)

    uv tool install claude-tap
  2. 2

    Ejecuta Claude Code a través de claude-tap

    claude-tap
  3. 3

    O traza Codex CLI

    claude-tap --tap-client codex

Antes de usarlo

  • Necesitas tener instalados por separado Python 3.11 o posterior y el cliente del agente que quieras trazar.
  • Algunos clientes, como AWS Bedrock nativo, requieren configuración adicional, como el modo de proxy de reenvío.

Temas

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

Preguntas frecuentes

¿Qué es claude-tap?
Proxy local y visor de trazas que captura el tráfico de API de agentes de programación con IA, como Claude Code y Codex CLI, para inspeccionar prompts, llamadas a herramientas y uso de tokens. claude-tap ejecuta la CLI de un agente de programación con IA a través de un proxy local o, para clientes que no admiten proxy, observa las transcripciones locales y registra el tráfico real de API. Cada traza muestra los prompts del sistema, el historial de la conversación, los esquemas de las herramientas, las llamadas a herramientas, las respuestas transmitidas en streaming, el uso de tokens y las diferencias entre solicitudes consecutivas.
¿claude-tap es gratuito? ¿Qué licencia tiene?
claude-tap es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿claude-tap sigue mantenido?
Mantenimiento activo. El último commit de claude-tap fue el 19 oct 2026.
¿Para qué puedo usar claude-tap?
Investigar por qué un agente de programación cambió su comportamiento entre turnos. Auditar qué herramientas y prompts del sistema envía un agente al modelo. Comparar el uso de tokens y el crecimiento del contexto entre sesiones del agente. Archivar o compartir una traza reproducible de una ejecución del agente para revisarla.
¿Cómo se instala claude-tap?
Instala claude-tap con uv (recomendado): uv tool install claude-tap Ejecuta Claude Code a través de claude-tap: claude-tap O traza Codex CLI: claude-tap --tap-client codex
¿Dónde consigo claude-tap?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/liaohch3/claude-tap

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados