API de Análisis de Código de Claude

Accede programáticamente a los análisis de uso de Claude Code de tu organización y métricas de productividad con la API de Administración de Análisis de Código de Claude.

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

La API de Administración de Análisis de Código de Claude proporciona acceso programático a métricas de uso agregadas diariamente para usuarios de Claude Code, permitiendo a las organizaciones analizar la productividad de los desarrolladores y construir paneles personalizados. Esta API cierra la brecha entre nuestro panel de Análisis básico y la integración compleja de OpenTelemetry.

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

• Análisis de Productividad del Desarrollador: 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 para diferentes herramientas de Claude Code (Edit, MultiEdit, Write, NotebookEdit)
• Análisis de Costos: Ve costos estimados y uso de tokens desglosados por modelo de Claude
• Reportes Personalizados: Exporta datos para construir 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

Clave de API de administrador requerida

Esta API es parte de la API de Administración. Estos endpoints requieren una clave de API de Administrador (que comienza con sk-ant-admin...) que difiere de las claves de API estándar. Solo los miembros de la organización con el rol de administrador pueden aprovisionar claves de API de Administrador a través de la Consola de Anthropic.

Inicio rápido

Obtén los análisis 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"

Establece un encabezado User-Agent para integraciones

Si estás construyendo una integración, establece tu encabezado User-Agent para ayudarnos a entender los patrones de uso:

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

API de Análisis de Código de Claude

Rastrea el uso de Claude Code, métricas de productividad y actividad de 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: Rastrea sesiones, líneas de código, commits, pull requests y uso de herramientas
• Datos de tokens y costos: Monitorea el uso y costos estimados desglosados por modelo de Claude
• Paginación basada en cursor: Maneja grandes conjuntos de datos con paginación estable usando cursores opacos
• Frescura de datos: Las métricas están disponibles con hasta 1 hora de retraso para consistencia

Para detalles completos de parámetros y esquemas de respuesta, consulta la referencia de la API de Análisis de Código de Claude.

Ejemplos básicos

Obtener análisis 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 análisis 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 subsecuente usando 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 solicitud

Parámetro	Tipo	Requerido	Descripción
starting_at	string	Sí	Fecha UTC en formato YYYY-MM-DD. Devuelve métricas solo para este día
limit	integer	No	Número de registros por página (predeterminado: 20, máximo: 1000)
page	string	No	Token de cursor opaco del campo next_page de la respuesta anterior

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 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 (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 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 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 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 usado:

• model: Identificador del modelo de Claude (ej., claude-3-5-sonnet-20241022)
• tokens.input/output: Conteos 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 USD para este modelo
• estimated_cost.currency: Código de moneda para el monto del costo (actualmente siempre USD)

Estructura de respuesta

La API devuelve datos en el siguiente formato:

{
  "data": [
    {
      "date": "2025-09-01T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "[e-mail]"
      },
      "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-3-5-sonnet-20241022",
          "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 soporta paginación basada en cursor para organizaciones con grandes números de usuarios:

1. Haz tu solicitud inicial con el parámetro opcional limit
2. Si has_more es true en la respuesta, usa el valor 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 asegura paginación estable incluso cuando llegan nuevos datos. Cada sesión de paginación mantiene un límite de datos consistente para asegurar que no pierdas o dupliques registros.

Casos de uso comunes

• Paneles ejecutivos: Crear informes de alto nivel mostrando el impacto de Claude Code en la velocidad de desarrollo
• Comparación de herramientas de IA: Exportar métricas para comparar Claude Code con otras herramientas de codificación de IA como Copilot y Cursor
• Análisis de productividad del desarrollador: Rastrear métricas de productividad individual y de equipo a lo largo del tiempo
• Seguimiento y asignación de costos: Monitorear patrones de gasto y asignar costos por equipo o proyecto
• Monitoreo de adopción: Identificar qué equipos y usuarios están obteniendo el mayor valor de Claude Code
• Justificación de ROI: Proporcionar métricas concretas para justificar y expandir la adopción de Claude Code internamente

Preguntas frecuentes

¿Qué tan frescos son los datos de análisis?

Los datos de análisis de Claude Code típicamente aparecen dentro de 1 hora de la finalización de la actividad del usuario. Para asegurar resultados de paginación consistentes, solo se incluyen en las respuestas datos con más de 1 hora de antigüedad.

¿Puedo obtener métricas en tiempo real?

No, esta API proporciona solo 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 vía OAuth (más común)
• api_actor: Contiene api_key_name para usuarios que se autentican vía clave de API

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

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

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

¿Qué despliegues de Claude Code son soportados?

Esta API solo rastrea el uso de Claude Code en la API de Anthropic (1ra parte). El uso en Amazon Bedrock, Google Vertex AI u otras plataformas de terceros no está incluido.

¿Cuánto cuesta usar esta API?

La API de Análisis de Código de Claude 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 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 para ese día.

Ver también

La API de Análisis de Código de Claude te ayuda a entender y optimizar el flujo de trabajo de desarrollo de tu equipo. Aprende más sobre características relacionadas:

• Descripción general de la API de Administración
• Referencia de la API de Administración
• Panel de Análisis de Código de Claude
• API de Uso y Costo - Rastrea el uso de API en todos los servicios de Anthropic
• Gestión de identidad y acceso
• Monitoreo de uso con OpenTelemetry para métricas personalizadas y alertas