Estilos de saída
Adapte Claude Code para usos além da engenharia de software
Os estilos de saída alteram como Claude responde, não o que Claude sabe. Eles definem o papel, tom e formato de saída do Claude para cada resposta. Use um quando você continua re-solicitando a mesma voz ou formato a cada turno, ou quando você quer que Claude atue como algo diferente de um engenheiro de software.
Um estilo de saída personalizado fornece ao Claude suas próprias instruções e permite que você escolha se deseja manter as instruções integradas de engenharia de software do Claude Code. Mantenha-as quando você está mudando como Claude se comunica, mas ainda está codificando, como sempre responder com um diagrama. Deixe-as de fora quando Claude não está fazendo engenharia de software, como um assistente de redação ou analista de dados.
Para instruções sobre seu projeto, convenções ou base de código, use CLAUDE.md em vez disso.
Estilos de saída integrados
O estilo de saída Default do Claude Code é seu conjunto padrão de instruções, projetado para ajudá-lo a completar tarefas de engenharia de software com eficiência.
Existem quatro estilos de saída integrados adicionais:
-
Proactive: Claude executa imediatamente, faz suposições razoáveis em vez de pausar para decisões rotineiras e prefere ação ao planejamento. Isso é uma orientação de execução autônoma mais forte do que o modo automático aplica, e funciona sem alterar seu modo de permissão, portanto seu modo de permissão ainda decide o que é executado sem perguntar.
-
Concise: Claude começa com o resultado, pula preâmbulo e narração, e mantém respostas curtas por padrão, enquanto faz o trabalho de engenharia tão completamente quanto no estilo Default. Quando você pede uma explicação ou mais detalhes, Claude responde completamente. Claude sempre mantém o conteúdo completo de relatórios de erro, avisos de segurança e confirmações de ações destrutivas. Requer Claude Code v2.1.237 ou posterior.
-
Explanatory: Fornece "Insights" educacionais entre ajudá-lo a completar 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.
Altere seu estilo de saída
Escolha um estilo de uma destas formas:
- Terminal: execute
/confige selecione Output style para escolher um estilo de um menu. Claude Code salva sua seleção em.claude/settings.local.jsonno nível do projeto local. - Extensão VS Code: abra o menu de comandos com
/e selecione Output styles para escolher um estilo, incluindo seus estilos personalizados. Claude Code salva sua seleção em.claude/settings.local.json, o mesmo arquivo que o menu do terminal escreve. Requer Claude Code v2.1.257 ou posterior. - Aplicativo Desktop: defina o campo
outputStyleem um arquivo de configurações, por exemplo.claude/settings.local.json, o arquivo que o menu do terminal escreve. Quando você executa/configlá, 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"
}
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.
Crie um arquivo Markdown
Salve-o em um de três níveis. O nome do arquivo se torna o nome do estilo, a menos que você defina name no frontmatter.
- Usuário:
~/.claude/output-styles - Projeto:
.claude/output-styles - Política gerenciada:
.claude/output-stylesdentro do diretório de configurações gerenciadas
Os estilos de saída do projeto são carregados de cada .claude/output-styles/ entre o diretório de trabalho e a raiz do repositório. Quando mais de um desses diretórios aninhados define um estilo com o mesmo nome, Claude Code usa o mais próximo do diretório de trabalho.
Adicione frontmatter e instruções
Decida se deseja manter as instruções de engenharia de software do Claude Code. Defina keep-coding-instructions: true se você está mudando como Claude se comunica, mas ainda quer que ele codifique da mesma forma. Deixe de fora se Claude não estará fazendo engenharia de software.
Este exemplo lidera cada explicação com um diagrama enquanto mantém o comportamento de codificação do Claude:
---
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.
Mude para seu estilo
Execute /config no terminal e selecione seu estilo em Output style. Claude usa o novo estilo a partir da sua próxima mensagem. No terminal, Claude Code lê arquivos de estilo quando inicia, portanto, se você criar ou editar um durante uma sessão em execução, reinicie Claude Code para aplicar a alteração.
Plugins também podem enviar estilos de saída em um diretório output-styles/.
Frontmatter
Os arquivos de estilo de saída suportam estes campos de frontmatter:
| Frontmatter | Propósito | Padrão |
|---|---|---|
name |
Nome do estilo de saída, se não for o nome do arquivo | Herda do nome do arquivo |
description |
Descrição do estilo de saída, mostrada no seletor /config |
Nenhum |
keep-coding-instructions |
Manter as instruções integradas de engenharia de software do Claude Code | false |
force-for-plugin |
Apenas estilos de saída de plugin: aplique este estilo automaticamente sempre que o plugin estiver habilitado, sem exigir que os usuários o selecionem. Substitui a configuração outputStyle do usuário. Se vários plugins habilitados definirem isso, Claude Code usa o primeiro carregado. |
false |
Como os estilos de saída funcionam
Um estilo de saída altera as instruções que Claude Code fornece ao Claude.
- Claude Code envia as instruções do estilo ativo com cada solicitação.
- Quando você seleciona um estilo diferente de Default, Claude Code também lembra Claude do estilo durante a conversa.
- Os estilos de saída personalizados deixam de fora as instruções integradas de engenharia de software do Claude Code, como como escopar mudanças, escrever comentários e verificar trabalho, a menos que
keep-coding-instructionsseja definido comotrue.
Os estilos de saída se aplicam à conversa principal e a um fork, que herda a conversa completa e o prompt do sistema do pai. Outros subagents executam seu próprio prompt do sistema, portanto os estilos não alteram como eles respondem.
O uso de tokens depende do estilo. As instruções de um estilo adicionam tokens de entrada, embora o prompt caching reduza esse custo após a primeira solicitação em uma sessão.
Os estilos integrados Explanatory e Learning produzem respostas mais longas que Default por design, o que aumenta os tokens de saída. O estilo Concise faz o oposto ao instruir Claude a manter as respostas curtas por padrão. Para estilos personalizados, o uso de tokens de saída depende do que suas instruções dizem ao Claude para produzir.
Comparações com recursos relacionados
Vários recursos personalizam como Claude Code se comporta. Os estilos de saída modificam as instruções padrão do Claude Code e se aplicam a cada resposta. Os outros adicionam instruções sem alterar os padrões, ou os limitam a uma tarefa específica.
| Recurso | Como funciona | Use-o quando |
|---|---|---|
| Estilos de saída | Modifica as instruções padrão do Claude Code | Você quer um papel, tom ou formato de resposta padrão diferente a cada turno |
| CLAUDE.md | Adiciona uma mensagem do usuário após o prompt do sistema | Claude deve sempre saber suas convenções de projeto e contexto da base de código |
--append-system-prompt |
Anexa ao prompt do sistema sem remover nada | Você quer uma adição única passada como um sinalizador CLI no lançamento |
| Agents | Executa um subagente com seu próprio prompt do sistema, modelo e ferramentas | Você quer um auxiliar com escopo separado para uma tarefa focada |
| Skills | Carrega instruções específicas de tarefas quando invocadas ou relevantes | Você tem um fluxo de trabalho reutilizável |
Recursos relacionados
- Settings: onde o campo
outputStylereside e como a precedência de configurações funciona - Permission modes: como o estilo Proactive se compara ao modo automático
- Plugins: empacote e distribua estilos de saída junto com skills, hooks e agents
- Debug your configuration: diagnostique por que um estilo de saída não está entrando em vigor