Инструмент advisor является экспериментальным и требует Claude Code v2.1.98 или более поздней версии с API Anthropic. Он недоступен на Amazon Bedrock, Google Vertex AI или Microsoft Foundry. Поведение, цены и доступность могут измениться.
Когда использовать советника
Советник подходит для длительных многошаговых задач, где большинство ходов рутинны, но качество плана определяет результат. Примеры включают крупные рефакторинги, сеансы отладки, где ошибка повторяется, и задачи, которые вы хотите независимо проверить перед тем, как Claude объявит их завершёнными.
Он добавляет меньше ценности для коротких задач, где мало что нужно планировать, или для работы, где каждый ход требует самой мощной модели. Для этого переключите основную модель или см. как советник сравнивается с opusplan и subagents для других способов получить второе мнение.
Включение советника
Вы можете установить модель советника тремя способами:
- Команда
/advisor: установите или измените советника во время сеанса и сохраните его как стандартный
- Параметр
advisorModel: настройте постоянное значение по умолчанию в вашем файле параметров
- Флаг
--advisor: установите советника для одного сеанса при запуске
Если любой из этих способов установит модель советника, советник будет включён для сеансов, основная модель которых его поддерживает. Чтобы перестать его использовать, см. Отключение советника.
Чтобы использовать Fable 5 в качестве советника, вам нужна Claude Code v2.1.170 или более поздняя версия и доступ к Fable 5 для вашей организации. Использование команды /advisor
Запустите /advisor без аргументов, чтобы открыть средство выбора со списком доступных моделей советника, или передайте модель напрямую:
Ваш выбор сохраняется в advisorModel в параметрах пользователя и сохраняется между сеансами. Если ваша текущая основная модель не поддерживает советника, выбор всё равно сохраняется и активируется при переключении на совместимую основную модель с помощью /model.
Установка advisorModel в параметрах
Чтобы настроить советника по умолчанию без открытия сеанса, установите его в файле параметров:
{
"advisorModel": "opus"
}
Использование флага --advisor
Чтобы установить советника для одного сеанса без изменения сохранённого параметра, запустите с флагом:
Флаг имеет приоритет над параметром advisorModel для этого сеанса. В отличие от /advisor, который сохраняет неактивный выбор, флаг завершается с ошибкой, если основная модель сеанса не поддерживает советника.
Выбор модели советника
Советник должен быть по крайней мере такой же способной, как основная модель. Принятые советники для каждой основной модели:
| Основная модель | Принятые советники | Примечания |
|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku может вызывать советника, но не может быть им |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Opus 4.6 или позже | Fable, Opus на версии основной модели или выше | Opus 4.7 в качестве основной с Opus 4.6 в качестве советника отклоняется |
| Fable 5 (v2.1.170+) | Fable | Советник Opus или Sonnet отклоняется |
opus, sonnet или fable. Эти псевдонимы разрешаются в последнюю версию каждой модели. Вы также можете передать полный ID модели, например claude-opus-4-8.
Подагенты наследуют настроенного советника и применяют ту же проверку пары к своей собственной модели.
Claude Code проверяет пару перед отправкой запроса:
- Если советник менее способен, чем основная модель, советник не присоединяется к запросам основной модели. Вывод команды
/advisor и уведомление показывают это. Подагенты, чья собственная модель удовлетворяет требованиям пары, могут по-прежнему использовать советника.
- Если основная модель или советник — это модель, которую Claude Code не распознает, советник не присоединяется.
Распространённые пары моделей
Любая принятая пара работает. Эти комбинации балансируют стоимость и возможности по-разному:
| Пара | Когда использовать |
|---|
| Sonnet основная + Opus советник | Sonnet обрабатывает рутинную работу и эскалирует планирование, неоднозначные сбои и проверки завершения на Opus |
| Sonnet основная + Fable советник | Рекомендации Fable 5 в точках принятия решений без запуска Fable 5 на протяжении всего процесса. Требует v2.1.170 или позже и доступ к Fable 5 |
| Haiku основная + Opus советник | Самая дешёвая основная модель с мощным планированием. Ожидайте более высокую стоимость, чем только Haiku, но ниже, чем переключение основной модели на Sonnet или Opus |
| Opus основная + Opus советник | Второй Opus проверяет первый. Полезно для высокорисковых задач, где независимая проверка важнее стоимости |
| Fable основная + Fable советник | Пара с наивысшей возможностью, когда Fable 5 доступна (v2.1.170+). Fable является более высоким уровнем, чем Opus и Sonnet, поэтому это единственный принятый советник для основной модели Fable |
| Sonnet основная + Sonnet советник | Более дешёвое второе мнение для выявления рутинных упущений |
Когда Claude консультируется с советником
Claude решает, когда вызывать советника. Он имеет тенденцию консультироваться перед принятием подхода, когда ошибка повторяется, и перед объявлением задачи завершённой, но время определяется моделью, а не правилами.
Вы можете попросить консультацию в своём приглашении так же, как вы запросили бы любой инструмент, например consult the advisor before you continue. Нет параметра для ограничения или принудительного вызова советника; если вы хотите, чтобы Claude консультировался чаще или реже во время задачи, скажите об этом в своих инструкциях.
Что вы видите во время сеанса
Когда Claude вызывает советника, стенограмма показывает строку Advising с именем модели советника во время выполнения вызова. Когда результат возвращается, строка подтверждает, что советник проверил диалог. Нажмите Ctrl+O, чтобы развернуть его и прочитать полные рекомендации советника.
Claude обычно следует рекомендациям советника, но адаптируется, когда его собственные доказательства противоречат конкретному утверждению: если рекомендуемый шаг не удаётся при попытке или содержимое файла противоречит совету, Claude выявляет конфликт, а не следует рекомендации безусловно.
Советник всегда получает полный диалог, и Claude контролирует время. Для большего контроля или другой конфигурации см. как советник сравнивается с subagents и opusplan.
Стоимость
Каждый вызов советника отправляет диалог модели советника, поэтому он потребляет токены по ставкам модели советника в дополнение к использованию вашей основной модели. При выставлении счёта по API токены советника взимаются по входным и выходным ставкам модели советника. На планах подписки использование советника учитывается в пределах использования вашего плана.
Claude вызывает советника в точках принятия решений, а не на каждом ходу, поэтому объединение более быстрой основной модели с более мощным советником обычно стоит меньше, чем запуск более мощной модели на протяжении всего процесса. Использование советника учитывается в итогах сеанса, показанных /usage.
Для информации о том, как токены советника сообщаются в ответах API, см. Usage and billing в документации Claude API.
Влияние на кэширование приглашений
Включение или отключение советника во время сеанса не делает недействительным кэш приглашений вашей основной модели. В отличие от изменения модели или уровня усилий, переключение /advisor сохраняет кэшированный префикс нетронутым, и возвращённые рекомендации советника кэшируются как часть стенограммы при последующих ходах.
Собственное чтение советником диалога не кэшируется. Каждый вызов советника обрабатывает полную стенограмму заново, без повторного использования между вызовами.
Требования
Инструмент advisor требует всё следующее:
- Claude Code v2.1.98 или позже: запустите
claude update для обновления.
- Только API Anthropic: советник является инструментом, выполняемым на сервере. Он недоступен на Amazon Bedrock, Google Vertex AI или Microsoft Foundry. Через LLM gateway, настроенный с
ANTHROPIC_BASE_URL, доступность зависит от того, пересылает ли шлюз запрос в целости на API Anthropic.
- Поддерживаемая основная модель: Opus 4.6 или позже, Sonnet 4.6 или Haiku 4.5. Fable 5 также подходит на Claude Code v2.1.170 или позже.
Отключение советника
Чтобы перестать использовать советника и очистить сохранённый advisorModel, запустите /advisor off или выберите No advisor в средстве выбора /advisor:
Чтобы полностью отключить инструмент advisor, включая команду /advisor и флаг --advisor, установите CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. См. Environment variables.
Советник — это один из нескольких способов объединить сильные стороны моделей. Выбирайте в зависимости от того, когда вы хотите, чтобы вторая модель была задействована.
| Подход | Когда работает более мощная модель | Как это начинается |
|---|
| Инструмент advisor | В точках принятия решений во время задачи | Claude вызывает его, когда ему нужна рекомендация |
opusplan | Во время режима плана, затем переключается на Sonnet для выполнения | Вы входите в режим плана |
Subagents с установленным model | Для всей делегированной подзадачи | Claude делегирует или вы вызываете subagent |
/model | Для всех последующих ходов | Вы переключаете модели |
См. также
