---
title: Claude Code Analytics API
url: https://platform.claude.com/docs/ru/manage-claude/claude-code-analytics-api
description: Программный доступ к аналитике использования Claude Code и метрикам продуктивности вашей организации с помощью Claude Code Analytics Admin API.
---
**Admin API недоступен для индивидуальных учётных записей.** Чтобы сотрудничать с коллегами и добавлять участников, настройте свою организацию на странице [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) в Claude Console.
Claude Code Analytics Admin API предоставляет программный доступ к ежедневным агрегированным метрикам использования для пользователей Claude Code, позволяя организациям анализировать продуктивность разработчиков и создавать собственные панели мониторинга. Этот API предоставляет больше деталей, чем базовая [панель аналитики](https://platform.claude.com/claude-code), без сложности интеграции с OpenTelemetry.
Этот API позволяет вам лучше отслеживать, анализировать и оптимизировать внедрение Claude Code:
* **Анализ продуктивности разработчиков:** отслеживайте сессии, добавленные/удалённые строки кода, коммиты и пулл-реквесты, созданные с помощью Claude Code
* **Метрики использования инструментов:** отслеживайте показатели принятия и отклонения для различных инструментов Claude Code (Edit, MultiEdit, Write, NotebookEdit)
* **Анализ затрат:** просматривайте оценочную стоимость и использование токенов с разбивкой по моделям Claude
* **Пользовательская отчётность:** экспортируйте данные для создания панелей мониторинга и отчётов для руководства
* **Обоснование использования:** предоставляйте метрики для обоснования и расширения внедрения Claude Code внутри организации
**Требуются учётные данные Admin API.** Эти конечные точки являются частью Admin API. Вы можете получить к ним доступ, используя [ключ Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api-keys), токен OAuth с областью действия `org:admin` либо ключ личной или сервисной учётной записи, не ограниченный рабочим пространством; ключи API рабочего пространства не подходят. Подробности см. в разделе [Аутентификация](https://platform.claude.com/docs/ru/manage-claude/admin-api#authentication).
**Claude Platform on AWS:** Claude Code Analytics API в настоящее время недоступен. Вместо этого просматривайте использование Claude Code на странице **Usage** в Claude Console.
**Организации Claude Enterprise:** активность Claude Code для пользователей claude.ai предоставляется через Claude Enterprise Analytics API, который использует ключ Analytics API вместо ключа Admin API. См. раздел [Analytics API](https://platform.claude.com/docs/ru/manage-claude/analytics-api), чтобы узнать, какой API и тип ключа нужен вашей организации.
## Быстрый старт
Получите аналитику Claude Code вашей организации за конкретный день:
```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"
```
**Установите заголовок User-Agent для интеграций**
Если вы создаёте интеграцию, установите заголовок User-Agent, чтобы помочь Anthropic понять паттерны использования:
```text wrap
User-Agent: YourApp/1.0.0 (https://yourapp.com)
```
## Claude Code Analytics API
Отслеживайте использование Claude Code, метрики продуктивности и активность разработчиков в вашей организации с помощью эндпоинта `/v1/organizations/usage_report/claude_code`.
### Ключевые понятия
* **Ежедневная агрегация:** возвращает метрики за один день, указанный параметром `starting_at`
* **Данные на уровне пользователя:** каждая запись представляет активность одного пользователя за указанный день
* **Метрики продуктивности:** отслеживайте сессии, строки кода, коммиты, пулл-реквесты и использование инструментов
* **Данные о токенах и стоимости:** отслеживайте использование и оценочную стоимость с разбивкой по моделям Claude
* **Курсорная пагинация:** обрабатывайте большие наборы данных со стабильной пагинацией с использованием непрозрачных курсоров
* **Актуальность данных:** метрики доступны с задержкой до 1 часа для обеспечения согласованности
Полное описание параметров и схем ответов см. в [справочнике Claude Code Analytics API](https://platform.claude.com/docs/ru/api/beta/organization/usage_report/retrieve_claude_code).
### Базовые примеры
#### Получение аналитики за конкретный день
```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"
```
#### Получение аналитики с пагинацией
```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"
# Последующий запрос с использованием курсора из ответа
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"
```
### Параметры запроса
| Параметр | Тип | Обязательный | Описание |
| ------------- | ------- | ------------ | -------------------------------------------------------------------------- |
| `starting_at` | string | Да | Дата UTC в формате YYYY-MM-DD; возвращает метрики только за этот один день |
| `limit` | integer | Нет | Количество записей на странице (по умолчанию: 20, максимум: 1000) |
| `page` | string | Нет | Непрозрачный токен курсора из поля `next_page` предыдущего ответа |
### Доступные метрики
Каждая запись ответа содержит следующие метрики для одного пользователя за один день:
#### Измерения
* **date:** дата в формате RFC 3339 (временная метка UTC)
* **actor:** пользователь или ключ API, выполнивший действия Claude Code (либо `user_actor` с `email_address`, либо `api_actor` с `api_key_name`)
* **organization\_id:** UUID организации
* **customer\_type:** тип учётной записи клиента (`api` для клиентов API, `subscription` для клиентов Pro/Team)
* **terminal\_type:** тип терминала или среды, в которой использовался Claude Code (например, `vscode`, `iTerm.app`, `tmux`)
#### Основные метрики
* **num\_sessions:** количество отдельных сессий Claude Code, инициированных этим актором
* **lines\_of\_code.added:** общее количество строк кода, добавленных Claude Code во всех файлах
* **lines\_of\_code.removed:** общее количество строк кода, удалённых Claude Code во всех файлах
* **commits\_by\_claude\_code:** количество git-коммитов, созданных с помощью функции коммитов Claude Code
* **pull\_requests\_by\_claude\_code:** количество пулл-реквестов, созданных с помощью функции PR Claude Code
#### Метрики действий инструментов
Разбивка показателей принятия и отклонения действий инструментов по типу инструмента:
* **edit\_tool.accepted/rejected:** количество предложений инструмента Edit, которые пользователь принял/отклонил
* **multi\_edit\_tool.accepted/rejected:** количество предложений инструмента MultiEdit, которые пользователь принял/отклонил
* **write\_tool.accepted/rejected:** количество предложений инструмента Write, которые пользователь принял/отклонил
* **notebook\_edit\_tool.accepted/rejected:** количество предложений инструмента NotebookEdit, которые пользователь принял/отклонил
#### Разбивка по моделям
Для каждой использованной модели Claude:
* **model:** идентификатор модели Claude (например, `claude-opus-5`)
* **tokens.input/output:** количество входных и выходных токенов для этой модели
* **tokens.cache\_read/cache\_creation:** использование токенов, связанное с кэшем, для этой модели
* **estimated\_cost.amount:** оценочная стоимость в центах USD для этой модели
* **estimated\_cost.currency:** код валюты для суммы стоимости (в настоящее время всегда `USD`)
### Структура ответа
API возвращает данные в следующем формате:
```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
}
```
## Пагинация
API поддерживает курсорную пагинацию для организаций с большим количеством пользователей:
1. Выполните первоначальный запрос с необязательным параметром `limit`.
2. Если `has_more` в ответе равно `true`, используйте значение `next_page` в следующем запросе.
3. Продолжайте, пока `has_more` не станет `false`.
Курсор кодирует позицию последней записи и обеспечивает стабильную пагинацию даже при поступлении новых данных. Каждая сессия пагинации поддерживает согласованную границу данных, чтобы вы не пропустили и не продублировали записи.
## Типичные сценарии использования
* **Панели мониторинга для руководства:** создавайте высокоуровневые отчёты, показывающие влияние Claude Code на скорость разработки
* **Сравнение ИИ-инструментов:** экспортируйте метрики для сравнения Claude Code с другими ИИ-инструментами для программирования, такими как Copilot и Cursor
* **Анализ продуктивности разработчиков:** отслеживайте индивидуальные и командные метрики продуктивности с течением времени
* **Отслеживание и распределение затрат:** отслеживайте паттерны расходов и распределяйте затраты по командам или проектам
* **Мониторинг внедрения:** определяйте, какие команды и пользователи получают наибольшую пользу от Claude Code
* **Обоснование ROI:** предоставляйте конкретные метрики для обоснования и расширения внедрения Claude Code внутри организации
## Часто задаваемые вопросы
### Насколько актуальны данные аналитики?
Данные аналитики Claude Code обычно появляются в течение 1 часа после завершения активности пользователя. Для обеспечения согласованных результатов пагинации в ответы включаются только данные старше 1 часа.
### Могу ли я получать метрики в реальном времени?
Нет, этот API предоставляет только ежедневные агрегированные метрики. Для мониторинга в реальном времени рассмотрите использование [интеграции с OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage).
### Как идентифицируются пользователи в данных?
Пользователи идентифицируются через поле `actor` двумя способами:
* **`user_actor`:** содержит `email_address` для пользователей, которые аутентифицируются через OAuth (наиболее распространённый вариант)
* **`api_actor`:** содержит `api_key_name` для пользователей, которые аутентифицируются с помощью ключа API
Поле `customer_type` указывает, относится ли использование к клиентам `api` (API с оплатой по факту использования) или к клиентам `subscription` (планы Pro/Team).
### Каков срок хранения данных?
Исторические данные аналитики Claude Code сохраняются и доступны через API. Для этих данных не установлен определённый срок удаления.
### Какие развёртывания Claude Code поддерживаются?
Этот API отслеживает только использование Claude Code через Claude API. Использование через [Claude в Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock), [Claude в Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry), [Claude в Google Cloud](https://platform.claude.com/docs/ru/build-with-claude/claude-on-vertex-ai) или [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) не включается.
### Сколько стоит использование этого API?
Claude Code Analytics API бесплатен для всех организаций, имеющих доступ к Admin API.
### Как рассчитать показатели принятия инструментов?
Показатель принятия инструмента = `accepted / (accepted + rejected)` для каждого типа инструмента. Например, если инструмент edit показывает 45 принятых и 5 отклонённых, показатель принятия составляет 90%.
### Какой часовой пояс используется для параметра даты?
Все даты указаны в UTC. Параметр `starting_at` должен быть в формате YYYY-MM-DD и представляет полночь UTC для этого дня.
## См. также
Claude Code Analytics API помогает вам понять и оптимизировать рабочий процесс разработки вашей команды. Узнайте больше о связанных функциях:
* [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api)
* [Справочник Admin API](https://platform.claude.com/docs/ru/api/beta/organization)
* [Панель аналитики Claude Code](https://platform.claude.com/claude-code)
* [Usage and Cost API](https://platform.claude.com/docs/ru/manage-claude/usage-cost-api) — отслеживайте использование API во всех сервисах Anthropic
* [Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api) — получайте данные аудита и активности
* [Управление идентификацией и доступом](https://code.claude.com/docs/en/iam)
* [Мониторинг использования с помощью OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage) для пользовательских метрик и оповещений