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 requeridaEsta 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 integracionesSi 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ámetroTipoRequeridoDescripción
starting_atstringSíFecha UTC en formato YYYY-MM-DD. Devuelve métricas solo para este 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 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": "[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-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: