Устранение неполадок мода

Узнайте, почему мод Claude Code ничего не делает: сопоставьте симптом или сообщение с его причиной, посмотрите сообщения об отказе и прочитайте лог отладки.

Когда модуль мода или один из его хуков дает сбой, Claude Code пропускает его и сессия продолжается, поэтому неработающий мод может выглядеть как мод, который ничего не делает. Начните с проверки того, что Claude Code прочитал из вашего мода и где он сообщает о проблеме, затем найдите симптом или сообщение, которое у вас есть.

Узнайте, почему мод ничего не делает

Когда мод ничего не делает, проверьте, что Claude Code читает из файлов мода, и строку, которую он пишет, когда что-то пропускает. Для первого запустите claude plugin validate в вашей оболочке с директорией мода, как в claude plugin validate ./first-mod. Это ловит неправильно написанное событие, неправильный манифест и модуль, который Claude Code не может прочитать, без запуска сессии.

Когда модуль не загружается, hook пропускается или другой мод отказывает вашему, Claude Code пишет одну строку, которая называет ваш мод. Где вы читаете эту строку, зависит от сеанса:

• Сеанс, который горячо перезагружает директорию плагина: тусклая строка в стенограмме. Это интерактивный сеанс, который вы запустили с --plugin-dir, или сеанс, где вы включили горячую перезагрузку для модов, которые написал Claude.
• Любой другой интерактивный сеанс, например тот, который запускает мод, установленный вами из маркетплейса: журнал отладки только. Чтобы получить его, запустите сеанс с claude --debug.
• Запуск claude -p с --plugin-dir: stderr в формате вывода текста по умолчанию. Отказ другого мода идет только в журнал отладки.

Проверьте, могут ли загружаться моды

Чтобы проверить, позволяет ли ваша установка вообще загружать моды, без установки одного, запустите claude plugin test в вашей оболочке из директории, которая не содержит мода. Вам не нужен сеанс. Сообщение, которое оно печатает, говорит вам о состоянии:

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

Мод не загружается

Ничего, что добавляет мод, не появляется: нет команды, нет рисунка и нет изменения в поведении.

Ваша версия слишком старая

См. какую версию использовать и как проверить свою.

Строка mods active не называет мод

Ничего, что добавляет мод, не появляется, и строка mods active в /plugin не называет его. Модуль hooks не загрузился. Когда Claude Code отказала ему, журнал отладки имеет строку, которая начинается с hooks module, имени мода и not loaded:, как в hooks module first-mod@inline not loaded: disableAllHooks in managed settings для мода, загруженного с --plugin-dir.

Прочитайте причину после двоеточия. Раздел сообщения об отказе перечисляет каждое. Если журнал не имеет такой строки, пройдите через другие записи в этой группе.

Некоторые настройки останавливают мод, оставляя остальную часть его плагина работающей. Раздел Включение и отключение модов называет их.

Запуск claude -p печатает hooks module not loaded

Строка начинается с имени мода и идет в stderr. Модуль hooks был отказан. Неинтерактивный запуск не имеет стенограммы, поэтому сообщение идет в stderr.

Прочитайте причину после двоеточия. Раздел сообщения об отказе перечисляет каждое.

Сообщения об отказе

Каждое из них следует за hooks module, именем мода и not loaded: в журнале отладки.

Сообщения от встроенной защиты

На машине с управляемыми настройками или в сессии, учётные данные которой получены через /login с Team или Enterprise, встроенный страж может отказать моду или одному из его ответов. Каждое сообщение называет опцию, которую администратор вашей организации устанавливает для изменения правила.

validate проходит и не перечисляет строку hooks

hooks/hooks.json не имеет ключа modules или ключ неправильно написан.

Добавьте "modules": ["./register.js"].

hooks module did not load

Строка начинается с имени мода, затем hooks module did not load: и причина, которая дает файл и строку, когда проблема в вашем коде. Claude Code не смогла загрузить модуль, например потому что его код верхнего уровня выбросил.

Исправьте ошибку, которую называет причина.

