\
CONTEXT/academy
Lección 05 · ≈ 14 min

Medir y mantener

El dashboard de analytics: adopción, contribución y qué reforzar o retirar.

Medir y mantener

Has montado mucho: skills, hooks, plugins, MCP, CI, routines, agentes en paralelo. La última pieza es saber si funciona y qué conviene reforzar o retirar. Para eso está el dashboard de analytics.

El dashboard (Team y Enterprise)

Si tu organización tiene plan Team o Enterprise, los admins y owners lo ven en claude.ai/analytics/claude-code. Muestra estas métricas resumen y sus gráficas:

MétricaQué mide
Lines of code acceptedlíneas escritas por Claude Code que el usuario aceptó en sus sesiones
Suggestion accept rate% de veces que se aceptan las ediciones de Claude Code (Edit, Write, NotebookEdit)
Adoption (users / sessions)usuarios y sesiones activos al día
PRs with CC / PRs with CC (%)PRs fusionados con al menos una línea asistida por Claude Code
Lines of code with CClíneas asistidas a lo largo de los PRs fusionados
Leaderboardtop 10 contribuidores por uso (PRs o líneas)
Data exportdescarga de la contribución de todos los usuarios en CSV

Las métricas de contribución (PRs/líneas con CC, leaderboard, export) requieren conectar tu organización de GitHub (un admin instala la GitHub app; un owner la activa) y aparecen en ~24 h. Son deliberadamente conservadoras: solo cuentan líneas y PRs donde hay alta confianza de que Claude Code participó —de hecho descartan código reescrito por el dev en más de un ~20 %, lock files y ficheros generados—. Son un suelo, no un techo, del impacto real.

Si no tienes dashboard (la mayoría)

Ese panel es solo para admins de Team/Enterprise. Si trabajas en solitario o en un plan Pro, no lo verás —pero sí puedes medir lo mismo con lo que ya tienes: tu repositorio y, si quieres, telemetría local.

Opción ligera — git log. Cuando Claude Code crea un commit, suele añadir un trailer de coautoría al mensaje. El formato exacto varía según tu configuración (el trailer típico es Co-Authored-By: Claude <noreply@anthropic.com>), así que ajústalo a lo que veas en tu propio historial. Para hacerte una idea de adopción e impacto:

# ¿Qué patrón de coautoría usan TUS commits? (mira primero esto)
git log --format='%(trailers:key=Co-Authored-By)' | sort -u

# Commits con coautoría de Claude vs total, en los últimos 90 días
git log --since='90 days ago' --grep='Co-Authored-By: Claude' -i --oneline | wc -l
git log --since='90 days ago' --oneline | wc -l

# Tendencia por semana: ¿sube, baja o se estanca?
git log --since='90 days ago' --grep='Co-Authored-By: Claude' -i \
  --date=format:'%Y-W%V' --format='%cd' | sort | uniq -c

Si conectaste el dashboard de contribución, GitHub etiqueta los PRs asistidos como claude-code-assisted —puedes contarlos con gh pr list --label claude-code-assisted aunque no veas el panel.

Opción potente — telemetría local con OpenTelemetry. Cualquier usuario puede activarla; no necesitas plan de equipo. Con el exporter console ves las métricas en tu propio terminal, sin montar backend:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
claude

Claude Code exporta, entre otras, claude_code.session.count, claude_code.lines_of_code.count, claude_code.commit.count, claude_code.pull_request.count, claude_code.cost.usage y claude_code.code_edit_tool.decision (con atributo decision: accept / reject) —de donde sale tu propio accept rate. Para un seguimiento real, apunta el exporter otlp a tu observabilidad en vez de a console.

De los datos a las decisiones

Tengas dashboard o solo git log, los datos no son para vigilar a nadie; son para mantener vivo tu setup. No hay cifras oficiales de "bueno" o "malo" —la doc no las da—, así que vigila tendencias y cambios bruscos, no números absolutos:

  • Adopción (usuarios/sesiones): lo que importa es la dirección. Una caída sostenida suele señalar fricción — algo se rompió o estorba. Ve a por la causa.
  • Accept rate: úsalo como termómetro relativo a ti mismo. Un buen valor "normal" es el tuyo cuando todo va fino; lo accionable es una caída sostenida tras un cambio (una skill nueva, una regla de CLAUDE.md, un hook), que apunta a que ese cambio empeoró las sugerencias.
  • Leaderboard: identifica power users que pueden compartir técnicas y onboardear al resto. Lo que ellos hacen bien, conviértelo en una skill o una regla de CLAUDE.md del equipo.
  • PRs/líneas con vs sin Claude Code: la medida de ROI para responder "¿merece la pena?" con datos de tu propio código, junto a tus KPIs (DORA, velocidad de sprint).

El ciclo de mantenimiento

Todo el plan de estudios cierra en bucle aquí. Lo que mides te dice qué tocar:

  1. Refuerza lo que se usa y funciona: documéntalo, empaquétalo en un plugin, hazlo el estándar del equipo.
  2. Retira lo que nadie usa o estorba: una skill que no se invoca, un hook que molesta más que ayuda, una routine que ya no aporta.
  3. Cura el contexto: igual que la auto memory, tu configuración de equipo se mantiene, no se acumula sin fin.

La misma disciplina de la primera lección del plan —curar el contexto— aplicada a escala de equipo: lo que no aporta, fuera.

Pruébalo

Mide tu propia adopción ahora mismo, sin dashboard. En un repo donde uses Claude Code:

# Cuántos commits llevan coautoría de Claude vs el total (últimos 90 días)
git log --since='90 days ago' --grep='Co-Authored-By: Claude' -i --oneline | wc -l
git log --since='90 days ago' --oneline | wc -l

Si el primer número es una fracción apreciable del segundo, Claude Code ya es parte de tu flujo. Repite el conteo dentro de un mes: lo que miras es si la tendencia sube, no el número exacto.

Si falla

  • El conteo da 0 aunque uses Claude Code: tus commits no llevan ese trailer. Mira qué patrón usas de verdad con git log --format='%(trailers)' | sort -u, o si commiteas a mano sin que Claude lo haga. Ajusta el --grep a tu patrón real.
  • claude_code... no aparece con el exporter console: confirma que exportaste CLAUDE_CODE_ENABLE_TELEMETRY=1 antes de lanzar claude, y recuerda que el intervalo por defecto es de 60 s —baja OTEL_METRIC_EXPORT_INTERVAL para verlas antes mientras pruebas.
  • No ves el dashboard pese a estar en Team/Enterprise: solo lo ven admins y owners; las métricas de contribución además necesitan la GitHub app instalada y tardan ~24 h en aparecer.

Cierre del curso y del plan de estudios

Has llegado al techo: de un agente a una flota coordinada y autónoma, y a medir su impacto. Recapitulando los seis niveles:

  • Fundamentos → qué es y cómo conducir una sesión.
  • Contexto y configuraciónCLAUDE.md, memoria, permisos, seguridad.
  • Extender → slash commands, skills, subagentes, hooks.
  • Integración → MCP y plugins.
  • Escalar y producción → CI y orquestación (este curso).

Has pasado de usar Claude Code a tenerlo como infraestructura de tu equipo, medida y mantenida.

Queda un peldaño opcional para quien quiera cruzar de usar a construir: el Agent SDK, para programar tu propio agente sobre el mismo motor. No lo necesitas para dominar Claude Code — es para quien quiera ir más allá.

Fuente oficial: Track team usage with analytics · Monitoring with OpenTelemetry

¿Quieres llevar la cuenta de las lecciones que has terminado?

Entrar para guardar progreso