Estilos de resposta no Claude Code: como alternar e criar o seu próprio estilo

Se dá por si a pedir ao Claude Code, em mensagens alternadas, que «responda de forma mais breve», «explique com mais detalhe» ou «aja como editor, não como programador», pode configurar isso uma única vez. Existe uma definição específica para este efeito: os estilos de resposta, chamados estilos de saída na interface. Um estilo altera o papel, o tom e o formato de cada resposta seguinte até o mudar.

Um estilo altera como o Claude responde, não o que sabe sobre o seu projeto. Pode definir o contexto do projeto no ficheiro CLAUDE.md; consulte o guia separado sobre como personalizar o Claude para si.

Pode encontrar informações sobre como trabalhar com Ailoot na documentação.

O que é um estilo de resposta no Claude Code?#

Normalmente, o Claude Code está configurado como engenheiro: explica os passos em detalhe, planeia alterações e comenta o que está a fazer. Este é o estilo Default — um conjunto de instruções padrão para trabalhar com código.

Um estilo de resposta substitui este conjunto de instruções pelo seu próprio conjunto. Em cada pedido, o Claude Code envia ao modelo as instruções do estilo ativo e, quando está selecionado um estilo diferente de Default, também relembra o Claude desse estilo à medida que a conversa avança. Assim, não precisa de repetir como quer que responda.

Use um estilo quando quiser manter sempre a mesma forma de resposta: respostas mais curtas, explicações ou o papel de revisor de texto ou analista de dados em vez de programador. Se precisar que o Claude se lembre das convenções e da estrutura de um projeto específico, use o ficheiro CLAUDE.md.

Em que difere um estilo de resposta de CLAUDE.md?#

O Claude Code oferece várias formas de influenciar o seu comportamento, e cada uma serve um propósito diferente.

Um estilo define a forma de responder, enquanto CLAUDE.md guarda o contexto do projeto. Não é necessário alterar um para fazer o trabalho do outro.

Que estilos integrados estão disponíveis e quando deve utilizar cada um?#

Proactive. O Claude executa a tarefa de imediato, faz suposições razoáveis perante pequenas incertezas e prefere agir a discuti-las. Este comportamento é mais autónomo do que o modo automático e funciona sem alterar o modo de acesso. O modo de acesso continua a determinar o que pode ser executado sem a sua confirmação: o estilo torna o Claude mais decidido, mas não remove as proteções contra comandos perigosos. Este estilo é adequado quando confia na ferramenta e não quer que pare para pedir esclarecimentos sobre cada pequeno pormenor.

Concise. O Claude começa pelo resultado, omite introduções e descrições do processo e mantém as respostas breves. Faz o trabalho com o mesmo rigor que no estilo Default e, se pedir uma explicação, responderá em detalhe. Os relatórios de erros, os avisos de segurança e as confirmações antes de ações perigosas continuam completos — o estilo não os encurta. Este estilo é adequado quando pretende uma resposta breve e direta.

Explanatory. Enquanto trabalha, o Claude explica por que motivo escolheu uma solução e como está estruturado o código do projeto. As respostas são mais longas do que no estilo Default. Este estilo é adequado quando, além de obter o resultado, quer perceber o que está a acontecer.

Learning. Um modo colaborativo: o Claude não só explica as suas decisões como também deixa no ficheiro pequenos trechos de código assinalados com marcadores TODO(human) para que os escreva. Este estilo é adequado quando quer aprender fazendo e escrever parte do código por si.

Como alternar entre estilos de resposta?#

Poderá encontrar um comando separado para estilos em instruções mais antigas. A documentação fornecida descreve o percurso através de /config.

1. Abra as definições

   /config
   

   Introduza o comando na conversa do Claude Code. O menu de definições será aberto.

2. Selecione Output style

   Encontre a linha Output style no menu e abra-a. Será apresentada uma lista: Default e os quatro estilos integrados, bem como os seus próprios estilos, caso tenha criado algum.

3. Escolha um estilo e continue a trabalhar

   Selecione o estilo pretendido. O Claude Code guardará a sua escolha em .claude/settings.local.json no projeto atual. Na versão 2.1.251 e posteriores, o novo estilo entrará em vigor na mensagem seguinte.

Se estiver a trabalhar na extensão do VS Code, abra o menu com o comando / e escolha Output styles. A sua escolha será guardada no mesmo ficheiro. O menu de estilos da extensão está disponível a partir da versão 2.1.257.

Também pode definir um estilo diretamente no ficheiro de definições, sem utilizar o menu:

