Skip to content

Estilos de Exibição (Output Styles): Mudando o Tom, Mantendo o Agente

📚 Navegação da Série: O artigo anterior 31 Configurações no settings.json (Settings JSON) esclareceu as regras de precedência e os caminhos de arquivos. Este capítulo foca em uma diretiva de comportamento que reside nessas configurações—os Estilos de Exibição (Output Styles). Eles não controlam as referências que o Claude armazena, mas sim a forma como ele responde a você. Com uma linha de configuração, você pode alternar seu assistente de um "desenvolvedor focado em entregas" para um tutor que detalha cada etapa ou um revisor textual puro.

Muitos dizem: "Se quer que o Claude obedeça, salve tudo no CLAUDE.md"—convenções, restrições e regras do repositório.

Para ser honesto, essa recomendação está apenas metade correta. O CLAUDE.md é ideal para mapear o contexto técnico do código (Artigo 18), mas tentar usá-lo para redefinir o estilo de conversação é colocar a instrução na gaveta errada.

Que tipo de instrução? "Quero mudar a voz, o formato de resposta ou a persona da IA". Exemplos: solicitar fluxogramas antes de explicações técnicas, forçar a IA a ensinar sintaxes de frameworks durante a escrita ou usá-la como revisora gramatical. Salvar essas orientações no CLAUDE.md gera inconsistências, pois o arquivo é anexado como recomendação contextual (user message), e não como regra de boot estrutural. A ferramenta correta para alterar a voz do modelo chama-se Output Styles (Estilos de Exibição).

Em termos simples: o CLAUDE.md é a documentação do projeto entregue ao desenvolvedor; o Output Style é a descrição do cargo dele—definindo se o profissional deve focar apenas em código, atuar como tutor técnico ou revisar artigos de marketing. Veremos agora como gerenciar esse parâmetro.

Imagine pedir ao Claude Code para revisar o texto do seu currículo profissional. Sob a persona padrão de desenvolvimento, a IA tentará "refatorar blocos de texto", "sugerir testes unitários locais" ou mapear arquivos de configuração—poluindo a conversa com termos de programação. Essa discrepância de comportamento não é resolvida por diretrizes no CLAUDE.md, mas sim alterando o Output Style do assistente.

Ao terminar este artigo, você obterá:

  • O conceito essencial do Output Styles (modificar a formatação da resposta, e não o conhecimento do modelo)
  • As quatro personas nativas (Default, Proactive, Explanatory e Learning) e seus respectivos cenários de uso
  • Como gerenciar atalhos no terminal (com um alerta de segurança sobre a remoção do comando /output-style)
  • Como criar estilos customizados em arquivos Markdown, configurando frontmatters e o parâmetro crucial keep-coding-instructions
  • A tabela definitiva de escopos: Output Styles vs CLAUDE.md vs Skills vs Subagents

01 A voz de resposta vs O conhecimento do modelo

Memorize a regra básica de configuração:

输出样式改变 Claude 的响应方式,而不是 Claude 知道什么。

Os estilos de exibição alteram a forma como o Claude responde, não o que o Claude sabe.

Essa diretriz oficial significa que a alteração de estilo não adiciona dados do seu código à IA. Ela modifica o system prompt (o bloco de instruções residente na inicialização do console que parametriza a persona do Claude)—redefinindo o tom, a formatação e a estruturação das respostas.

Analogia: O apresentador de TV. O profissional de comunicação mantém seus conhecimentos técnicos e vocabulário intactos em qualquer situação; contudo, adota um tom sério ao apresentar o telejornal da noite, uma postura enérgica em programas infantis e uma fala didática e pausada ao gravar tutoriais educativos. Muda-se a orientação do programa, não a pessoa. O Output Style funciona como essa diretriz—o modelo de IA permanece o mesmo, mas a voz de interação é reconfigurada.

Quando adotar essa configuração? A documentação detalha:

当你在每个回合中不断重新提示相同的语音或格式时,或者当你希望 Claude 充当软件工程师以外的角色时,请使用一个。