Если причина заканчивается на ; the version loaded before is unloaded, ни одна версия мода сейчас не работает. Когда вы исправите ошибку, выполните /reload-plugins в сессии, чтобы снова загрузить мод. Если вы установили мод, а не написали его, попросите его автора исправить ошибку.

options do not fit plugin.json userConfig

Строка начинается с имени мода, затем hooks module did not load: options do not fit plugin.json userConfig: и причина. Опция не проходит проверку по своему полю userConfig, например число выше max поля, или обязательное поле не имеет значения.

Установите или измените значение. Конец строки называет его запись pluginConfigs в settings.json.

code nested too deep to scan: more than 2000 scopes

Строка начинается с имени мода, затем hooks module did not load:, файл и code nested too deep to scan: more than 2000 scopes. Файл в модуле хуков не может вкладывать области видимости, такие как функции, блоки и циклы, глубже чем на 2 000 уровней. claude plugin validate сообщает ту же причину.

Перепишите код так, чтобы его области видимости были вложены менее глубоко.

the engine ran out of stack linking the file and its imports

Код в модуле хуков вложен слишком глубоко или его цепочка импортов слишком длинная, чтобы Claude Code мог его загрузить. Строка начинается с имени мода и hooks module did not load:, затем указывает имя файла и эту причину.

Просмотрите этот файл и файлы, к которым ведут его импорты, найдите наиболее глубоко вложенную часть и перепишите её так, чтобы вложенность была меньше, или сократите цепочку импортов. Если мод написали не вы, попросите его автора исправить это.

the parser stopped или the engine ran out of stack loading the file

Код в одном из файлов модуля хуков вложен настолько глубоко, что Claude Code исчерпал стек при его чтении. Строка начинается с имени мода и hooks module did not load:, затем указывает имя этого файла и одну из следующих причин:

• code nested too deep to scan (the parser stopped: <message>)
• the engine ran out of stack loading the file (code nested too deep): <message>

Причина не указывает номер строки и не сообщает, какой именно код вложен, поэтому самостоятельно просмотрите файл и найдите его наиболее глубоко вложенную часть. Перепишите эту часть так, чтобы вложенность была меньше. Если вы установили мод, а не написали его, попросите об этом его автора.

Ни один мод не загружается в директории, которую вы открыли впервые

Вы не ответили на приглашение доверия для директории.

Запустите интерактивный сеанс в этой директории с claude и примите приглашение доверия, которое оно открывает.

Ни один установленный плагин не загружается вообще

Вы запустили Claude Code с --safe-mode.

Запустите без флага.

Claude Code перестает предлагать включить горячую перезагрузку

Claude пишет мод в интерактивной сессии, ничего не загружается, и Claude Code больше не спрашивает, включить ли горячую перезагрузку. Если вопрос трижды завершается без выбранного ответа, горячая перезагрузка остается отключенной. Например, вопрос завершается так, когда вы задали askUserQuestionTimeout и время истекает до вашего ответа. Эта настройка применяется здесь, потому что Claude Code задает вопрос в том же диалоге вопросов, который использует AskUserQuestion. Вопрос, который вы закрываете сами, не засчитывается в эти три.

Чтобы запустить мод, скопируйте его директорию из папки модов, затем в оболочке запустите новую сессию с --plugin-dir, как в claude --plugin-dir ~/mods/git-branch.

Hook пропускается или мод выгружается

Мод загрузился, а затем Claude Code пропустила один из его hooks или выгрузила его.

hook skipped

Строка называет мод и событие, затем содержит hook skipped: и причину, как в first-mod: tool.call hook skipped: threw Error: boom. Хук выбросил исключение, превысил свое ограничение по времени или вернул результат неправильной формы. Строка появляется один раз для каждого события и вида сбоя до перезагрузки мода.

Исправьте ошибку. Журнал отладки имеет строку для каждого возникновения.

no command.run hook answered it

Вы запускаете команду, которую добавил ваш мод, и ответ называет мод и команду, как в first-mod registered /tally but no command.run hook answered it, затем говорит вам добавить hook. Claude Code выводит этот ответ, когда команда достигает конца цепи без ответа, что происходит в двух случаях:

