Настройка outputStyle в Claude Code: руководство
Узнайте, как параметры outputStyle меняют системный промпт и формат ответов Claude Code. Разбираем работу встроенных стилей и исправление ошибки переключения в версии v2.1.251.
Что такое стиль вывода в Claude Code
Стиль вывода в Claude Code — это набор инструкций, которые Claude Code добавляет к каждому запросу, отправляемому в Claude. Он меняет способ ответа Claude: роль, которую принимает модель, и формат выводимого текста. Он не передает Claude информацию о вашей кодовой базе и не дает модели прав на выполнение каких-либо действий.
В Claude Code встроено пять стилей. Ваш выбор сохраняется в одном ключе настроек, outputStyle. В Claude Code версии v2.1.251 и выше стиль, выбранный во время сессии, применяется начиная со следующего сообщения. В версиях от v2.1.73 до v2.1.251 переключение сохранялось, но игнорировалось до выполнения команды /clear; именно этот факт объясняет большую часть путаницы, которую до сих пор можно встретить в устаревших руководствах по этой функции.
При работе через VPS это не просто косметическая настройка. Транскрипт — это то, что вы читаете через SSH-соединение, обычно в окне tmux, поэтому каждая строка, которую выводит Claude, — это строка, которую вы ждете, и строка в буфере прокрутки фиксированного размера.
Где находится настройка outputStyle
Выберите стиль в меню /config в разделе Output style. Claude Code запишет ваш выбор в .claude/settings.local.json в проекте, над которым вы работаете.
Команда /output-style выполняет ту же задачу из командной строки. Запустите /output-style concise для переключения или /output-style без аргументов, чтобы вывести список стилей и узнать текущий. Она сохраняет значение в тот же файл .claude/settings.local.json, не учитывает регистр и работает в неинтерактивном режиме. Описанная здесь команда появилась в Claude Code v2.1.269. Более старая команда /output-style существовала в v2.0.30 и была признана устаревшей в v2.1.73 в пользу /config, поэтому сборки между этими двумя релизами могут вести себя не так, как описано на этой странице. Проверьте используемую версию перед тем, как следовать любому руководству, включая это. Версии на данной странице были проверены в октябре 2026 года.
claude --versionВы также можете задать ключ вручную. Его могут содержать четыре файла настроек, при этом более узкий файл имеет приоритет над более широким.
~/.claude/settings.json— ваш пользовательский файл. Применяется во всех проектах на этой машине..claude/settings.json— файл проекта. Он фиксируется в git, поэтому применяется для всех, кто клонирует репозиторий..claude/settings.local.json— локальный файл проекта. Он не фиксируется в git и переопределяет оба вышеуказанных файла. Именно в этот файл записывают настройки меню/configи команда/output-style.- Управляемые настройки, развернутые ИТ-отделом из системного пути, например
/etc/claude-code/в Linux, переопределяют все остальное.
Значение ключа — это имя стиля:
{
"outputStyle": "Concise"
}Значение чувствительно к регистру. Пишите имена встроенных стилей как Proactive, Concise, Explanatory и Learning. Значение, которое не совпадает с именем стиля в точности, например concise, без уведомлений установит стиль Default.
Для одной сессии можно передать тот же ключ через командную строку. Флаг --settings принимает путь или встроенную JSON-строку, и его значения переопределяют соответствующие ключи в ваших пользовательских, проектных и локальных файлах настроек для данного запуска. Управляемые настройки все равно имеют приоритет:
claude --settings '{"outputStyle": "Concise"}'В документации перечислены четыре способа выбора стиля, и только два из них требуют определенной минимальной версии. Меню /config в терминале не имеет таких требований. Команда /output-style в текущем виде требует v2.1.269, а меню Output styles в расширении VS Code требует v2.1.257. В приложении Desktop вы задаете поле outputStyle в файле настроек. Сам ключ outputStyle не имеет минимальной версии, поэтому на него можно полагаться. Если скриншот в руководстве перестал соответствовать тому, что вы видите, задайте ключ напрямую и подтвердите его командой /status, которая выводит список действующих источников настроек.
Когда вступает в силу новый стиль вывода
В Claude Code версии v2.1.251 и новее стиль, выбранный в середине сессии через команду, меню или файл настроек, применяется начиная со следующего сообщения. Очистка не требуется. В версиях от v2.1.73 до v2.1.251 текущая сессия сохраняла стиль, с которым была запущена, а новый загружался только после /clear или при следующем запуске.
В терминале Claude Code считывает файлы стилей при запуске. Если вы создаете или редактируете файл пользовательского стиля во время работы сессии, перезапустите Claude Code перед его выбором. В VS Code версии v2.1.261 и новее мастер Build a custom style в меню Output styles создает файл и сразу добавляет новый стиль в список. В более старых версиях или после перезапуска для применения правок в файле стиля в терминале, эти две команды сбросят состояние и покажут, что именно было загружено:
/clear
/context/context выводит содержимое окна контекста с разбивкой по категориям, включая системный промпт. Запустите эту команду в новой сессии для каждого стиля, и строка системного промпта станет входными данными для вашего сравнения. Это также самый быстрый способ убедиться, что пользовательский стиль вообще загрузился. Подробнее о том, как заполняется окно контекста, см. в разделе как заполняется контекст в долгой сессии Claude Code.
Такое поведение обусловлено кэшированием. API обслуживает повторные запросы из кэша промптов, который сопоставляется с началом каждого запроса, а системный промпт находится в самом начале. Его перезапись в середине диалога привела бы к недействительности всего последующего содержимого, поэтому на следующем шаге вся история была бы обработана как новый ввод. В версиях от v2.1.73 до v2.1.251 этот расход ресурсов исключался фиксацией стиля при старте сессии. В текущих версиях инструкции нового стиля передаются в виде сообщения внутри диалога, поэтому запрос после переключения по-прежнему считывает системный промпт и предыдущую историю из кэша. Переключение стилей в любом случае не требует больших затрат.
Как каждый встроенный стиль вывода меняет протокол работы
- Default — это стандартный системный промпт Claude Code, предназначенный для задач по разработке ПО.
- Concise — ставит результат на первое место. Этот стиль исключает вводные фразы и пошаговое описание действий, сохраняя ответы краткими до тех пор, пока вы не запросите подробности. Техническая часть работы при этом не меняется. Стиль никогда не сокращает отчеты об ошибках или предупреждения безопасности и всегда запрашивает подтверждение перед выполнением деструктивных действий. Для работы этого стиля требуется Claude Code версии 2.1.237 или новее.
- Explanatory — добавляет образовательные «Идеи» (Insights) между этапами выполнения задачи. В них объясняется, почему было принято то или иное решение по реализации и какие шаблоны уже используются в вашей кодовой базе. Протокол работы намеренно становится длиннее.
- Learning — идет еще дальше. Claude делится этими идеями, а затем предлагает вам самостоятельно написать небольшие фрагменты кода, помечая каждое место комментарием
TODO(human)в файле. - Proactive — заставляет Claude действовать, а не спрашивать. Система делает обоснованные предположения при принятии рутинных решений, вместо того чтобы останавливаться для подтверждения.
Внимательно ознакомьтесь с последним пунктом, так как его чаще всего понимают неправильно. Proactive — это лишь указание в системном промпте. Оно меняет то, что пытается сделать Claude. Ваш режим разрешений по-прежнему определяет, что именно будет запущено без запроса подтверждения; именно этот параметр имеет значение для сервера, который вы оставляете работать без присмотра. Это описано в автоматическом режиме и режимах разрешений Claude Code.
Чем стиль вывода отличается от CLAUDE.md, хука и субагента
Все эти механизмы определяют поведение Claude, но работают на разных уровнях.
- Стиль вывода — это часть инструкций, которые Claude Code отправляет с каждым запросом. Он применяется к каждому ответу в основном диалоге.
- CLAUDE.md добавляется как сообщение пользователя после системного промпта. Здесь следует указывать соглашения проекта и факты о кодовой базе.
--append-system-promptдобавляет текст к системному промпту для одного вызова, не удаляя ничего из него. Это разовая версия стиля вывода.- Хук — это shell-команда, которую Claude Code выполняет самостоятельно при наступлении события. Она принудительно исполняется окружением, поэтому сработает независимо от того, выбрал бы Claude это действие или нет. См. что может и чего не может хук Claude Code.
- Субагент работает со своим собственным системным промптом и набором инструментов.
Короткий тест поможет выбрать между первыми двумя вариантами. Факты о вашем проекте размещайте в CLAUDE.md, так как Claude должен их знать. Формулировки указывайте в стиле вывода, так как они определяют то, как читается ответ. Всё, что должно происходить каждый раз, независимо от решения модели, оформляйте как хук. Уровень, на котором находится каждый из этих механизмов, является свойством программы, запускающей модель, а не самой модели. Именно поэтому стиль может только влиять на результат, тогда как хук может его принудительно задавать.
Стили вывода применяются только к основному диалогу. Субагент не наследует ваш стиль, так как он начинает собственный диалог со своим системным промптом. Исключением является ветвление (fork) текущего диалога, поскольку ветка в точности наследует системный промпт родителя. Если субагент пишет в манере, которая вам не нравится, отредактируйте файл этого агента, а не свой стиль. Второй сеанс Claude Code на той же машине соблюдает те же границы, считывая файлы настроек при запуске. Поэтому, когда вы передаете работу другому сеансу, запущенному параллельно, его ответы будут приходить в том стиле, который загрузил этот сеанс, а не ваш.
Как создать собственный стиль вывода
Пользовательский стиль вывода — это файл в формате markdown с frontmatter. Сохраните его в домашней директории, чтобы использовать во всех проектах, или внутри репозитория, чтобы хранить его вместе с кодом. Директория пользователя — ~/.claude/output-styles/, а директория проекта — .claude/output-styles/.
mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---
Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.
Do not narrate what you are about to do. Report what you did.
When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOFЗапустите сессию и откройте /config. Ваш стиль появится в списке Output style с описанием, которое вы указали. Если стиль отсутствует, значит, файл не считывается: проверьте путь и перезапустите Claude Code, если сессия была активна в момент сохранения файла. Если стиль отображается под именем файла без описания, значит, frontmatter не был распознан, и claude --debug покажет ошибку парсинга. Имя файла становится именем стиля, если в frontmatter не задано name, поэтому данный стиль называется Terse ops, а не terse-ops.
Выберите его или установите ключ с этим точным именем, соблюдая регистр:
{
"outputStyle": "Terse ops"
}Одно поле определяет, является ли ваш файл дополнением или заменой. keep-coding-instructions по умолчанию имеет значение false, что означает, что пользовательский стиль отменяет встроенные инструкции Claude Code по разработке ПО и работает только с вашим текстом. Эти встроенные инструкции определяют, как Claude оценивает масштаб изменений и проверяет свою работу. Не используйте это поле для ассистента по написанию текстов или аналитика данных, где эти инструкции не требуются. Установите значение true для любых задач, связанных с кодом, иначе вы заметите, что внимательный инженер перестал проверять результаты своей работы. Только полный системный промпт Claude Code содержит этот раздел, поэтому в сокращенном системном промпте поле не оказывает эффекта. Установка переменной окружения CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT в значение 0 активирует полный промпт для любой модели. Если ваша цель — не изменить стиль общения, а более строго ограничить объем работы для задачи, это относится к инженерным инструкциям, а не к файлу стиля: навык Ponytail является примером такой реализации — это единое правило, которое побуждает агента выполнять минимально необходимые изменения.
description — это строка, которую селектор /config отображает рядом с именем. Напишите её так, чтобы через полгода вы могли легко выбрать нужный стиль из двух похожих.
Почему лаконичный стиль предпочтительнее при работе по SSH
На VPS вы просматриваете вывод через уровни абстракции, которых нет в локальном терминале, и каждый такой уровень требует экономии на многословности.
Первый уровень — буфер прокрутки. В tmux каждая панель хранит фиксированное количество строк, задаваемое параметром history-limit, значение по умолчанию для которого равно 2000. Повествовательный стиль заполняет этот буфер быстрее, поэтому начало сессии вытесняется раньше, и нужный вам вывод пропадает. Увеличьте это значение, если требуется больше места:
echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.confПанели, созданные после изменения, будут хранить по 20000 строк каждая, что увеличит потребление памяти на панель. В tmux версии 3.7 и выше изменение history-limit применяется и к уже открытым панелям; в более старых версиях оно действует только на новые. Если вы еще настраиваете структуру сессии, в разделе запуск Claude Code внутри tmux на VPS описаны подробности.
Второй уровень — задержка. Ответ передается в терминал по мере генерации. При высоком времени кругового обхода сети (RTT) длинное вступление заставляет вас ждать, пока текст отобразится, прежде чем появится сам ответ.
Третий уровень — выходные токены. Каждая строка с пояснениями оплачивается как выходной контент. Режимы Explanatory и Learning по своей сути более объемные. Режим Concise спроектирован как более короткий, так как он дает указание Claude по умолчанию сокращать ответы.
Не доверяйте процентным показателям, включая данные на этой странице. Размер разницы зависит от ваших запросов, используемой модели и характера задач, поэтому измеряйте показатели до и после самостоятельно. Выполните одну и ту же реальную задачу в двух новых сессиях: одну в режиме Default, другую в режиме Concise, а затем сравните результаты. Строка состояния — самый простой инструмент измерения, так как Claude Code передает вашему скрипту объект JSON через stdin, который уже содержит название стиля, количество выходных токенов последнего ответа и текущую оценку стоимости сессии:
cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.shУкажите на него в настройке statusLine:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}Теперь в нижней части сессии отображается активный стиль, размер последнего ответа и оценочная стоимость сессии на текущий момент. Параметр out учитывает только последний ответ, поэтому он показывает количество токенов в последнем сообщении. Параметр cost суммирует значения, поэтому итоговая цифра в конце каждого запуска — это ваш показатель «до и после». Прочитайте его перед очисткой, так как стоимость сбрасывается до $0 при запуске новой сессии командой /clear, и воспринимайте это как оценку, а не как счет к оплате. Скрипту требуется jq, парсер JSON для командной строки, поэтому сначала установите его с помощью sudo apt install -y jq. Если строка состояния остается пустой, запустите скрипт вручную и передайте в него JSON через конвейер, так как строка состояния, завершающаяся с ненулевым кодом, ничего не выводит и не сообщает. В разделе пользовательская строка состояния Claude Code перечислены остальные поля этого объекта. Что касается биллинга, а не параметров сессии, ознакомьтесь с материалами куда на самом деле уходят токены Claude Code и инструменты для отслеживания расходов Claude Code.
Как проверить, какой стиль вывода загружен на самом деле
Используйте эти проверки вместо предположений.
/statusвыводит список источников настроек, действующих в текущей сессии, включая информацию о том, применяются ли управляемые настройки организации./contextпоказывает загруженный системный промпт как категорию в разбивке окна контекста.claude doctor, запущенная из оболочки без открытия сессии, выводит диагностику установки и настроек, а также сообщает о невалидных файлах настроек.
Если стиль не применяется, причина почти всегда одна из двух. Первая — время: в версиях от v2.1.73 до v2.1.251 переключение в середине сессии ожидает /clear, а в терминале файл стиля, созданный или отредактированный во время сессии, ожидает перезапуска. Вторая — приоритет: .claude/settings.local.json переопределяет .claude/settings.json, а оба они переопределяют ~/.claude/settings.json. Поскольку выбор в /config и команда /output-style записывают данные в локальный файл, стиль, который ваша команда зафиксировала в .claude/settings.json, будет незаметно переопределен на любой машине, где кто-то воспользовался одним из этих способов. /status показывает, какие файлы были загружены, но не указывает, какой из них предоставил ключ, поэтому откройте каждый файл из списка и найдите outputStyle.
Синтаксическая ошибка JSON дает тот же симптом, но требует иного исправления. claude doctor называет файл, который не удалось проанализировать; стоит запустить эту команду, прежде чем искать более сложные причины. Значение с неверным регистром, например explanatory, является валидным JSON, но все равно приводит к использованию стиля Default, поэтому проверяйте и заглавные буквы.
FAQ
Почему команда /output-style перестала работать?
В текущей версии она работает. /output-style выводит список стилей, а /output-style concise переключает на выбранный. В истории команды есть пробел: в v2.1.73 она была признана устаревшей в пользу /config, а в v2.1.269 была добавлена текущая форма /output-style [name], поэтому в версиях между ними она может работать не так, как описано здесь. Запустите claude --version, чтобы увидеть, что у вас есть. В любой версии можно выбрать стиль в /config под Output style или задать ключ outputStyle в файле настроек. В документации для этого ключа не указана минимальная версия, поэтому прямая установка ключа — это инструкция, которую стоит записать в свои заметки.
Я изменил стиль вывода, но ничего не произошло. Почему?
Сначала проверьте версию. В Claude Code v2.1.251 и новее стиль, выбранный в середине сессии, применяется со следующего сообщения. В версиях от v2.1.73 до v2.1.251 изменение сохранялось, но применялось только после /clear или начала новой сессии. В терминале файл пользовательского стиля, созданный или отредактированный во время сессии, требует перезапуска, так как Claude Code считывает файлы стилей при старте. Если стиль все еще не применяется, убедитесь, что значение в точности совпадает с именем стиля, включая заглавные буквы, затем запустите /status, чтобы увидеть, какие файлы настроек были загружены, так как .claude/settings.local.json переопределяет .claude/settings.json, а оба они переопределяют ~/.claude/settings.json.
Экономит ли деньги стиль вывода Concise?
Он сокращает количество выходных токенов, как и ожидается, поскольку предписывает Claude по умолчанию давать краткие ответы. Насколько именно — зависит от ваших промптов и модели, поэтому любые опубликованные проценты считайте лишь оценкой чужой работы. Измерьте свои показатели: запустите /context в новой сессии для каждого стиля, чтобы оценить входные данные, затем выполните одну и ту же задачу в каждом из них и сравните количество выходных токенов и расчетную стоимость. Concise никогда не сокращает отчеты об ошибках или предупреждения безопасности, поэтому части, которые вам важнее всего прочитать, остаются в полном объеме.
Изменит ли стиль вывода то, как пишут мои субагенты?
Нет. Стили вывода применяются только к основному диалогу, так как субагент начинает свой собственный диалог со своим системным промптом и своим набором инструментов. Исключением является форк текущего диалога, так как форк в точности наследует системный промпт родителя. Чтобы изменить способ ответа субагента, отредактируйте файл самого агента.
Может ли стиль вывода позволить Claude выполнять команды без запроса?
Нет. Стиль вывода — это текст в системном промпте, поэтому он может влиять только на то, что Claude пытается сделать. Стиль Proactive заставляет Claude делать предположения и действовать, а не останавливаться для принятия рутинных решений, но он все равно не может утвердить команду. Ваш режим разрешений определяет, что выполняется без запроса, и именно эту настройку следует проверить, прежде чем оставлять сессию запущенной на сервере.