Claude Code Advisor: настройка Sonnet + Opus и проверка вызовов
Оставьте обычные задачи Sonnet и подключайте Opus для консультаций в Claude Code. Настройте /advisor, advisorModel или --advisor, выберите совместимую пару и проверьте вызовы по журналу. Оцените стоимость чтения диалога без кеша и различайте проблемы с флагами функций, отказ API принять пару моделей и отказ шлюза поддерживать инструмент.
Содержание
Включите advisor в Claude Code: Sonnet будет выполнять обычную работу, а Opus — выступать консультантом для сложных решений. Запустите claude --model sonnet --advisor opus, затем найдите в журнале строку Advising и проверьте результат вызова, прежде чем полагаться на консультацию. Момент вызова выбирает модель; консультации расходуют дополнительные токены и могут прекратиться, если шлюз отклонит инструмент.
По состоянию на 2026-11-06 функция advisor остаётся экспериментальной. Для примеров ниже нужен установленный консольный клиент с рабочей аутентификацией, который уже успешно отправляет обычные запросы напрямую в Anthropic. Для прямого подключения подходят как аккаунты с подпиской, так и аккаунты с оплатой по API. Поддержку через шлюз нужно проверять отдельно.
Когда нужен advisor, а когда лучше сменить модель?
Подключайте консультанта для рефакторинга, поиска повторяющейся ошибки или задачи, в которой сложные решения возникают лишь время от времени. Sonnet продолжает работу, а вторая модель проверяет историю диалога, включая вызовы инструментов и их результаты.
Так Anthropic описывает стратегию с консультантом. Она не гарантирует качество Opus в каждой задаче или заранее известную экономию.
| Что вам нужно | Что выбрать | Как это работает |
|---|---|---|
| Советы на отдельных этапах работы | Advisor | Claude сам решает, когда обратиться к другой модели |
| Планирование на Opus, затем реализация на Sonnet | opusplan | В режиме планирования работает Opus, если доступ к нему разрешён; код пишет Sonnet |
| Отдельное исследование или проверка | Субагент с выбранным model | Выбранная модель выполняет порученную подзадачу |
| Более сильная основная модель для следующих запросов | /model | Вы меняете основную модель |
Для короткой задачи, где почти нечего планировать, начните без консультанта. Если Opus нужен практически на каждом шаге, лучше переключить основной сеанс на Opus 5.5.
Команда запуска не создаёт трёх субагентов Haiku для поиска, grep и документации. Для этого отдельно задайте модель субагента по инструкции. В документации для такого запуска указан параметр --agents с JSON. Не заменяйте его командой --subagents haiku из пересказов.
Как включить advisor: три способа
Для первой проверки используйте флаг запуска: он не меняет сохранённый выбор консультанта. Сначала проверьте версию клиента в Bash:
claude --versionДля этого примера с Sonnet 5.5 и Opus 5.5 нужна версия 2.1.284 или новее. Этот минимум задают требования моделей, а не версия первого появления advisor. В документации для обновления клиента указана команда claude update.
На один сеанс: флаг —advisor
Выполните в Bash из каталога проекта:
claude --model sonnet --advisor opusПо состоянию на 2026-11-06 при прямом подключении к Anthropic эти псевдонимы выбирают Sonnet 5.5 и Opus 5.5. Их соответствия могут меняться или быть переопределены настройками. Чтобы явно выбрать версии, укажите полные ID:
claude --model claude-sonnet-5-5 --advisor claude-opus-5-5В этом сеансе значение флага имеет приоритет над advisorModel. Документация отдельно предупреждает: --advisor не отображается в claude --help.
В текущем сеансе: команда /advisor
Введите внутри Claude Code:
/advisor opusВ ответ появится Advisor set to и название модели. Команда /advisor без аргументов открывает список доступных консультантов.
В локальном терминале этот выбор обычно сохраняется как значение по умолчанию. Для удалённых сеансов действуют отдельные правила сохранения настройки.
Для следующих сеансов: настройка advisorModel
Добавьте это свойство в пользовательский файл настроек ~/.claude/settings.json:
{
"advisorModel": "opus"
}Сохраните остальные настройки файла. Это свойство выбирает консультанта, но не назначает Sonnet основной моделью.
После включения найдите уведомление:
Advisor Tool (experimental) is on and may use more tokens · /advisorОно подтверждает, что функция включена. Само уведомление ещё не доказывает, что консультация состоялась.
Какие пары моделей поддерживаются?
Выбирайте консультанта не ниже основной модели в рейтинге Claude Code для этой роли. Ниже приведены отдельные допустимые пары из официальной таблицы, проверенной 2026-11-06.
| Основная модель | Консультант | Для чего подходит |
|---|---|---|
| Sonnet 5.5 | Opus 5.5 | Обычная реализация с проверкой более сильной моделью |
| Haiku 5.5 | Opus 5.5 | Более лёгкая основная модель с углублённой консультацией |
| Sonnet 5.5 | Sonnet 5.5 | Дополнительная проверка той же моделью |
| Opus 5.5 | Opus 5.5 | Дополнительная проверка со стороны Opus |
| Opus 4.7 или Opus 4.8 | Sonnet 5.5 | Документированная пара из разных семейств |
Для Haiku 5.5 в роли основной модели или консультанта нужна версия 2.1.293 или новее. Для Sonnet 5.5 как консультанта при основной Opus 4.7 или Opus 4.8 нужна 2.1.287 или новее. Haiku 4.5 может запрашивать советы, но не может выступать консультантом.
Это список допустимых сочетаний, а не гарантированный рейтинг качества для вашего репозитория. Организация может ограничить выбор списком availableModels. Недопустимое или запрещённое значение --advisor может остановить интерактивный запуск с ошибкой. Если ранг консультанта ниже ранга основной модели или ID модели не распознан, сеанс может продолжиться без консультаций.
Субагенты наследуют настройку advisor и проверяют совместимость со своей моделью. При оценке общего расхода учитывайте и их возможные обращения к консультанту.
Как проверить, что консультант действительно был вызван?
Сначала найдите вызов инструмента в журнале сеанса, затем проверьте расход. Уведомления при запуске или слов Claude о том, что он посоветовался с Opus, недостаточно.
В знакомом репозитории попробуйте следующий запрос без изменения файлов. Он просит изучить аутентификацию, предложить небольшой рефакторинг и обратиться к консультанту перед показом плана:
Inspect this repository's authentication flow without changing files.
Propose one small refactor and identify its main regression risk.
Consult the advisor before presenting the plan.
Include the tests that would check the proposed change.Это пример проверочного запроса, который не гарантирует вызов. Момент обращения выбирает Claude. Планирование, повторяющиеся ошибки и проверка перед завершением — типичные поводы, а не три обязательных условия срабатывания.
В настройках advisor для Claude Code нет параметра, который принудительно вызывает консультанта или ограничивает число вызовов. В запросе или CLAUDE.md можно попросить обращаться чаще. Но такая просьба не создаёт обязательного этапа проверки.
Ищите строку Advising с названием модели консультанта. Затем посмотрите, чем закончился вызов:
| Результат | Что он подтверждает | Что делать дальше |
|---|---|---|
| Reviewed | Консультант проверил историю диалога | Нажмите Ctrl+O, если вернулся читаемый текст рекомендаций; изучите получившийся план |
| Declined | Вызов состоялся, но консультант отказался давать совет | Прочитайте причину, если она доступна, и пересмотрите запрос |
| Unavailable | Вызов завершился ошибкой | Посмотрите Advisor unavailable (<error_code>) и разберите указанную ошибку |
Нет записи Advising | В журнале нет подтверждённой консультации | Явно попросите консультацию; если записи снова нет, проверьте включение функции и подключение |
После проверочного запроса выполните /usage. Расход консультанта входит в общие показатели сеанса. Однако сам рост расхода не доказывает, что проверка прошла успешно. Сопоставляйте его с результатом вызова в журнале.
Сколько стоит консультация advisor?
Закладывайте в расчёт ещё одно чтение диалога другой моделью. Токены консультанта добавляются к расходу основной модели.
При оплате по API входные и выходные токены оплачиваются по тарифам консультанта. При работе Sonnet/Opus по подписке консультации расходуют её лимиты. Отдельного безлимитного объёма проверок они не дают.
По состоянию на 2026-11-06 стандартные тарифы Anthropic для Opus 5.5 — $4 за миллион входных токенов и $20 за миллион выходных.
Ниже — условный расчёт только для консультанта. Предположим прямую оплату Anthropic API по стандартным глобальным тарифам, 50,000 входных токенов без кеша и 2,000 оплачиваемых выходных токенов. В оплачиваемый выход входят и токены рассуждения.
Advisor token cost
= (50,000 × $4 + 2,000 × $20) / 1,000,000
= $0.24Это не фиксированная цена консультации. Расчёт не включает работу основной модели и не показывает расход лимита подписки. Более длинная история или ответ консультанта увеличат сумму.
Согласно документации Claude Code, при каждой консультации модель заново читает всю историю без повторного использования собственного кеша. Включение и отключение через /advisor сохраняет кеш промпта основной модели. Полученные советы могут попасть в этот кеш при следующих запросах.
Это описание относится именно к Claude Code. Для прямой работы через Messages API теперь описан отдельный параметр caching консультанта. Он не входит в настройку консольного клиента из этого примера.
Прежде чем постоянно использовать пару моделей, сравните полную стоимость одной и той же завершённой задачи. Сохраните одинаковые критерии приёмки, учитывайте повторные запросы и неудачные попытки. Для сеансов с большим контекстом сначала оцените вклад MCP в расход контекста, а затем делайте выводы о влиянии advisor.
Сумма в долларах в /usage — оценка. Фактические списания проверяйте в отчёте провайдера.
Как исправить ошибки 400 и незаметное отключение за шлюзом?
Сначала определите, на каком этапе перестал работать advisor. Функция могла не включиться, API мог отклонить пару моделей, а шлюз — не поддержать серверный инструмент. Для этих случаев нужны разные действия.
Нет уведомления при запуске или вызовов консультанта
Прежде чем менять модели, проверьте переменные среды и раздел env в настройках. Значение CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 полностью отключает инструмент.
Проверьте также DISABLE_TELEMETRY и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Они могут отключить механизм загрузки флагов доступности функций, от которого зависит advisor. Изучите описание этих настроек, включая условия для первого сеанса и учётных данных при подключении через шлюз.
Если эти параметры задала организация, используйте согласованную конфигурацию или другой способ проверки кода. Если причиной стал необязательный локальный параметр, уберите его из конфигурации, где он задан, и перезапустите клиент. Повторите проверочный запрос и найдите вызов в журнале. Одно изменение переменной среды ещё не подтверждает успех.
Сеанс работает, но API отклонил пару моделей
Проверьте фактические ID обеих моделей и список availableModels. Сохранённый выбор консультанта может оставаться неактивным, если основная модель с ним несовместима.
Если API отклоняет переданную пару, Claude Code повторяет запрос без advisor. Диалог при этом может продолжиться без видимой ошибки. Выберите допустимого консультанта, затем выполните /clear, /compact или начните новый сеанс и проверьте вызов снова.
Перед очисткой диалога сохраните нужный контекст задачи. Этот способ относится к отказу принять пару моделей, а не к любой ошибке шлюза.
Появляется Input tag ‘advisor_20260301’
Ошибка 400 или 422 с фрагментом Input tag 'advisor_20260301' означает, что шлюз или API за ним отклонил тип инструмента advisor.
Начиная с 2.1.280, Claude Code распознаёт такой отказ и один раз повторяет запрос без записи advisor и связанного beta-значения. Работа с кодом может продолжиться, хотя консультант уже недоступен.
Руководство по совместимости шлюзов задаёт срок такого отключения: запросы к тому же базовому URL идут без advisor до выхода из Claude Code. Команда /advisor в этом состоянии недоступна. Исправьте маршрут через шлюз, затем полностью завершите процесс Claude Code и запустите его заново. Одного /clear для такого сброса недостаточно.
Если клиент старый, сначала обновите его. Если ошибка остаётся на актуальном клиенте, попросите администратора шлюза проверить определение инструмента:
- Запись в
toolsс типомadvisor_20260301доходит до API Anthropic, который поддерживает этот инструмент. - Связанное значение
advisor-tool-2026-03-01заголовкаanthropic-betaпередаётся вместе с записью инструмента. - Тела ответов с ошибкой сохраняют исходную формулировку, по которой Claude Code распознаёт отказ.
Если после исключения инструмента и связанного значения заголовка обычные запросы заработали, это подтверждает повтор без advisor. Поддержку самого инструмента такой результат не доказывает.
По состоянию на 2026-11-06 в списке моделей BetterToken есть claude-sonnet-5-5 и claude-opus-5-5. В инструкции для Claude Code для ANTHROPIC_BASE_URL указан https://bettertoken.ai, без /v1. Наличие моделей не подтверждает поддержку advisor: уточните её для своего маршрута и проверьте реальную консультацию.
Если обычные запросы Messages тоже завершаются ошибкой, сначала проверьте подключение по примеру минимального запроса к Claude API. Затем повторите проверку advisor.
Как отключить advisor?
Чтобы прекратить консультации, выполните команду в текущем сеансе:
/advisor offДля полного отключения задайте переменную в Bash перед запуском:
export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1
claudeКогда эта переменная задана, команда /advisor недоступна, а настройка advisorModel игнорируется. Claude Code принимает флаг --advisor, но тот ничего не меняет.