• Ни один hook не ответил на команду: модуль не имеет command.run hook, фильтр hook называет другую команду или hook вернул next(e)
• Claude Code пропустила hook: hook skipped перечисляет причины. Передача focus: false в $.ui.open — один из способов туда попасть.

Если модуль уже имеет hook, который описывает ответ, ищите строку hook skipped, которая называет command.run, что дает причину. Тест, который запускает команду, не проходит по той же причине.

it crashed the hooks worker

Строка начинается с имени мода, как в first-mod was unloaded: it crashed the hooks worker. Установленные моды используют один рабочий поток. Рабочий перестал отвечать или упал, и Claude Code проследила это до этого мода и выгрузила его. Hook, который блокирует поток, например цикл, который никогда не ожидает, является одной из причин.

Исправьте hook.

its session.start ran again in a fresh copy

Строка начинается с имени мода и называет вызов $.prompt.submit, $.command.run или $.agent.spawn, как в first-mod: its session.start ran again in a fresh copy; the $.prompt.submit call it had already made was not made again. Claude Code снова загрузила модуль мода, например после того как рабочий поток хуков упал и был заменен, и в свежей копии выполнился хук session.start. Вызов, названный в строке, вернул результат своего первого выполнения вместо повторного выполнения, поэтому ваш мод не отправляет промпт, не запускает команду и не запускает субагента дважды. Остальная часть хука выполнилась как обычно.

Исправлять ничего не нужно.

До v2.1.292 вызов выполнялся второй раз, поэтому промпт отправлялся, команда запускалась или субагент запускался дважды.

This mod's change didn't load или the earlier version is no longer running

Изменение в моде, который Claude написала в этой сессии, не удалось загрузить. Строка в транскрипте начинается с имени мода и заканчивается причиной:

• This mod's change didn't load, so the earlier version is still running: <reason>.
• This mod didn't load, and the earlier version is no longer running: <reason>.

Claude не видит эту строку, поэтому вставьте ее в свое следующее сообщение, когда попросите Claude исправить проблему.

$.agent.register refused: the hooks module that made the call is no longer loaded

Строка начинается с имени вашего мода, как в first-mod: $.agent.register refused: the hooks module that made the call is no longer loaded (it was reloaded or removed), и агент не регистрируется. Ваш мод был перезагружен или выгружен до вызова. Перезагрузка загружает свежую копию модуля хуков, а этот вызов пришел из кода, который все еще выполнялся в старой копии, например из хука, который еще не вернул результат.

Если этот хук не перехватывает отказ, он завершается сбоем, и Claude Code пропускает его. Чтобы зарегистрировать агента из копии, которая остается загруженной, выполните вызов в своем хуке session.start, который снова выполняется в каждой свежей копии после перезагрузки.

mods that run in the hooks worker are off for this session

Строка читает hooks: mods that run in the hooks worker are off for this session: it crashed 3 times. Рабочий остановился три раза и Claude Code не смогла проследить остановки до одного мода, поэтому она выгрузила каждый мод, который не встроен, включая моды, которые устанавливает ваша организация. Эта строка достигает стенограммы в каждом интерактивном сеансе.

Запустите /reload-plugins для их перезагрузки.

Вызов инструмента отказан

Мод загрузился и его hooks работают, и вызов инструмента, который он коснулся, отказан.

a hook changed this call's input after the model wrote it

В автоматическом режиме отказанный вызов инструмента дает эту причину. Hook изменила входные данные вызова инструмента после того, как классификатор на стороне сервера его рассмотрел, поэтому этот обзор не охватывает то, что будет запущено. Hook может быть tool.call мода или turn.step hook или PreToolUse hook параметров. Сообщение не говорит, какой.

Сообщение говорит Claude выдать вызов еще раз, как записано. Если это также отказано, hook изменяет входные данные каждый раз, поэтому отключите мод или hook или выйдите из автоматического режима и одобрите вызов сами.

[!NOTE]

В некоторых интерактивных сессиях терминала и сессиях VS Code такой же отказ сопровождается причиной a hook changed this call's input after auto mode reviewed it. Повторный вызов в этом случае содержит первое изменение мода, и хук tool.call всё равно выполняется для него, но дальнейшее изменение отбрасывается. Вам не нужно менять свой мод, если только Claude не сообщит в своём ответе, что авторежим не смог проверить вызов.