Use um estilo de exibição quando se pegar repetindo a mesma instrução de voz ou formatação a cada rodada, ou quando quiser que o Claude atue em um papel diferente do de engenheiro de software.

Identificamos dois cenários claros de uso:

  • Instruções repetitivas no chat: se você precisa digitar "inicie com um fluxograma Mermaid" ou "seja o mais conciso possível" em todas as rodadas, consolide essa preferência em um estilo permanente de exibição.
  • Tarefas que fogem da programação: se estiver usando o Claude Code como revisor textual, redator ou tradutor de artigos. A inicialização padrão do console injeta regras complexas de engenharia (análise de pastas, validações de testes, lints) que atrapalham tarefas de escrita criativa ou marketing.

Mudar o Output Style é a única forma de contornar a persona padrão de desenvolvimento. Tentar contornar isso adicionando observações como "ignore as regras de git e atue apenas como tradutor" no CLAUDE.md gera inconsistências porque a instrução técnica de boot original continua ativa no system prompt.

💡 Resumo em uma frase: O Output Style altera o system prompt inicial da IA (voz, formato e persona); configure-o quando notar repetição de instruções textuais no chat ou quando o repositório focar em tarefas sem programação.


02 As quatro personas nativas

O Claude Code disponibiliza quatro configurações padrão prontas para uso:

Default (Padrão): O modo de engenharia tradicional usado nos capítulos anteriores. É otimizado para codificação pragmática, edições contidas de arquivos e validações rígidas de compilação.

Além da padrão, a documentação apresenta três estilos alternativos de interação:

Proactive (Proativo): Minimiza conversas e planejamentos prévios de arquivos. A IA realiza inferências lógicas razoáveis e avança diretamente para a escrita do código. Indicada para aceleração de tarefas simples.

Atenção: O estilo Proactive define o comportamento da IA (estilo mais dinâmico de tomada de decisões), mas não altera os níveis de permissões de ferramentas configurados no terminal (Artigo 20). As solicitações de aprovação local de comandos bash continuarão ativas no console.

Explanatory (Explicativo): Intercala a escrita do código com explicações conceituais (Insights) sobre as decisões tomadas, a arquitetura e os padrões do projeto. Ideal para apropriação e estudo de bases de dados ou códigos novos.

Learning (Aprendizado): Funciona como uma mentoria interativa. Além de conceituar o código, a IA cria a estrutura do projeto mas deixa as chaves lógicas vazias sinalizadas com comentários TODO(human), desafiando o desenvolvedor a concluir a lógica física.

Exemplo de comportamento em uma tarefa comum de paginação:

  • Sob o estilo Proactive, a IA iniciará diretamente a edição do arquivo, omitindo debates sobre estratégias de paginação.
  • Sob o estilo Explanatory, ela adicionará os códigos explicando a preferência por cursor-based pagination em relação ao offset tradicional.
  • Sob o estilo Learning, ela estruturará a rota e os middlewares, salvando uma linha // TODO(human): implemente a lógica de decodificação do cursor na função de paginação.

Resumo comparativo dos estilos nativos:

Estilo de ExibiçãoDiferencial em relação à padrãoCenário ideal de acionamentoTamanho médio da resposta
DefaultPersona padrão de desenvolvimentoCodificação no dia a diaNormal (Baseline)
ProactiveMenos conversas e tomadas de decisões autônomasAceleração de rotinas sem validações préviasVariável
ExplanatoryAdição de blocos de explicações técnicasEstudo e onboarding de repositóriosMaior (por design)
LearningTutoria interativa com placeholders de exercíciosAprendizado prático de novos frameworksMaior (por design)

Lembre-se do impacto financeiro: as personas Explanatory e Learning produzem respostas mais extensas devido à injeção de textos explicativos, aumentando o custo em tokens de saída (ver custos no Artigo 06). Recomendamos alternar para esses estilos apenas durante estudos locais, mantendo o Default ativo no fluxo padrão de trabalho.

