Claude Platform Docs
AdministraciónMonitoreo

API de Analytics de Claude Code

Accede de forma programática a las analíticas de uso y métricas de productividad de Claude Code de tu organización con la API de administración de Analytics de Claude Code.

La API de administración de Analytics 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 proporciona más detalle que el panel de Analytics básico sin la complejidad de la integración con OpenTelemetry.

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

  • Análisis de productividad de desarrolladores: Rastrea sesiones, líneas de código agregadas/eliminadas, commits y pull requests creados usando Claude Code
  • Métricas de uso de herramientas: Monitorea las tasas de aceptación y rechazo de las diferentes herramientas de Claude Code (Edit, MultiEdit, Write, NotebookEdit)
  • Análisis de costos: Consulta los costos estimados y el uso de tokens desglosados por modelo de Claude
  • Informes personalizados: Exporta datos para crear paneles ejecutivos e informes para los equipos de gestión
  • Justificación del uso: Proporciona métricas para justificar y ampliar 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
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

API de Analytics de Claude Code

Rastrea el 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 único 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: Rastrea 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 cursores: 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 los detalles completos de los parámetros y los esquemas de respuesta, consulta la referencia de la API de Analytics de Claude Code.

Ejemplos básicos

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

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

Obtener analíticas con paginación

cURL
# Primera solicitud
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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=" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Parámetros de la solicitud

ParámetroTipoRequeridoDescripción
starting_atstringSíFecha UTC en formato YYYY-MM-DD; devuelve métricas solo para este único día
limitintegerNoNúmero de registros por página (predeterminado: 20, máximo: 1000)
pagestringNoToken de cursor opaco del campo next_page de la respuesta anterior

Métricas disponibles

Cada registro de la respuesta contiene las siguientes métricas para un único usuario en un único 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 la API, subscription para clientes Pro/Team)
  • terminal_type: Tipo de terminal o entorno donde se usó Claude Code (por ejemplo, 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 agregadas 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 mediante la funcionalidad de commit de Claude Code
  • pull_requests_by_claude_code: Número de pull requests creados mediante 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 (por ejemplo, claude-opus-5)
  • tokens.input/output: Recuento de tokens de entrada y salida para este modelo
  • tokens.cache_read/cache_creation: Uso de tokens relacionado con la 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": "developer@company.com"
      },
      "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-5",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 141
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

Paginación

La API admite paginación basada en cursores 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 datos nuevos. 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: Rastrea 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 la 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 ampliar 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 normalmente aparecen dentro de 1 hora después de que finaliza 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 el monitoreo en tiempo real, considera usar la integración con 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 los usuarios que se autentican mediante OAuth (lo más común)
  • api_actor: Contiene api_key_name para los 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 de 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 rastrea el uso de Claude Code en la API de Claude. El uso a través de Claude en Amazon Bedrock, Claude en Microsoft Foundry, Claude en Google Cloud o Claude Platform on AWS no está incluido.

¿Cuánto cuesta usar esta API?

La API de Analytics 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 herramientas = 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.

Ver también

La API de Analytics 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 las funciones relacionadas:

Was this page helpful?