Пин модели у субагентов Claude Code срывается молча

Автор блога Thomas-witt 16 августа объяснил, почему его субагенты Claude Code, закреплённые строкой model: sonnet, на деле работали на Fable, модели основной сессии. Там же он выложил хук на девять строк, который не даёт такому вызову пройти.
Его схема типовая: основная сессия на Fable или Opus 5 и небольшой «зоопарк» субагентов для рутины: шлюзовые агенты, форматтеры, проверялки. Модель для таких агентов один раз прописывают во frontmatter, заголовке файла агента, и больше о ней не вспоминают. В какой-то момент расход токенов перестал совпадать с тем, сколько, по ощущениям автора, было сделано за неделю. При этом ничего не сломалось и не выдало ни одной ошибки. «Падение вежливо, оно сообщает о себе. Здесь не сообщается ничего. Это всплывает через четыре недели в виде числа», - пишет он.
Субагенты автор не ругает. Главное в них, по его словам, даже не меньшая модель, а собственное контекстное окно: агент уходит, делает что-то шумное и грязное и возвращает короткий ответ, а мусор не попадает в основную сессию. Идеальная задача для субагента - забрать много, отфильтровать и вернуть мало. Для неё нужна послушная модель, а не блестящая, и Sonnet с этим справляется. Гонять такую работу на Fable или Opus 5 автор называет оплатой по фронтирному тарифу «за grep с хорошими манерами».
В его списке агентов, которым нечего делать на дорогой модели, CloudWatch Logs (запрос по одному request ID возвращает океан строк, а нужны стектрейс и время), GitHub с issues, диффами PR и статусом CI, Honeybadger, Langfuse, где 95% каждого трейса не относится к вопросу, статический анализ вроде RubyCritic и RuboCop («отчёт на сто страниц, полезная часть - девять строк») и тест-раннеры. Чтобы понять, какие четыре спеки RSpec красные, Fable не нужен.
Пин выглядит как одна строка в файле .claude/agents/cloudwatch-digger.md: model: sonnet. И пинят, как замечает автор, именно те агенты, которые вызывают чаще всего, а смотрят на них реже всего.
Модель для субагента Claude Code, по описанию автора, выбирает по четырём уровням в порядке приоритета: переменная окружения, параметр model в самом вызове, frontmatter агента и модель, с которой запущена сессия. Тот уровень, которым пользуются все, потому что он задокументирован и пишется один раз, стоит третьим. По словам автора, в нескольких релизах frontmatter молча выпадал, и закреплённые агенты проваливались на четвёртый уровень, к модели сессии. Агент, которого вызывают двести раз в день, тихо работал на самом дорогом, что есть в подписке. Автор оговаривается, что порядок приоритетов в Claude Code меняется от релиза к релизу, и советует сверяться со своей версией.
С этим сталкивался не только он. В одном из отчётов на GitHub пользователь цитирует документацию инструмента Agent: если параметр model не передан, используется модель из определения агента или наследуется родительская. На практике, утверждает он, поле model: во frontmatter игнорируется. В его воспроизведении агент с model: sonnet, запущенный без параметра, назвал себя Opus 4.6, моделью родителя, а с явным "sonnet" в вызове - Sonnet 4.6. Автор отчёта пишет, что мультиагентные фреймворки вроде claude-mpm, где больше 50 агентов закреплены на sonnet или haiku, из-за этого целиком работают на Opus и обходятся «в 5-34 раза дороже задуманного».
Обходной путь во всех таких отчётах один: передавать модель явно в вызове. Это второй уровень, на ступень выше frontmatter, и он, по словам автора блога, ни разу не ломался. Но тогда оркестратор должен помнить о модели при каждом вызове и всегда. Автор GitHub-отчёта отмечает то же: такой обход сводит на нет смысл объявлять модель в определении агента. Автор блога формулирует короче: «Не запоминайте. Принуждайте».
Принуждает хук PreToolUse. Он срабатывает до того, как вызов инструмента уйдёт дальше, и может заблокировать его кодом выхода 2. Скрипт .claude/hooks/enforce-subagent-model.sh через jq читает из stdin три поля: имя инструмента, тип субагента и модель. Всё, кроме Task и Agent, он пропускает сразу. Если тип субагента указан, а модели в вызове нет, awk достаёт значение model: из frontmatter файла .claude/agents/<имя>.md. Пустое значение или inherit пропускаются. Если пин есть, хук пишет в stderr сообщение BLOCKED с просьбой переотправить вызов с этой моделью и уточнением, что осознанно выбранная другая модель тоже пройдёт, если указана явно. Claude Code получает это сообщение и сам повторяет вызов правильно.
Подключается хук в .claude/settings.json: секция PreToolUse с матчером Task и командой $CLAUDE_PROJECT_DIR/.claude/hooks/enforce-subagent-model.sh. Скрипту нужен chmod +x. Проверка простая: вызвать закреплённого агента без модели. Должно прийти сообщение BLOCKED, а следующий вызов должен уже нести пин.
Исключения автор оставил сознательно. Любой вызов с явной моделью проходит, даже если модель другая: «Я защищаюсь от упущения, а не от выбора». Отправить маленького агента на большую модель намеренно можно, провалиться в неё случайно нельзя. Пропускаются агенты без пина или с model: inherit, а также встроенные типы вроде Explore, Plan и general-purpose: файлов в .claude/agents у них нет, проверять нечего. Пустая или null-модель в вызове выбором не считается: она падает на тот самый уровень frontmatter, который под подозрением, поэтому блокируется так же, как отсутствующая.
Если jq не может разобрать payload, все три переменные оказываются пустыми и хук выходит с кодом 0. Автор называет хук защитой от расходов, а не границей безопасности. Хук, который блокирует всё непонятное, рано или поздно заклинит сессию в самый неудачный момент, его отключат, и всё вернётся к исходной точке. Там же стоит его предупреждение: хуки умеют блокировать ваши собственные вызовы, и при ошибке в настройке можно долго смотреть на заблокированный Task, не понимая причины.
Дыра остаётся одна. Внутренние вызовы agent() внутри workflow-инструментов не проходят через PreToolUse, хук ловит только Task и Agent. Такие агенты автор, по его словам, закрывает текстом в справочной документации, «что является вежливым способом сказать, что они не закрыты».
Дальше
Общие сессии и треды в Claude Code Projects, Видео
По данным TestingCatalog, Anthropic готовит совместные Projects для Claude Code в Claude Desktop, где несколько человек и Claude работают в одной сессии с тредами внутри. Память и контекст сохраняются между сессиями.
Читайте также
- Скрытая инструкция запрещает Opus 5 звать субагентов
- Из системного промпта Claude Code убрали около 80%
- Мод для Claude Code сам меряет идеи и откатывает неудачи
- Claude Code отдал свой TypeScript вместе с source maps
- Флот агентов для Claude Code собирает один HTML-файл
- Pairmark судит гонку Claude Code и Codex вслепую
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