Diretriz recomendada: mantenha o Default ativo para entregas rápidas; use o Explanatory ao clonar bibliotecas open-source complexas para entender suas interações; utilize o Learning para guiar exercícios práticos pessoais.

💡 Resumo em uma frase: A suíte conta com Default (focado), Proactive (independente), Explanatory (didático) e Learning (exercícios); alterne conforme a tarefa para poupar consumo de tokens.


03 Como alternar os estilos no terminal

Atenção para uma alteração importante de versão: comandos antigos descritos em tutoriais de terceiros não funcionam mais no console.

O atalho /output-style foi desativado em favor de interfaces centralizadas. A documentação esclarece:

独立的 /output-style 命令在 v2.1.73 中已弃用,在 v2.1.91 中被移除。使用 /config 或直接编辑 outputStyle 设置。

O comando independente /output-style foi descontinuado na v2.1.73 e removido na v2.1.91. Use /config ou edite a configuração outputStyle diretamente.

Para alternar as personas ativas, siga estes dois caminhos suportados:

Método 1: Menu interativo /config (Recomendado)

No console do Claude Code, digite /config e navegue até a opção Output Styles. Seleção conforme a documentação:

运行 /config 并选择输出样式从菜单中选择一种样式。你的选择会保存到本地项目级别.claude/settings.local.json

Execute /config e escolha Output Styles no menu para selecionar um estilo. Sua escolha será salva no .claude/settings.local.json no escopo local do projeto.

A seleção realizada no menu interativo é gravada automaticamente no .claude/settings.local.json. Isso garante que o estilo de exibição alterado seja aplicado apenas à sua máquina local, sem alterar o repositório de outros colaboradores (Artigo 31).

Método 2: Gravação manual no JSON

Você pode parametrizar a chave manualmente adicionando o campo outputStyle no arquivo JSON:

json
{
  "outputStyle": "Explanatory"
}

Declare um dos termos padrão (Explanatory, Learning, Proactive ou o nome do seu arquivo customizado). O escopo do carregamento segue as mesmas regras de precedência vistas no Artigo 31 (Global, Projeto ou Privado local).

Alerta sobre o momento de ativação

Lembre-se do comportamento de recarregamento do terminal. O manual de desenvolvimento descreve:

输出样式是系统提示的一部分,Claude Code 在会话开始时读取一次。更改将在 /clear 或新会话后生效。

O estilo de exibição é parte do system prompt e é lido apenas uma vez no início da sessão do Claude Code. As alterações entrarão em vigor após um /clear ou em uma nova sessão.

Analogia: O roteiro impresso. Se você alterar o roteiro no meio da gravação de um episódio, o apresentador continuará seguindo a folha que tem em mãos. A nova diretriz só será lida na gravação do episódio seguinte. Como os Output Styles alteram o system prompt, o Claude lê essa regra apenas na inicialização da conversa. Após modificar o estilo, execute o comando /clear no chat (Artigo 19) ou reinicie o console para carregar a nova configuração.

Se notar que o console continua respondendo de forma concisa após a troca de estilos, lembre-se de limpar a tela com /clear para reinicializar o contexto da IA com o estilo selecionado.

💡 Resumo em uma frase: O comando /output-style foi removido; selecione no /config (salvo no .local.json) ou altere a propriedade no settings.json; execute o comando /clear no terminal para ativar as mudanças.


04 Criando um estilo de exibição personalizado

É possível customizar personas e regras de formatação locais criando arquivos Markdown simples no disco.

A documentação detalha a estrutura de arquivos:

自定义输出样式是一个 Markdown 文件:frontmatter 用于元数据,然后是要添加到系统提示的说明。

Um estilo de exibição personalizado é um arquivo Markdown: o frontmatter para metadados, seguido pelas instruções a serem adicionadas ao system prompt.

A estrutura é composta de: cabeçalho frontmatter YAML delimitado por --- e o corpo Markdown contendo as diretrizes que serão adicionadas ao system prompt. Siga estas etapas:

Passo 1: Escolher o caminho físico do arquivo

