Claude Platform Docs
АдминистрированиеМониторинг

Claude Code Analytics API

Программный доступ к аналитике использования Claude Code и метрикам продуктивности вашей организации с помощью Claude Code Analytics Admin API.

Claude Code Analytics Admin API предоставляет программный доступ к ежедневным агрегированным метрикам использования для пользователей Claude Code, позволяя организациям анализировать продуктивность разработчиков и создавать собственные панели мониторинга. Этот API предоставляет больше деталей, чем базовая панель аналитики, без сложности интеграции с OpenTelemetry.

Этот API позволяет вам лучше отслеживать, анализировать и оптимизировать внедрение Claude Code:

  • Анализ продуктивности разработчиков: отслеживайте сессии, добавленные/удалённые строки кода, коммиты и пулл-реквесты, созданные с помощью Claude Code
  • Метрики использования инструментов: отслеживайте показатели принятия и отклонения для различных инструментов Claude Code (Edit, MultiEdit, Write, NotebookEdit)
  • Анализ затрат: просматривайте оценочную стоимость и использование токенов с разбивкой по моделям Claude
  • Пользовательская отчётность: экспортируйте данные для создания панелей мониторинга и отчётов для руководства
  • Обоснование использования: предоставляйте метрики для обоснования и расширения внедрения Claude Code внутри организации

Быстрый старт

Получите аналитику Claude Code вашей организации за конкретный день:

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Claude Code Analytics API

Отслеживайте использование Claude Code, метрики продуктивности и активность разработчиков в вашей организации с помощью эндпоинта /v1/organizations/usage_report/claude_code.

Ключевые понятия

  • Ежедневная агрегация: возвращает метрики за один день, указанный параметром starting_at
  • Данные на уровне пользователя: каждая запись представляет активность одного пользователя за указанный день
  • Метрики продуктивности: отслеживайте сессии, строки кода, коммиты, пулл-реквесты и использование инструментов
  • Данные о токенах и стоимости: отслеживайте использование и оценочную стоимость с разбивкой по моделям Claude
  • Курсорная пагинация: обрабатывайте большие наборы данных со стабильной пагинацией с использованием непрозрачных курсоров
  • Актуальность данных: метрики доступны с задержкой до 1 часа для обеспечения согласованности

Полное описание параметров и схем ответов см. в справочнике Claude Code Analytics API.

Базовые примеры

Получение аналитики за конкретный день

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Получение аналитики с пагинацией

cURL
# Первый запрос
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Последующий запрос с использованием курсора из ответа
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Параметры запроса

ПараметрТипОбязательныйОписание
starting_atstringДаДата UTC в формате YYYY-MM-DD; возвращает метрики только за этот один день
limitintegerНетКоличество записей на странице (по умолчанию: 20, максимум: 1000)
pagestringНетНепрозрачный токен курсора из поля next_page предыдущего ответа

Доступные метрики

Каждая запись ответа содержит следующие метрики для одного пользователя за один день:

Измерения

  • date: дата в формате RFC 3339 (временная метка UTC)
  • actor: пользователь или ключ API, выполнивший действия Claude Code (либо user_actor с email_address, либо api_actor с api_key_name)
  • organization_id: UUID организации
  • customer_type: тип учётной записи клиента (api для клиентов API, subscription для клиентов Pro/Team)
  • terminal_type: тип терминала или среды, в которой использовался Claude Code (например, vscode, iTerm.app, tmux)

Основные метрики

  • num_sessions: количество отдельных сессий Claude Code, инициированных этим актором
  • lines_of_code.added: общее количество строк кода, добавленных Claude Code во всех файлах
  • lines_of_code.removed: общее количество строк кода, удалённых Claude Code во всех файлах
  • commits_by_claude_code: количество git-коммитов, созданных с помощью функции коммитов Claude Code
  • pull_requests_by_claude_code: количество пулл-реквестов, созданных с помощью функции PR Claude Code

Метрики действий инструментов

Разбивка показателей принятия и отклонения действий инструментов по типу инструмента:

  • edit_tool.accepted/rejected: количество предложений инструмента Edit, которые пользователь принял/отклонил
  • multi_edit_tool.accepted/rejected: количество предложений инструмента MultiEdit, которые пользователь принял/отклонил
  • write_tool.accepted/rejected: количество предложений инструмента Write, которые пользователь принял/отклонил
  • notebook_edit_tool.accepted/rejected: количество предложений инструмента NotebookEdit, которые пользователь принял/отклонил

