Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 при запуске сеанса, изменения вступают в силу при следующем запуске нового сеанса. Это сохраняет стабильность системного prompt на протяжении всего разговора, чтобы prompt caching мог снизить задержку и стоимость.

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

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

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

Сохраните его на одном из трех уровней. Имя файла становится именем стиля, если вы не установите name в frontmatter.
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. Это вступит в силу при следующем запуске сеанса.
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Добавляет пользовательское сообщение после системного promptClaude должен всегда знать соглашения вашего проекта и контекст кодовой базы
--append-system-promptДобавляет к системному prompt без удаления чего-либоВы хотите одноразовое добавление для одного вызова
AgentsЗапускает подагента с его собственным системным prompt, моделью и инструментамиВы хотите отдельно ограниченного помощника для сосредоточенной задачи
SkillsЗагружает инструкции, специфичные для задачи, при вызове или при необходимостиУ вас есть повторно используемый рабочий процесс

​
Связанные ресурсы

  • Settings: где находится поле outputStyle и как работает приоритет настроек
  • Permission modes: стиль Proactive отражает режим автоматизации без изменения вашего режима разрешений
  • Plugins: упакуйте и распространяйте output styles вместе с skills, hooks и agents
  • Debug your configuration: диагностируйте, почему output style не вступает в силу