Output styles

Измените роль, тон и формат ответов Claude Code с помощью встроенного стиля вывода, такого как Concise или Explanatory, или напишите собственный стиль.

Output style — это набор инструкций, которые устанавливают роль Claude, тон и формат ответов для каждого ответа в сеансе. Claude Code включает четыре встроенных стиля помимо стиля по умолчанию, и вы можете написать свой собственный.

Используйте output style, чтобы изменить способ ответа Claude и работы с вами на протяжении всего сеанса, чтобы вам не нужно было повторять запрос в каждом приглашении. Например, встроенный стиль может сделать ответы короче, добавить объяснение каждого изменения или заставить Claude начать работу без задания рутинных вопросов. Пользовательский стиль также может превратить Claude в что-то другое, чем инженер-программист, например в помощника по написанию текстов или аналитика данных.

• Чтобы использовать встроенный стиль, выберите один из встроенных output styles и переключитесь на него.
• Чтобы написать свои собственные инструкции, создайте пользовательский output style.

Встроенные output styles

Claude Code начинает работу в стиле Default, его стандартном наборе инструкций для выполнения задач разработки программного обеспечения. Каждый из четырёх других встроенных стилей сохраняет эти инструкции и добавляет свои собственные.

В этой таблице показано, что изменяет каждый стиль в сеансе и когда его использовать:

Default

Default означает, что не выбран никакой output style. Claude Code не добавляет инструкции стиля, и Claude работает из стандартного системного приглашения Claude Code, которое написано для задач разработки программного обеспечения.

default появляется в списке /output-style вместе с другими стилями, поэтому вы выбираете его так же.

Proactive

В стиле Proactive Claude начинает реализацию сразу же после отправки задачи. Он делает разумные предположения о рутинных решениях вместо того, чтобы останавливаться и спрашивать, и не переходит в режим плана, если вы не попросите план. Вы можете перенаправить его в любой момент.

Инструкции стиля также говорят Claude проверить с вами в разговоре перед действием, которое удаляет данные или изменяет общую или производственную систему. Эта проверка — это инструкция, которую Claude следует, и она отделена от запросов разрешения.

Переключение на стиль Proactive не изменяет ваш режим разрешений. Ваш режим разрешений по-прежнему решает, какие вызовы инструментов выполняются без запроса, поэтому запросы разрешения появляются так же, как они появлялись до переключения.

Concise

В стиле Concise первое предложение ответа указывает, что произошло или какой ответ. Claude опускает вводную часть, пошаговое повествование и закрывающее резюме, и отвечает на простой вопрос в одно-три предложения. Он выполняет инженерную работу так же тщательно, как в стиле Default. Требует Claude Code v2.1.237 или позже.

Claude по-прежнему пишет в полном объёме в этих случаях:

• Всё, что вы просите: когда вы просите объяснение или больше деталей, Claude отвечает в полном объёме.
• Всё, что вам нужно для безопасного действия: отчёты об ошибках, вывод неудачных тестов, предупреждения безопасности и подтверждения деструктивных действий сохраняют своё полное содержание.

Explanatory

В стиле Explanatory Claude выполняет задачу так же, как в стиле Default, и добавляет краткие объяснения того, почему он сделал выбор, который он сделал. Каждое объяснение появляется в разговоре, до или после кода, к которому оно относится, в блоке с меткой Insight. Объяснения не записываются в ваши файлы как комментарии.

Блок Insight содержит две или три точки о вашей кодовой базе или коде, который написал Claude, например, этот после добавления конечной точки API:

★ Insight ─────────────────────────────────────
- Каждый маршрут в этом репозитории проходит через обёртку withAuth, поэтому новая конечная точка получает проверки сеанса без собственного промежуточного ПО.
- Ограничения скорости устанавливаются для каждого маршрута в limits.ts, поэтому это изменение добавляет запись там, а не глобальное значение по умолчанию.
─────────────────────────────────────────────────

Learning

В стиле Learning Claude добавляет те же блоки Insight, что и стиль Explanatory, и также просит вас написать часть кода. Claude сам обрабатывает рутинную реализацию. Когда он достигает фрагмента с реальным решением проектирования, такого как обработка ошибок, структура данных или бизнес-логика с более чем одним допустимым подходом, он оставляет несколько строк для вас.

Claude отмечает место комментарием TODO(human) в файле, а затем отправляет запрос, который говорит, что уже построено, что написать и что учесть:

● Learn by Doing

Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

Claude затем останавливается и ждёт. Напишите свой код в комментарии TODO(human) и скажите Claude, когда вы закончите. Claude отвечает с одним Insight о вашем коде и продолжает задачу.

Измените ваш output style

Выберите стиль с помощью команды, меню или файла настроек. Команда и оба меню сохраняют ваш выбор в .claude/settings.local.json на локальном уровне проекта.

• /output-style command: запустите /output-style <style> для переключения, например /output-style concise. Без аргумента команда выводит список доступных стилей и отмечает текущий.

  Команда также работает в неинтерактивном режиме и сеансах Agent SDK, а также из мобильного приложения или веб-версии через Remote Control, где вы можете просмотреть и выбрать только встроенные стили. Требуется Claude Code версии 2.1.269 или позже.

• Terminal menu: запустите /config и выберите Output style, чтобы выбрать стиль из меню.

• VS Code extension: откройте меню команд с помощью / и выберите Output styles, чтобы выбрать стиль, включая ваши пользовательские стили. Требуется Claude Code версии 2.1.257 или позже.

• Desktop app: установите поле outputStyle в файле настроек, например .claude/settings.local.json, файл, в который пишет меню терминала. Когда вы запустите /config там, Claude Code открывает Settings > Claude Code вместо меню.

Чтобы установить стиль без меню, отредактируйте поле outputStyle непосредственно в файле настроек:

{
  "outputStyle": "Explanatory"
}

Значение чувствительно к регистру, поэтому пишите встроенные имена как Proactive, Concise, Explanatory и Learning. Значение, которое не совпадает точно с именем стиля, например explanatory, дает вам стиль Default. Команда /output-style игнорирует регистр.

Чтобы сделать стиль своим стилем по умолчанию во всех проектах, установите outputStyle в ~/.claude/settings.json. Собственные файлы настроек проекта имеют приоритет над этим значением.

Когда вы переключаете стили в середине сеанса, Claude использует новый стиль, начиная со следующего сообщения. Информацию о том, что стоит первое сообщение в prompt caching, см. в разделе Изменение output style. До версии 2.1.251 новый стиль применялся только после того, как вы запустили /clear или начали новый сеанс.

Создайте пользовательский output style

Пользовательский output style — это файл Markdown: frontmatter для метаданных, затем инструкции для Claude.

В расширении VS Code вы также можете создать файл из меню Output styles вместо того, чтобы писать его вручную. Это требует Claude Code версии 2.1.261 или позже.

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.

Plugins также могут поставляться с output styles в каталоге output-styles/.

Справочник Frontmatter

Настройте output style с помощью YAML frontmatter между маркерами --- в начале файла. Все поля являются необязательными, и имена полей используют строчные слова, разделенные дефисами. Неправильно написанное поле игнорируется без ошибки. Если YAML не анализируется, стиль все равно загружается под своим именем файла без установленных полей; запустите claude --debug, чтобы увидеть ошибку анализа.