Сообщение о правилах deny в ваших параметрах

tried to lift a deny rule in your settings и the deny rules in your settings could not be checked for this call, so it is refused оба поступают от встроенной защиты.

Посмотрите их в Сообщения от встроенной защиты.

После остановки хода появляется всплывающее уведомление

Stopped: type a message to continue; a mod cannot resume work after Stop

Это всплывающее уведомление означает, что после того, как вы остановили ход, например клавишей Esc, мод попытался самостоятельно начать работу, и Claude Code не позволил ему это сделать. Ничего исправлять не нужно. После вашего следующего сообщения моды снова смогут начинать работу, и часть этой работы вернётся сама по себе. Если то, что вы ожидали от мода, не вернётся, попросите об этом снова или повторно выполните команду мода.

Если вы написали этот мод, см. раздел Вызовы и фоновая работа после того, как пользователь прерывает ход.

Рисунок не появляется или не отвечает

Мод загрузился, и его панель, полоса, всплывающее уведомление или элементы управления не ведут себя так, как вы ожидаете.

Полоса другого мода отображается, а ваша нет

Над промптом есть одна полоса, и все моды используют ее совместно. Мод, который выполняется до вашего, заменяет вашу полосу, когда возвращает дерево, в котором нет результата next(e). Чтобы показать обе полосы, измените хук этого мода или попросите его автора сделать это:

• Сохраните полосы после него: поместите результат await next(e) среди дочерних элементов Box в его дереве, как на вкладке Band above the prompt в разделе Выберите, где рисовать
• Сохраните дерево валидным: не задавайте этому Box или любому Box вокруг него проп width, height, minWidth, minHeight, position, top, left, right, bottom, display или overflow

Чтобы найти этот мод, запишите лог отладки и найдите в нем answered ui.render without next(). Строка вроде other-mod (user) answered ui.render without next() называет мод, который вернул свое дерево, не вызвав next(e). Она не называет точку отрисовки, поэтому в ней может оказаться и мод, который рисует только панель. Для мода, который вызывает next(e) и отбрасывает результат, строки нет, поэтому проверьте также хуки, выполняемые до вашего.

Полоса мода также отсутствует, когда дерево, которое вернул его собственный хук, не проходит валидацию, а полосы других модов при этом остаются. Чтобы узнать, какой это мод и почему, запишите лог отладки и найдите в нем ui.render hook skipped.

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

Дерево, которое вернул ваш хук, не прошло валидацию. Строка hook skipped в транскрипте или логе отладки называет ваш мод и причину, как в этой строке для Box в панели:

first-mod: ui.render hook skipped: returned the wrong shape (a tree Pane refuses: Box prop "flexDirection" must be one of row, column, row-reverse, column-reverse)

Исправьте то, что названо в причине. Если причина обрезана, запишите лог отладки и найдите в нем a hook returned a tree that does not validate, чтобы прочитать остальное.

Если же строка сообщает refused: сразу после имени точки, как в ui.render (Pane) refused:, см. Строка ui.render сообщает refused.

Строка ui.render сообщает refused

ui.render (<site>) refused: или ui.render (<site>): the chain settled on a tree that does not validate в логе отладки означает, что дерево в этой точке превышает ограничение размера. Любая из этих строк называет точку отрисовки, а затем причину, и причина называет ограничение.

Измените моды, которые рисуют в этой точке, чтобы их хуки ui.render возвращали деревья меньшего размера, или попросите их авторов сделать это. Если строка транскрипта начинается с hooks, у нескольких загруженных модов есть хук ui.render для этой точки, поэтому проверьте дерево каждого из этих модов. Для нескольких модов, чьи полосы над промптом вкладываются в дерево глубиной более 32 уровней, строка выглядит так:

hooks: ui.render (AbovePrompt) refused: deeper than 32; nothing was drawn

