Estilos de saída

Altere o papel, tom e formato de resposta do Claude Code com um estilo de saída integrado, como Conciso ou Explicativo, ou escreva um estilo personalizado.

Um estilo de saída é um conjunto de instruções que define o papel, tom e formato de resposta do Claude para cada resposta em uma sessão. Claude Code inclui quatro estilos integrados além do padrão, e você pode escrever o seu próprio.

Use um estilo de saída para alterar a forma como Claude responde e trabalha com você durante toda uma sessão, para que você não repita a solicitação em cada prompt. Por exemplo, um estilo integrado pode tornar as respostas mais curtas, adicionar uma explicação de cada alteração, ou fazer com que Claude comece o trabalho sem fazer perguntas rotineiras. Um estilo personalizado também pode transformar Claude em algo diferente de um engenheiro de software, como um assistente de redação ou um analista de dados.

• Para usar um estilo integrado, escolha um dos estilos de saída integrados e mude para ele.
• Para escrever suas próprias instruções, crie um estilo de saída personalizado.

Estilos de saída integrados

O Claude Code começa no estilo Default, suas instruções padrão para completar tarefas de engenharia de software. Cada um dos outros quatro estilos integrados mantém essas instruções e adiciona as suas próprias.

Esta tabela mostra o que cada estilo muda em uma sessão e quando se encaixa:

Default

Default significa que nenhum estilo de saída está selecionado. O Claude Code não adiciona instruções de estilo, e Claude trabalha a partir do prompt do sistema padrão do Claude Code, que é escrito para tarefas de engenharia de software.

default aparece na lista /output-style com os outros estilos, então você o seleciona da mesma forma.

Proactive

No estilo Proactive, Claude começa a implementar assim que você envia uma tarefa. Ele faz suposições razoáveis sobre decisões rotineiras em vez de parar para perguntar, e não muda para o modo de plano a menos que você peça um plano. Você pode redirecioná-lo em qualquer ponto.

As instruções do estilo também dizem ao Claude para verificar com você na conversa antes de uma ação que exclui dados ou altera um sistema compartilhado ou de produção. Essa verificação é uma instrução que Claude segue e é separada dos prompts de permissão.

Mudar para o estilo Proactive não altera seu modo de permissão. Seu modo de permissão ainda decide quais chamadas de ferramenta são executadas sem perguntar a você, então os prompts de permissão aparecem da mesma forma que antes de você mudar.

Concise

No estilo Concise, a primeira frase de uma resposta afirma o que aconteceu ou qual é a resposta. Claude omite a introdução, a narração passo a passo e o recapitulação de fechamento, e responde uma pergunta simples em uma a três frases. Ele faz o trabalho de engenharia tão completamente quanto no estilo Default. Requer Claude Code v2.1.237 ou posterior.

Claude ainda escreve em comprimento total nestes casos:

• Qualquer coisa que você pedir: quando você pedir uma explicação ou mais detalhes, Claude responde completamente.
• Qualquer coisa que você precisa para agir com segurança: relatórios de erro, saída de teste falhando, avisos de segurança e confirmações para ações destrutivas mantêm seu conteúdo completo.

Explanatory

No estilo Explanatory, Claude faz a tarefa da forma como faz no estilo Default e adiciona explicações curtas sobre por que fez as escolhas que fez. Cada explicação aparece na conversa, antes ou depois do código sobre o qual se trata, em um bloco rotulado Insight. As explicações não são escritas em seus arquivos como comentários.

Um bloco Insight carrega dois ou três pontos sobre sua base de código ou o código que Claude escreveu, como este após adicionar um endpoint de API:

★ Insight ─────────────────────────────────────
- Every route in this repo goes through the withAuth wrapper, so the new endpoint gets session checks without its own middleware.
- Rate limits are set per route in limits.ts, which is why this change adds an entry there rather than a global default.
─────────────────────────────────────────────────

Learning

No estilo Learning, Claude adiciona os mesmos blocos Insight que o estilo Explanatory e também pede que você escreva parte do código. Claude lida com a implementação rotineira em si. Quando chega a uma peça com uma decisão de design real, como tratamento de erro, uma estrutura de dados ou lógica de negócios com mais de uma abordagem válida, ele deixa algumas linhas para você.

Claude marca o local com um comentário TODO(human) no arquivo, depois envia uma solicitação que diz o que já foi construído, o que escrever e o que pesar:

● Learn by Doing

Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

Claude então para e espera. Escreva seu código no comentário TODO(human) e diga ao Claude quando terminar. Claude responde com um Insight sobre seu código e continua a tarefa.

Altere seu estilo de saída

Escolha um estilo com o comando, um menu ou um arquivo de configurações. O comando e ambos os menus salvam sua escolha em .claude/settings.local.json no nível do projeto local.

• Comando /output-style: execute /output-style <style> para alternar, por exemplo /output-style concise. Sem argumentos, o comando lista os estilos que você pode escolher e marca o atual.

  O comando também funciona em modo não interativo e sessões do Agent SDK, e do aplicativo móvel ou web via Controle Remoto, onde você pode listar e selecionar apenas estilos integrados. Requer Claude Code v2.1.269 ou posterior.

• Menu do Terminal: execute /config e selecione Output style para escolher um estilo de um menu.

• Extensão VS Code: abra o menu de comandos com / e selecione Output styles para escolher um estilo, incluindo seus estilos personalizados. Requer Claude Code v2.1.257 ou posterior.

• Aplicativo Desktop: defina o campo outputStyle em um arquivo de configurações, por exemplo .claude/settings.local.json, o arquivo que o menu do terminal escreve. Quando você executa /config lá, Claude Code abre Settings > Claude Code em vez de um menu.

Para definir um estilo sem o menu, edite o campo outputStyle diretamente em um arquivo de configurações:

{
  "outputStyle": "Explanatory"
}

O valor é sensível a maiúsculas e minúsculas, portanto escreva os nomes integrados como Proactive, Concise, Explanatory e Learning. Um valor que não corresponde exatamente a um nome de estilo, como explanatory, oferece o estilo Padrão. O comando /output-style ignora maiúsculas e minúsculas.

Para tornar um estilo seu padrão em todos os projetos, defina outputStyle em ~/.claude/settings.json. Os arquivos de configurações próprios de um projeto têm precedência sobre esse valor.

Quando você alterna estilos no meio da sessão, Claude usa o novo estilo a partir da sua próxima mensagem. Para o custo dessa primeira mensagem em cache de prompt, consulte Alterando estilo de saída. Antes da v2.1.251, o novo estilo era aplicado apenas após você executar /clear ou iniciar uma nova sessão.

Crie um estilo de saída personalizado

Um estilo de saída personalizado é um arquivo Markdown: frontmatter para metadados, depois as instruções para Claude.

Na extensão VS Code, você também pode criar o arquivo a partir do menu Output styles em vez de escrevê-lo manualmente. Isso requer Claude Code v2.1.261 ou posterior.

---
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.

Plugins também podem enviar estilos de saída em um diretório output-styles/.

Referência de frontmatter

Configure um estilo de saída com frontmatter YAML entre marcadores --- no topo do arquivo. Todos os campos são opcionais, e os nomes dos campos usam palavras minúsculas separadas por hífens. Um campo digitado incorretamente é ignorado sem um erro. Se o YAML não for analisado, o estilo ainda será carregado com seu nome de arquivo sem campos definidos; execute claude --debug para ver o erro de análise.