La Admin API no está disponible para cuentas individuales. Para colaborar con compañeros de equipo y agregar miembros, configura tu organización en Console → Settings → Organization.
La Admin API de Analítica de Claude Code proporciona acceso programático a métricas de uso agregadas diariamente para 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 Analítica 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:
Se requiere una clave de API de administrador. Estos endpoints requieren una clave de API de administrador, que es diferente de una clave de API estándar de Claude. Consulta Crear una clave de API de administrador para saber dónde crear una para tu tipo de organización y qué alcances seleccionar.
Claude Platform en AWS: La API de Analítica de Claude Code no está disponible actualmente. En su lugar, visualiza el uso de Claude Code en la página Usage en la Claude Console.
Organizaciones Claude Enterprise: La actividad de Claude Code para usuarios de claude.ai se reporta mediante la API de Analítica de Claude Enterprise, que usa una clave de API de Analítica en lugar de una clave de Admin API. Consulta APIs de Analítica para saber qué API y tipo de clave necesita tu organización.
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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ADMIN_API_KEY"Configura un encabezado User-Agent para integraciones
Si estás construyendo una integración, configura tu encabezado User-Agent para ayudarnos a entender los patrones de uso:
User-Agent: YourApp/1.0.0 (https://yourapp.com)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.
starting_atPara obtener detalles completos de los parámetros y los esquemas de respuesta, consulta la referencia de la API de Analítica de Claude Code.
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: $ADMIN_API_KEY"# 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: $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=" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ADMIN_API_KEY"| 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 |
Cada registro de respuesta contiene las siguientes métricas para un solo usuario en un solo día:
user_actor con email_address o api_actor con api_key_name)api para clientes de API, subscription para clientes Pro/Team)vscode, iTerm.app, tmux)Desglose de las tasas de aceptación y rechazo de acciones de herramientas por tipo de herramienta:
Para cada modelo de Claude utilizado:
claude-opus-5)USD)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-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 141
}
}
]
}
],
"has_more": false,
"next_page": null
}La API admite paginación basada en cursores para organizaciones con grandes cantidades de usuarios:
limit.has_more es true en la respuesta, usa el valor de next_page en tu siguiente solicitud.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 pierdas ni dupliques registros.
Los datos de analítica de Claude Code generalmente 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.
No, esta API proporciona únicamente métricas agregadas diariamente. Para monitoreo en tiempo real, considera usar la integración con OpenTelemetry.
Los usuarios se identifican a través del campo actor de dos maneras:
user_actor: Contiene email_address para usuarios que se autentican mediante OAuth (lo más común)api_actor: Contiene api_key_name para usuarios que se autentican con una clave de APIEl campo customer_type indica si el uso proviene de clientes api (API de pago por uso) o clientes subscription (planes Pro/Team).
Los datos históricos de analítica 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.
Esta API solo rastrea el uso de Claude Code en la Claude API. El uso a través de Claude en Amazon Bedrock, Claude en Microsoft Foundry, Claude en Google Cloud o Claude Platform en AWS no está incluido.
La API de Analítica de Claude Code es gratuita para todas las organizaciones con acceso a la Admin API.
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%.
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.
La API de Analítica de Claude Code te ayuda a entender y optimizar el flujo de trabajo de desarrollo de tu equipo. Obtén más información sobre funciones relacionadas:
Was this page helpful?