Output styles
Адаптируйте Claude Code для использования за пределами разработки программного обеспечения
Output styles изменяют способ ответа Claude, а не то, что Claude знает. Они изменяют системный prompt для установки роли, тона и формата вывода, сохраняя при этом основные возможности, такие как запуск скриптов, чтение и запись файлов, а также отслеживание TODO. Используйте один из них, когда вы постоянно переформулируете запросы для одного и того же голоса или формата на каждом ходу, или когда вы хотите, чтобы Claude действовал как что-то другое, чем инженер-программист.
Для инструкций о вашем проекте, соглашениях или кодовой базе используйте CLAUDE.md вместо этого.
Встроенные output styles
Default output style Claude Code — это существующий системный prompt, разработанный для эффективного выполнения задач разработки программного обеспечения.
Существует два дополнительных встроенных output style, сосредоточенных на обучении вас кодовой базе и тому, как работает 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 для указания метаданных:
| Frontmatter | Назначение | По умолчанию |
|---|---|---|
name |
Имя output style, если не имя файла | Наследуется из имени файла |
description |
Описание output style, отображаемое в средстве выбора /config |
Нет |
keep-coding-instructions |
Сохранять ли части системного prompt Claude Code, связанные с кодированием. | false |
force-for-plugin |
Только для output styles плагинов: применять этот стиль автоматически всякий раз, когда плагин включен, без необходимости выбора пользователем. Переопределяет параметр outputStyle пользователя. Если несколько включенных плагинов установят это, первый загруженный выигрывает. |
false |
Сравнения со связанными функциями
Output Styles vs. CLAUDE.md vs. --append-system-prompt
Output styles полностью "отключают" части системного prompt Claude Code, специфичные для разработки программного обеспечения. Ни CLAUDE.md, ни --append-system-prompt не редактируют системный prompt Claude Code по умолчанию. CLAUDE.md добавляет содержимое как пользовательское сообщение после системного prompt Claude Code по умолчанию. --append-system-prompt добавляет содержимое в системный prompt.
Output Styles vs. Agents
Output styles напрямую влияют на основной цикл агента и влияют только на системный prompt. Agents вызываются для обработки конкретных задач и могут включать дополнительные параметры, такие как модель для использования, доступные им инструменты и некоторый контекст о том, когда использовать агента.
Output Styles vs. Skills
Output styles изменяют способ ответа Claude (форматирование, тон, структура) и всегда активны после выбора. Skills — это специфичные для задач prompts, которые вы вызываете с помощью /skill-name или которые Claude загружает автоматически при необходимости. Используйте output styles для согласованных предпочтений форматирования; используйте skills для повторно используемых рабочих процессов и задач.