Рекомендации разработчика · Claude Opus 5
Запросы к Claude Opus 5: что убрать и что добавить
Пересказ на русском. Оригинал: «Prompting Claude Opus 5» ↗ — Anthropic, на английском.
Для тех, кто подключает Claude Opus 5 через API и пишет системный запрос — постоянную инструкцию с ролью и правилами: что убрать и что задать прямо.
Коротко
- Запросы под Opus 4.8 работают без переделки; давайте всю задачу сразу.
- Уберите «перепроверь себя»: модель проверяет себя сама.
- Длину ответа задавайте отдельно, не через
effort. - Границы задачи и правило делегирования подагентам пишите прямо.
- Мышление не выключайте — снижайте
effort.
Уровень усилия
effort задаёт, сколько модель думает перед ответом; low и medium дают сильное качество за малую долю токенов и времени.
- Начните с
high— уровня по умолчанию. - Спускайтесь до
mediumиlowвезде, где качество на ваших проверках держится — это главный рычаг цены и скорости; значения с прежней модели перепроверьте. - Для трудного кода и агентной работы — модель сама работает с файлами и инструментами — поднимайтесь до
xhigh.
Длина и отчёты
Ответы Opus 5 длиннее прежних; снижение effort их надёжно не укорачивает.
- Краткость: задайте отдельной инструкцией, а в длинном системном запросе повторите напоминанием ближе к концу.
- Ритм сообщений: в агентной работе модель объявляет каждый шаг; опишите, когда писать и с чего начинать итог. Хотите больше отчётов — дайте примеры, они работают лучше запретов.
- Файлы: отчёты и сводки на диске тоже длиннее; задайте им объём отдельно.
ВместоОтвечай кратко.
ЛучшеВ чате поддержки: фраза о причине сбоя, потом шаги списком; историю вопроса не пересказывай.
ПримерПока переносишь тесты, не отчитывайся о каждом файле. Напиши, когда закончишь или упрёшься в ошибку, начав с числа прошедших.
Проверки, границы, подагенты
Opus 5 проверяет себя сама, зато расширяет задачу и охотно раздаёт её подагентам — отдельным экземплярам модели, которым поручает часть работы.
- Уберите: «добавь финальную проверку», «перепроверь ответ», «проверь через подагента» и обвязки с отдельным шагом проверки: она удваивается, токены уходят впустую.
- Проверка кода: «сообщай только серьёзное» модель выполнит буквально и найдёт меньше; просите всё, отсеивайте потом.
- Границы: скажите прямо, где остановиться.
- Подагенты: задайте правило, когда делегировать: большие независимые куски окупаются, мелкие умножают цену и время. Лимиты в Claude Code и Claude Agent SDK (от 2.1.217) — переменные
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH,CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTSи параметрmax_budget_usd.
ВместоИсправь падающий тест и перепроверь результат.
ЛучшеИсправь падающий тест в модуле отчётов. Соседние тесты и рефакторинг не трогай; ошибку рядом только назови в итоге.
Выключенное мышление
Мышление включено по умолчанию; выключается только при effort не выше high.
- Снижайте
effortвместо выключения: по замерам Anthropic, на большинстве задач мышление наlowлучше выключенного при похожей цене. - Без мышления вызов инструмента иногда уходит в текст ответа: не выполняется, остаётся в истории и портит следующие ходы; просачиваются служебные теги вроде
<thinking>, а правило «не думай» в системном запросе усиливает утечку. - Если выключать всё же нужно, помогает инструкция: разрешить фразу перед вызовом инструмента, велеть признаться, если подходящего нет, и запретить служебные теги, не называя их.
Источник: Prompting Claude Opus 5 (Anthropic). Пересказ ИИтак.