Содержание
Хочется, чтобы план составляла умная модель, а сам код писала модель побыстрее и подешевле. В Claude Code есть настройка, которая делает это автоматически, — opusplan.
Если коротко, opusplan — это указание модели, при котором в plan mode работает Opus, а всё остальное время — Sonnet. Чтобы им воспользоваться, введите /model opusplan или пропишите его в model файла settings.json. Но в списке /model его нет, так что без знания имени его не найти. Кроме того, модель переключается при каждом входе в plan mode и выходе из него, поэтому стоит учитывать, что при каждом переключении весь диалог читается заново без кэша.
В этой статье по официальной документации, журналу изменений Claude Code (CHANGELOG) и issue на GitHub на 15 сентября 2026 года разобрано, как его настроить, как проходит работа, почему его нет в списке, что учитывать с ценами и кэшем и чем он отличается от похожих механизмов (advisor и субагентов).
С opusplan модель переключается при входе в plan mode и выходе из него
Для Anthropic API. Куда ведут opus и sonnet, зависит от провайдера
В plan mode
Opus 5
Изучает код и пишет план, ничего не редактируя
Всё остальное (реализация)
Sonnet 5
Редактирует файлы и выполняет команды по плану
Источник: официальная документация Claude Code, «Model configuration» (opusplan model setting, куда ведут псевдонимы моделей)
1. Что такое opusplan: Opus только в plan mode
opusplan — это псевдоним модели, который, как и sonnet или opus, можно указать в /model. Официальная документация описывает его как «особый режим, который в plan mode использует opus, а для выполнения переключается на sonnet».
Переключение зависит только от одного: находитесь ли вы в plan mode. Plan mode — это состояние, в котором Claude читает файлы и выполняет команды, чтобы разобраться в задаче, пишет план и не редактирует исходный код, пока план не одобрен (все режимы разрешений разобраны в статье Режимы разрешений Claude Code: 5 режимов и Shift+Tab).
| Состояние | Модель при opusplan | Для какой работы (по документации) |
|---|---|---|
| В plan mode | opus (в Anthropic API — Opus 5) | Сложные рассуждения и архитектурные решения |
| Всё остальное | sonnet (в Anthropic API — Sonnet 5) | Генерация и реализация кода |
Источник: официальная документация Claude Code, «Model configuration» (на 15 сентября 2026 года). Куда ведут псевдонимы, зависит от провайдера: например, в Amazon Bedrock и Agent Platform в Google Cloud sonnet — это Sonnet 4.5
Есть и ещё один похожий механизм. Сессия, работающая на Haiku, в plan mode автоматически поднимается до Sonnet (появилось в v2.0.17 вместе с Haiku 4.5; на момент появления в Amazon Bedrock и Google Vertex AI автоматического повышения не было). Он действует без всякой настройки.
2. Как настроить
Указывается он так же, как любая другая модель. Ниже способы в порядке приоритета — от высшего к низшему, как в официальной документации.
| Способ | Как записать | Где действует |
|---|---|---|
| Переключить посреди диалога | /model opusplan | Текущая сессия и последующие новые сессии (сохраняется в пользовательских настройках) |
| Указать при запуске | claude --model opusplan | Эта сессия |
| Переменная окружения | ANTHROPIC_MODEL=opusplan | Сессии, запущенные в этом окружении |
| Файл настроек | "model": "opusplan" в settings.json | Все новые сессии |
Команда /model opusplan не только переключает текущую сессию: она записывает model в пользовательские настройки, и он становится моделью по умолчанию для новых сессий. Если хотите попробовать только в этот раз, запустите Claude Code командой claude --model opusplan.
{
"model": "opusplan"
}
Полезно знать ещё три настройки.
- Закрепить версии моделей: какой Opus
opusplanиспользует в plan mode, задаётANTHROPIC_DEFAULT_OPUS_MODEL, а какой Sonnet в остальное время —ANTHROPIC_DEFAULT_SONNET_MODEL. В Amazon Bedrock и у других провайдеров сюда пишут ID моделей своего провайдера - Работать с контекстом 1M токенов: на тарифах, где Opus автоматически получает 1M, — например, Max, Team и Enterprise — сторона Opus в
opusplanтоже получает 1M. В остальных случаях, чтобы 1M был у обеих, укажитеopusplan[1m]. Через/model opusplan[1m]это можно сделать начиная с v2.1.265, а в более ранних версиях — через--modelили файл настроек - В переменной окружения модели по умолчанию не работает: если записать
opusplanвANTHROPIC_DEFAULT_MODEL, которая задаёт модель по умолчанию для новых сессий, значение игнорируется. Чтобы сделать его моделью по умолчанию, введите/model opusplanили пропишите его вmodelфайлаsettings.json
Источник: официальная документация Claude Code, «Model configuration» (Setting your model, Environment variables, Extended context, opusplan model setting), там же, «Settings reference» (model)
Можно ли выбрать его в интерфейсе
- В списке
/modelв терминале его нет. Если открыть/modelбез аргумента, там будут Opus, Sonnet, Haiku и другие, но неopusplan. Запрос на GitHub добавить его в список (#26556) на 15 сентября 2026 года остаётся открытым. 🟡 В официальной документации не сказано, есть ли он в списке, так что это основано на сообщениях пользователей. В том же issue сообщается и о том, что если добавить строку самостоятельно через настройкуmodelPicker, появившуюся в v2.1.243, то в режиме добавления (append) она считается дубликатом строки Sonnet и не отображается - 🟡 Появляется ли
opusplanв выборе модели в расширении VS Code и десктопном приложении, официальная документация не говорит. Оба работают поверх Claude Code, который используетsettings.json, но как они показывают его в интерфейсе, не подтверждено, поэтому перед использованием проверьте, какая модель отображается
3. Как проходит работа
Если только указать opusplan, работа продолжится на Sonnet. Opus включается, только когда вы сами входите в plan mode.
- Войти в plan mode: в терминале переключитесь на него клавишами
Shift+Tabили начните запрос с/plan. Чтобы сразу запуститься в нём, используйтеclaude --permission-mode plan. В десктопном приложении выберите его в селекторе режима разрешений (mode selector) - Opus пишет план: читает файлы, выполняет команды, чтобы разобраться, и составляет план, ничего не редактируя. Клавишами
Ctrl+Gплан можно открыть в редакторе и поправить напрямую - Одобрить план: выберите «Yes, and use auto mode» (продолжить в auto mode), «Yes, manually approve edits» (одобрять правки по одной) или «No, keep planning» (продолжить планирование); если auto mode недоступен, первый вариант называется «Yes, auto-accept edits» (одобрять правки автоматически). После одобрения plan mode завершается, и дальше реализацией занимается Sonnet
- Если нужно спланировать ещё раз: вернитесь в plan mode клавишами
Shift+Tabили начните следующий запрос с/plan. На это время снова включается Opus
Если в настройках задать showClearContextOnPlanAccept равным true, в самом верху вариантов одобрения появится «Yes, clear context and …» — одобрение с очисткой контекста (продолжение надписи называет режим разрешений). Этот вариант отбрасывает, например, содержимое файлов, прочитанных при составлении плана, и начинает реализацию только с планом (по умолчанию false). Как описано в разделе 5, с opusplan это сказывается и на стоимости.
Источник: официальная документация Claude Code, «Choose a permission mode» (Analyze before you edit with plan mode, Review and approve a plan), там же, «Settings reference» (showClearContextOnPlanAccept), там же, «Desktop» (выбор режима разрешений)
Не спрашивайте саму модель, на какой модели она сейчас работает. В обсуждении на GitHub в сентябре 2025 года сотрудник Anthropic написал, что вместо того чтобы спрашивать модель, кто она, нужно смотреть, что показывает приложение. Способы проверки собраны в вопросе 3 в FAQ.
4. Почему его нет в списке /model
opusplan — не новая функция. Его нет в списке, потому что в какой-то момент его убрали из интерфейса. Вот что показывают журнал изменений и issue на GitHub.
| Когда | Что произошло |
|---|---|
| v1.0.77 | Добавлен в /model как «Opus Plan Mode»: Opus только в plan mode, в остальное время Sonnet |
| v1.0.88 | Через ANTHROPIC_DEFAULT_OPUS_MODEL и ANTHROPIC_DEFAULT_SONNET_MODEL стало можно задавать версии, которые использует opusplan |
| v2.0.0 (сентябрь 2025 года) | Убран из экрана выбора модели (в журнале изменений этого нет, это видно из issue). Пользователь открывает issue #8358 с вопросом, почему его убрали |
| 29 сентября 2025 года | Сотрудник Anthropic объясняет в issue: «Мы сочли, что Sonnet 4.5 в целом лучше Opus 4.1, и намеренно убрали его из экрана выбора. Сама настройка opusplan продолжает работать» |
| v2.0.17 | Сессии на Haiku 4.5 в plan mode автоматически используют Sonnet |
| 18 февраля 2026 года | Автор issue убеждается, что всё работает через /model opusplan, и закрывает #8358. В тот же день открыт #26556 с просьбой показывать его в списке (на 15 сентября 2026 года не решён) |
| Февраль–март 2026 года | Сообщение об ошибке #27237: opusplan выбирает Sonnet 4.5 вместо Sonnet 4.6. Закрыто автоматически без ответа Anthropic |
| v2.1.172 | Исправлено: на тарифах с контекстом 1M Opus в plan mode не получал 1M |
| v2.1.265 | Исправлено: /model opusplan[1m] отклонялся с ошибкой «Model not found» |
Источник: Claude Code CHANGELOG, GitHub issue #8358, #26556, #27237 (все проверены 15 сентября 2026 года)
🟡 Почему его нет в списке сейчас, Anthropic заново не объяснял. Объяснение от сентября 2025 года сравнивало тогдашние Sonnet 4.5 и Opus 4.1. Сохраняется ли то же решение для пары Opus 5 и Sonnet 5, неизвестно. С другой стороны, в официальной документации раздел про opusplan по-прежнему есть, а в журнале изменений есть исправления 2026 года, так что как настройка он остаётся рабочим.
Бывают и сообщения, как issue #27237, что версии выбирались не так, как ожидалось. Правда, ID модели в этом сообщении записан в формате Google Cloud, а по нынешней официальной документации sonnet в Google Cloud указывает на Sonnet 4.5, так что, возможно, всё работало как задумано (это моё предположение). Если это вас беспокоит, закрепите версии двумя переменными окружения, о которых говорилось выше, и проверьте, какая модель работала на самом деле.
5. Цены и кэш: каждое переключение — повторное чтение
Чаще всего opusplan выбирают, чтобы сократить расход или стоимость. Если отдать реализацию Sonnet, цена за токен снижается.
| Модель | Ввод | Вывод | Запись в 5-минутный кэш | Запись в часовой кэш | Чтение кэша |
|---|---|---|---|---|---|
| Claude Opus 5 | $5 | $25 | $6.25 | $10 | $0.50 |
| Claude Sonnet 5 | $2 | $10 | $2.50 | $4 | $0.20 |
Источник: Claude Platform Docs, «Pricing» (за миллион токенов, на 15 сентября 2026 года)
Однако есть одна статья расходов, которую легко упустить. Кэш промптов у каждой модели свой, и официальная документация пишет: «в opusplan вход в plan mode и выход из него — это смена модели, и каждый раз кэш создаётся заново». Иными словами, первый ответ Sonnet сразу после выхода из plan mode и первый ответ Opus сразу после возвращения в него читают весь предыдущий диалог без кэша.
Чтобы оценить масштаб, я посчитал переключение в момент, когда диалог дорос до 100 000 токенов. По подписке в пределах тарифа кэш основного диалога живёт 1 час, поэтому запись считается по цене часового кэша. При этом и с API-ключом или через облачного провайдера кэш основного диалога можно сделать часовым, установив promptCacheTtl в 1h (v2.1.242 и новее), а по подписке, наоборот, кэш становится 5-минутным, пока вы сверх тарифа платите дополнительными кредитами (usage credits).
| Переключение | Сколько записывается заново | API-ключ (5-минутный кэш) | Подписка (часовой кэш) |
|---|---|---|---|
| Выход из plan mode (на Sonnet 5) | 100 000 токенов | Около $0.25 | Эквивалент около $0.40 |
| Возврат в plan mode (на Opus 5) | 100 000 токенов | Около $0.63 | Эквивалент около $1.00 |
Источник: мой расчёт по официальным ценам (100 000 токенов × цена). 🟡 Официально не сообщается, что лимиты подписки расходуются в пропорции к этим суммам. Время жизни кэша — по официальной документации Claude Code, «How Claude Code uses prompt caching»
Если продолжать читать те же 100 000 токенов на Opus, чтение кэша обойдётся примерно в $0.05 за раз. Если много раз входить в plan mode и выходить из него, пока обмены при реализации ещё короткие, запись при переключениях может обойтись дороже. Сократить расходы помогают три приёма.
- Планировать в начале диалога: пока контекст маленький, при переключении и записывать заново приходится меньше
- Очищать контекст при одобрении: включите
showClearContextOnPlanAcceptи выберите вариант с очисткой контекста — тогда Sonnet начнёт только с планом и перечитает меньше - Не метаться между планированием и реализацией: при каждом возвращении в plan mode повторное чтение происходит и на стороне Opus
Скажу и о лимитах подписки. Лимит сессии и недельный лимит общие для всех моделей, а помимо них есть лимиты по семействам моделей — «лимит Opus» и «лимит Sonnet». Поскольку opusplan в plan mode использует Opus, при исчерпанном лимите Opus воспользоваться Opus в plan mode не получится. На странице цен Opus указан как доступный и на тарифе Pro, но, по официальной документации, чтобы на Pro работать с Opus в контексте 1M, нужны дополнительные кредиты (usage credits).
Источник: официальная документация Claude Code, «How Claude Code uses prompt caching» (Switching models, Changing permission mode, Which TTL each request gets), там же, «Error reference» (общие для всех моделей лимиты и лимиты по семействам моделей), там же, «Model configuration» (Extended context), страница цен Claude (модели по тарифам)
6. Чем отличается от advisor и субагентов
opusplan — не единственный способ сочетать сильную модель с быстрой. Официальная документация сравнивает варианты по тому, когда работает более сильная модель.
| Способ | Когда работает сильная модель | Как включается |
|---|---|---|
| Инструмент advisor | В точках принятия решений по ходу работы | Claude вызывает его, когда нужно |
opusplan | В plan mode, если это разрешено в availableModels (выполнение — на Sonnet) | Вы сами входите в plan mode |
| Субагент с указанной моделью | На всём порученном ему задании | Claude поручает или вы вызываете сами |
Переключение через /model | Со следующего запроса и дальше | Вы переключаете сами |
Источник: официальная документация Claude Code, «Escalate hard decisions with the advisor tool» (Compare with related features)
Инструмент advisor оставляет основную сессию на быстрой модели, а Claude по ходу работы советуется с более сильной. В отличие от opusplan, его включение и выключение не ломает кэш основной сессии. Но при каждой консультации advisor читает весь диалог, и это чтение не кэшируется. На 15 сентября 2026 года это экспериментальная функция, доступная только в Anthropic API (в Amazon Bedrock и у других провайдеров недоступна).
Субагенты запускают на другой модели только порученную работу. Настройка и замеры разобраны в статье Как запускать субагентов Claude Code на другой модели.
Источник: официальная документация Claude Code, «Escalate hard decisions with the advisor tool» (Cost, Impact on prompt caching, Requirements)
7. Когда подходит, а когда нет
Исходя из описанного устройства, соберу ориентиры для решения (это не официальная рекомендация, а мои выводы из того, как всё работает).
Подходит
Схема «спланировать, одобрить и долго реализовывать»
Работа, где вы и так пользуетесь plan mode и после того, как план утверждён, реализация идёт долго. Переключений мало, и более низкая цена реализации даёт выигрыш.
Подходит с оговорками
Работа, где планируют, когда контекст уже вырос
При каждом переключении перечитывать приходится больше. В сочетании с настройкой, очищающей контекст при одобрении, повторное чтение на стороне Sonnet можно сократить.
Не подходит
Работа с частыми переходами между планом и реализацией
Если возвращаться в plan mode ради каждой мелкой правки, повторных чтений становится больше. Работа, где сильная модель нужна для самой реализации, тоже плохо сочетается с opusplan, который выполняет её на Sonnet.
Если сомневаетесь, надёжнее всего выполнить однотипную задачу один раз с opusplan и один раз с привычной моделью и сравнить цифры в /usage и результат. Как подробно смотреть расход по сессиям, описано в статье Claude Code: расход по сессиям — как его измерить.
FAQ
Q1. Открываю /model, но не нахожу opusplan.
Так и задумано: в списке его нет (на 15 сентября 2026 года). Укажите его, набрав имя: /model opusplan. Так он сохранится и как модель по умолчанию для новых сессий. Если он нужен только в этот раз, запустите Claude Code командой claude --model opusplan.
Q2. Я включил opusplan, но всё время работает Sonnet.
Это нормально. opusplan использует Opus только в plan mode, а сам в plan mode не входит. Переключитесь на него клавишами Shift+Tab или начните запрос с /plan.
Q3. Можно ли проверить, на какой модели работа идёт прямо сейчас?
Не спрашивайте модель, а смотрите, что показывает приложение. Текущую модель можно увидеть через /status; кроме того, в строку состояния (status line) текущая модель передаётся скрипту, поэтому её можно настроить на показ имени модели. Задним числом это видно в логах диалогов (JSONL-файлы в ~/.claude/projects): в message.model каждого ответа записана модель, которая на самом деле ответила.
Q4. Работает ли это в Amazon Bedrock или Google Cloud?
Работает. Укажите ID моделей своего провайдера в ANTHROPIC_DEFAULT_OPUS_MODEL и ANTHROPIC_DEFAULT_SONNET_MODEL, чтобы задать версии, которые использует opusplan. Если управляемые настройки организации (availableModels) исключают самый новый Opus, в Anthropic API и Claude Platform on AWS план составляет самый новый из разрешённых Opus, а если исключены все Opus, то и в plan mode работа остаётся на Sonnet. В Bedrock, Google Cloud, Microsoft Foundry и у других провайдеров, если модель исключена, планирование и в plan mode идёт на исходной модели сессии (оба варианта поведения — начиная с v2.1.205).
Q5. Что такое opusplan[1m]?
Это указание, при котором и Opus в plan mode, и Sonnet при выполнении работают с контекстом 1 миллион токенов. На тарифах, где Opus автоматически получает 1M, — например, Max, Team и Enterprise — сторона Opus получает 1M и без него. При этом Sonnet 5 в Anthropic API всегда работает с 1M, даже без указания. /model принимает такую запись начиная с v2.1.265.
Источники
- Claude Code Docs — Model configuration (что такое
opusplan, куда ведут псевдонимы, способы указать модель и их приоритет, переменные окружения, контекст 1M,availableModelsи повышение модели в plan mode) - Claude Code Docs — Choose a permission mode (как войти в plan mode, одобрение плана)
- Claude Code Docs — Settings reference (
model,showClearContextOnPlanAccept) - Claude Code Docs — How Claude Code uses prompt caching (смена модели и кэш, переключение plan mode в
opusplan, время жизни кэша) - Claude Code Docs — Escalate hard decisions with the advisor tool (сравнение со связанными функциями, стоимость, влияние на кэш)
- Claude Code Docs — Error reference (лимиты использования)
- Claude Code Docs — Desktop (выбор модели и режима разрешений)
- Claude Code CHANGELOG (v1.0.77, v1.0.88, v2.0.17, v2.1.172, v2.1.265)
- GitHub issue #8358, #26556, #27237 (как его убрали из экрана выбора, объяснение сотрудника Anthropic, просьба показывать его в списке, сообщение о том, какие версии выбираются)
- Claude Platform Docs — Pricing, страница цен Claude (цены по моделям, модели по тарифам)
Похожие статьи
- Как запускать субагентов Claude Code на другой модели — разные модели для разных задач
- Режимы разрешений Claude Code: 5 режимов и Shift+Tab — режимы разрешений, включая plan mode
- Claude Code: расход по сессиям — как его измерить — как сравнивать расход
- Claude Code: что на самом деле съедает ваш контекст? — почему объём повторного чтения растёт
- 10 советов по экономии токенов Claude Code и разбор тарифов — где ещё можно сэкономить