АдминистрированиеМониторинг

API аналитики

Copy page



Разберитесь, какой API аналитики и какой ключ API нужен вашей организации, а затем предоставьте доступ к метрикам продуктивности Claude Code или к данным о вовлечённости и внедрении Claude Enterprise.

Anthropic предоставляет два API аналитики, и какой из них вы используете, зависит от того, каким продуктом Claude управляет ваша организация:

• Claude Code Analytics API предоставляет ежедневные метрики продуктивности Claude Code для организаций, использующих Claude Platform. Он является частью Admin API и использует ключ Admin API.
• Claude Enterprise Analytics API предоставляет данные о вовлечённости, внедрении и затратах в масштабе всей организации по продуктам Claude (чат, проекты, Claude Code и другие) для организаций Claude Enterprise. Он использует ключ Analytics API, созданный в claude.ai.

Эти два API используют разные типы ключей, создаваемые в разных местах разными ролями. На этой странице описано, какой API подходит вашей организации и как создать правильный ключ.

Какой API вам нужен?

Типы ключей не взаимозаменяемы: ключ Admin API не может вызывать Claude Enterprise Analytics API, а ключ Analytics API не может вызывать Admin API. Оба API представлены в справочнике Admin API, но это отдельные API с отдельными типами ключей. Если ваша организация использует и Claude Platform, и Claude Enterprise, вы можете создать оба ключа и использовать каждый API для его собственных данных.

Получение доступа к Claude Code Analytics API

Claude Code Analytics API доступен каждой организации, имеющей доступ к Admin API, и бесплатен в использовании.

1. 1

   Создайте ключ Admin API

   Следуйте шагам в разделе Создание ключа Admin API.

2. 2

   Вызовите API

   Передайте ключ в заголовке x-api-key:

   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: $ANTHROPIC_ADMIN_KEY"

   

Доступные метрики, параметры запроса и схему ответа см. в руководстве по Claude Code Analytics API и в справочнике API.

Получение доступа к Claude Enterprise Analytics API

Claude Enterprise Analytics API доступен организациям Claude Enterprise. Данные о вовлечённости и внедрении доступны на всех планах Enterprise. Конечные точки затрат и использования применимы к планам Enterprise с оплатой по использованию; для планов Enterprise с оплатой по местам они отражают только кредиты использования.

1. 1

   Войдите как основной владелец

   Только основной владелец организации может включить доступ к API и создавать ключи Analytics API.

2. 2

   Включите доступ к API и создайте ключ

   Перейдите в claude.ai > Organization settings > API и включите публичный доступ к API, затем создайте ключ Analytics API. Ключи имеют область действия read:analytics. Скопируйте отображённый секрет и сохраните его в вашем менеджере секретов.

3. 3

   Вызовите API

   Передайте ключ в заголовке x-api-key и включайте заголовок anthropic-version в каждый запрос. Эндпоинты расположены по адресу https://api.anthropic.com/v1/organizations/analytics/. Примеры запросов, параметры и схемы ответов см. в справочнике Claude Enterprise Analytics API.

Claude Enterprise Analytics API предоставляет:

