Claude Code usage tracking by LangWatch

LangWatch: Профессиональное отслеживание использования Claude Code и оптимизация ИИ-агентов

В современную эпоху разработки программного обеспечения ИИ-агенты становятся неотъемлемой частью рабочего процесса. Инструменты вроде Claude Code, Cursor, Copilot и Codex значительно ускоряют написание кода, однако они также создают потребность в детальном контроле. Сколько токенов было потрачено? Какова реальная стоимость сессии? Где возникают ошибки в цепочке рассуждений агента? LangWatch — это специализированная платформа для инженерного анализа LLM, созданная для того, чтобы дать ответы на эти вопросы и предоставить полный контроль над использованием Claude Code.

Что такое LangWatch?

LangWatch представляет собой комплексную платформу для команд и индивидуальных разработчиков, которые внедряют ИИ в производство. Это не просто инструмент для чтения логов; это полноценная среда для мониторинга, отладки и управления ИИ-агентами.

Основная задача LangWatch в контексте Claude Code — обеспечить прозрачность каждой сессии. Платформа использует нативный экспорт OpenTelemetry, что позволяет собирать данные о каждом шаге агента: от простых текстовых запросов до сложных вызовов инструментов Bash и правок файлов. В отличие от локальных инструментов просмотра логов, которые привязаны к одной машине и могут быть стерты при очистке системы, LangWatch сохраняет историю трассировки в облаке (или self-hosted среде), обеспечивая доступ к аналитике из любой точки.

Основные возможности и функции

LangWatch предлагает широкий спектр функций, которые превращают хаотичные логи ИИ-агента в структурированные и понятные данные.

1. Детальный учет токенов и расчет стоимости

Одной из главных проблем при использовании мощных моделей, таких как claude-opus-4-8 или claude-haiku, является непредсказуемость затрат. LangWatch решает эту проблему:

• Теоретические vs Фактические затраты: Платформа показывает точные цифры стоимости прямо из ответов API. Если вы используете индивидуальные или командные подписки (Pro, Max, Team), LangWatch помечает такие сессии как "Bundled" (пакетные), но при этом рассчитывает их теоретическую стоимость по рыночным ценам API.
• Классификация кэша: Платформа разделяет чтение и запись кэша на отдельные классы токенов для каждого пролета (span). Учитываются даже детали TTL (время жизни кэша) — 5 минут или 1 час.

2. Трассировка инструментов, навыков и MCP

Каждое действие Claude Code фиксируется как отдельный элемент трассировки:

• Bash-команды: Видны все вводимые команды и их полные выводы.
• Редактирование файлов: LangWatch отслеживает изменения, внесенные агентом.
• MCP (Model Context Protocol): Каждый вызов навыка или MCP-инструмента сохраняется с указанием длительности, входных и выходных данных.

3. Интеграция с LangWatch MCP

Это уникальная функция, позволяющая самому агенту Claude Code обращаться к своей истории. С помощью MCP-сервера агент может:

• Изучать свои запуски за прошлую неделю.
• Анализировать, на что расходуются токены.
• Редактировать собственные рабочие процессы на основе найденных закономерностей.

4. Визуализация и аналитика

Любая метрика в трассировке может быть преобразована в график. Это позволяет отслеживать:

• Количество параллельных сессий.
• Стоимость за сессию.
• Время простоя (idle time), пока агент ждет вашего ответа.
• Производительность различных моделей в сравнении.

Как использовать LangWatch с Claude Code

Начать работу с платформой можно всего за одну команду. Процесс настройки максимально упрощен для разработчиков.

1. Запуск отслеживания: Введите в терминале команду:

   npx langwatch claude
   

   Эта команда настраивает нативный экспорт OpenTelemetry из Claude Code в LangWatch.

2. Авторизация и работа: После запуска вы продолжаете работать с Claude Code в обычном режиме. Каждая сессия, поворот модели и вызов инструмента будут автоматически отправляться на платформу.

3. Анализ в UI: Откройте интерфейс LangWatch, чтобы увидеть полную историю трассировки. Вы сможете просматривать цепочки сообщений, ошибки, затраты и время выполнения каждой операции.

Кейсы использования (Use Cases)

Оптимизация рабочих процессов

Разработчики могут использовать историю трассировки для поиска повторяющихся ошибок. Например, если агент постоянно совершает лишние вызовы Bash-команд для одной и той же задачи, это будет сразу заметно на графике или в дереве спанов. Анализируя сессии, можно уточнить инструкции для агента, сократив расход токенов и время выполнения задач.

Контроль бюджета в командах

Для руководителей команд LangWatch предоставляет инструмент для понимания того, сколько ресурсов потребляет разработка с использованием ИИ. Метки "Bundled" помогают оценить реальную ценность подписок по сравнению с прямой оплатой через API.

Безопасность и соответствие (Governance)

Платформа идеально подходит для корпоративного сектора благодаря автоматической редакции секретных ключей и персональных данных (PII). Это гарантирует, что конфиденциальная информация никогда не попадет в хранилище трассировок, соответствуя стандартам безопасности предприятия.

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

Как именно происходит отслеживание Claude Code? При запуске команды npx langwatch claude настраивается экспорт OpenTelemetry. Каждая сессия сохраняется как трассировка, включающая ходы модели, вызовы инструментов, классификацию токенов и стоимость. В отличие от локальных логов, этот метод работает на разных машинах и сохраняет данные даже после очистки системы.

Поддерживает ли платформа другие инструменты, такие как Cursor или Copilot? Да. LangWatch поддерживает Codex, OpenCode, Copilot, Cursor и Pi. Все эти агенты экспортируют данные через один и тот же эндпоинт OTLP, что позволяет объединять всю аналитику в одном месте.

Что означает метка стоимости "Bundled"? Если вы используете Claude по подписке (Pro, Max или Team), у вас нет счета за каждый отдельный токен. LangWatch помечает такие сессии как "Bundled" и вычисляет теоретическую стоимость на основе рыночных цен API, чтобы вы могли оценить свои затраты.

Учитываются ли кэшированные токены? Да. Чтение и запись кэша учитываются как отдельные классы токенов с разной тарификацией. Это критически важно, так как в длительных сессиях кэшированные токены составляют основную часть объема, и их неправильный учет ведет к ошибкам в расчете стоимости.

Что произойдет, если я случайно вставлю секретный ключ в чат с Claude? API-ключи и секреты автоматически обнаруживаются и маскируются (redacted) на стороне LangWatch. Персональные данные (PII) обрабатываются таким же образом, чтобы они не попали в историю трассировки. Для максимального контроля доступны корпоративные политики и варианты self-hosted установки.

LangWatch — это не просто мониторинг, это ключ к эффективному и безопасному использованию ИИ-агентов в современном цикле разработки. Начните отслеживать свои сессии сегодня и узнайте, на что на самом деле уходят ваши ресурсы.