До v2.1.307 строка refused: для любой точки сообщала о любом дереве, которое не прошло валидацию, а для Pane и AbovePrompt она заканчивалась на ; the engine drew its own. В этих выпусках исправьте то, что названо в причине.

needs a key, is drawn twice или key each once

У элемента в дереве, которое возвращает ваш хук ui.render, нет допустимого key, или два элемента используют один и тот же. Найдите полученное сообщение:

• <Input> needs a key или <Select> needs a key: у элемента нет пропа key, или его key пуст или не является строкой, как в key: 3. Задайте ему в качестве key непустую строку.
• <Button> needs a key: задайте кнопке непустую строку в качестве key
• is drawn twice; each takes its own key: у двух элементов того вида, который назван в сообщении, одинаковый key, как в Input "size" is drawn twice; each takes its own key. Задайте каждому элементу собственный key.
• key each once от press в тесте: в рисунке больше одной кнопки с переданным вами ключом. Кнопки с одинаковой подписью и без пропа key используют эту подпись как общий ключ. Задайте каждой кнопке собственный key.

Строка ui.render сообщает threw while drawn

Строка называет точку отрисовки, затем сообщает threw while drawn: и ошибку, как в first-mod: ui.render (ToolUse) threw while drawn: <error>; the engine drew its own. Claude Code столкнулся с этой ошибкой при отрисовке дерева, которое вернул ваш хук ui.render, или при отрисовке точки из props, которые ваш хук передал в next. Окончание the engine drew its own означает, что точка показывает обычное содержимое Claude Code.

Прочитайте ошибку и исправьте значение в вашем хуке, которое ее вызвало.

До v2.1.289 эта ошибка в строке транскрипта завершала сессию с Claude Code exited after an unrecoverable interface error.

the module failed without a message

Client завершился с ошибкой без сообщения, например throw new Error(). Строка на его месте выглядит как my-mod: Client client/spinner.js: the module failed without a message.

Найдите throw в коде вашего Client и задайте ошибке сообщение. Тогда строка покажет это сообщение.

До v2.1.289 строка вместо этого показывала Error в качестве причины.

$.ui.open работает и панель не появляется

Вызов не поступил от чего-то, что сделал пользователь, и терминал уже, чем ширина, необходимая этой панели.

Откройте панель из команды или кнопки или проверьте результат isPlaced вызова. См. Откройте панель в нужное время.

Всплывающее уведомление не появляется

Ваш мод вызывает $.ui.toast в интерактивной сессии терминала, а вы не видите уведомление. Чтобы убедиться, что вызов выполнился, найдите в логе отладки строку с именем вашего мода и текстом уведомления, как в $.ui.toast (first-mod): build finished. Затем проверьте такие причины:

• Строки для вызова нет: найдите строку, которая объясняет, почему Claude Code отклонил вызов, как в first-mod: $.ui.toast dropped: timeoutMs is a whole number of ms, 1 to 60000.
• Панель удерживает уведомления: ваш или другой мод передал holdToasts при открытии отображаемой панели. Закройте панель, чтобы прекратить удержание. Если панель ваша и должна оставаться открытой, удалите holdToasts из ее вызова $.ui.open и откройте панель снова.
• Уведомление находится под промптом: в классическом рендерере посмотрите справа под промптом. Уведомление там - это одна строка, начинающаяся с имени мода, а не блок в правом верхнем углу.
• Ваш мод показал более новое уведомление: в классическом рендерере более новое уведомление от вашего мода может заменить то, которое отображается или ожидает отображения. В логе отладки есть еще одна строка для старого уведомления, которая заканчивается на gave way, cut short, если оно отображалось, или на gave way, unseen, если оно так и не появилось. Чтобы показать оба сообщения, поместите их в одно уведомление.
• Время уведомления истекло до отрисовки: в полноэкранной отрисовке Claude Code отрисовывает не более трех уведомлений одновременно, поэтому время уведомления может истечь до его отрисовки. В логе отладки есть еще одна строка для этого уведомления, которая заканчивается на left the stack, never drawn. Когда ваш мод показывает несколько уведомлений сразу, поместите сообщения в одно уведомление.

