API аналитики

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, и его использование бесплатно.

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



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

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

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

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

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



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

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

Конечные точки вовлечённости и внедрения (активность пользователей, сводки, проекты, навыки, коннекторы) возвращают снимок за указанный вами день. Данные за конкретный день агрегируются в 10

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



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

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

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



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

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



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