Pular para o conteúdo principal
Os estilos de saída permitem que você use Claude Code como qualquer tipo de agente, mantendo suas capacidades principais, como executar scripts locais, ler/escrever arquivos e rastrear TODOs.

Estilos de saída integrados

O estilo de saída Padrão do Claude Code é o prompt do sistema existente, projetado para ajudá-lo a concluir tarefas de engenharia de software com eficiência. Existem dois estilos de saída integrados adicionais focados em ensiná-lo sobre a base de código e como Claude opera:
  • Explanatory: Fornece “Insights” educacionais entre ajudá-lo a concluir tarefas de engenharia de software. Ajuda você a entender as escolhas de implementação e padrões da base de código.
  • Learning: Modo colaborativo de aprender fazendo, onde Claude não apenas compartilhará “Insights” enquanto codifica, mas também pedirá que você contribua com pequenos e estratégicos pedaços de código. Claude Code adicionará marcadores TODO(human) no seu código para você implementar.

Como os estilos de saída funcionam

Os estilos de saída modificam diretamente o prompt do sistema do Claude Code.
  • Todos os estilos de saída excluem instruções para saída eficiente (como responder de forma concisa).
  • Os estilos de saída personalizados excluem instruções para codificação (como verificar código com testes), a menos que keep-coding-instructions seja verdadeiro.
  • Todos os estilos de saída têm suas próprias instruções personalizadas adicionadas ao final do prompt do sistema.
  • Todos os estilos de saída acionam lembretes para Claude aderir às instruções do estilo de saída durante a conversa.

Altere seu estilo de saída

Você pode:
  • Executar /output-style para acessar um menu e selecionar seu estilo de saída (isso também pode ser acessado no menu /config)
  • Executar /output-style [style], como /output-style explanatory, para mudar diretamente para um estilo
Essas alterações se aplicam ao nível do projeto local e são salvas em .claude/settings.local.json. Você também pode editar diretamente o campo outputStyle em um arquivo de configurações em um nível diferente.

Crie um estilo de saída personalizado

Os estilos de saída personalizados são arquivos Markdown com frontmatter e o texto que será adicionado ao prompt do sistema:
---
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...]
Você pode salvar esses arquivos no nível do usuário (~/.claude/output-styles) ou no nível do projeto (.claude/output-styles).

Frontmatter

Os arquivos de estilo de saída suportam frontmatter, útil para especificar metadados sobre o comando:
FrontmatterPropósitoPadrão
nameNome do estilo de saída, se não for o nome do arquivoHerda do nome do arquivo
descriptionDescrição do estilo de saída. Usado apenas na interface do usuário de /output-styleNenhum
keep-coding-instructionsSe deve manter as partes do prompt do sistema do Claude Code relacionadas à codificação.false

Comparações com recursos relacionados

Output Styles vs. CLAUDE.md vs. —append-system-prompt

Os estilos de saída “desativam” completamente as partes do prompt do sistema padrão do Claude Code específicas para engenharia de software. Nem CLAUDE.md nem --append-system-prompt editam o prompt do sistema padrão do Claude Code. CLAUDE.md adiciona o conteúdo como uma mensagem do usuário seguindo o prompt do sistema padrão do Claude Code. --append-system-prompt anexa o conteúdo ao prompt do sistema.

Output Styles vs. Agents

Os estilos de saída afetam diretamente o loop do agente principal e afetam apenas o prompt do sistema. Os agentes são invocados para lidar com tarefas específicas e podem incluir configurações adicionais, como o modelo a usar, as ferramentas disponíveis e algum contexto sobre quando usar o agente.

Output Styles vs. Skills

Os estilos de saída modificam como Claude responde (formatação, tom, estrutura) e estão sempre ativos uma vez selecionados. Skills são prompts específicos de tarefas que você invoca com /skill-name ou que Claude carrega automaticamente quando relevante. Use estilos de saída para preferências de formatação consistentes; use skills para fluxos de trabalho e tarefas reutilizáveis.