Prompt Warrior: геймифицированный анализ логов Claude Code — установка и использование | AiManual
AiManual Logo Ai / Manual.
04 Июл 2026 Инструмент

Prompt Warrior: геймифицированный самоанализ логов Claude Code — инструкция по установке и использованию

Prompt Warrior — open-source инструмент для геймифицированного анализа логов Claude Code. Достижения, психологический профиль агента, локальная установка. Инстр

Вы когда-нибудь читали логи Claude Code после того, как он час колдовал над вашим проектом? Я — нет. Там километры токенов, куча "Analyzing...", "Thinking..." и непонятные вызовы функций. Скука смертная. Только если не приделать к этому геймификацию. Prompt Warrior делает именно это: превращает унылый текстовый поток в RPG-доску с ачивками, психологическим портретом твоего агента и профилем его «характера». И да, всё локально, бесплатно и с открытым исходным кодом.

Что такое Prompt Warrior

Это Python-скрипт, который парсит JSON-логи Claude Code (вы их наверняка видели — ~/.claude/logs/ или claude_logs.jsonl) и строит на их основе отчёт с достижениями. Не просто «ты вызвал 15 раз edit_file», а система рангов и бейджей. Например, если агент больше 50 раз использовал grep, получает achievement "The Seeker". Если он ни разу не запросил уточнения у человека — "Lone Wolf". Если наделал тонну правок и тут же их откатил — "Chaos Monkey". И таких штук под сорок.

Фишка: инструмент не отправляет данные никуда, всё считается на вашей машине. Безопасность логов — ваша забота, но тут хотя бы нет облачной утечки. (Кстати, мы уже разбирали, что даже «локальный» Claude Code иногда что-то шлёт на сервер — здесь этой проблемы нет.)

Ачивки, профиль и прочая RPG

Prompt Warrior генерирует два главных отчёта:

  • Достижения (achievements). Каждое — с названием, иконкой и кратким описанием. Получено 10 таких? Агент получает ранг.
  • Психологический портрет. На основе частот вызовов tools, длины ответов, количества ошибок строится шкала: "Перфекционист", "Хаотик", "Интроверт" (мало запросов к человеку) и т.д.

Звучит как игрушка, но на деле это мощный инструмент ретроспективы. Вы вдруг понимаете: ваш ИИ-помощник тратит 80% времени на grep и чтение файлов, но почти не пишет тесты. Или что он постоянно переспрашивает одно и то же — признак плохого контекста в промпте. Лучшие практики из репозитория с 56k звезд советуют чистить историю диалогов — Prompt Warrior покажет, когда агент начинает зацикливаться.

Сравнение с альтернативами

Честно? Прямых аналогов нет. Можно, конечно, выгрузить логи в Excel, построить графики и вручную выискивать паттерны. Но это больно. Можно использовать jq и grep — для одноразового анализа сойдёт. Но геймификации нет, подсчёта достижений нет, психологического профиля нет. Prompt Warrior делает это за пять секунд.

ИнструментГеймификацияПрофиль агентаЛокальностьПростота
Prompt WarriorДаДаДаВысокая
Ручной grep/jqНетНетДаНизкая
Elastic/LogstashНетНет (нужен скриптинг)ДаНизкая (оверкилл)

Есть ещё Cursor и Warp, но они не анализируют логи — они их генерируют. Так что сравнение тут не совсем честное.

Установка: три команды и ты в игре

Всё ставится через pip, зависимости минимальны. Работает на Python 3.10+.

1 Клонируем репозиторий

git clone https://github.com/your/prompt-warrior.git
cd prompt-warrior

2 Устанавливаем зависимости

pip install -r requirements.txt

3 Запускаем на своих логах

python warrior.py --input ~/.claude/logs/logs.json

Важно: Если у вас логи в другом формате (например, после руководства по начальной установке там может быть claude_cli.log), проверьте флаг --format. В README автора есть примеры.

После запуска в терминале появится таблица с достижениями, а в папке output/ — HTML-отчёт с визуализацией (круговая диаграмма вызовов, временная шкала, список ачивок). Можно открыть в браузере и сохранить.

Живой пример: как я продиагностировал свой Claude Code

Я скармливаю лог за последнюю неделю работы над pet-проектом. Prompt Warrior за пару секунд выдаёт:

  • 14 достижений: "The Grep God" (45 вызовов grep), "Undo King" (12 раз откатывал изменения), "Silent Worker" (ни одного запроса к пользователю).
  • Психотип — "Chaotic Neutral": много параллельных правок, мало тестов, частые переключения контекста.
  • Совет! Prompt Warrior пишет: «Ваш агент редко обращается за помощью — возможно, слишком высокая уверенность. Попробуйте добавить в системный промпт инструкцию спрашивать подтверждение перед массовыми изменениями».

Я бы никогда не вытащил этот инсайт из сырых логов. А тут — бац, и готовый отчёт. Прямо как методология поиска 23-летнего бага в ядре Linux: тоже анализ логов, но для AI-агента.

Кому это реально нужно

  • Разработчикам, которые плотно сидят на Claude Code. Если вы прямо сейчас читаете статью про Claude Code 2.0 и хотите выжать из него максимум — этот инструмент покажет, где агент тупит.
  • QA-инженерам. Можно быстро проверить, как модель ведёт себя в стрессовых сценариях (много вызовов, ошибки, ретраи).
  • Продакт-менеджерам. Оценить, насколько эффективно AI-ассистент тратит токены. Если у вас бюджет на Claude ограничен, «Chaos Monkey» — звоночек менять промпты.
  • Исследователям agentic-систем. Prompt Warrior — отличный инструмент для сбора статистики по поведению агентов. Можно залогировать сессию с разными системными промптами и сравнить профили.
💡
И да, никто не мешает запускать Prompt Warrior на логах других AI-инструментов, если они пишут JSON-логи в том же формате. Но заявлена поддержка только Claude Code.

Подводные камни и ограничения

Во-первых, инструмент сыроват. На момент написания это open-source прототип, возможны баги с парсингом нестандартных логов. Во-вторых, психологический профиль — это смесь эвристик, не воспринимайте его слишком серьёзно. В-третьих, если у вас в логах миллион строк, скрипт может тормозить: там нет потоковой обработки, всё грузится в память.

Но для ежедневного быстрого аудита — самое то. Особенно если совместить с проактивной защитой от InstallFix-атак: всегда проверяйте, что логи не подменены.

Финальный совет

Не ждите, что Prompt Warrior сделает из вас гуру Claude Code. Он просто даст зеркало — посмотрите, как ваш AI-напарник на самом деле работает. Иногда это отрезвляет. Попробуйте запустить на логах недельной давности и на свежих — профили могут отличаться кардинально. Если после анализа вы переписали системный промпт и ваш агент перестал быть «Chaos Monkey» — инструмент окупился.

Подписаться на канал