Claude Code · 12 шагов

Claude Code /insights: техосмотр ваших привычек в коде

Одна слэш-команда читает ваши недавние сессии и возвращает HTML-отчёт: над чем вы работаете, где возникает трение и какие исправления сделать первыми. Двенадцать иллюстрированных шагов с двух реальных терминалов.

Коротко

  • Введите /insights в любой сессии Claude Code — команда проанализирует до 200 сессий на этой машине и пропустит совсем короткие.
  • Примерно через минуту отчёт появится в ~/.claude/usage-data/report.html; каждый запуск также сохраняет копию с меткой времени.
  • Отчёт охватывает ваши проекты, стиль работы с Claude Code, точки трения и функции, которые стоит попробовать — со ссылками и готовыми промптами.
  • Попросите ту же сессию сжать отчёт до «топ-3 полезных советов», а затем поручите Claude внести исправления в CLAUDE.md и hooks.

Claude Code Course 15 - The /insights Report

Канал: Code Playbook5:09

Открыть источник

Claude Code: 5 New "Minor" Features You May Have Missed

Канал: AI Coding Daily6:31

Открыть источник

Analyze your usage patterns (official docs)

Документация: code.claude.com

Открыть источник

Факты на этой странице сверены с официальным changelog Claude Code и документацией: /insights анализирует до 200 ранее не анализированных сессий на вашей машине, пропускает очень короткие и пишет report.html с копией по времени в ~/.claude/usage-data/ (удаляется после cleanupPeriodDays — по умолчанию 30 дней).

Скриншоты взяты из двух записей авторов выше, кадры с камерой обрезаны; каждый шаг ведёт к точной секунде исходного видео.

Запустить /insights, прочитать отчёт, внести исправления

Запуск команды (шаги 1–3)

  1. 1

    Поймите, что делает /insights, до запуска

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

    X post from Anthropic's Thariq announcing the Claude Code /insights command that reads your message history from the past month and summarizes your projects and workflow
    Официальный анонс — кадр из видео AI Coding Daily.Смотреть на 0:35
  2. 2

    Введите /insights в любом проекте

    Откройте Claude Code в любой папке и запустите /insights. Анализ охватывает все недавние сессии на этой машине, а не только текущий проект. Пока Claude читает историю, крутится спиннер — это занимает около минуты.

    Claude Code v2.1.52 terminal with /insights typed at the prompt and the Gesticulating spinner counting up while the usage analysis runs
    Запущенный /insights в записи Code Playbook; спиннер показывает ход анализа.Смотреть на 0:50
  3. 3

    Дождитесь сообщения 'report is ready'

    По завершении Claude Code печатает путь к отчёту: ~/.claude/usage-data/report.html — и спрашивает, хотите ли вы углубиться в раздел или попробовать suggestion. Ответьте прямо в сессии.

    Claude Code v2.1.38 terminal printing Your shareable insights report is ready with the file:///Users/povilas/.claude/usage-data/report.html path after /insights finishes
    Завершающее сообщение с путём к report.html — из второй записи.Смотреть на 0:45