• Активность пользователей: ежедневные метрики по каждому пользователю для чата (разговоры, сообщения, проекты, файлы, артефакты), Claude Code (сессии, коммиты, pull request'ы, строки кода, действия инструментов), объединённого Chat and Cowork (активность в чате и сессии Cowork) и других продуктов Claude
• Сводки активности: ежедневные, еженедельные и ежемесячные активные пользователи на уровне организации, количество мест и ожидающие приглашения
• Использование проектов, навыков и коннекторов: разбивка внедрения по проектам чата, навыкам и коннекторам
• Отчёты о затратах и использовании: использование токенов и затраты по каждому пользователю и на уровне организации с течением времени (планы Enterprise с оплатой по использованию)

Подробности о конечных точках, параметрах и схемах ответов см. в справочнике Claude Enterprise Analytics API. В следующих разделах рассматриваются актуальность данных, определения метрик и операционные рекомендации, применимые ко всем этим конечным точкам.

Доступность и актуальность данных

Данные Claude Enterprise Analytics API доступны для дат начиная с 1 января 2026 года.

Эндпоинты вовлечённости и внедрения (активность пользователей, сводки, проекты, навыки, коннекторы) возвращают снимок данных за указанную вами дату. Данные за определённый день обычно становятся доступны примерно к 13:00–13:30 UTC следующего дня (задержка в 1 день). До этого момента самым последним доступным днём обычно является день, отстоящий на два дня от текущей даты по UTC. Если вышестоящий конвейер данных запускается с опозданием, данные поступают позже. Точная актуальность также зависит от запроса. Поэтому не рассчитывайте на фиксированное время, а проверяйте ответ с ошибкой: запрос за дату, данные за которую ещё недоступны, возвращает ошибку 400 с указанием самого последнего доступного дня. Если данные не появляются намного позже обычной задержки, это, как правило, указывает на сбой конвейера данных на стороне Anthropic. Если задержка сохраняется, обратитесь в службу поддержки.

Конечные точки затрат и использования следуют другой модели актуальности. Данные обычно становятся доступны в течение четырёх часов после фактического использования, но это может занять до 24 часов. Значения могут пересматриваться по мере поступления запоздавших событий и выполнения сверки — примерно до 7 дней после окончания календарного месяца. Например, значения за 1 октября могут меняться примерно до 7 ноября. Для итоговых сумм, пригодных для выставления счетов, запрашивайте только месяцы, закончившиеся не менее 7 дней назад.

Как определяются метрики

Активные пользователи. Пользователь считается активным за день, если верно хотя бы одно из следующего: он отправил хотя бы одно сообщение в чате Claude, у него была хотя бы одна сессия Claude Code (локальная или удалённая), связанная с вашей организацией Claude Enterprise и включавшая «tool use» (использование инструментов) или активность git, либо у него была хотя бы одна сессия Cowork с использованием инструментов или активностью сообщений.

Объединённый Chat and Cowork (бета). Объединённый Chat and Cowork переносит возможности Cowork в чат claude.ai. Большая часть активности в объединённом Chat and Cowork отражается под значением продукта chat_cowork_unified, а не chat или cowork.

В активности пользователей, а также в использовании навыков, коннекторов и плагинов это использование отображается в объекте chat_cowork_unified_metrics. В сводках активности оно учитывается в chat_cowork_unified_daily_active_user_count, chat_cowork_unified_weekly_active_user_count и chat_cowork_unified_monthly_active_user_count.

По мере того как всё больше пользователей начинают использовать объединённый Chat and Cowork, использование перемещается из ваших показателей чата и Cowork в эти новые показатели. Использование за дни до того, как пользователь начал работать с объединённым Chat and Cowork, остаётся в чате или Cowork. Показатели по всей организации, такие как общее использование токенов, общие затраты и общее количество активных пользователей, не меняются. Отчёты о затратах и использовании, отфильтрованные по продукту, не включают использование объединённого Chat and Cowork, если products[] не содержит chat_cowork_unified.

Часть активности пользователей объединённого Chat and Cowork, например голосовой режим, по-прежнему может отражаться в чате или Cowork. Кроме того, в день, когда пользователь начинает использовать объединённый Chat and Cowork, его активность может быть разделена между продуктами. То же самое относится и к дню, когда эта функция для него отключается. Способ разделения активности не гарантируется.

Пользователь может учитываться как в показателях чата или Cowork, так и в показателях объединённого Chat and Cowork. Это может произойти в день, когда он использует объединённый Chat and Cowork, а часть его активности всё ещё отражается в чате или Cowork. В еженедельных и ежемесячных показателях он может учитываться в обоих наборах, если в окне есть активность обоих видов, даже в разные дни. Например, окно может охватывать дни до и после того, как он начал использовать объединённый Chat and Cowork.

При фильтрации активности пользователей по проекту активность в проектах за каждый день учитывается только в одном месте. Если в этот день пользователь отправил сообщение в чате объединённого Chat and Cowork, вся его активность в проектах учитывается в chat_cowork_unified_metrics.chat. В противном случае она учитывается в chat_metrics.

Блоки метрик по продуктам. Объекты метрик по продуктам (например, метрики Office Agent или Cowork в записи активности пользователя) всегда присутствуют в каждой записи. Организации, не использующие соответствующий продукт, видят нулевые значения, а не null. Исключение составляет объединённый Chat and Cowork: в развёртываниях, где он не предлагается, его поля не включаются в ответ.

Названия коннекторов. Названия коннекторов нормализуются по всем источникам. Например, Atlassian MCP server, mcp-atlassian и atlassian_MCP все отображаются как atlassian в конечной точке использования коннекторов.

Работа с API

Курсоры пагинации привязаны к запросу, который их выдал. На конечных точках затрат и использования не меняйте параметры запроса в середине последовательности: если вы измените products[], group_by[], order_by, диапазон дат или любой фильтр и передадите старый курсор, запрос вернёт ошибку 400. Чтобы изменить параметры, начните заново с первой страницы без курсора.

Параметры-списки используют нотацию с квадратными скобками. Повторяйте параметр для каждого значения, например products[]=chat&products[]=claude_code.

Поля сумм — это десятичные строки в центах. Денежные суммы возвращаются в виде десятичных строк, таких как "41280.000000" (что соответствует $412,80). Чтобы перевести в доллары, разберите значение как десятичное число и разделите на 100. Избегайте разбора в двоичные числа с плавающей запятой для значений, которые могут превышать несколько миллионов долларов.

«Rate limits» (ограничения скорости) применяются на уровне организации, а не на уровне ключа, со значением по умолчанию 60 запросов в минуту для всех конечных точек этого API. Если этого недостаточно для вашего сценария использования, свяжитесь с вашей командой по работе с клиентами Anthropic, чтобы обсудить изменение лимита.

Версионирование

Отправляйте заголовок anthropic-version в каждом запросе; доступные версии см. в разделе Версии API.

Известные ограничения

Если ваша организация использует Claude Code через Amazon Bedrock, Claude Enterprise Analytics API не возвращает активность Claude Code для такого использования.

Следующие шаги