Output styles
Адаптируйте Claude Code для использования за пределами разработки программного обеспечения
Output styles позволяют вам использовать Claude Code в качестве любого типа агента, сохраняя при этом его основные возможности, такие как запуск локальных скриптов, чтение/запись файлов и отслеживание TODO.
Встроенные 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).
Frontmatter
Файлы output style поддерживают frontmatter для указания метаданных:
| Frontmatter | Назначение | По умолчанию |
|---|---|---|
name |
Имя output style, если не имя файла | Наследуется из имени файла |
description |
Описание output style, отображаемое в средстве выбора /config |
Нет |
keep-coding-instructions |
Сохранять ли части системного prompt Claude Code, связанные с кодированием. | 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 для повторно используемых рабочих процессов и задач.