API аналитики Claude Code

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

Этот API позволяет вам эффективнее отслеживать, анализировать и оптимизировать внедрение Claude Code:

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

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

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

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

User-Agent: YourApp/1.0.0 (https://yourapp.com)

API аналитики Claude Code

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

Ключевые концепции

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

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

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

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

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: $ADMIN_API_KEY"

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

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

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

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

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

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

Измерения

• 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: количество pull-запросов, созданных через функциональность 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-4-8)
• 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": "[email protected]"
      },
      "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-4-8",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "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 Platform на AWS, Claude в Microsoft Foundry, Claude в Amazon Bedrock или Claude на Vertex AI не учитывается.

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

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

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

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

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

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

См. также

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

• Admin API
• Справочник по Admin API
• Панель аналитики Claude Code
• API использования и затрат — отслеживайте использование API во всех сервисах Anthropic
• API соответствия требованиям — получайте данные аудита и активности
• Управление идентификацией и доступом
• Мониторинг использования с помощью OpenTelemetry для пользовательских метрик и оповещений