Чтение отчёта (шаги 4–8)

  1. 4

    Откройте report.html и начните с шапки

    Отчёт — один локальный HTML-файл. В шапке — итоги: сообщения, добавленные и удалённые строки, затронутые файлы, активные дни, сообщений в день, а также восемь вкладок разделов от What You Work On до Team Feedback.

    Claude Code insights report header showing 936 messages, +51,970/-3,083 lines, 651 files, 14 days and 66.9 messages per day under eight report section pills
    Статистика шапки по анализу 176 сессий: 936 сообщений за 14 активных дней.Смотреть на 2:10
  2. 5

    Сначала прочитайте карточку At a Glance

    Вступительная карточка сжимает весь отчёт до четырёх абзацев: что работает, что мешает, быстрые победы и амбициозные воркфлоу. Здесь Claude отмечает повторяющееся синтаксическое трение и советует правила CLAUDE.md и хук проверки сборки.

    At a Glance card of a Claude Code insights report with highlighted what's hindering you, quick wins to try and ambitious workflows paragraphs in a yellow summary
    Сводка At a Glance — самый быстрый способ решить, за что браться.Смотреть на 1:48
  3. 6

    Посмотрите, как вы реально используете Claude Code

    Раздел How You Use CC показывает график запросов, инструменты Claude (Read, Edit, Bash…), ваши языки и типы сессий — одиночная задача, итеративная доработка. Автор записи выше узнал, что его сильнейшая сторона — воркфлоу «сначала план, потом выполнение».

    How You Use CC section of a Claude Code insights report with bar charts for what you wanted, top tools led by Read and Edit, languages led by TypeScript, and session types
    Графики использования из отчёта: топ-инструменты, языки и типы сессий.Смотреть на 2:18
  4. 7

    Проверьте разбивку по проектам

    What You Work On перечисляет недавние проекты с описанием того, что вы в каждом построили и сколько сессий это заняло — сразу видно, где больше всего туда-сюда.

    What You Work On cards in a Claude Code insights report describing a blog platform with OG image generation, SaaS registration and payment integration, and a private Composer package setup with session counts
    Карточки проектов со счётчиком сессий — из второй записи.Смотреть на 1:25
  5. 8

    Взгляните на раздел трения

    Отчёт количественно описывает, что пошло не так: основные типы трения вроде багованного кода или неверного подхода, и оценку удовлетворённости от модели. Ниже Existing CC Features to Try предлагает конкретику — правила CLAUDE.md, хуки, даже собственный /plan skill.

    Claude Code insights report charting primary friction types like buggy code with an inferred satisfaction score above the Existing CC Features to Try section
    Типы трения, оценка удовлетворённости и предложения функций.Смотреть на 1:40

Из наблюдений — в исправления (шаги 9–11)

  1. 9

    Используйте блоки PASTE INTO CLAUDE CODE

    Многие предложения оформлены как готовые промпты. Этот задаёт цикл «сборка-проверка-исправление»: после каждой правки запусти typecheck, разбери ошибки, исправь все, пересобери и прогоните grep по всем использованиям изменённого типа. Нажмите Copy и вставьте в сессию.

    Claude Code insights report suggestion with a PASTE INTO CLAUDE CODE block telling Claude to run a build-typecheck-fix loop after every edit above a Copy button
    Готовый промпт из отчёта — промпт-инжиниринг не нужен.Смотреть на 2:35
  2. 10

    Попросите ту же сессию сжать отчёт

    Отчёт длинный. Спросите Claude в той же сессии: «give me the top 3 actionable pieces of advice, summarized in less than 200 words» — получите короткий список из отчёта, и можно продолжать спрашивать.

    Claude Code session split between the usage-data report and the terminal after asking for the top 3 actionable pieces of advice summarized in less than 200 words
    Запрос трёх главных выводов сразу после генерации отчёта.Смотреть на 2:55
  3. 11

    Поручите Claude внести исправления

    Типовая тройка: добавить файлы соглашений CLAUDE.md в каждый репозиторий, настроить хук автосборки после правок в .claude/settings.json и добавить правило «проверяй все использования перед коммитом». Ответьте «да» — Claude сам напишет записи CLAUDE.md и конфиг хука.

    Claude Code answer listing three insights fixes: add CLAUDE.md convention files to each repo, set up a post-edit build hook, and add a trace-all-usages-before-committing rule
    Три предложенных исправления — каждое Claude применит сам.Смотреть на 3:45

Хранение и обмен отчётом (шаг 12)

  1. 12

    Сохраните или поделитесь HTML-файлом

    report.html — самодостаточный локальный файл: открывайте в браузере когда угодно или отправьте коллеге. Каждый запуск сохраняет свежую копию с меткой времени, а очистка удаляет файлы старше cleanupPeriodDays (по умолчанию 30 дней).

    Chrome address bar showing the local file:///Users/petemcpherson/.claude/usage-data/report.html URL of a Claude Code insights report open for reading or sharing
    Отчёт живёт по обычному адресу file:/// — работает офлайн.Смотреть на 2:06

Новое в v2.1.281: рекомендация auto mode

В changelog Claude Code v2.1.281 к /insights добавлена рекомендация auto mode: отчёт теперь оценивает, сколько запросов разрешений auto mode мог бы обработать в ваших недавних сессиях. Если день уходит на одобрения, обновитесь, перезапустите /insights и посмотрите, сколько запросов, по мнению отчёта, забрал бы на себя auto mode.

Читать запись changelog v2.1.281

Частые вопросы

Читать дальше