Os caminhos físicos suportados seguem a hierarquia de escopo padrão:

EscopoDiretório de destinoUsuários/Projetos autorizados
Global (User)~/.claude/output-styles/Disponível para o seu usuário em qualquer repositório local
Local (Project).claude/output-styles/Restrito ao repositório ativo; compartilhado via git
Managed (Gerenciado)Diretório central gerenciado por TIPolíticas corporativas restritas

A lógica é equivalente ao mapeamento de diretórios do Artigo 31: rotinas pessoais de uso diário globais ficam na pasta raiz do usuário; padrões de formatação da equipe acompanham o repositório no controle de versão.

Regra de nomenclatura de arquivos:

文件名成为样式名称,除非你在 frontmatter 中设置 name

O nome do arquivo torna-se o nome do estilo, a menos que você defina a chave name no frontmatter.

Por exemplo, salvar o arquivo como code-reviewer.md registrará o estilo como code-reviewer no terminal, salvo se sobrescrito pela propriedade name no cabeçalho YAML.

Passo 2: Redigir o cabeçalho e as diretrizes

Abaixo está um modelo sugerido que orienta o Claude a priorizar diagramas lógicos nas respostas:

markdown
---
name: Diagrams first
description: Força o uso de diagramas Mermaid em todas as explicações técnicas
keep-coding-instructions: true
---

Ao explicar estruturas de código, endpoints ou arquiteturas de arquivos, comece exibindo um fluxograma ou diagrama de sequência usando a sintaxe Mermaid. Adicione a explicação textual apenas após o diagrama.

## Convenções do diagrama

Use `flowchart TD` para fluxos lógicos e `sequenceDiagram` para caminhos de requisições de rede. Mantenha os diagramas simplificados abaixo de 15 nós.

O corpo do arquivo especifica que explicações técnicas devem ser iniciadas por ilustrações com diagramas Mermaid. Esses parágrafos serão anexados ao system prompt ativo.

Propriedades do frontmatter YAML:

Parâmetro YAMLFunção técnicaValor padrão
nameIdentificador visual do estilo no consoleNome do arquivo físico
descriptionBreve explicação exibida na lista do menu /configNulo
keep-coding-instructionsDefine se preserva as diretivas internas de programação do consolefalse
force-for-pluginAtivação mandatória automática ao inicializar um Pluginfalse

Os campos name e description servem para organização do console. Os outros dois gerenciam a conformidade técnica, com destaque para a chave keep-coding-instructions, que detalharemos a seguir.

Passo 3: Ativar o estilo personalizado

Após salvar o arquivo, acesse o console, abra /config, navegue até "Output Styles" e selecione seu novo estilo na lista. Em seguida, execute /clear para forçar a leitura do system prompt.

💡 Resumo em uma frase: Estilos customizados são arquivos Markdown com cabeçalho YAML; salve no escopo correto (User ou Project), selecione a opção no /config e execute /clear para aplicar.


05 O parâmetro crucial keep-coding-instructions

A chave keep-coding-instructions gerencia a presença das regras de engenharia padrão do Claude Code, e configurá-la de forma errada altera radicalmente o comportamento da IA.

Como vimos, a inicialização padrão do console injeta orientações rígidas voltadas a desenvolvimento (análise de diretórios, validações de testes, lints). Ao adotar um estilo customizado, o Claude Code remove esse bloco de engenharia por padrão. O manual oficial sinaliza:

自定义输出样式排除了 Claude Code 的内置软件工程说明……除非 keep-coding-instructions 设置为 true

Os estilos de exibição personalizados excluem as instruções de desenvolvimento internas do Claude Code... a menos que keep-coding-instructions esteja definido como true.

Com o valor false (padrão), o system prompt original de engenharia é descartado, mantendo apenas o texto do seu arquivo Markdown. Para decidir o valor adequado, faça uma pergunta simples:

