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

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. Единственное исключение — Usage and Cost Analytics API, который организации Claude Enterprise вызывают с помощью своего ключа Analytics 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" \
     -H "anthropic-version: 2026-10-21" \
     -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

   

Доступные метрики, параметры запроса и схему ответа см. в руководстве Claude Code Analytics API и в справочнике по APIДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..

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

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

1. 1

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

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

2. 2

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

   Перейдите в claude.ai > Настройки организации > 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 день). До этого момента последним доступным днём обычно является день за 2 дня до текущей даты по UTC. В дни, когда вышестоящий конвейер данных запаздывает, данные поступают позже, а точная актуальность зависит от запроса. Вместо того, чтобы рассчитывать на фиксированное время, проверяйте ответ с ошибкой: запрос даты, которая ещё недоступна, возвращает ошибку 400 с указанием последнего доступного дня. Если данные недоступны значительно дольше обычной задержки, это, как правило, указывает на сбой конвейера данных на стороне Anthropic; если пробел сохраняется, обратитесь в службу поддержки.

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

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

Активные пользователи. Пользователь считается активным в течение дня, если выполняется любое из следующих условий:

• Он отправил хотя бы одно сообщение в чате Claude.
• У него был хотя бы один сеанс Claude Code (локальный или удалённый), связанный с вашей организацией Claude Enterprise, который включал использование инструментов или активность в 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. Использование за дни до того, как пользователь начал работать с объединённым 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: в развёртываниях, где он не предлагается, его поля не включаются в ответ. Отдельные поля внутри этих объектов могут иметь значение null, что означает, что значение недоступно. Например, при фильтрации активности пользователей по проекту поле distinct_skills_used_count в chat_metrics имеет значение null. Какие поля могут иметь значение null, указано в справочнике Claude Enterprise Analytics API.

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

Работа с API

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

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

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

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

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

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

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

Claude Code через Amazon Bedrock

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

Claude Code и Cowork с ключами шифрования, управляемыми клиентом

Если ваша организация использует ключи шифрования, управляемые клиентом, Anthropic исключает некоторые сведения об использовании Claude Code и Cowork из своей аналитики использования, чтобы защитить ваши данные. Поэтому не используйте следующие показатели Claude Enterprise Analytics API для измерения того, насколько активно ваша организация использует Claude Code или Cowork. Они могут быть нулевыми или ниже фактического использования:

• Изменения кода: в активности пользователей следующие поля в claude_code_metrics.core_metrics могут быть нулевыми: lines_of_code (добавленные и удалённые строки) и commit_count. Поле pull_request_count может быть меньше реального количества pull request.
• Навыки, запущенные слэш-командой: если пользователь запускает навык в Claude Code или Cowork, введя слэш-команду, например /skill-name, такое использование не учитывается. Это относится к использованию навыков и к подсчёту навыков Cowork в активности пользователей. Навыки, которые Claude вызывает без слэш-команды, по-прежнему учитываются.

Другие изменения аналитики при использовании ключей шифрования, управляемых клиентом, см. в разделе Что охватывает CMEK в Claude Enterprise.

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