API de Analíticas de Claude Code

La API de Administración de Analíticas de Claude Code proporciona acceso programático a métricas de uso agregadas diariamente para los usuarios de Claude Code, lo que permite a las organizaciones analizar la productividad de los desarrolladores y crear paneles personalizados. Esta API cubre la brecha entre el panel de Analíticas básico y la compleja integración de OpenTelemetry.

Esta API te permite monitorear, analizar y optimizar mejor tu adopción de Claude Code:

• Análisis de productividad de desarrolladores: Realiza un seguimiento de sesiones, líneas de código añadidas/eliminadas, commits y pull requests creados con Claude Code
• Métricas de uso de herramientas: Monitorea las tasas de aceptación y rechazo de diferentes herramientas de Claude Code (Edit, MultiEdit, Write, NotebookEdit)
• Análisis de costos: Visualiza los costos estimados y el uso de tokens desglosados por modelo de Claude
• Informes personalizados: Exporta datos para crear paneles ejecutivos e informes para equipos de gestión
• Justificación de uso: Proporciona métricas para justificar y expandir la adopción de Claude Code internamente

Inicio rápido

Obtén las analíticas de Claude Code de tu organización para un día específico:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

User-Agent: YourApp/1.0.0 (https://yourapp.com)

API de Analíticas de Claude Code

Realiza un seguimiento del uso de Claude Code, las métricas de productividad y la actividad de los desarrolladores en toda tu organización con el endpoint /v1/organizations/usage_report/claude_code.

Conceptos clave

• Agregación diaria: Devuelve métricas para un solo día especificado por el parámetro starting_at
• Datos a nivel de usuario: Cada registro representa la actividad de un usuario para el día especificado
• Métricas de productividad: Realiza un seguimiento de sesiones, líneas de código, commits, pull requests y uso de herramientas
• Datos de tokens y costos: Monitorea el uso y los costos estimados desglosados por modelo de Claude
• Paginación basada en cursor: Maneja grandes conjuntos de datos con paginación estable usando cursores opacos
• Actualidad de los datos: Las métricas están disponibles con un retraso de hasta 1 hora para garantizar la consistencia

Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta la referencia de la API de Analíticas de Claude Code.

Ejemplos básicos

Obtener analíticas para un día específico

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Obtener analíticas con paginación

# Primera solicitud
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# Solicitud posterior usando el cursor de la respuesta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Parámetros de la solicitud

Métricas disponibles

Cada registro de respuesta contiene las siguientes métricas para un solo usuario en un solo día:

Dimensiones

• date: Fecha en formato RFC 3339 (marca de tiempo UTC)
• actor: El usuario o la clave de API que realizó las acciones de Claude Code (ya sea user_actor con email_address o api_actor con api_key_name)
• organization_id: UUID de la organización
• customer_type: Tipo de cuenta de cliente (api para clientes de API, subscription para clientes Pro/Team)
• terminal_type: Tipo de terminal o entorno donde se usó Claude Code (p. ej., vscode, iTerm.app, tmux)

Métricas principales

• num_sessions: Número de sesiones distintas de Claude Code iniciadas por este actor
• lines_of_code.added: Número total de líneas de código añadidas en todos los archivos por Claude Code
• lines_of_code.removed: Número total de líneas de código eliminadas en todos los archivos por Claude Code
• commits_by_claude_code: Número de commits de git creados a través de la funcionalidad de commit de Claude Code
• pull_requests_by_claude_code: Número de pull requests creados a través de la funcionalidad de PR de Claude Code

Métricas de acciones de herramientas

Desglose de las tasas de aceptación y rechazo de acciones de herramientas por tipo de herramienta:

• edit_tool.accepted/rejected: Número de propuestas de la herramienta Edit que el usuario aceptó/rechazó
• multi_edit_tool.accepted/rejected: Número de propuestas de la herramienta MultiEdit que el usuario aceptó/rechazó
• write_tool.accepted/rejected: Número de propuestas de la herramienta Write que el usuario aceptó/rechazó
• notebook_edit_tool.accepted/rejected: Número de propuestas de la herramienta NotebookEdit que el usuario aceptó/rechazó

Desglose por modelo

Para cada modelo de Claude utilizado:

• model: Identificador del modelo de Claude (p. ej., claude-opus-4-8)
• tokens.input/output: Recuentos de tokens de entrada y salida para este modelo
• tokens.cache_read/cache_creation: Uso de tokens relacionados con caché para este modelo
• estimated_cost.amount: Costo estimado en centavos de USD para este modelo
• estimated_cost.currency: Código de moneda para el monto del costo (actualmente siempre USD)

Estructura de la respuesta

La API devuelve datos en el siguiente formato:

{
  "data": [
    {
      "date": "2025-09-08T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]"
      },
      "organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
      "customer_type": "api",
      "terminal_type": "vscode",
      "core_metrics": {
        "num_sessions": 5,
        "lines_of_code": {
          "added": 1543,
          "removed": 892
        },
        "commits_by_claude_code": 12,
        "pull_requests_by_claude_code": 2
      },
      "tool_actions": {
        "edit_tool": {
          "accepted": 45,
          "rejected": 5
        },
        "multi_edit_tool": {
          "accepted": 12,
          "rejected": 2
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-opus-4-8",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

Paginación

La API admite paginación basada en cursor para organizaciones con un gran número de usuarios:

1. Realiza tu solicitud inicial con el parámetro opcional limit
2. Si has_more es true en la respuesta, usa el valor de next_page en tu siguiente solicitud
3. Continúa hasta que has_more sea false

El cursor codifica la posición del último registro y garantiza una paginación estable incluso cuando llegan nuevos datos. Cada sesión de paginación mantiene un límite de datos consistente para garantizar que no omitas ni dupliques registros.

Casos de uso comunes

• Paneles ejecutivos: Crea informes de alto nivel que muestren el impacto de Claude Code en la velocidad de desarrollo
• Comparación de herramientas de IA: Exporta métricas para comparar Claude Code con otras herramientas de codificación con IA como Copilot y Cursor
• Análisis de productividad de desarrolladores: Realiza un seguimiento de las métricas de productividad individuales y de equipo a lo largo del tiempo
• Seguimiento y asignación de costos: Monitorea los patrones de gasto y asigna costos por equipo o proyecto
• Monitoreo de adopción: Identifica qué equipos y usuarios están obteniendo el mayor valor de Claude Code
• Justificación del ROI: Proporciona métricas concretas para justificar y expandir la adopción de Claude Code internamente

Preguntas frecuentes

¿Qué tan actualizados están los datos de analíticas?

Los datos de analíticas de Claude Code generalmente aparecen dentro de 1 hora después de que se completa la actividad del usuario. Para garantizar resultados de paginación consistentes, solo se incluyen en las respuestas los datos con más de 1 hora de antigüedad.

¿Puedo obtener métricas en tiempo real?

No, esta API solo proporciona métricas agregadas diariamente. Para monitoreo en tiempo real, considera usar la integración de OpenTelemetry.

¿Cómo se identifican los usuarios en los datos?

Los usuarios se identifican a través del campo actor de dos maneras:

• user_actor: Contiene email_address para usuarios que se autentican a través de OAuth (lo más común)
• api_actor: Contiene api_key_name para usuarios que se autentican con una clave de API

El campo customer_type indica si el uso proviene de clientes api (API de pago por uso) o clientes subscription (planes Pro/Team).

¿Cuál es el período de retención de datos?

Los datos históricos de analíticas de Claude Code se conservan y son accesibles a través de la API. No hay un período de eliminación especificado para estos datos.

¿Qué implementaciones de Claude Code son compatibles?

Esta API solo realiza un seguimiento del uso de Claude Code en la API de Claude. El uso a través de Claude Platform en AWS, Claude en Microsoft Foundry, Claude en Amazon Bedrock o Claude en Vertex AI no está incluido.

¿Cuánto cuesta usar esta API?

La API de Analíticas de Claude Code es gratuita para todas las organizaciones con acceso a la API de Administración.

¿Cómo calculo las tasas de aceptación de herramientas?

Tasa de aceptación de herramienta = accepted / (accepted + rejected) para cada tipo de herramienta. Por ejemplo, si la herramienta edit muestra 45 aceptadas y 5 rechazadas, la tasa de aceptación es del 90%.

¿Qué zona horaria se usa para el parámetro de fecha?

Todas las fechas están en UTC. El parámetro starting_at debe estar en formato YYYY-MM-DD y representa la medianoche UTC de ese día.

Consulta también

La API de Analíticas de Claude Code te ayuda a comprender y optimizar el flujo de trabajo de desarrollo de tu equipo. Obtén más información sobre funciones relacionadas:

• API de Administración
• Referencia de la API de Administración
• Panel de Analíticas de Claude Code
• API de Uso y Costos - Realiza un seguimiento del uso de la API en todos los servicios de Anthropic
• API de Cumplimiento - Recupera datos de auditoría y actividad
• Gestión de identidad y acceso
• Monitoreo de uso con OpenTelemetry para métricas personalizadas y alertas