Output styles do Claude Code: os 5 nativos e estilos custom, ilustrado
Quando o modelo fica mais inteligente mas as respostas ficam mais difíceis de ler, não troque de modelo — troque o estilo. Este passo a passo cobre os cinco output styles nativos, a pasta ~/.claude/output-styles, keep-coding-instructions e estilos de time por papel, um screenshot por vez.
TL;DR — output styles num relance
- Um output style remodela como o Claude Code se comunica em cada resposta de uma sessão — papel, tom e formato. Ele muda o system prompt, não o modelo.
- Cinco estilos nativos vêm com o Claude Code: Default, Proactive, Concise, Explanatory e Learning. Troque com /output-style ou /config → Output style.
- Estilos custom são arquivos markdown em ~/.claude/output-styles (usuário) ou .claude/output-styles (projeto). Por padrão eles substituem as instruções de código nativas — coloque keep-coding-instructions: true para mantê-las.
- O movimento de mestre do vídeo: desenhe estilos por audiência usando regras do ASD-STE100 — uma palavra, um significado; frases curtas — para que PMs, tradutores e engenheiros recebam respostas que conseguem ler.
Claude Code Output Styles Made Opus 5 Readable Again
Canal:Eric Tech15:40
Opus 5 Is Exhausting. Anthropic Reveals The Fix.
Canal:Ray Amjad5:56
You Think Claude Got Dumber? You Are Actually Just Missing This Setting
Canal:Gary Chen11:41
Output styles — Claude Code documentation
Docs:code.claude.com
Os frames vêm do deep dive de output styles do Eric Tech; o texto do passo a passo foi escrito de forma independente e verificado contra a documentação oficial de output styles, incluindo a lista de estilos nativos e o comportamento de keep-coding-instructions.
Os screenshots permanecem propriedade de seus criadores e são usados com atribuição como documentação visual. Cada passo tem deep-link para o momento exato do vídeo original.
Mude como o Claude fala, passo a passo
1 · O problema e a solução
- 1
Reconheça o problema: inteligente mas ilegível
O vídeo abre com a reclamação da comunidade em um esboço: os modelos funcionam — a tarefa fica pronta — mas as respostas viraram paredões de jargão. Matt Pocock apontou o mesmo publicamente depois de testar o Opus 5 e não fazer ideia do que ele estava dizendo. Se essa também é a sua semana, a solução não é outro modelo.
“Funciona. Não conseguimos ler.” — a razão de existirem output styles.Assistir em 0:20 - 2
Pegue a solução com uma engenheira da Anthropic
O post da Lydia Hallie é o mecanismo inteiro em duas linhas: ponha as instruções de estilo em ~/.claude/output-styles, rode /config e escolha o estilo. Ela compartilha o favorito dela para navegação pós-trabalho — um estilo “me explique como se eu tivesse 5 anos” que vamos ler por inteiro no próximo passo.
O post original: instruções em ~/.claude/output-styles, depois /config → Output style.Assistir em 2:00 - 3
Leia um arquivo de estilo real de ponta a ponta
Um arquivo de estilo é markdown: frontmatter com name, description e keep-coding-instructions: true — a flag que mantém as instruções de código do Claude em vez de substituí-las — seguido de instruções simples. Este define o contrato para um leitor exausto: palavras pequenas, frases curtas, no máximo duas opções quando houver decisão, e caminhos e comandos exatos porque “não me sobram neurônios para o resto”.
O estilo ELI5: frontmatter mais regras que um humano exausto consegue seguir.Assistir em 2:20
2 · Nativos e seu primeiro estilo custom
- 4
Conheça os cinco estilos nativos
Abra /config → Output style e o Claude Code lista o que vem por padrão, cada um com seu contrato: Default completa tarefas com eficiência e respostas concisas; Proactive executa imediatamente e minimiza interrupções; Concise responde de forma enxuta, começando pelo resultado; Explanatory explica escolhas de implementação e padrões do codebase; Learning faz pausas e pede para você escrever pequenos trechos de código, na prática.
O menu de preferred output style — cada nativo com sua descrição de uma linha.Assistir em 5:20 - 5
Rascunhe um estilo custom com ajuda do Claude
Você não precisa escrever estilos do zero. O workflow do vídeo: quando uma saída te decepciona, peça ao Claude três ou quatro variações da mesma resposta, escolha a que lê melhor, e peça ao Claude para transformar a vencedora em um output style reutilizável salvo na sua máquina.
A receita: saída → 3–4 variações → salve a melhor como estilo.Assistir em 4:20 - 6
Veja onde um estilo custom mora
Aqui vai um real: “Map First”, um estilo que abre cada explicação com um diagrama de arquitetura. O arquivo mora na pasta .claude/output-styles do projeto e tem um symlink para ~/.claude/output-styles para ficar disponível em todo projeto — um padrão elegante para compartilhar estilos com o time pelo repo.
Map First: pasta do projeto como fonte da verdade, com symlink para o diretório do usuário.Assistir em 5:00 - 7
Selecione e faça valer
No /config, filtre por “output” e a setting de Output style está logo ali — trocada para Map First. Definido uma vez, sobrevive a reinícios: sessões novas já abrem falando nesse estilo. Você também pode trocar em pleno voo com /output-style <name>, ou definir um campo “outputStyle” nas settings como padrão entre projetos.
Output style: Map First — defina uma vez, vale para toda sessão seguinte.Assistir em 5:48
3 · Desenhe estilos como profissional
- 8
Saiba a diferença entre estilo e skill
O skill /wait-what do Matt Pocock faz o agente repetir a última mensagem em inglês claro — sob demanda, quando você o invoca. Um output style é o contrato oposto: fica ativo desde o primeiro token de cada resposta, moldando tom e formato sem ser pedido. Skills são ferramentas que você pega; estilos são a voz com que você fala.
/wait-what — um skill roda quando invocado; um estilo fica sempre ativo.Assistir em 6:09 - 9
Roube um padrão de aviação dos anos 1980 para seu estilo
O melhor conselho de escrita de estilos do vídeo vem do ASD-STE100, Simplified Technical English — escrito para que mecânicos de aviação nunca lessem errado um passo de manutenção. As regras: uma palavra tem exatamente um significado, nada de sinônimos (escolha uma palavra aprovada para “iniciar” e fique com ela), frases de instrução abaixo de 20 palavras, e uma ação por frase. Exatamente o contrato que um bom output style precisa.
STE100: um significado por palavra, sem sinônimos, instruções ≤ 20 palavras.Assistir em 6:20 - 10
Distribua estilos por papel
O time da autora publica um estilo por persona, e eles aparecem direto no menu: TPM para project managers técnicos que conhecem APIs, frontend, backend e bancos de dados mas não programam — premissas declaradas, cada decisão apresentada como trade-off com recomendação; Technical Translator para leitores zero técnicos, uma analogia do cotidiano por resposta e operações perigosas atrás de um checkpoint; SDE para engenheiros que querem o rodeio cortado.
O menu cresce: TPM, Technical Translator, SDE — uma voz por papel.Assistir em 6:00 - 11
Troque estilos como troca de modo
Output style: TPM — selecionado no /config e ativo a partir do próximo olá. O retorno, segundo o vídeo: case o estilo com o trabalho (Explanatory quando você está aprendendo um codebase, Proactive para execuções noturnas, Concise quando só quer o resultado) e você recebe respostas que o time todo consegue ler — muitas vezes com menos tokens, porque o estilo proíbe o enchimento.
Output style: TPM — quem não programa no time ganha a própria voz.Assistir em 11:04
Os cinco estilos nativos, com precisão
Segundo a documentação oficial, cinco estilos vêm com o Claude Code — Default mais quatro complementos:
- 1Default — nenhuma instrução de estilo adicionada; o Claude usa o system prompt padrão de engenharia de software. Conclusão eficiente de tarefas, respostas concisas.
- 2Proactive — começa o trabalho de cara e faz premissas razoáveis em vez de perguntar sobre decisões de rotina; ainda confirma antes de ações destrutivas ou que afetam produção.
- 3Concise — respostas começam pelo resultado e pulam preâmbulo, narração e recapitulação. Requer Claude Code v2.1.237 ou mais recente.
- 4Explanatory — adiciona blocos curtos de Insight explicando escolhas de design conforme trabalha (ficam no chat, não são escritos nos seus arquivos).
- 5Learning — os mesmos blocos de Insight, e ainda deixa pequenos trechos de código para você escrever, marcados com um comentário TODO(human), e espera você terminar.
Troque a qualquer momento com /output-style <name> (sem argumento lista todos), via /config → Output style, no menu / do VS Code, ou permanentemente com um campo "outputStyle" nas settings. Um alerta da doc: subagents rodam com os próprios system prompts, então seu estilo molda a conversa principal, não a saída dos subagents.