SpyBara
Go Premium

output-styles.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

3 added, 1 removed.

2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Output styles

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

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

Пользовательский output style добавляет ваши инструкции в системный prompt и позволяет вам выбрать, сохранять ли встроенные инструкции Claude Code по разработке программного обеспечения. Сохраняйте их, когда вы изменяете способ общения Claude, но все еще кодируете, например всегда отвечаете диаграммой. Исключите их, когда 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 style

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

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

{
  "outputStyle": "Explanatory"
}

Output style является частью системного prompt, который Claude Code читает один раз при запуске сеанса. Изменения вступают в силу после /clear или нового сеанса. См. Как Claude Code использует prompt caching, чтобы узнать, что изменение output style делает с кешем.

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

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

1

Создайте файл Markdown

Сохраните его на одном из трех уровней. Имя файла становится именем стиля, если вы не установите name в frontmatter.

Output styles проекта загружаются из каждого .claude/output-styles/ между рабочей директорией и корнем репозитория. {/* min-version: 2.1.178 */}Начиная с версии 2.1.178, когда несколько из этих вложенных директорий определяют стиль с одинаковым именем, Claude Code использует тот, который находится ближе всего к рабочей директории.

2

Добавьте frontmatter и инструкции

Решите, сохранять ли встроенные инструкции Claude Code по разработке программного обеспечения. Установите keep-coding-instructions: true, если вы изменяете способ общения Claude, но все еще хотите, чтобы он кодировал так же. Исключите это, если Claude не будет заниматься разработкой программного обеспечения.

Этот пример начинает каждое объяснение с диаграммы, сохраняя при этом поведение Claude при кодировании:

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
3

Переключитесь на ваш стиль

Запустите /config и выберите ваш стиль в разделе Output style. Это вступит в силу после /clear или при следующем запуске сеанса.

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

Frontmatter

Файлы output style поддерживают эти поля frontmatter:

Frontmatter Назначение По умолчанию
name Имя output style, если не имя файла Наследуется из имени файла
description Описание output style, отображаемое в средстве выбора /config Нет
keep-coding-instructions Сохранять встроенные инструкции Claude Code по разработке программного обеспечения false
force-for-plugin Только для output styles плагинов: применять этот стиль автоматически всякий раз, когда плагин включен, без необходимости выбора пользователем. Переопределяет параметр outputStyle пользователя. Если несколько включенных плагинов установят это, Claude Code использует первый загруженный. false

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

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

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

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

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

Функция Как это работает Используйте это, когда
Output styles Изменяет системный prompt Вы хотите другую роль, тон или формат ответа по умолчанию на каждом ходу
CLAUDE.md Добавляет пользовательское сообщение после системного prompt Claude должен всегда знать соглашения вашего проекта и контекст кодовой базы
--append-system-prompt Добавляет к системному prompt без удаления чего-либо Вы хотите одноразовое добавление для одного вызова
Agents Запускает подагента с его собственным системным prompt, моделью и инструментами Вы хотите отдельно ограниченного помощника для сосредоточенной задачи
Skills Загружает инструкции, специфичные для задачи, при вызове или при необходимости У вас есть повторно используемый рабочий процесс
  • Settings: где находится поле outputStyle и как работает приоритет настроек
  • Permission modes: как стиль Proactive сравнивается с режимом автоматизации
  • Plugins: упакуйте и распространяйте output styles вместе с skills, hooks и agents
  • Debug your configuration: диагностируйте, почему output style не вступает в силу