Разбивка по моделям

Для каждой использованной модели Claude:

  • model: идентификатор модели Claude (например, claude-opus-5)
  • tokens.input/output: количество входных и выходных токенов для этой модели
  • tokens.cache_read/cache_creation: использование токенов, связанное с кэшем, для этой модели
  • estimated_cost.amount: оценочная стоимость в центах USD для этой модели
  • estimated_cost.currency: код валюты для суммы стоимости (в настоящее время всегда USD)

Структура ответа

API возвращает данные в следующем формате:

{
  "data": [
    {
      "date": "2025-09-08T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "developer@company.com"
      },
      "organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
      "customer_type": "api",
      "terminal_type": "vscode",
      "core_metrics": {
        "num_sessions": 5,
        "lines_of_code": {
          "added": 1543,
          "removed": 892
        },
        "commits_by_claude_code": 12,
        "pull_requests_by_claude_code": 2
      },
      "tool_actions": {
        "edit_tool": {
          "accepted": 45,
          "rejected": 5
        },
        "multi_edit_tool": {
          "accepted": 12,
          "rejected": 2
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-opus-5",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 141
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

Пагинация

API поддерживает курсорную пагинацию для организаций с большим количеством пользователей:

  1. Выполните первоначальный запрос с необязательным параметром limit.
  2. Если has_more в ответе равно true, используйте значение next_page в следующем запросе.
  3. Продолжайте, пока has_more не станет false.

Курсор кодирует позицию последней записи и обеспечивает стабильную пагинацию даже при поступлении новых данных. Каждая сессия пагинации поддерживает согласованную границу данных, чтобы вы не пропустили и не продублировали записи.

Типичные сценарии использования

  • Панели мониторинга для руководства: создавайте высокоуровневые отчёты, показывающие влияние Claude Code на скорость разработки
  • Сравнение ИИ-инструментов: экспортируйте метрики для сравнения Claude Code с другими ИИ-инструментами для программирования, такими как Copilot и Cursor
  • Анализ продуктивности разработчиков: отслеживайте индивидуальные и командные метрики продуктивности с течением времени
  • Отслеживание и распределение затрат: отслеживайте паттерны расходов и распределяйте затраты по командам или проектам
  • Мониторинг внедрения: определяйте, какие команды и пользователи получают наибольшую пользу от Claude Code
  • Обоснование ROI: предоставляйте конкретные метрики для обоснования и расширения внедрения Claude Code внутри организации

Часто задаваемые вопросы

Насколько актуальны данные аналитики?

Данные аналитики Claude Code обычно появляются в течение 1 часа после завершения активности пользователя. Для обеспечения согласованных результатов пагинации в ответы включаются только данные старше 1 часа.

Могу ли я получать метрики в реальном времени?

Нет, этот API предоставляет только ежедневные агрегированные метрики. Для мониторинга в реальном времени рассмотрите использование интеграции с OpenTelemetry.

Как идентифицируются пользователи в данных?

Пользователи идентифицируются через поле actor двумя способами:

  • user_actor: содержит email_address для пользователей, которые аутентифицируются через OAuth (наиболее распространённый вариант)
  • api_actor: содержит api_key_name для пользователей, которые аутентифицируются с помощью ключа API

Поле customer_type указывает, относится ли использование к клиентам api (API с оплатой по факту использования) или к клиентам subscription (планы Pro/Team).

Каков срок хранения данных?

Исторические данные аналитики Claude Code сохраняются и доступны через API. Для этих данных не установлен определённый срок удаления.

Какие развёртывания Claude Code поддерживаются?

Этот API отслеживает только использование Claude Code через Claude API. Использование через Claude в Amazon Bedrock, Claude в Microsoft Foundry, Claude в Google Cloud или Claude Platform on AWS не включается.

Сколько стоит использование этого API?

Claude Code Analytics API бесплатен для всех организаций, имеющих доступ к Admin API.

Как рассчитать показатели принятия инструментов?

Показатель принятия инструмента = accepted / (accepted + rejected) для каждого типа инструмента. Например, если инструмент edit показывает 45 принятых и 5 отклонённых, показатель принятия составляет 90%.

Какой часовой пояс используется для параметра даты?

Все даты указаны в UTC. Параметр starting_at должен быть в формате YYYY-MM-DD и представляет полночь UTC для этого дня.

См. также

Claude Code Analytics API помогает вам понять и оптимизировать рабочий процесс разработки вашей команды. Узнайте больше о связанных функциях:

Was this page helpful?