"Este estilo de exibição continuará executando código no terminal?"

  • Sim, a IA continuará programando (apenas mudando o tom de voz, como forçar diagramas Mermaid): defina keep-coding-instructions: true para preservar as ferramentas de escrita de arquivos e lints. O modelo de fluxogramas anterior utilizou true porque o Claude Code precisava continuar editando o repositório.
  • Não, a IA executará tarefas sem código (como revisão gramatical, redação ou tradução): omita o parâmetro (or use false) para desativar a persona de engenharia, evitando que ela tente rodar lints locais ou testar arquivos de texto.

A documentação fornece uma orientação direta:

当你在改变 Claude 的通信方式但仍在编程时(例如总是用图表回答),请保留它们。当 Claude 根本不进行软件工程时(例如写作助手或数据分析师),请省略它们。

Mantenha-as quando estiver mudando a forma como o Claude se comunica, mas ainda estiver programando (por exemplo, sempre respondendo com diagramas). Omita-as quando o Claude não estiver fazendo engenharia de software de forma alguma (por exemplo, um assistente de escrita ou analista de dados).

Comparativo do impacto de configuração:

Propósito do EstiloValor recomendadoImpacto de configuração incorreta
✅ Continuará programando, alterando apenas a formataçãotrueCom false: O Claude perde as instruções de testes e segurança de lints locais, realizando edições de arquivos sem validação adequada.
✅ Executará tarefas textuais sem programação (traduções, marketing)Omitir / falseCom true: A IA continuará focada em refatorações de código, linting e chamadas bash inapropriadas para textos literários.

No caso da revisão de currículo do Artigo 01, a dor de cabeça se resolve usando um estilo de escrita puro com a chave keep-coding-instructions omitida (desabilitada). Isso limpa os utilitários de compilação locais do boot do Claude, permitindo o foco em análise puramente textual.

💡 Resumo em uma frase: O parâmetro keep-coding-instructions remove o boot de desenvolvimento se definido como false; use true se a IA continuar programando e omita para tarefas textuais puras.


06 Mecanismo de funcionamento e consumo de tokens

Compreender o funcionamento interno dos estilos ajuda a esclarecer regras como a necessidade de reiniciar com /clear e o gerenciamento de tokens. A documentação resume as propriedades:

Três regras de funcionamento do sistema:

  • 所有输出样式都在系统提示的末尾添加了自己的自定义说明。
  • Todos os estilos de exibição adicionam suas instruções personalizadas ao final do system prompt.
  • 所有输出样式都会在对话期间触发提醒,让 Claude 遵守输出样式说明。
  • Todos os estilos de exibição disparam lembretes durante a conversa para manter o Claude alinhado com as instruções do estilo.
  • 自定义输出样式排除了 Claude Code 的内置软件工程说明……除非 keep-coding-instructions 设置为 true
  • Estilos de exibição personalizados excluem as instruções internas de engenharia... a menos que keep-coding-instructions seja definido como true.

1. Concatenação de boot: Suas diretrizes Markdown são anexadas diretamente na inicialização do console. Isso garante que a persona oriente todas as respostas da conversa ativa.

2. Lembretes periódicos (Reinforcement): O terminal injeta lembretes contextuais curtos nas rodadas de chat para evitar que a IA se desvie da persona com o passar das conversas.

3. Preservação do boot: O campo keep-coding-instructions: true instrui o console a preservar a persona de engenharia, enquanto o valor false descarta a inicialização de lints e bash.

Abaixo está ilustrado o fluxo de montagem do system prompt:

Montagem do System Prompt: Padrão, Customizado com Keep=true e Customizado com Keep=false; comandos /clear ativam as mudanças

O diagrama demonstra a concatenação: o Claude Code monta o system prompt usando a persona selecionada; edições durante o chat exigem o comando /clear para que o interpretador leia novamente o arquivo de estilos.

Sobre o consumo de tokens, a documentação aponta:

令牌使用情况取决于样式。向系统提示添加说明会增加输入令牌,尽管 prompt caching 在会话中的第一个请求之后会降低这个成本。

