Output styles no Claude Code: como configurar o jeito que o agente responde sem instalar skill

Fala aí, beleza? Se você já instalou skill de terceiros só pra mudar o tom do Claude Code, se liga: o próprio Claude Code tem um recurso nativo pra isso, sem instalar nada

Ele está ativo e documentado na página oficial de output styles e muda o papel, o tom e o formato das respostas na sessão inteira

Só que esse recurso já foi descontinuado e voltou mais de uma vez, então tudo aqui parte da documentação e do changelog oficial, não de tutorial antigo 🙂

O que é output style no Claude Code e por que o status já mudou?

Um output style é um conjunto de instruções que define o papel, o tom e o formato de resposta do Claude em todas as respostas de uma sessão

A diferença pra um simples "responda assim" no chat: o output style altera diretamente o system prompt do Claude Code

Que system prompt? É o conjunto de instruções base que o agente lê antes de qualquer mensagem sua, tipo o manual de conduta dele 😀

E o histórico é meio montanha-russa, se liga:

• v2.0.30 (31/10/2025): output styles anunciados como descontinuados
• v2.0.32 (quatro dias depois): descontinuação revertida, com a nota "Un-deprecate output styles based on community feedback"
• v2.1.73: o comando avulso /output-style foi descontinuado
• v2.1.91: o comando foi removido, e o /config virou o único caminho interativo
• v2.1.269 (11/09/2026): o /output-style voltou, listando e trocando estilos, inclusive via Remote Control, em sessões na nuvem e outras sessões headless

Conclusão prática: antes de seguir qualquer tutorial sobre o assunto, confira a versão do seu Claude Code

Tutorial escrito entre a v2.1.91 e a v2.1.269 vai te dizer que o comando não existe, e ele existe de novo

Quais são os estilos prontos do Claude Code e o que cada um muda?

Além do Default, que é o system prompt padrão do Claude Code, vêm quatro estilos prontos:

• Proactive: começa o trabalho sem perguntas de rotina, parte de suposições razoáveis e prefere agir a planejar. Faz sentido quando tu já sabe o que quer e não quer ficar respondendo "posso seguir?"
• Concise: abre com o resultado, sem preâmbulo nem narração, e segundo a documentação faz o trabalho com o mesmo cuidado. Bom pra quem cansou do agente contando cada passo que vai dar
• Explanatory: mantém o foco em engenharia de software, mas acrescenta Insights educativos explicando o porquê das escolhas de implementação e dos padrões do código. Massa pra revisar código e entender decisões
• Learning: modo colaborativo em que o Claude compartilha insights e pede que você mesmo escreva pequenos trechos, marcados com TODO(human) no arquivo. Ele explica o que já foi feito, o que tu deve escrever e o que levar em conta

Nenhum desses estilos vem com promessa oficial de economia de tokens ou de resposta melhor, então não espere número mágico aqui

Tome cuidado: o que sai do system prompt

Os estilos que não são o Default deixam de fora as instruções específicas de geração de código e de saída eficiente do system prompt, como responder de forma concisa e verificar o código com testes

Ou seja, trocar de estilo não é só trocar o tom

Você pode estar tirando do agente parte das regras de engenharia que ele seguia por padrão… e isso pesa bastante no estilo customizado, que é o próximo assunto

O que você precisa antes de configurar:

A lista é curta:

• Claude Code instalado. Pra usar o comando /output-style, versão 2.1.269 ou posterior. Em versões anteriores, o caminho é o /config
• Acesso de escrita a ~/.claude/ (se o estilo for só seu) ou ao repositório (se o estilo for do projeto)

Só isso, não precisa de skill, plugin nem nada externo

Como configurar um output style no Claude Code passo a passo

São quatro passos: escolher um pronto, criar o seu, definir o escopo e conferir. Bora ver na prática?

1. Escolha um estilo pronto. Abra o /config e vá em Output style. Na v2.1.269 ou posterior, também dá pra usar o comando:

/output-style
/output-style Explanatory

O primeiro lista os estilos disponíveis, o segundo troca pro estilo informado

A escolha fica gravada no campo outputStyle do arquivo .claude/settings.local.json, que é local do projeto e não vai pro git

Erro comum deste passo: trocar o estilo e esperar que a conversa em andamento mude. O output style faz parte do system prompt, que é lido no início da sessão, então a troca só vale a partir de uma nova sessão

2. Crie um estilo próprio. Um output style customizado é um arquivo Markdown: frontmatter com os metadados e, logo depois, as instruções que entram no system prompt. O frontmatter abaixo é o exemplo da documentação oficial, e o corpo é só um exemplo didático pra tu adaptar:

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