{
  "outputStyle": "Explanatory"
}

Como criar o seu próprio estilo de resposta?#

Não precisa de programar para o fazer — basta escrever o estilo em linguagem corrente. O ficheiro é composto por um cabeçalho entre três travessões (metadados) e o texto das instruções abaixo.

O local onde deve colocar o ficheiro depende de onde quer que o estilo esteja disponível:

• ~/.claude/output-styles — o estilo fica disponível em todos os seus projetos.
• .claude/output-styles dentro de um projeto — o estilo fica disponível apenas nesse projeto.

Exemplo de um estilo que pede ao Claude para responder como revisor de textos comerciais em vez de programador:

---
name: Copy editor
description: Reply as a business copy editor, not as a programmer
---

É um editor de textos comerciais. Responda na língua preferida do utilizador, em parágrafos curtos.
Apresente primeiro a versão corrigida e, em seguida, uma lista das alterações com os respetivos motivos.
Não sugira código nem aborde pormenores técnicos, a menos que lhe peçam.

No cabeçalho, name é o nome do estilo que verá no menu /config; se o omitir, será utilizado o nome do ficheiro. description é uma breve explicação que também fica visível no menu.

Existe também o campo keep-coding-instructions. Por predefinição, um estilo personalizado remove as instruções de engenharia integradas no Claude Code — por exemplo, como escrever comentários, verificar o trabalho e limitar as alterações. Se o Claude ainda dever agir como engenheiro ao utilizar o seu estilo de resposta (por exemplo, começar sempre por um diagrama), defina keep-coding-instructions: true no cabeçalho. Se o Claude não trabalhar com código nesse estilo, como no exemplo do revisor de textos, não precisa deste campo.

1. Crie a pasta dos estilos

   mkdir -p ~/.claude/output-styles
   

   Isto disponibiliza o estilo em todos os projetos. Para um único projeto, utilize .claude/output-styles dentro do próprio projeto.

2. Guarde o ficheiro Markdown

   Coloque na pasta um ficheiro como redaktor.md e acrescente-lhe o cabeçalho e as instruções. Pode utilizar o exemplo acima e adaptá-lo à sua tarefa.

3. Escolha o estilo e verifique-o

   Se criou o ficheiro durante uma sessão de terminal, reinicie primeiro o Claude Code. Abra /config, encontre o seu estilo na lista Output style e selecione-o. Dê ao Claude uma tarefa relacionada com o estilo e veja se responde da forma pretendida.

O seu próprio estilo define a forma como a ferramenta responde: descreve-a uma vez e a ferramenta mantém-na a partir daí.

O que não é afetado por um estilo de resposta?#

Um estilo não acrescenta factos ao modelo. Se o Claude não souber algo sobre o seu projeto, mudar o estilo não resolverá o problema — pode fornecer o contexto do projeto através de CLAUDE.md.

Um estilo funciona na conversa principal e na sua ramificação, que herda toda a conversa. Os subagentes — assistentes separados para tarefas especializadas — são executados com a sua própria mensagem de sistema, e o estilo não afeta as respetivas respostas.

Os estilos também podem vir de plugins: um plugin coloca-os na sua própria pasta output-styles. Esse estilo aparece na mesma lista que os seus.

Quantos tokens custa um estilo?#

As próprias instruções do estilo acrescentam tokens de entrada, mas a colocação dos pedidos em cache reduz esse custo após o primeiro pedido de uma sessão. A diferença nos tokens de saída é mais evidente: Explanatory e Learning foram concebidos para produzir respostas mais longas, enquanto Concise as mantém breves. Num estilo personalizado, o consumo de tokens de saída depende do que especificar nas instruções.

Não é possível prometer uma poupança exata — depende das suas tarefas e do modelo. Se quiser respostas mais breves e menos dispendiosas, escolha Concise; se quiser mais detalhe, escolha Explanatory.

O que deve fazer primeiro?#

Abra /config, escolha Concise ou Explanatory e utilize-o numa tarefa habitual. Se der por si a pedir sempre a mesma coisa, crie o seu próprio estilo seguindo os passos acima.

A seguir, sobre este tema: como personalizar o Claude para si através de CLAUDE.md, para que o Claude se lembre do contexto do projeto, e o que escolher no Claude Code: Skills, Subagents, MCP ou Plugins, se quiser conhecer outras formas de o expandir. Se o Claude não conseguir ver os ficheiros de que precisa, consulte porque é que o Claude Code não consegue ver os ficheiros do projeto.

Conheça Ailoot.