Модели и effort: --model, --effort

Почему это важно именно вам

API Anthropic оплачивается по факту использования: чем больше токенов потратили, тем больше заплатили. Токены — это примерно слова: и в запросе, и в ответе. Если вы обрабатываете сотни документов в месяц — выбор модели напрямую влияет на стоимость.

Но дело не только в деньгах. Разные модели имеют разное соотношение скорость/качество/цена. Для проверки орфографии в коротком письме не нужен самый мощный Opus — Haiku справится за долю секунды и стоит в 30 раз дешевле. Для глубокого анализа сложного договора с неоднозначными формулировками — Haiku может пропустить важное, а Sonnet или Opus разберётся.

Параметр --effort — отдельный инструмент. Он управляет тем, сколько «думает» модель, прежде чем ответить. На рутинных задачах это лишние секунды и токены. На задачах с нюансами — именно то, что нужно.

Что это такое

Anthropic выпускает четыре класса моделей под брендом Claude (Haiku, Sonnet, Opus и Fable — последний для самых длинных автономных задач; в этом уроке разбираем первые три):

• Haiku — быстрый и дешёвый. Хорошо справляется с простыми задачами: выписать данные, переформатировать, проверить орфографию, ответить на прямой вопрос.
• Sonnet — баланс скорость/качество/цена. Основная рабочая лошадка для большинства задач директора.
• Opus — самый мощный. Для задач, где важна глубина анализа, нюансы, сложные рассуждения.

Аналогия: Haiku — толковый стажёр для рутины. Sonnet — опытный аналитик. Opus — внешний консультант с почасовой ставкой.

--effort управляет глубиной «размышления» модели перед ответом:
- low — быстро и поверхностно
- medium — экономит токены там, где можно немного пожертвовать глубиной
- high — умолчание на всех моделях (у Opus 4.7 умолчание — xhigh)
- xhigh и max — глубже и дороже; max — самый тщательный разбор

Как работает на практике

Выбор модели через --model

claude --model haiku -p "проверь орфографию в этом тексте" < письмо.txt

claude --model sonnet -p "проанализируй риски в этом договоре" < договор.txt

claude --model opus -p "сравни два стратегических сценария и обоснуй выбор" < сценарии.txt

Если --model не указан — используется модель по умолчанию: на Pro и Team Standard это Sonnet 5, на Max, Team Premium и Enterprise — Opus 5.

Управление effort через --effort

claude --effort low -p "переведи эти заголовки на английский" < заголовки.txt

claude --effort high -p "найди противоречия между разделами договора" < договор.txt

claude --model opus --effort high -p "дай юридическую оценку рисков" < договор.txt

Последний вариант — максимум качества и минимум скорости/экономии. Используйте для действительно важных документов.

Практическая матрица выбора

Как задать модель по умолчанию

Если вы хотите всегда использовать конкретную модель без явного указания флага — задайте её командой /model внутри сессии (выбор сохранится как умолчание) или полем model в ~/.claude/settings.json. В CLAUDE.md модель не настраивается: это файл контекста, а не конфигурации.

/model sonnet

После этого claude без флага --model будет использовать Sonnet.

Пример: экономия на массовой обработке

Допустим, нужно извлечь имя и дату из 100 стандартных актов:

for f in акты/*.txt; do
  claude --model haiku --effort low \
    -p "извлеки: имя контрагента и дату акта. Формат: КОНТРАГЕНТ: ..., ДАТА: ..." \
    < "$f" >> реестр.txt
done

Для такой задачи Haiku + low — оптимальный выбор. Задача простая и структурированная, скорость критична, качество достаточное.

Частые ошибки

Ошибка 1. Всегда использовать самую мощную модель

Opus стоит значительно дороже Haiku. Для форматирования списка или перевода заголовков это деньги на ветер. Навык выбора модели под задачу — это навык, который окупается.

Ошибка 2. Думать, что Haiku «плохой»

Haiku не плохой — он просто для другого. На простых структурированных задачах он часто неотличим от Sonnet. Попробуйте на своей конкретной задаче и сравните.

Ошибка 3. Игнорировать --effort

На задачах с нюансами (неоднозначные формулировки, скрытые риски, тонкие различия) --effort high заметно улучшает результат даже при той же модели. Это не просто «медленнее» — это другой режим обработки.

Ошибка 4. Прописать конкретную версию модели в скрипт навсегда

Модели обновляются. sonnet сегодня — это не то же самое, что будет через полгода. Поэтому в командах и скриптах указывайте псевдоним (opus, sonnet, haiku, fable) — он сам переезжает на новое поколение. Полный идентификатор нужен только там, где важна стабильность поведения, и тогда его периодически сверяют со справочником моделей на platform.claude.com.

Когда нужно / когда нет

Указывать --model явно стоит, если:
- Обрабатываете много файлов (Haiku для рутины)
- Задача критически важная (Opus для серьёзного анализа)
- Пишете скрипт, который будет работать регулярно

Можно не указывать --model, если:
- Разовый запрос средней сложности
- Нет требований к стоимости или скорости
- Ещё не знаете, какая модель подходит

Указывать --effort high стоит, если:
- Договор, где пропустить риск дорого
- Стратегический документ
- Хотите максимальную глубину анализа

--effort low подходит, если:
- Простая механическая задача
- Нужна скорость
- Обрабатываете большой объём простых файлов

Связь с другими уроками

• День 3 — headless-режим: именно там --model и --effort используются чаще всего
• День 6 — форматы вывода: комбинируйте с --output-format json для структурированных ответов от Haiku
• День 10 — итоговый скрипт: выбор модели будет частью финального рабочего инструмента

Задание на сегодня

Возьмите один и тот же текст (подойдёт тест.txt из Дня 3 или любое своё письмо) и выполните два запроса:

claude --model haiku --effort low -p "три главных вывода" < тест.txt
claude --model sonnet --effort high -p "три главных вывода" < тест.txt

Сравните ответы. Есть ли разница для вашего конкретного текста?

Критерий выполнено: выполнили оба запроса, сравнили результаты, поняли — для этой задачи достаточно Haiku или нужен Sonnet.

Резюме

• Haiku — быстрый и дешёвый, для рутинных задач; Sonnet — основной; Opus — для глубокого анализа
• --model имя-модели выбирает модель явно
• --effort low/medium/high/xhigh/max управляет глубиной «размышления» (плюс отдельный режим ultracode — это уже не уровень модели)
• Для массовой обработки простых файлов: Haiku + low = значительная экономия
• Для важных документов с рисками: Sonnet или Opus + high
• Актуальные идентификаторы моделей — всегда на platform.claude.com