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

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'ы, строки кода, действия инструментов) и других продуктах Claude
• Сводки активности: ежедневные, еженедельные и ежемесячные активные пользователи на уровне организации, количество мест и ожидающие приглашения
• Использование проектов, навыков и коннекторов: разбивка внедрения по проектам чата, навыкам и коннекторам
• Отчёты о затратах и использовании: использование токенов и затраты по каждому пользователю и на уровне организации с течением времени (планы Enterprise с оплатой по использованию)

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

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

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

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

Конечные точки затрат и использования следуют другой модели актуальности. Данные обычно доступны в течение четырёх часов после соответствующего использования, но это может занять до 24 часов. Значения за определённую дату могут пересматриваться в течение 30 дней по мере поступления запоздавших событий и выполнения сверки. Для итогов уровня выставления счетов запрашивайте даты не менее чем 30-дневной давности.

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

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

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

Названия коннекторов. Названия коннекторов нормализуются по всем источникам. Например, 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 для такого использования.

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