Бывает ощущение, что вы каждый раз просите об одном и том же: «отвечай короче», «объясняй, почему выбрал такой подход», «не рассказывай, что собираешься делать, — просто сделай». Повторять это в каждом сообщении утомительно, а через несколько десятков реплик просьба и вовсе теряется в контексте.
Output styles решают эту задачу на другом уровне. Они меняют не отдельный ответ, а системный промпт — то есть базовую роль, тон и формат, с которыми Claude работает всю сессию. Один раз выбрали стиль — и агент отвечает нужным образом без напоминаний.
После урока вы будете знать встроенные стили, понимать, чем они отличаются по влиянию на работу, уметь переключать стиль актуальным способом и при необходимости создавать собственный.
Что уже умеем / что добавим
Вы освоили механику работы: запуск, исследование кода, режимы разрешений, откат, команды и горячие клавиши. Всё это про то, что агент делает. Последняя тема главы — про то, как он с вами разговаривает, и это тоже настраивается.
Что вы узнаете в рамках статьи
- Что такое output style и на каком уровне он работает
- Какие стили встроены и для каких задач подходит каждый
- Как переключить стиль актуальным способом и почему старая команда не работает
- Как создать собственный стиль и что означает ключ
keep-coding-instructions - Чем стиль отличается от разовой просьбы в запросе
Ключевые термины
- Output style — набор инструкций, добавляемых в системный промпт и задающих роль, тон и формат ответов.
- Системный промпт — базовые инструкции модели, читаемые один раз при старте сессии.
- Встроенные стили — пять готовых стилей, поставляемых с Claude Code: Default, Proactive, Concise, Explanatory, Learning.
- Пользовательский стиль — Markdown-файл с фронтматтером и инструкциями, добавляемыми в системный промпт.
keep-coding-instructions— поле фронтматтера, определяющее, сохранять ли встроенные инженерные инструкции Claude Code.
Что меняет output style, а что нет
Формулировка из документации точная: output styles меняют то, как Claude отвечает, а не то, что он знает. Они модифицируют системный промпт, задавая роль, тон и формат вывода.
Отсюда область применения. Стиль уместен, когда вы раз за разом переспрашиваете одно и то же про форму ответа, либо когда Claude должен выступать не в роли инженера — скажем, помощником в написании текстов или аналитиком данных.
Стиль не место для инструкций о вашем проекте, соглашениях команды и устройстве кодовой базы — для этого есть отдельный механизм, с которым мы познакомимся позже в курсе.
Важная техническая деталь: системный промпт читается один раз при старте сессии. Поэтому смена стиля вступает в силу после /clear или в новой сессии, а не мгновенно.
Пять встроенных стилей
Default — обычный системный промпт Claude Code, рассчитанный на эффективное решение инженерных задач. Стиль по умолчанию.
Proactive — Claude действует сразу, делает разумные предположения вместо пауз на рутинные уточнения и предпочитает действие планированию. Здесь важно понимать разницу с режимами разрешений: Proactive — это указание модели быть решительнее, а не разрешение делать больше. Что именно выполнится без вопроса, по-прежнему определяет режим разрешений.
Concise — Claude начинает с результата, пропускает вступления и не пересказывает свои действия, сохраняя при этом обычную тщательность инженерной работы. Если вы попросите объяснить подробнее, ответ будет полным. Содержимое отчётов об ошибках, предупреждений о безопасности и подтверждений разрушительных действий сохраняется целиком.
Explanatory — по ходу работы Claude добавляет образовательные вставки «Insights», объясняя выбор решений и особенности кодовой базы. Хорош, когда вы разбираетесь в новом проекте или незнакомой технологии.
Learning — режим обучения через практику: Claude не только делится наблюдениями, но и просит вас написать небольшие фрагменты кода самостоятельно, оставляя в коде маркеры TODO(human).
Стиль влияет и на расход токенов. Explanatory и Learning по замыслу дают более длинные ответы, Concise — наоборот, короткие. Любые инструкции в системном промпте увеличивают объём входных токенов, хотя кеширование промпта снижает эту стоимость после первого обращения.
Как переключить стиль
Здесь важно не выучить устаревшее. Отдельная команда /output-style объявлена устаревшей в версии 2.1.73 и удалена в 2.1.91. Если вы встретите её в старой статье или в ответе модели — это неактуальная информация.
Актуальных способов три.
В терминале — команда /config, раздел Output style, выбор стиля из меню. Выбор сохраняется в .claude/settings.local.json на локальном уровне проекта.
В расширении VS Code — меню команд по /, пункт Output styles; запись идёт в тот же файл.
Прямо в настройках — поле outputStyle в файле настроек:
{
"outputStyle": "Explanatory"
}
Этот способ универсален и работает везде, включая десктопное приложение, где /config открывает системные настройки, а не меню выбора.
Напомним про отложенное применение: после смены стиля выполните /clear или начните новую сессию.
Собственный стиль
Пользовательский стиль — это Markdown-файл: фронтматтер с метаданными, затем инструкции, добавляемые в системный промпт.
Файл кладётся на одном из трёх уровней:
- пользовательский —
~/.claude/output-styles; - проектный —
.claude/output-styles; - уровень управляемой политики организации.
Имя файла становится именем стиля, если в фронтматтере не задано поле name.
Ключевое решение при создании — оставлять ли встроенные инженерные инструкции Claude Code. За это отвечает поле keep-coding-instructions, по умолчанию false. Логика простая: если Claude продолжает писать код, а вы меняете только манеру общения, ставьте true. Если Claude выступает в роли, не связанной с разработкой, оставляйте значение по умолчанию.
Пример стиля, который сохраняет инженерное поведение и добавляет требование к форме ответа:
---
name: Diagrams first
description: Начинать каждое объяснение с диаграммы
keep-coding-instructions: true
---
Объясняя код, архитектуру или поток данных, начинайте с диаграммы
Mermaid, показывающей структуру, и только затем переходите к тексту.
## Соглашения по диаграммам
Используйте `flowchart TD` для потока управления и `sequenceDiagram`
для маршрутов запросов. Держите диаграммы в пределах 15 узлов.
После создания файла выберите стиль через /config или укажите его имя в поле outputStyle.
Ещё одна деталь, полезная для понимания: стиль действует на основной диалог. Подагенты работают с собственным системным промптом, и стиль на их ответы не влияет — к подагентам мы вернёмся в отдельной главе.
Частые ошибки
- Использовать команду
/output-style. Она удалена в версии 2.1.91. Актуальные способы: меню/configили полеoutputStyleв файле настроек. - Ждать, что стиль применится мгновенно. Системный промпт читается при старте сессии, поэтому изменение вступает в силу после
/clearили в новой сессии. - Складывать в стиль знания о проекте. Стиль задаёт роль и форму ответа. Соглашения команды и устройство кодовой базы описываются другим механизмом, который мы разберём позже.
- Забывать про
keep-coding-instructions. По умолчанию поле равноfalse, и пользовательский стиль отбрасывает встроенные инженерные инструкции. Если Claude должен продолжать писать код как раньше, поставьтеtrue.
Наиболее частые вопросы
- Чем стиль отличается от просьбы «отвечай короче» в запросе? — Просьба относится к текущему разговору и может потеряться при сжатии контекста. Стиль встроен в системный промпт и действует всю сессию.
- Влияет ли Proactive на то, что агенту разрешено делать? — Нет. Это указание модели действовать решительнее; что выполняется без подтверждения, по-прежнему определяет режим разрешений.
- Где хранится выбранный стиль? — Выбор из меню
/configзаписывается в.claude/settings.local.jsonна локальном уровне проекта; можно задать полеoutputStyleи в других файлах настроек. - Можно ли поделиться стилем с командой? — Да, положите файл стиля в
.claude/output-stylesпроекта, и он станет доступен всем, кто работает в этом репозитории. - Сильно ли стиль увеличивает расход? — Инструкции в системном промпте добавляют входные токены, но кеширование снижает эту стоимость. Заметнее влияние на выходные токены: Explanatory и Learning отвечают длиннее, Concise — короче.
Итоги
Поздравляем — вы завершили главу «Основы работы». За семь уроков вы прошли путь от первой пустой строки ввода до настроенной под себя среды: научились запускать сессии и ставить задачи, исследовать кодовую базу, выбирать режим разрешений под уровень риска, понимать модель доверия и защищаться от prompt injection, откатывать изменения и знать границы отката, пользоваться командами и горячими клавишами, а теперь ещё и настраивать манеру ответов агента. Это уже уверенное владение инструментом, а не первое знакомство.
Дальше начинается работа с тем, что определяет качество результата сильнее всего, — с контекстом. В следующей главе разберём, как устроено контекстное окно, что в него попадает, почему оно переполняется и как управлять им осознанно, чтобы агент не терял нить в длинных задачах.