O uso de tokens varia de acordo com o estilo. Adicionar instruções ao system prompt aumenta os tokens de entrada, embora o prompt caching diminua esse custo após a primeira requisição da sessão.

Inserir regras de estilo aumenta levemente os tokens de entrada. Graças ao mecanismo de cache do Claude (prompt caching), esse valor se estabiliza após a rodada inicial do chat. O principal fator de aumento de consumo são as respostas longas geradas por personas explicativas (tokens de saída).

💡 Resumo em uma frase: Estilos personalizados são anexados ao system prompt e mantidos por lembretes regulares; a remoção da persona de desenvolvimento é automática (salvo se configurada com keep-coding-instructions: true); limpe o console com /clear para aplicar.


07 Comparativo definitivo: Output Styles vs CLAUDE.md vs Skills vs Subagents

Mapearemos as fronteiras conceituais do Output Styles em relação a outras ferramentas de configuração abordadas na série:

O principal diferencial do Output Style é alterar diretamente a raiz do system prompt, aplicando-se a todas as rodadas do chat. Comparativo estrutural:

ExtensãoMecanismo técnicoCenário de uso recomendado
Output StylesAltera o system prompt; aplica-se a todas as respostas do chatRedefinir a voz de conversação, tom ou personas de forma persistente.
CLAUDE.mdAnexado como instrução inicial após o promptCompartilhar diretrizes do repositório (gerenciador de pacotes, build).
--append-system-promptConcatena dados adicionais ao prompt ativoTestar atalhos ou adicionar diretrizes temporárias para apenas uma execução.
SubagentsExecuta subchats com modelos e prompts própriosIsolar logs ou rodar buscas pesadas, consumindo apenas o resultado.
SkillsCarrega instruções sob demanda via chaves no chatCriar rotinas e processos reutilizáveis acionados por palavras-chave.

Diferença essencial: Output Styles versus CLAUDE.md.

O CLAUDE.md define a regra do projeto (conteúdo); o Output Style molda a voz da IA (forma). O primeiro ensina as dependências do código local, enquanto o segundo indica a estilização e tom de escrita da resposta. O CLAUDE.md é a documentação técnica, o Output Style é o contrato do cargo. Convenções de pacotes pertencem ao CLAUDE.md; padrões de Mermaid ou diagramas de texto pertencem a Output Styles. O manual oficial orienta:

有关你的项目、约定或代码库的说明,请改用 CLAUDE.md。

Para instruções sobre o seu projeto, convenções ou base de código, use o CLAUDE.md.

A flag --append-system-prompt atua de forma temporária. Use-a para testes rápidos no console:

powershell
claude --append-system-prompt "Responda de forma concisa em português"

Essa flag não persiste na sessão seguinte. Para consolidar uma persona de forma recorrente, salve-a como um arquivo Markdown na pasta de estilos de exibição.

Skills (Artigo 26) são carregadas de forma condicional para tarefas específicas (como /deploy); Output Styles são lidos no boot inicial e regem o tom de todas as respostas da conversa.

Solicitar no CLAUDE.md que a IA "seja concisa" costuma ser ignorado em chats longos. Ajustes de tom e brevidade pertencem aos Output Styles.

💡 Resumo em uma frase: O Output Style altera permanentemente o system prompt; use o CLAUDE.md para regras de código e a flag --append-system-prompt para testes rápidos em sessões únicas.


08 Prática: Criando o estilo "Diagrams first"

Vamos testar o fluxo prático: criar o arquivo Markdown global → ativar no /config → limpar a sessão → testar a resposta ilustrada.

Passo 1: Criar o arquivo de estilos global

Salvaremos no escopo global para habilitar a persona em qualquer pasta local. Crie a pasta do usuário (PowerShell):

powershell
New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude\output-styles" -Force

Crie o arquivo diagrams-first.md no diretório correspondente com o seguinte conteúdo:

markdown
---
name: Diagrams first
description: Força o uso de diagramas Mermaid em todas as explicações técnicas
keep-coding-instructions: true
---

