--- title: API аналитики url: https://platform.claude.com/docs/ru/manage-claude/analytics-api description: Разберитесь, какой API аналитики и какой ключ API нужен вашей организации, а затем предоставьте доступ к метрикам продуктивности Claude Code или к данным о вовлечённости и внедрении Claude Enterprise. --- Anthropic предоставляет два API аналитики, и какой из них вы используете, зависит от того, каким продуктом Claude управляет ваша организация: * **Claude Code Analytics API** предоставляет ежедневные метрики продуктивности Claude Code для организаций, использующих Claude Platform. Он является частью [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) и использует ключ Admin API. * **Claude Enterprise Analytics API** предоставляет данные о вовлечённости, внедрении и затратах в масштабе всей организации по продуктам Claude (чат, проекты, Claude Code и другие) для организаций Claude Enterprise. Он использует ключ Analytics API, созданный в claude.ai. Эти два API используют разные типы ключей, создаваемые в разных местах разными ролями. На этой странице описано, какой API подходит вашей организации и как создать правильный ключ. ## Какой API вам нужен? | API | Тип ключа | Где создаётся | Кто может создать | Что охватывает | | ----------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Claude Code Analytics API** | Ключ Admin API (`sk-ant-admin01-...`) | Страница [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) в Claude Console | Администратор организации | Ежедневные метрики Claude Code по каждому пользователю: сессии, строки кода, коммиты, pull request'ы, принятие инструментов и оценочная стоимость по моделям | | **Claude Enterprise Analytics API** | Ключ Analytics API | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Основной владелец | Вовлечённость и внедрение в масштабе организации (активность пользователей, сводки по активным пользователям, использование проектов, навыков и коннекторов), а также отчёты о затратах и использовании | Типы ключей не взаимозаменяемы: ключ Admin API не может вызывать Claude Enterprise Analytics API, а ключ Analytics API не может вызывать Admin API. Оба API представлены в [справочнике Admin API](https://platform.claude.com/docs/ru/api/beta/organization), но это отдельные API с отдельными типами ключей. Если ваша организация использует и Claude Platform, и Claude Enterprise, вы можете создать оба ключа и использовать каждый API для его собственных данных. Ищете данные об использовании API и затратах, а не продуктовую аналитику? См. [Usage and Cost API](https://platform.claude.com/docs/ru/manage-claude/usage-cost-api) , где объясняется правильный путь как для организаций Claude Console, так и для организаций Claude Enterprise. Если вы хотите просматривать данные о вовлечённости и внедрении в самом продукте, а не программно, используйте [панель Analytics](https://claude.ai/analytics/activity) в claude.ai. Для сценариев управления и аудита (действия отдельных пользователей, необработанные события активности, содержимое разговоров) см. [Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access). ## Получение доступа к Claude Code Analytics API Claude Code Analytics API доступен каждой организации, имеющей доступ к [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api), и бесплатен в использовании. Следуйте шагам в разделе [Создание ключа Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization). Передайте ключ в заголовке `x-api-key`: ```bash 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](https://platform.claude.com/docs/ru/manage-claude/claude-code-analytics-api) и в [справочнике API](https://platform.claude.com/docs/ru/api/beta/organization/usage_report/retrieve_claude_code). ## Получение доступа к Claude Enterprise Analytics API Claude Enterprise Analytics API доступен организациям Claude Enterprise. Данные о вовлечённости и внедрении доступны на всех планах Enterprise. Конечные точки затрат и использования применимы к планам Enterprise с оплатой по использованию; для планов Enterprise с оплатой по местам они отражают только кредиты использования. Только основной владелец организации может включить доступ к API и создавать ключи Analytics API. Перейдите в [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) и включите публичный доступ к API, затем создайте ключ Analytics API. Ключи имеют область действия `read:analytics`. Скопируйте отображённый секрет и сохраните его в вашем менеджере секретов. Передайте ключ в заголовке `x-api-key` и включайте заголовок [`anthropic-version`](https://platform.claude.com/docs/ru/api/versioning) в каждый запрос. Эндпоинты расположены по адресу `https://api.anthropic.com/v1/organizations/analytics/`. Примеры запросов, параметры и схемы ответов см. в [справочнике Claude Enterprise Analytics API](https://platform.claude.com/docs/ru/api/beta/organization/analytics). Claude Enterprise Analytics API предоставляет: * **Активность пользователей:** ежедневные метрики по каждому пользователю для чата (разговоры, сообщения, проекты, файлы, артефакты), Claude Code (сессии, коммиты, pull request'ы, строки кода, действия инструментов), объединённого Chat and Cowork (активность в чате и сессии Cowork) и других продуктов Claude * **Сводки активности:** ежедневные, еженедельные и ежемесячные активные пользователи на уровне организации, количество мест и ожидающие приглашения * **Использование проектов, навыков и коннекторов:** разбивка внедрения по проектам чата, навыкам и коннекторам * **Отчёты о затратах и использовании:** использование токенов и затраты по каждому пользователю и на уровне организации с течением времени (планы Enterprise с оплатой по использованию) Подробности о конечных точках, параметрах и схемах ответов см. в [справочнике Claude Enterprise Analytics API](https://platform.claude.com/docs/ru/api/beta/organization/analytics). В следующих разделах рассматриваются актуальность данных, определения метрик и операционные рекомендации, применимые ко всем этим конечным точкам. ## Доступность и актуальность данных Данные Claude Enterprise Analytics API доступны для дат начиная с 1 января 2026 года. **Эндпоинты вовлечённости и внедрения** (активность пользователей, сводки, проекты, навыки, коннекторы) возвращают снимок данных за указанную вами дату. Данные за определённый день обычно становятся доступны примерно к 13:00–13:30 UTC следующего дня (задержка в 1 день). До этого момента самым последним доступным днём обычно является день, отстоящий на два дня от текущей даты по UTC. Если вышестоящий конвейер данных запускается с опозданием, данные поступают позже. Точная актуальность также зависит от запроса. Поэтому не рассчитывайте на фиксированное время, а проверяйте ответ с ошибкой: запрос за дату, данные за которую ещё недоступны, возвращает ошибку 400 с указанием самого последнего доступного дня. Если данные не появляются намного позже обычной задержки, это, как правило, указывает на сбой конвейера данных на стороне Anthropic. Если задержка сохраняется, обратитесь в службу поддержки. **Конечные точки затрат и использования** следуют другой модели актуальности. Данные обычно становятся доступны в течение четырёх часов после фактического использования, но это может занять до 24 часов. Значения могут пересматриваться по мере поступления запоздавших событий и выполнения сверки — примерно до 7 дней после окончания календарного месяца. Например, значения за 1 октября могут меняться примерно до 7 ноября. Для итоговых сумм, пригодных для выставления счетов, запрашивайте только месяцы, закончившиеся не менее 7 дней назад. Ответы о затратах и использовании включают временную метку `data_refreshed_at`. Если `ending_at` опущен (по умолчанию используется текущее время), ответ включает хвост данных после `data_refreshed_at`, который является неполным. Для стабильных результатов при повторных вызовах установите `ending_at` в значение, равное или предшествующее ранее возвращённому `data_refreshed_at`. ## Как определяются метрики **Активные пользователи.** Пользователь считается активным за день, если верно хотя бы одно из следующего: он отправил хотя бы одно сообщение в чате 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](https://platform.claude.com/docs/ru/api/versioning). ## Известные ограничения Если ваша организация использует Claude Code через Amazon Bedrock, Claude Enterprise Analytics API не возвращает активность Claude Code для такого использования. ## Следующие шаги Отслеживайте сессии Claude Code, изменения кода и использование инструментов с помощью ключа Admin API. Отслеживайте использование токенов API и затраты вашей организации. Справочник конечных точек для данных о вовлечённости, внедрении и затратах. Данные аудита и соответствия требованиям используют собственные типы ключей.