Аудит промптов Claude Code: как пользоваться /doctor prompt-audit
Как проверить настройку Claude Code на промпты, написанные под старые модели: обновитесь до 2.1.283, запустите /doctor prompt-audit в реальном проекте, прочитайте отчёт из девяти проверок и одобрьте только те исправления, которые вам нужны.
Аудит промптов в четырёх пунктах
- Аудит промптов — это подкоманда проверки настроек /doctor: запустите /doctor prompt-audit (или /checkup prompt-audit) внутри сессии Claude Code.
- Он сканирует ваши файлы CLAUDE.md, навыки, агентов и команды на шаблоны промптов, написанные под старые модели, и в первую очередь показывает устаревшие пути, устаревшие команды и противоречащие друг другу файлы инструкций.
- Он появился в Claude Code 2.1.283, поэтому сначала обновитесь: старая сборка ответит на /doctor ошибкой «неизвестная подкоманда» вместо отчёта.
- Проверка сначала отчитывается и спрашивает разрешение, прежде чем что-то менять; если нужен только режим чтения, запустите claude doctor в терминале.
Anthropic just dropped the new Checkup command (/doctor)
Канал:Software Engineer Meets AI2:18
Claude Code 2.1.283 — Prompt Audits & Windows Fix
Канал:Claude Code Updates1:02
Claude Code v2.1.283 — Advanced Model Control and Auditing
Канал:Claude Code Changelog2:10
Claude Code changelog — 2.1.283 adds /doctor prompt-audit
Документация:github.com/anthropics/claude-codeChangelog
Claude Code commands reference — /doctor, /checkup and /claude-api
Документация:code.claude.comDocs
Кадры взяты из трёх записей. Software Engineer Meets AI записал полный прогон проверки /doctor на v2.1.205; подкоманда prompt-audit и её охват были анонсированы в v2.1.283 и используют тот же интерфейс проверки. Claude Code Updates и Claude Code Changelog дали кадры релиза v2.1.283. Каждый кадр проверен вручную; два кадра со слайдами обрезаны, чтобы убрать водяные знаки каналов на изображении.
Скриншоты остаются собственностью каналов выше и используются для иллюстрации наших собственных инструкций; каждый шаг снабжён ссылкой на точный таймкод.
Запускаем аудит промптов Claude Code шаг за шагом
Перед запуском
- 1
Обновите Claude Code до 2.1.283 или новее
Запускайте /doctor prompt-audit только на сборке, где он есть. Проверьте версию в терминале командой claude --version, а если она старше 2.1.283 — релиза, в котором появился аудит, — обновитесь командой claude update. Внутри сессии собственная проверка версии в /doctor (Проверка 6) показывает установленную версию в сравнении с вашим каналом релизов.
«Аудит промптов» стоит первым пунктом в релизе 2.1.283 — сборка без него просто не поймёт команду.Смотреть на 0:08 - 2
Поймите, зачем проверять старые шаблоны промптов
Инструкции, написанные под более раннюю модель, накапливаются в файлах памяти, навыках, агентах и командах и продолжают влиять на каждую сессию ещё долго после того, как модель, под которую их настраивали, исчезла. Аудит и нужен, чтобы вытащить эти устаревшие шаблоны наружу — и вы точно знали, что переписывать, а не гадали.
Устаревшие указания не видны в повседневной работе — поэтому это аудит, а не обычное предупреждение.Смотреть на 0:12 - 3
Запомните точную команду и её область сканирования
Команда — /doctor prompt-audit, а /checkup prompt-audit — то же самое, потому что /checkup это псевдоним /doctor. Область охвата — ваша конфигурация Claude Code: файлы CLAUDE.md, навыки, агенты и команды. Это подкоманда проверки настроек, а не отдельный плагин и не установка из маркетплейса.
Один аргумент у уже существующей команды — ставить ничего не нужно.Смотреть на 1:02
Запускаем аудит в живой сессии
- 4
Откройте Claude Code в проекте, который хотите проверить
Запускайте сессию из корня проекта. Аудит читает ту конфигурацию, которую проект реально загружает, поэтому сессия, открытая в родительской папке, проверит не те файлы CLAUDE.md. Строка в шапке подтверждает каталог и модель ещё до того, как вы что-то введёте.
Рабочий каталог в шапке сессии и есть область аудита.Смотреть на 1:00 - 5
Введите команду и дайте ей работать в режиме чтения
Введите /doctor prompt-audit в приглашении. Проверка объявляет свой метод заранее: сначала она выполняет проверку здоровья в режиме чтения и показывает отчёт, и только потом что-то меняет. Готовьтесь к нескольким ходам с чтением файлов и shell-командами, пока она собирает доказательства, — это нормально, а не зависание.
Обещание «только чтение» звучит до любых предложений — пока идёт разбор, ничего не записывается.Смотреть на 0:30 - 6
Смотрите, как он собирает факты для каждой проверки
В транскрипте видно, какую проверку питает каждая команда: последняя версия — для Проверки 6, каталоги навыков и конфигурация хуков — для проверок расширений, небольшие файлы CLAUDE.md — для Проверок 2 и 3, а недавние транскрипты сессий — для Проверок 1, 4 и 8. Если хук блокирует команду, проверка заново формулирует нужные ей факты и повторяет попытку, а не падает.
Каждая запущенная команда привязана к пронумерованной проверке.Смотреть на 0:36
Читаем отчёт
- 7
Разберитесь в девяти проверках, которые может покрыть отчёт
Проверка 0 — здоровье настройки, Проверка 1 — неиспользуемые расширения, Проверка 2 — дедупликация LOCAL-памяти, Проверка 3 — перенос постоянно загружаемого контента, Проверка 4 — медленные хуки, Проверка 5 — перегруженные контекстом расширения, Проверка 6 — версия, Проверка 7 — auto mode как режим разрешений по умолчанию, Проверка 8 — часто отклоняемые команды только для чтения. Для аудита промптов важнее всего проверки файлов инструкций: Проверка 2 находит личные заметки, которые дублируют или противоречат командным инструкциям в репозитории, а Проверка 3 убирает редко нужные указания из всегда включённого контекста.
Проверки 2, 3 и 5 — те, что касаются CLAUDE.md и других файлов инструкций.Смотреть на 1:16 - 8
Сначала прочитайте раздел «Предлагаемые действия»
«Предлагаемые действия» — это часть отчёта, которая меняла бы файлы; каждая запись называет файл, который она правит, и обратима ли правка. Здоровая проверка помечается и закрывается строкой «No action» — так с первого взгляда видно, какая из девяти проверок что-то нашла, а какая нет.
Прочитайте путь к файлу в каждом предложении, прежде чем решать, — именно туда попадёт правка.Смотреть на 0:40 - 9
Прочитайте предупреждения и два контрольных вопроса
Под предложениями находится блок «Warnings (no action)» — то, что аудит измерил, но менять не будет: медленные хуки и перегруженные контекстом расширения, с приложенными измеренными числами, чтобы вы могли судить сами. Отчёт заканчивается тем, что задаёт вам контрольные вопросы, а не подразумевает ответ.
Предупреждения — это измерения, а не правки: в них числа, а не предложения.Смотреть на 0:56
Одобряем и повторяем
- 10
Одобрьте, выберите или откажитесь — до того, как что-то записано
Проверка заканчивается меню: очистить всё, дать выбрать, оставить всё, ввести свой вариант или обсудить. Выбор рекомендованного пункта применяет все предложения, «Let me pick» проходит по списку пункт за пунктом, а «No, keep everything» оставляет все файлы нетронутыми. Из одного отчёта ничего не применяется.
По умолчанию — вопрос, а не правка: в этом вся модель безопасности.Смотреть на 0:52 - 11
Поставьте аудит на ежемесячное напоминание
Аудит достаточно дешёвый, чтобы повторять его, но ничто в Claude Code не запустит его по расписанию: /schedule создаёт облачную задачу, а /loop работает только пока жива сессия. Практичный выход — повторяющееся событие в календаре, которое напоминает запустить аудит снова: раз в месяц или после обновления модели, которое делает ваши старые шаблоны ненужными.
Ежемесячное напоминание — единственный планировщик, который переживает перезапуски.Смотреть на 2:08
Пять сбоев, с которыми вы реально столкнётесь
Большинство жалоб на «сломанный» аудит промптов — это один из этих случаев. Проверьте их по порядку, прежде чем решать, что команды нет.
- 1Неизвестная команда или нет пункта prompt-audit — ваша сборка старше 2.1.283. Выполните claude --version, обновитесь через claude update и запустите новую сессию, чтобы загрузилась свежая сборка.
- 2/checkup prompt-audit против /doctor prompt-audit — это одна и та же команда. /checkup задокументирован как псевдоним /doctor, так что любой префикс приводит к одному и тому же навыку проверки.
- 3/claude-api prompt-audit — другая подкоманда с другой целью. Она проверяет промпты, навыки и описания инструментов в коде вашего собственного приложения на Claude API и предлагает правки в виде диффа; ей нужен Claude Code 2.1.221 или новее, а не 2.1.283, и ваши файлы CLAUDE.md она не смотрит.
- 4Аудит ничего не сообщает о ваших файлах инструкций — либо они действительно компактные, либо вообще не загрузились. Запустите /context, чтобы увидеть, какие файлы памяти и навыки реально в контексте, и убедитесь, что сессия начата из корня проекта.
- 5Нужен проход только для чтения и вообще без сессии — запустите claude doctor в терминале. Он печатает диагностику установки и настроек, не открывая сессию, тогда как /doctor внутри сессии — та версия, которая умеет предлагать и применять правки.