Ao explicar estruturas de código, endpoints ou arquiteturas de arquivos, comece exibindo um fluxograma ou diagrama de sequência usando a sintaxe Mermaid. Adicione a explicação textual apenas após o diagrama.

## Convenções do diagrama

Use `flowchart TD` para fluxos lógicos e `sequenceDiagram` para caminhos de requisições de rede. Mantenha os diagramas simplificados abaixo de 15 nós.

Utilizamos keep-coding-instructions: true porque o Claude Code precisa continuar editando e compilando arquivos de código locais normalmente.

Passo 2: Selecionar a persona no terminal

Inicialize o terminal do Claude Code e abra a interface de opções:

powershell
claude

No chat, execute /config, navegue até Output Styles e selecione Diagrams first.

Saída esperada: O item Diagrams first estará disponível para seleção com a descrição configurada. Se estiver oculto, confirme se a pasta física foi nomeada corretamente.

Passo 3: Limpar o terminal para carregar o prompt

Lembre-se de reiniciar o system prompt para forçar a leitura do novo arquivo:

text
/clear

Passo 4: Testar o acionamento prático

Envie uma pergunta técnica que demanada conceituação visual:

text
Como funciona o fluxo de requisição do usuário passando pelo nginx, backend Node e banco PostgreSQL?

Saída esperada: A IA renderizará primeiro um diagrama de sequência Mermaid ilustrando o trajeto da requisição e, em seguida, detalhará os tópicos em texto. Isso confirma que a persona foi integrada com sucesso.

Se alternar novamente para o estilo Default e rodar o /clear, a IA retornará apenas texto plano, provando a influência direta do Output Style no comportamento do console.

Passo 5: Remoção do arquivo de testes

Para remover o estilo de teste, exclua o arquivo Markdown do disco (PowerShell):

powershell
Remove-Item -Path "$env:USERPROFILE\.claude\output-styles\diagrams-first.md" -Force

💡 Resumo em uma frase: O fluxo básico consiste em salvar o arquivo .md, selecionar a opção no /config, executar /clear no terminal, testar a formatação e limpar a pasta física ao concluir.


09 Resumo

Os estilos de exibição gerenciam a persona de conversação, a formatação e o tom das respostas do Claude de forma consistente.

Revisão dos tópicos principais:

ObjetivoO que fazerPonto-chave a lembrar
Alterar a persona do consoleModificar o system prompt inicialRedefine a forma de comunicação da IA, preservando os conhecimentos do modelo.
Adotar personas nativasAlternar entre Default, Proactive, Explanatory ou LearningEstilos explicativos geram respostas extensas que consomem mais tokens.
Alternar as configuraçõesAcessar o menu /config ou declarar no JSONO comando /output-style foi descontinuado; use /clear para aplicar.
Criar estilos customizadosSalvar arquivo Markdown com YAML frontmatterUse caminhos globais (User) ou locais de repositório (Project).
Preservar comandos de desenvolvimentoConfigurar a chave keep-coding-instructionsUse true se a IA continuar editando códigos; omita para tarefas textuais puras.
Diferença conceitual do CLAUDE.mdAvaliar se define conteúdo ou formaO CLAUDE.md detalha regras de código; o Output Style define a voz da conversa.

Agora você deve ser capaz de: Escolher as personas padrão baseando-se no custo de tokens, alternar configurações no menu interativo /config, reiniciar o interpretador via /clear, desenvolver estilos customizados controlando os comandos de compilação locais via keep-coding-instructions e separar o escopo comportamental do visual. A chave outputStyle molda o console do Claude Code para diferentes cenários de projeto.


No próximo artigo, 33 "Hooks (Gatilhos de Terminal)"—passaremos para as automações físicas obrigatórias. Enquanto os estilos moldam a conversação dependendo da IA, os Hooks impõem a execução de tarefas locais em eventos específicos (como formatar códigos autonomamente sempre que um arquivo for editado, ou rejeitar comandos inseguros no console). Veremos a sintaxe de desenvolvimento dessas travas técnicas a seguir.


Leitura Recomendada