Visualiza las ejecuciones de Claude Code

Cuándo utilizamos Claude Code puede que no te des cuenta de la cantidad de procesos que pueden estar ocurriendo hasta que el LLM te ofrece la respuesta o realiza la tarea que le has indicado. Yo normalmente utilizo Langfuse en local para observabilidad IA, y me es realmente útil para entender qué hace Claude Code en cada llamada, cuántos tokens usa en cada ejecución, cuándo da errores o reitera muchas más veces de lo necesario apra realizar algo, pero hoy os comparto Claude Scope.

El otro día vi un repo de  Alexey Milovidov y se me ocurrió mejorar el interface y hacer fácil para cualquier persona poder monitorizar de manera visual las ejecuciones que se realizan en Claud Code.

No voy a meterme con detalles técnicos, por que a casi nadie le interesan, pero como resumen lo que hace es crear un interface HTML que ejecuta consultas SQL mediante clickhouse-local usando como fuente los ficheros con los datos de las sesiones que guarda Claude Code.

El restulado es este dashboar, que permite visualizar cada ejecución de Claude Code. Por cada ejecución calcula los costes en caso de haber usado la API en vez de la cuenta de suscripción. el  número de tokens de entrada, de salida, tokens de cache , etc. 

También puedes ver la salida de cada Tool que use el LLM, la salida generada por cada llamamiento a herramientas, el contexto que le llega en cada prompt. Los datos se pueden agrupar por sesión, por trace o no agruparlas. personalmente suelo hacerlo por Traces.

Cómo ejecutarlo

Para ejecutarlo::

1. Ddebes descargar los ficheros del repositorio claude-scope 
2. Una vez descargados y descomprimidos, debes abrir un terminal dentro de la carpeta descargada (la que contiene installer/ y claude-scope/).
3. Dependiendo de tu sistema:

python3 installer/launcher.py

Python ya viene en casi todas las distros. Si falta, en Debian/Ubuntu: sudo apt install python3.

python3 installer/launcher.py

Si no tienes Python, instálalo desde python.org o con Homebrew (brew install python).

ClickHouse no tiene versión nativa para Windows, así que el panel lo ejecuta a través de WSL (Windows Subsystem for Linux). Sólo se activa una vez:

# PowerShell como Administrador, sólo la primera vez
wsl --install
# Reinicia el equipo cuando lo pida.

Instala Python desde python.org (marca "Add python.exe to PATH" en el instalador). Después, en PowerShell o CMD dentro de la carpeta:

python installer\launcher.py

La primera vez que lo ejecutes te mostrará una pantalla inicial para preguntar de dóde obtiene los datos, con tres opciones:

• Usar la carpeta por defecto de Claude Code: lee ~/.claude/projects/ en sólo-lectura. Lo normal si usas Claude Code en local.
• Otra carpeta:  si prefieres no usar la propia carpeta de Claude Code y prefieres usar una copia de la misma puedes elegir la carpeta donde tienes los .jsonl.
• Arrastrar / subir mis ficheros .jsonl: se copian dentro del panel y se usan como fuente local; útil si te han pasado las sesiones desde otro equipo.

Una vez configurada la ruta, podrás modificarlo cuando quieras desde la parte superior del panel... Espero que le sea útil a alguien y como siempre, acepto y agradezco feedback de cosas a mejorar..