Стили вывода Claude Code

Стиль вывода позволяет настроить стиль взаимодействия и способ ответа Claude Code, адаптируя его к большему числу сценариев использования за пределами разработки ПО, сохраняя при этом ключевые функции, такие как запуск локальных скриптов, чтение/запись файлов и отслеживание задач.

По сути, он изменяет логику взаимодействия и стиль ответов Claude Code путём модификации системного промпта.


Встроенные стили вывода

Claude Code предоставляет 3 готовых стиля вывода:

Название стиля Применимые сценарии Основные возможности
Стиль по умолчанию (default) Повседневные задачи разработки ПО Сосредоточен на эффективном выполнении кодинга, отладки, рефакторинга и других задач с краткими и прямыми ответами.
Пояснительный стиль (explanatory) Сценарии обучения в процессе выполнения Объясняет идеи реализации, шаблоны проектирования и другие знания в процессе выполнения задач; подходит разработчикам, которые хотят глубоко разобраться в коде
Стиль обучения (learning) Активное обучение через практику Сотрудничает с вами при выполнении задач, добавляя в ключевых местахTODO(human)маркеры, которые помогают вам самостоятельно реализовать ключевые фрагменты кода, а не дают готовые ответы

Как это работает

При переключении стилей вывода Claude Code настраивает системный промпт в соответствии со следующими правилами:

  1. Все стили удаляют стандартные ограничивающие инструкции, такие как "краткие ответы, эффективный вывод"
  2. Пользовательские стили по умолчанию удаляют инструкции, связанные с программированием, такие как "проверять код с помощью тестов" (если их нужно сохранить, их можно включить в файле стиляkeep-coding-instructions: true)
  3. Каждый стиль добавляет пользовательские правила в конец системного промпта, переопределяя поведение по умолчанию
  4. Проверки соответствия запускаются во время диалогов, чтобы гарантировать, что 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. Шаги использования

  1. Создайте в соответствии с вышеуказанным форматом.mdфайл (напримерdata-analyst.md)
  2. Поместите файл в соответствующий каталог:
    • Доступно для всех проектов:~/.claude/output-styles/data-analyst.md
    • Доступно только для текущего проекта:.claude/output-styles/data-analyst.md
  3. Выполнить в 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. При обнаружении неясных требований уточните намерение, прежде чем начать писать.]
Другие расширения