До v2.1.290 Claude Code отбрасывал уведомление, показанное в течение двух секунд после последнего уведомления, которое он отобразил для вашего мода, и строка лога отладки для отброшенного уведомления сообщала within 2000ms of the last; dropped.

Полоса показывает plugin panel hidden

Полоса свернута. Она сворачивается, когда вы нажимаете Ctrl+X, затем Ctrl+A, или клавиши, которые вы назначили вместо них, а в полноэкранной отрисовке - когда вы щелкаете [-] в ее первой строке. Она остается свернутой, пока вы не развернете ее или снова не запустите Claude Code, и все это время ни горячая клавиша, ни привязка action не нажимает кнопки в ней.

Чтобы развернуть полосу, нажмите клавиши, указанные в строке, по умолчанию Ctrl+X, затем Ctrl+A, или в полноэкранной отрисовке щелкните строку.

Горячие клавиши ничего не делают

Ваша панель или полоса не имеет фокуса клавиатуры, ваша кнопка находится в свернутой полосе, или рисунок находится в расширении VS Code, где у кнопок нет горячих клавиш. Выполните то, что соответствует вашему случаю:

• Нет фокуса клавиатуры: нажмите Ctrl+X затем Tab или в полноэкранной отрисовке щелкните панель или полосу. Чтобы панель получала фокус при открытии, откройте ее с focus: true из команды.
• Кнопка находится в свернутой полосе: полоса показывает одну тусклую строку, начинающуюся с ▸ plugin panel hidden. Нажмите клавиши, указанные в строке, по умолчанию Ctrl+X, затем Ctrl+A, чтобы развернуть ее.
• В расширении VS Code: щелкните кнопку или нажмите Enter на ней, когда она получит фокус

Рисунок работает в терминале и не в приложении Desktop или VS Code

Либо это приложение не отрисовывает точку отрисовки или элемент, либо сессия относится к тем, в которых расширение VS Code ничего не отрисовывает для модов. Другие хуки мода по-прежнему выполняются. Проверьте такие причины:

• Точка отрисовки или элемент не отрисовываются в этом приложении: найдите вашу точку в таблице точек отрисовки, а ваши элементы - в таблице элементов. Для элемента, которого нет в приложении, проверьте e.surface в хуке и верните дерево, которое приложение может отрисовать.
• Расширение VS Code старше 2.1.299: панель чата отрисовывает содержимое модов начиная с версии расширения 2.1.299. Проверьте версию в представлении Extensions в VS Code и обновите расширение там.
• Расширение старше 2.1.304, и сессия не загружает флаги функций: обновите расширение или вместо этого запустите claude во встроенном терминале VS Code. Сессии в Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry пропускают эту загрузку. О других сессиях, которые ее пропускают, например о сессии через шлюз приложений Claude, см. Функции, которым нужна загрузка флагов функций.

Правка или значение потеряны

Мод работает, но внесённого вами изменения или сохранённого им значения нет.

Ваши правки не вступают в силу

Вы редактируете установленный плагин. Claude Code запускает кэшированную копию установленной версии.

Ведите разработку с --plugin-dir, указывающим на вашу рабочую копию, например claude --plugin-dir ./first-mod, — тогда мод перезагружается при сохранении.

Значение сбрасывается при перезагрузке модуля

Переменные уровня модуля инициализируются заново при каждой перезагрузке.

Храните значение в $.state или $.store.

Значение сбрасывается после /clear, /resume или /branch

Значение сбрасывается, или сохранённое значение заменяется значением по умолчанию. Каждая из этих команд сбрасывает $.state к значениям по умолчанию, а session.start повторно не срабатывает.

Загрузите сохранённое значение снова в хуке classic.SessionStart.

Ключ, который возвращает ваш хук settings.read, не вступает в силу

Если вы возвращаете правила разрешений или env при собственном чтении Claude Code, эти правила не проверяются при вызовах инструментов, а записи env не становятся переменными окружения. Используйте для того и другого файл настроек или $.env.set для env.

Для другого ключа проверьте, какие моды получают settings.read и с какой версии, затем найдите в логе отладки settings.read и поищите одну из следующих строк:

