Output styles

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

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

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

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

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

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

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

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

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

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

Output styles напрямую изменяют системный prompt Claude Code.

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

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

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

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

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

{
  "outputStyle": "Explanatory"
}

Поскольку output style устанавливается в системный prompt при запуске сеанса, изменения вступают в силу при следующем запуске нового сеанса. Это сохраняет стабильность системного prompt на протяжении всего разговора, чтобы prompt caching мог снизить задержку и стоимость.

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

Пользовательские output styles — это файлы Markdown с frontmatter и текстом, который будет добавлен в системный prompt:

---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]

Вы можете сохранять эти файлы на трех уровнях:

• Пользователь: ~/.claude/output-styles
• Проект: .claude/output-styles
• Управляемая политика: .claude/output-styles внутри управляемого каталога настроек

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

Frontmatter

Файлы output style поддерживают frontmatter для указания метаданных:

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

Output Styles vs. CLAUDE.md vs. --append-system-prompt

Выбирайте в зависимости от того, должен ли Claude перестать действовать как помощник по кодированию или сохранить свою роль по умолчанию и узнать больше. Output styles заменяют части системного prompt Claude Code, связанные с разработкой программного обеспечения, на вашу собственную роль и голос, поэтому используйте их, когда Claude должен принять другую личность, например редактора текстов или помощника по анализу данных. CLAUDE.md и --append-system-prompt оба сохраняют идентичность Claude Code по умолчанию и добавляют к ней, поэтому используйте их, когда Claude должен оставаться помощником по кодированию, который также следует соглашениям вашего проекта или дополнительным инструкциям.

Механизмы также отличаются. Output styles редактируют системный prompt напрямую. CLAUDE.md добавляет его содержимое как пользовательское сообщение после системного prompt. --append-system-prompt добавляет содержимое в конец системного prompt без удаления чего-либо.

Output Styles vs. Agents

Используйте output style для изменения того, как основной разговор реагирует в каждой сессии. Используйте subagent, когда вам нужен отдельно ограниченный помощник, которому основной разговор делегирует задачи. Output styles влияют только на системный prompt основного цикла агента. Agents обрабатывают конкретные задачи и могут иметь свою собственную модель, инструменты и контекст о том, когда их вызывать.

Output Styles vs. Skills

Output styles изменяют способ ответа Claude (форматирование, тон, структура) и всегда активны после выбора. Skills — это специфичные для задач prompts, которые вы вызываете с помощью /skill-name или которые Claude загружает автоматически при необходимости. Используйте output styles для согласованных предпочтений форматирования; используйте skills для повторно используемых рабочих процессов и задач.