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



Дальнейшие шаги