Если ни одна строка не объясняет ситуацию с ключом, проверьте моды, выполняющиеся раньше вашего, на наличие хука settings.read, который изменяет этот ключ. Отключите такой мод или попросите об этом администратора вашей организации. Если такого хука нет, задайте ключ в файле настроек.

the answer for <key> is no value the key can hold

Эта строка лога отладки означает, что Claude Code отклонил значение, которое хук settings.read вернул для указанного ключа, и только для этого ключа:

settings.read: the answer for <key> is no value the key can hold; the settings' own value stands

Значение, возвращённое для указанного ключа, не соответствует схеме этого ключа, например по типу или по диапазону.

• Ваше значение не соответствует схеме ключа: верните значение, допустимое согласно записи этого ключа в справочнике настроек.
• Ваше значение подходит: неподходящее значение пришло из хука settings.read другого мода. Чтобы найти этот мод, выполните шаги по поочерёдному отключению модов. Ищите в каждом новом логе эту строку вместо refused to the engine.

Пока значение не подходит, ключ сохраняет значение, объединённое из источников настроек до ответа какого-либо хука. В строке оно называется собственным значением настроек.

settings.read: refused to the engine

Эта строка появляется в логе отладки, когда в собственном чтении Claude Code отказано, и Claude Code отбрасывает значения всех хуков. Когда хук settings.read отказывает в этом чтении с помощью { deny: reason }, строка содержит причину, указанную этим хуком:

settings.read: refused to the engine (engine: $.settings.read: <reason>); the settings' own values stand

Найдите в своём коде причину, указанную в скобках:

• Текст есть в вашем коде: в чтении отказал ваш хук. Сделайте так, чтобы он возвращал { value }, когда next.origin указывает на собственное чтение Claude Code.
• Её нет в вашем коде: отключайте другие свои моды по одному. Если мод развернула ваша организация, попросите её администратора отключить его. После каждого отключения:
  1. Запустите сессию из оболочки командой claude --debug-file ./settings-read-2.log, добавив флаги, с которыми она была запущена. Каждый раз используйте новый путь.
  2. Найдите в этом файле refused to the engine. Если строка есть, отключите следующий мод. Если нет — в чтении отказал последний отключённый вами мод, поэтому оставьте его отключённым.

Если строка остаётся, а других модов не осталось, задайте ключи, которые возвращает ваш хук, в файле настроек. Его значения действуют, пока в чтении отказано.

Прочитайте лог отладки

В логе отладки есть строка для каждого модуля, который Claude Code загружает или отклоняет, для каждого хука, завершившегося сбоем, и для каждого отклонённого результата, поэтому именно туда стоит смотреть, когда транскрипт ничего не показывает. Чтобы записать лог, запустите Claude Code в оболочке с --debug или с --debug-file <path>, чтобы выбрать место назначения:

claude --debug-file ./mod-debug.log --plugin-dir ./first-mod

В другом терминале следите за файлом и фильтруйте по имени вашего мода:

tail -f ./mod-debug.log | grep first-mod

Для загруженного мода есть строка, в которой указано его имя и перечислены события, которые он обрабатывает. Мод, загруженный с --plugin-dir, отображается под своим именем, за которым следует @inline:

hooks module first-mod@inline loaded (worker, environment 2, tier user); events: session.start,tool.call,command.run,ui.render

Чтобы записать собственные строки в лог, вызовите $.ui.log со вторым аргументом, как в $.ui.log('message', { to: 'debug' }). Без второго аргумента $.ui.log добавляет тусклую строку в транскрипт.

Пока вы редактируете мод, загруженный с --plugin-dir, транскрипт показывает строку для каждой перезагрузки, в которой указано имя мода и перечислены его хуки. Если после сохранения модуль ломается, в строке выводится reload failed, the previous version stays loaded: с причиной, а последняя рабочая версия продолжает работать до следующей перезагрузки плагинов в Claude Code, например когда вы запускаете /reload-plugins.

Следующие шаги

• Протестируйте мод: ловите проблемы до того, как они достигнут сеанса
• Устранение неполадок плагинов: проблемы с установкой и загрузкой плагина, которые не специфичны для модов