Comece toda explicação com um diagrama simples em texto.
Depois do diagrama, explique em poucos parágrafos.
Use português do Brasil nas respostas.

O keep-coding-instructions: true é o campo que mantém as instruções de engenharia de software do Claude Code

Erro comum deste passo: esquecer o keep-coding-instructions: true quando a ideia era mudar só a forma de comunicar. Sem ele, o estilo cai na regra dos estilos fora do Default e as instruções de engenharia ficam de fora

3. Defina o escopo. Onde tu salva o arquivo decide onde ele vale:

• ~/.claude/output-styles/: escopo de usuário, o estilo fica disponível em todos os seus projetos
• .claude/output-styles/ dentro do repositório: escopo de projeto, pode ser commitado e compartilhado com o time

Erro comum deste passo: achar que commitar o estilo faz o time inteiro usar ele. O arquivo do estilo em .claude/output-styles/ vai pro git, mas a seleção do estilo fica em .claude/settings.local.json, que é local. Cada pessoa escolhe o estilo na própria máquina

4. Faça a checagem final. Abra uma sessão nova, confirme o estilo ativo no /config ou na listagem do /output-style e mande um pedido qualquer

Se o estilo pegou, a forma da resposta muda: no exemplo acima, a explicação deveria abrir com um diagrama

E lembra: output styles afetam só a conversa principal. Se tu usa subagents no Claude Code, eles não herdam o estilo, porque cada subagente começa uma conversa com o próprio system prompt

Output style, CLAUDE.md, –append-system-prompt ou skill: qual usar?

Depende do que tu quer mudar: o comportamento do agente, as regras do projeto ou só uma execução

O ponto que mais confunde: o CLAUDE.md não mexe no system prompt

Ele entra como mensagem de usuário depois dele, então é o lugar certo pra "aqui usamos tal padrão de pasta" ou "rode os testes com tal comando", e não pra mudar a personalidade do agente

Já o --append-system-prompt é o ajuste pontual: acrescenta texto naquela execução e pronto, sem tirar nada do prompt padrão

E a skill?

A skill é a categoria que vem de fora, tu instala no Claude Code pra ganhar um comportamento novo (se quiser entender onde ela se encaixa, tem um post sobre skills, agentes e plugins)

O caso clássico de skill de terceiros que mexe no tom das respostas é o Caveman, que viralizou justamente por isso

A diferença prática é essa: a skill depende de alguém ter escrito e de tu instalar e manter, enquanto o output style já vem no Claude Code, documentado, com estilos prontos e um formato oficial pra criar o seu

Se o que tu quer é só controlar tom e formato, vale olhar o recurso nativo antes de instalar qualquer coisa

Quando o output style é a escolha certa (e quando atrapalha)?

O veredito muda conforme o teu perfil:

• Quer mudar só o tom e manter o jeito de programar: estilo customizado com keep-coding-instructions: true
• Está aprendendo ou revisando código: Explanatory, pros Insights, ou Learning, pra escrever os trechos TODO(human) com as próprias mãos
• Quer menos papo e mais resultado: Concise
• Quer menos perguntas de confirmação: Proactive
• Quer registrar regras do repositório: CLAUDE.md, não output style
• Quer um ajuste numa execução só: --append-system-prompt

E onde ele atrapalha:

• Estilos fora do Default deixam de fora as instruções de engenharia, incluindo coisas como verificar código com testes. Pra quem usa o Claude Code como daily driver de programação, isso não é detalhe
• Subagentes não herdam o estilo, então o tom pode mudar quando a tarefa é delegada
• A troca só vale em sessão nova, não no meio da conversa

Ou seja, é um recurso massa e oficial, mas não é botão de "responda melhor" 😛

Vídeo complementar:

Nesse vídeo do canal tem o Reasonix, um agente de código para o DeepSeek, bora conferir?

Próximo passo: escreva um estilo de cinco linhas e teste numa sessão nova

Confira a versão do teu Claude Code: se for 2.1.269 ou posterior, o /output-style está disponível, senão vai pelo /config

Crie um arquivo .md em ~/.claude/output-styles/ com name, description, keep-coding-instructions: true e umas três linhas de instrução de tom

Abra uma sessão nova, selecione o estilo e mande o mesmo pedido que tu costuma fazer, comparando a forma da resposta com a do Default

Se no meio do caminho tu perceber que o que queria era uma regra do projeto, e não um tom, leva essa regra pro CLAUDE.md

Até o próximo post! 🙂

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.