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

• Анализ продуктивности разработчиков: Отслеживайте сессии, добавленные/удаленные строки кода, коммиты и pull request’ы, созданные с помощью Claude Code
• Метрики использования инструментов: Мониторинг показателей принятия и отклонения для различных инструментов Claude Code (Edit, MultiEdit, Write, NotebookEdit)
• Анализ затрат: Просматривайте предполагаемые затраты и использование токенов с разбивкой по моделям Claude
• Пользовательская отчетность: Экспортируйте данные для создания исполнительных панелей управления и отчетов для команд менеджмента
• Обоснование использования: Предоставляйте метрики для обоснования и расширения внедрения 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

​

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

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

​

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

​

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

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 request’ов, созданных через функциональность 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, которые пользователь принял/отклонил

​

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

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

​

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

{
  "data": [
    {
      "date": "2025-09-01T00: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-3-5-sonnet-20241022",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

​

Пагинация

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

​

Общие случаи использования

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

​

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

​

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

​

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

​

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

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

​

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

​

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

​

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

​

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

​

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

​

См. также

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