Output styles

Адаптируйте Claude Code для использования за пределами разработки программного обеспечения

Output styles изменяют способ ответа Claude, а не то, что Claude знает. Они устанавливают роль Claude, тон и формат вывода для каждого ответа. Используйте один из них, когда вы постоянно переформулируете запросы для одного и того же голоса или формата на каждом ходу, или когда вы хотите, чтобы Claude действовал как что-то другое, чем инженер-программист.

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

Для инструкций о вашем проекте, соглашениях или кодовой базе используйте CLAUDE.md вместо этого.

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

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

Существует четыре дополнительных встроенных output style:

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

• Concise: Claude начинает с результата, пропускает преамбулу и повествование, и по умолчанию держит ответы краткими, при этом выполняя инженерную работу так же тщательно, как в стиле Default. Когда вы просите объяснение или больше деталей, Claude отвечает полностью. Claude всегда сохраняет полное содержание отчётов об ошибках, предупреждений безопасности и подтверждений деструктивных действий. Требует Claude Code v2.1.237 или позже.

• Explanatory: предоставляет образовательные "Insights" между помощью в выполнении задач разработки программного обеспечения. Помогает вам понять выбор реализации и паттерны кодовой базы.

• Learning: совместный режим обучения на практике, в котором Claude не только будет делиться "Insights" во время кодирования, но также попросит вас внести небольшие, стратегические фрагменты кода самостоятельно. Claude Code добавит маркеры TODO(human) в ваш код для реализации.

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

Выберите стиль одним из следующих способов:

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

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

• Terminal: запустите /config и выберите Output style, чтобы выбрать стиль из меню. Claude Code сохраняет ваш выбор в .claude/settings.local.json на локальном уровне проекта.

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

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

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

{
  "outputStyle": "Explanatory"
}

Когда вы переключаете стили в середине сеанса, 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 поддерживают эти поля frontmatter:

Как работают output styles

Output style изменяет инструкции, которые Claude Code отправляет Claude.

• Claude Code отправляет инструкции активного стиля с каждым запросом.
• Когда вы выбираете стиль, отличный от Default, Claude Code также напоминает Claude о стиле во время разговора.
• Пользовательские output styles исключают встроенные инструкции Claude Code по разработке программного обеспечения, такие как определение области изменений, написание комментариев и проверка работы, если только keep-coding-instructions не установлен в true.

Output styles применяются к основному разговору и к fork, который наследует полный разговор и системный prompt родителя. Другие subagents запускают свой собственный системный prompt, поэтому стили не изменяют способ их ответов.

Использование токенов зависит от стиля. Инструкции стиля добавляют входные токены, хотя prompt caching снижает эту стоимость после первого запроса в сеансе.

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

Сравнения со связанными функциями

Несколько функций настраивают поведение Claude Code. Output styles изменяют системный prompt Claude Code по умолчанию и применяются к каждому ответу. Остальные добавляют инструкции без изменения значений по умолчанию или ограничивают их конкретной задачей.

Связанные ресурсы

• Settings: где находится поле outputStyle и как работает приоритет настроек
• Permission modes: как стиль Proactive сравнивается с режимом автоматизации
• Plugins: упакуйте и распространяйте output styles вместе с skills, hooks и agents
• Debug your configuration: диагностируйте, почему output style не вступает в силу