Стили вывода Claude Code
Стиль вывода позволяет настроить стиль взаимодействия и способ ответа Claude Code, адаптируя его к большему числу сценариев использования за пределами разработки ПО, сохраняя при этом ключевые функции, такие как запуск локальных скриптов, чтение/запись файлов и отслеживание задач.
По сути, он изменяет логику взаимодействия и стиль ответов Claude Code путём модификации системного промпта.
Встроенные стили вывода
Claude Code предоставляет 3 готовых стиля вывода:
| Название стиля | Применимые сценарии | Основные возможности |
|---|---|---|
| Стиль по умолчанию (default) | Повседневные задачи разработки ПО | Сосредоточен на эффективном выполнении кодинга, отладки, рефакторинга и других задач с краткими и прямыми ответами. |
| Пояснительный стиль (explanatory) | Сценарии обучения в процессе выполнения | Объясняет идеи реализации, шаблоны проектирования и другие знания в процессе выполнения задач; подходит разработчикам, которые хотят глубоко разобраться в коде |
| Стиль обучения (learning) | Активное обучение через практику | Сотрудничает с вами при выполнении задач, добавляя в ключевых местахTODO(human)маркеры, которые помогают вам самостоятельно реализовать ключевые фрагменты кода, а не дают готовые ответы |
Как это работает
При переключении стилей вывода Claude Code настраивает системный промпт в соответствии со следующими правилами:
- Все стили удаляют стандартные ограничивающие инструкции, такие как "краткие ответы, эффективный вывод"
- Пользовательские стили по умолчанию удаляют инструкции, связанные с программированием, такие как "проверять код с помощью тестов" (если их нужно сохранить, их можно включить в файле стиля
keep-coding-instructions: true) - Каждый стиль добавляет пользовательские правила в конец системного промпта, переопределяя поведение по умолчанию
- Проверки соответствия запускаются во время диалогов, чтобы гарантировать, что Claude всегда следует инструкциям текущего стиля
Переключение стилей вывода
Есть два способа переключения стилей; конфигурация сохраняется в каталоге проекта.claude/settings.local.jsonфайл, идействует только для текущего проекта:
Способ 1: выбор из менюПосле ввода команды выберите нужный стиль в интерактивном меню:
/output-style
Способ 2: прямое указаниеДобавьте имя стиля непосредственно после команды, чтобы выполнить это за один шаг:
/output-style explanatory
/output-style learning
/output-style default
Помимо переключения с помощью команд, вы также можете напрямую редактировать
.claude/settings.local.json(на уровне проекта) или~/.claude/settings.json(на глобальном уровне) файлы, чтобы изменитьoutputStyleзначение поля для переключения стилей.
Создание пользовательских стилей вывода
Если встроенные стили не соответствуют вашим потребностям, вы можете определить собственный стиль с помощью файла Markdown.
1. Место сохранения файла
| Уровень | Путь сохранения | Область действия |
|---|---|---|
| Пользовательский уровень | ~/.claude/output-styles/ |
Может использоваться всеми проектами текущего пользователя |
| Уровень проекта | .claude/output-styles/(в корневом каталоге проекта) |
Доступно только для текущего проекта; можно зафиксировать в git и поделиться с командой |
2. Формат файла
Пользовательский файл стиля состоит из двух частей: верхняяYAML frontmatter(конфигурация метаданных) и нижняяMarkdown body(содержимое конкретных инструкций).
Пример
name: data-analyst # Имя стиля, отображается в меню /output-style (использует имя файла, если не заполнено)
description: Сосредоточиться на преобразовании сложных данных в визуальные отчёты и аналитические выводы
# Описание стиля, отображается в тексте описания меню (необязательно)
keep-coding-instructions: false # Сохранять ли стандартные инструкции, связанные с программированием
# false (по умолчанию): удалить инструкции по программированию, подходит для сценариев, не связанных с разработкой
# true: сохраняйте инструкции по написанию кода, одновременно применяя пользовательские правила
---
# Определение роли
Вы — профессиональный ассистент по анализу данных, умеющий использовать Python для обработки различных типов структурированных данных,
и превращающий сложные данные в краткие и понятные визуальные отчёты.
## Правила ответа
1. Все анализы должны включать три части: "Вывод + Поддержка данными + Рекомендации по оптимизации"
2. При генерации кода необходимо включать подробные комментарии, отдавая приоритет Pandas и Matplotlib
3. Избегайте нагромождения технического жаргона; объясняйте сложные концепции простым языком
## Требования к формату
1. Раздел заключения должен быть выделен жирным шрифтом
2. Блоки кода должны быть обёрнуты в теги ```python
3. Раздел с рекомендациями должен быть представлен в виде нумерованного списка
## Особые сценарии
1. При обнаружении отсутствующих данных активно предлагайте пользователю дополнить ключевую информацию вместо того, чтобы сразу выдавать ошибку
2. При создании визуальных диаграмм по умолчанию используйте китайские подписи и светлую тему
3. Описание параметров Frontmatter
| Название параметра | Обязательно? | Описание | Значение по умолчанию |
|---|---|---|---|
name |
нет | Название стиля, отображается в/output-styleменю. Если не заполнено, используйте имя файла (без расширения .md) |
Имя файла |
description |
нет | Краткое описание функции стиля, отображается в тексте описания меню, чтобы помочь различать несколько пользовательских стилей | Отсутствует |
keep-coding-instructions |
нет | Сохранять ли инструкции, связанные с программированием, в системном промпте по умолчанию. Если установлено значениеtrue, пользовательские инструкции будут наложены поверх инструкций по программированию по умолчанию |
false |
4. Шаги использования
- Создайте в соответствии с вышеуказанным форматом
.mdфайл (напримерdata-analyst.md) - Поместите файл в соответствующий каталог:
- Доступно для всех проектов:
~/.claude/output-styles/data-analyst.md - Доступно только для текущего проекта:
.claude/output-styles/data-analyst.md
- Доступно для всех проектов:
- Выполнить в Claude Code
/output-style, и вы сможете увидеть и выбрать только что созданный стиль в меню
Отличия от связанных функций
Output styles выглядят похоже на следующие функции, но работают на разных уровнях:
| Объект сравнения | Ключевое различие |
|---|---|
| Output Style vs CLAUDE.md | Output style будетзаменятьстандартный системный промпт для программной инженерии, коренным образом меняя режим работы Claude; CLAUDE.md добавляет контекст проекта и соглашения в виде пользовательских сообщений, не изменяя сам системный промпт. |
| Output Style vs --append-system-prompt | Стиль вывода заменяет и отключает промпт по умолчанию;--append-system-promptдобавляет содержимое в конец промпта по умолчанию; оба сохраняют исходный промпт |
| Стиль вывода против субагента | Стиль вывода изменяет системный промпт основного агента, влияя на глобальный стиль взаимодействия; субагент — это независимый модуль обработки задач, который позволяет настраивать модели, инструменты и условия запуска, а после обработки конкретных подзадач возвращает результаты |
| Стиль вывода против пользовательских слэш-команд | Стиль вывода — это «сохранённый системный промпт», определяющий общий стиль взаимодействия Claude; пользовательские слэш-команды — это «сохранённые пользовательские промпты», используемые для быстрого выполнения конкретной инструкции или задачи |
Шаблон пользовательского стиля
Ниже приведён общий шаблон пользовательского стиля вывода. Замените[ ]содержимое в нём на ваши реальные потребности и сохраните его как.mdфайл для использования:
Пример
name: [Название стиля, например, Помощник по написанию]
description: [Описание назначения в одном предложении, например: сосредоточьтесь на написании технической документации, выводите понятный и точный контент]
keep-coding-instructions: [true или false]
---
# 1. Основное позиционирование
[Определите роль и компетенции Claude, например:
Вы — профессиональный помощник по написанию технической документации, умеющий преобразовывать сложные технические концепции в ясный и легко понятный текст]
# 2. Правила ответов
[Укажите логику ответов Claude, например:
1. Каждый ответ должен включать три части: "Ключевая мысль + Подробное объяснение + Пример"
2. Используйте действительный залог и избегайте пассивных конструкций предложений
3. Давайте краткое пояснение при первом появлении технических терминов]
# 3. Требования к форматированию
[Укажите формат оформления вывода, например:
1. Используйте## для заголовков второго уровня
2. Примеры кода используют блоки кода и указывают тип языка
3. Ключевая информация выделена полужирным шрифтом]
# 4. Обработка особых сценариев
[Правила обработки для конкретных ситуаций, например:
1. Когда нужны примеры, предпочитайте реальные сценарии абстрактным примерам.
2. При обнаружении неясных требований уточните намерение, прежде чем начать писать.]