---
title: API de Analytics de Claude Code
url: https://platform.claude.com/docs/es/manage-claude/claude-code-analytics-api
description: 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 Admin API no está disponible para cuentas individuales.** Para colaborar con compañeros de equipo y agregar miembros, configura tu organización en la página [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) en la Claude Console.
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](https://platform.claude.com/claude-code) 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
**Se requieren credenciales de la Admin API.** Estos endpoints forman parte de la Admin API. Puedes acceder a ellos usando una [clave de Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api-keys), un token de OAuth con el alcance `org:admin`, o una clave personal o de cuenta de servicio que no esté limitada a un espacio de trabajo; las claves de API de espacio de trabajo no funcionan. Consulta [Autenticación](https://platform.claude.com/docs/es/manage-claude/admin-api#authentication) para obtener más detalles.
**Claude Platform on AWS:** La API de Analytics de Claude Code no está disponible actualmente. En su lugar, consulta el uso de Claude Code en la página **Usage** del Claude Console.
**Organizaciones de Claude Enterprise:** La actividad de Claude Code de los usuarios de claude.ai se reporta mediante la API de Analytics de Claude Enterprise, que usa una clave de API de Analytics en lugar de una clave de API de administración. Consulta [APIs de Analytics](https://platform.claude.com/docs/es/manage-claude/analytics-api) para saber qué API y qué tipo de clave necesita tu organización.
## Inicio rápido
Obtén las analíticas de Claude Code de tu organización para un día específico:
```bash 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"
```
**Establece un encabezado User-Agent para integraciones**
Si estás creando una integración, establece tu encabezado User-Agent para ayudar a Anthropic a comprender los patrones de uso:
```text wrap
User-Agent: YourApp/1.0.0 (https://yourapp.com)
```
## 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](https://platform.claude.com/docs/es/api/beta/organization/usage_report/retrieve_claude_code).
### Ejemplos básicos
#### Obtener analíticas para un día específico
```bash 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
```bash 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ámetro | Tipo | Requerido | Descripción |
| ------------- | ------- | --------- | --------------------------------------------------------------------------- |
| `starting_at` | string | Sí | Fecha UTC en formato YYYY-MM-DD; devuelve métricas solo para este único 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 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:
```json
{
"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-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 113
}
}
]
}
],
"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](https://code.claude.com/docs/en/monitoring-usage).
### ¿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](https://platform.claude.com/docs/es/build-with-claude/claude-in-amazon-bedrock), [Claude en Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry), [Claude en Google Cloud](https://platform.claude.com/docs/es/build-with-claude/claude-on-vertex-ai) o [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/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:
* [API de administración](https://platform.claude.com/docs/es/manage-claude/admin-api)
* [Referencia de la API de administración](https://platform.claude.com/docs/es/api/beta/organization)
* [Panel de Analytics de Claude Code](https://platform.claude.com/claude-code)
* [API de uso y costos](https://platform.claude.com/docs/es/manage-claude/usage-cost-api) - Rastrea el uso de la API en todos los servicios de Anthropic
* [API de cumplimiento](https://platform.claude.com/docs/es/manage-claude/compliance-api) - Recupera datos de auditoría y actividad
* [Gestión de identidad y acceso](https://code.claude.com/docs/en/iam)
* [Monitoreo del uso con OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage) para métricas personalizadas y alertas