SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Estilos de saída do Claude Code: como funcionam

Entenda como os 5 estilos predefinidos alteram cada resposta, o transcript no SSH e como a mudança passou a valer na mensagem seguinte na v2.1.251.

Qual é o funcionamento dos estilos de saída no Claude Code

Um estilo de saída no Claude Code é um bloco de instruções que o Claude Code adiciona ao que envia ao Claude em cada solicitação. Ele muda a forma como o Claude responde: o papel que assume e o formato do que imprime. Ele não ensina nada ao Claude sobre a sua base de código e não pode dar ao Claude permissão para executar qualquer coisa.

O Claude Code disponibiliza cinco estilos integrados. A sua escolha fica armazenada na chave de configurações outputStyle. No Claude Code v2.1.251 ou posterior, um estilo que você altera no meio de uma sessão passa a valer a partir da sua próxima mensagem. Da v2.1.73 até a v2.1.251, a alteração era salva e depois ignorada até você limpar a sessão com /clear; esse fato explica grande parte da confusão que ainda aparece nos guias mais antigos sobre esse recurso.

Em um VPS, isso vai além de uma preferência estética. A transcrição é o que você lê por meio de uma conexão SSH (secure shell), normalmente dentro de uma janela do tmux. Portanto, cada linha narrada pelo Claude é uma linha que você espera e uma linha em um buffer de rolagem de tamanho fixo.

Onde fica a configuração outputStyle

Escolha um estilo no menu /config, em Output style. O Claude Code grava sua escolha em .claude/settings.local.json no projeto em que você está trabalhando.

O comando /output-style faz o mesmo a partir do prompt. Execute /output-style concise para trocar de estilo ou /output-style sem argumentos para listar os estilos e ver qual está em uso. Ele grava no mesmo arquivo .claude/settings.local.json, não diferencia maiúsculas de minúsculas e também funciona no modo não interativo. O comando descrito aqui foi introduzido no Claude Code v2.1.269. Um comando /output-style mais antigo já existia na v2.0.30 e foi descontinuado na v2.1.73 em favor de /config. Por isso, uma build entre essas duas versões pode não se comportar como descrito nesta página. Verifique qual versão está em execução antes de seguir qualquer guia, inclusive este. As versões desta página foram verificadas em outubro de 2026.

claude --version

Você também pode definir a chave manualmente. Quatro arquivos de configurações podem armazená-la, e o arquivo mais específico tem precedência sobre o mais abrangente.

  • ~/.claude/settings.json é o arquivo do usuário. Ele se aplica a todos os projetos nessa máquina.
  • .claude/settings.json é o arquivo do projeto. Ele é commitado no git, portanto se aplica a todos que clonarem o repositório.
  • .claude/settings.local.json é o arquivo local do projeto. Ele não é commitado e substitui os dois arquivos anteriores. É nesse arquivo que o menu /config e o comando /output-style gravam.
  • As configurações gerenciadas, implantadas por uma equipe de TI a partir de um caminho do sistema como /etc/claude-code/ no Linux, substituem todas as outras.

O valor da chave é o nome do estilo:

{
  "outputStyle": "Concise"
}

O valor diferencia maiúsculas de minúsculas. Escreva os nomes integrados como Proactive, Concise, Explanatory e Learning. Um valor que não corresponda exatamente a um nome de estilo, como concise, seleciona silenciosamente o estilo Default.

Para uma única sessão, passe a mesma chave na linha de comando. A flag --settings aceita um caminho ou uma string JSON embutida, e os valores dela substituem as mesmas chaves nos arquivos de configurações do usuário, do projeto e local durante essa execução. As configurações gerenciadas ainda têm precedência:

claude --settings '{"outputStyle": "Concise"}'

A documentação lista quatro formas de escolher um estilo, e apenas duas delas exigem uma versão mínima. O menu /config no terminal não exige nenhuma versão mínima. O comando /output-style, no formato atual, exige a v2.1.269, e o menu Output styles na extensão do VS Code exige a v2.1.257. No aplicativo Desktop, você define o campo outputStyle em um arquivo de configurações. A chave outputStyle não exige uma versão mínima, portanto é a opção mais confiável. Quando uma captura de tela de qualquer guia deixar de corresponder ao que você vê, defina a chave diretamente e confirme com /status, que lista as fontes de configurações em vigor.

Quando um novo estilo de saída entra em vigor

No Claude Code v2.1.251 ou posterior, um estilo que você altera durante a sessão, pelo comando, pelo menu ou pelo ficheiro de definições, aplica-se a partir da mensagem seguinte. Não é necessário limpar. Da v2.1.73 até à v2.1.251, a sessão em execução mantinha o estilo com que tinha começado, e o novo só era carregado no próximo /clear ou no próximo arranque.

No terminal, o Claude Code lê os ficheiros de estilo quando arranca. Portanto, se criar ou editar um ficheiro de estilo personalizado enquanto uma sessão estiver em execução, reinicie o Claude Code antes de o selecionar. No VS Code v2.1.261 ou posterior, o assistente Build a custom style no menu Output styles cria o ficheiro e apresenta imediatamente o novo estilo. Numa build desse intervalo mais antigo, ou depois de reiniciar devido à edição de um ficheiro de estilo no terminal, estes dois comandos deixam o ambiente limpo e mostram o que foi carregado:

/clear
/context

/context mostra o que está atualmente a ocupar a janela de contexto, dividido por categoria, incluindo o system prompt. Execute-o numa sessão nova com cada estilo; a linha do system prompt será o lado de entrada da comparação. É também a forma mais rápida de confirmar que um estilo personalizado foi carregado. Para uma visão mais ampla do que preenche essa janela, consulte como o contexto se preenche numa sessão longa do Claude Code.

O caching explica este comportamento. A API atende pedidos repetidos a partir de uma prompt cache que coincide com o início de cada pedido, e o system prompt fica logo no início. Reescrevê-lo durante a conversa invalidaria tudo o que vem depois, fazendo com que o turno seguinte tivesse de processar novamente todo o histórico como entrada nova. As builds da v2.1.73 até à v2.1.251 evitavam esse custo fixando o estilo no início da sessão. As builds atuais enviam as instruções do novo estilo como uma mensagem na conversa. Assim, o pedido após a alteração continua a ler o system prompt e a conversa anterior a partir da cache. De qualquer forma, mudar de estilo tem um custo reduzido.

O que cada estilo de saída integrado altera na transcrição

  • Default é o prompt de sistema normal do Claude Code, escrito para trabalho de engenharia de software.
  • Concise começa pelo resultado. Remove o preâmbulo e a narração passo a passo, e mantém as respostas curtas até pedir mais detalhes. O trabalho de engenharia subjacente não é alterado. Nunca encurta um relatório de erro ou um aviso de segurança e continua a pedir confirmação completa antes de uma ação destrutiva. Este estilo requer o Claude Code v2.1.237 ou posterior.
  • Explanatory adiciona "Insights" educativos entre as etapas de uma tarefa, explicando por que uma decisão de implementação foi tomada e que padrão a sua base de código já utiliza. A transcrição fica deliberadamente mais longa.
  • Learning vai mais longe. O Claude partilha esses insights e depois pede-lhe que escreva pequenas partes do código, marcando cada ponto com um comentário TODO(human) no ficheiro.
  • Proactive faz o Claude agir em vez de perguntar. Permite que tome decisões razoáveis em tarefas rotineiras, em vez de parar para pedir confirmação.

Leia essa última opção com atenção, porque é a mais frequentemente interpretada de forma errada. Proactive é uma orientação no prompt de sistema. Altera aquilo que o Claude tenta fazer. O modo de permissões continua a decidir o que é efetivamente executado sem lhe perguntar. Esta é a configuração relevante num servidor que fica a executar tarefas sem supervisão. Isto é explicado em modo automático e modos de permissões do Claude Code.

Como um estilo de saída difere de CLAUDE.md, de um hook e de um subagente

Todas estas opções parecem instruir o Claude sobre como deve comportar-se, mas atuam em camadas diferentes.

  • Um estilo de saída faz parte das instruções que o Claude Code envia com cada pedido. Aplica-se a todas as respostas na conversa principal.
  • O CLAUDE.md é adicionado como uma mensagem do utilizador depois do prompt do sistema. É onde devem ficar as convenções do projeto e os factos sobre a base de código.
  • O --append-system-prompt acrescenta texto ao prompt do sistema para uma única invocação, sem remover nada. É a versão pontual de um estilo de saída.
  • Um hook é um comando shell que o Claude Code executa quando ocorre um evento. É aplicado pelo harness, por isso é executado independentemente de o Claude o ter escolhido ou não. Consulte o que um hook do Claude Code pode e não pode fazer.
  • Um subagente é executado com o seu próprio prompt do sistema e o seu próprio conjunto de ferramentas.

Um teste simples permite escolher entre as duas primeiras opções. Os factos sobre o seu projeto devem ficar no CLAUDE.md, porque o Claude precisa de os conhecer. A formulação deve ficar num estilo de saída, porque diz respeito à forma como a resposta é apresentada. Tudo o que tiver de acontecer sempre, independentemente da decisão do modelo, deve ser um hook. A camada em que cada opção atua é uma propriedade de o programa que executa o modelo, não do próprio modelo. Por isso, um estilo só pode influenciar, enquanto um hook pode impor.

Os estilos de saída aplicam-se apenas à conversa principal. Um subagente não herda o seu estilo, porque inicia a própria conversa com o seu próprio prompt do sistema. Uma bifurcação da conversa atual é a exceção, porque herda exatamente o prompt do sistema da conversa principal. Se um subagente escrever de uma forma que não lhe agrada, edite o ficheiro desse agente, não o seu estilo. Uma segunda sessão do Claude Code no mesmo sistema segue o mesmo limite e lê os próprios ficheiros de configuração no arranque. Assim, quando passa trabalho para outra sessão em execução ao lado da sua, as respostas regressam no estilo carregado por essa sessão, não no seu.

Como escrever o seu próprio estilo de saída

Um estilo de saída personalizado é um ficheiro Markdown com frontmatter. Guarde-o no seu diretório pessoal para o utilizar em todos os projetos ou dentro do repositório para o manter junto do código. O diretório do utilizador é ~/.claude/output-styles/ e o diretório do projeto é .claude/output-styles/.

mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---

Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.

Do not narrate what you are about to do. Report what you did.

When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOF

Inicie uma sessão e abra /config. O seu estilo aparece na lista Output style, com a descrição que escreveu. Se não aparecer, o ficheiro não está a ser lido: verifique o caminho e reinicie o Claude Code se a sessão já estava em execução quando guardou o ficheiro. Se aparecer com o nome do ficheiro e sem descrição, o frontmatter não foi analisado corretamente, e claude --debug mostra o erro de análise. O nome do ficheiro torna-se o nome do estilo, exceto se o frontmatter definir name. Por isso, este estilo chama-se Terse ops e não terse-ops.

Selecione-o ou defina a chave com esse nome exato, mantendo as mesmas maiúsculas:

{
  "outputStyle": "Terse ops"
}

Um campo determina se o seu ficheiro é um ajuste ou uma substituição. keep-coding-instructions assume false por predefinição. Isso significa que um estilo personalizado remove as instruções incorporadas de engenharia de software do Claude Code e funciona apenas com o seu texto. Essas instruções incorporadas dizem ao Claude como delimitar uma alteração e como verificar o trabalho realizado. Omita o campo para um assistente de escrita ou um analista de dados, quando essas instruções não se aplicam. Defina-o como true para qualquer caso que ainda envolva código. Caso contrário, poderá perguntar-se por que motivo um engenheiro cuidadoso deixou subitamente de verificar o próprio trabalho. Apenas o prompt de sistema completo do Claude Code contém essa secção. Por isso, num prompt de sistema mais curto, o campo não tem efeito. Definir a variável de ambiente CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT como 0 seleciona o prompt completo em qualquer modelo. Se o objetivo real não for uma voz diferente, mas uma definição mais rigorosa da quantidade de trabalho que uma tarefa exige, isso deve ficar nas instruções de engenharia e não no ficheiro de estilo: a skill Ponytail é um exemplo prático, com uma única regra que orienta um agente para a alteração mínima que funciona.

description é a linha que o seletor /config mostra junto ao nome. Escreva-a pensando no momento em que, daqui a seis meses, estiver a escolher entre dois dos seus próprios estilos.

Porque o estilo conciso é diferente através de SSH

Num VPS, lê a transcrição através de camadas que um terminal local não tem, e cada camada penaliza a verbosidade.

O scrollback é o primeiro. No tmux, cada painel mantém um número fixo de linhas, definido por history-limit, cujo valor predefinido é 2000. Uma transcrição narrada preenche esse buffer mais depressa, por isso a parte inicial da sessão é removida mais cedo e o output que queria consultar deixa de estar disponível no scrollback. Aumente esse valor se precisar de mais espaço:

echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.conf

Os painéis criados depois disso mantêm 20000 linhas cada, com o custo de memória por painel. No tmux 3.7 ou posterior, alterar history-limit também atualiza os painéis já abertos; as versões mais antigas aplicam a alteração apenas aos painéis novos. Se ainda estiver a criar o layout da sessão, executar Claude Code dentro do tmux num VPS explica como fazê-lo.

A latência é a segunda. A resposta é transmitida para o terminal à medida que é gerada. Numa ligação com um tempo de ida e volta elevado, um preâmbulo longo é tempo passado a observar o texto a chegar antes de a resposta aparecer.

Os tokens de output são o terceiro. Cada linha narrada é contabilizada como output. Explanatory e Learning são mais longos por conceção. Concise é mais curto por conceção, porque instrui o Claude a manter as respostas curtas por predefinição.

Não confie numa percentagem apresentada por outra pessoa, incluindo nesta página. A dimensão da diferença depende dos seus prompts, do seu modelo e do trabalho que pede, por isso faça a sua própria medição antes e depois. Execute a mesma tarefa real em duas sessões novas, uma com Default e outra com Concise, e compare os resultados. Uma statusline é o medidor mais simples, porque o Claude Code fornece ao seu script um objeto JSON através de stdin que já contém o nome do estilo, os tokens de output da resposta mais recente e uma estimativa acumulada do custo da sessão:

cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.sh

Aponte a definição statusLine para esse script:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

A barra na parte inferior da sessão mostra agora o estilo ativo, o tamanho da resposta mais recente e o custo estimado da sessão até ao momento. out cobre apenas a resposta mais recente, por isso mostra quantos tokens de output tem cada resposta. cost acumula os valores, por isso o número no final de cada execução é a sua comparação antes e depois. Consulte-o antes de limpar a sessão, porque o custo é reposto para $0 quando /clear inicia uma sessão nova, e trate-o como uma estimativa, não como o valor da fatura. O script precisa de jq, o parser JSON da linha de comandos, por isso instale-o primeiro com sudo apt install -y jq. Se a barra continuar vazia, execute o script manualmente e envie-lhe algum JSON através de pipe, porque uma statusline que termina com um código diferente de zero não imprime nem comunica nada. Uma statusline personalizada do Claude Code apresenta os restantes campos desse objeto. Para a parte da faturação, em vez da parte da sessão, leia para onde vão realmente os tokens do Claude Code e as ferramentas que acompanham os gastos do Claude Code.

Como verificar qual é o estilo de saída efetivamente carregado

Use estas verificações em vez de tentar adivinhar.

  • /status lista as fontes de definições em vigor nesta sessão, incluindo se estão a ser usadas definições geridas por uma organização.
  • /context mostra o system prompt carregado como uma categoria na análise da janela de contexto.
  • claude doctor, executado a partir da shell sem iniciar uma sessão, mostra diagnósticos da instalação e das definições e identifica os ficheiros de definições inválidos.

Quando um estilo não é aplicado, a causa quase sempre é uma de duas. A primeira é o momento da alteração: numa build da v2.1.73 até à v2.1.251, uma alteração durante a sessão aguarda /clear; no terminal, um ficheiro de estilo criado ou editado durante a sessão aguarda um reinício. A segunda é a precedência: .claude/settings.local.json substitui .claude/settings.json, e ambos substituem ~/.claude/settings.json. Como o seletor /config e o comando /output-style escrevem no ficheiro local, um estilo que a sua equipa guardou em .claude/settings.json é silenciosamente substituído em qualquer máquina onde alguém tenha usado um deles. /status informa quais ficheiros foram carregados, mas não qual deles forneceu a chave. Por isso, abra cada ficheiro listado e procure outputStyle.

Um erro de sintaxe JSON tem o mesmo sintoma, mas exige uma correção diferente. claude doctor indica o ficheiro que não conseguiu analisar. Vale a pena executá-lo antes de procurar uma causa mais complexa. Um valor com capitalização incorreta, como explanatory, é JSON válido e, ainda assim, apresenta o estilo Default. Verifique também as maiúsculas e minúsculas.

FAQ

Porque é que o comando /output-style deixou de funcionar?

Numa build atual, isso não aconteceu. /output-style lista os estilos e /output-style concise muda para um deles. O comando tem uma lacuna no seu histórico: a v2.1.73 marcou-o como obsoleto em favor de /config, e a v2.1.269 adicionou a forma atual /output-style [name]. Portanto, numa build entre essas duas versões, ele pode não funcionar conforme descrito aqui. Execute claude --version para ver a versão instalada. Em qualquer build, pode selecionar o estilo em /config, em Output style, ou definir a chave outputStyle num ficheiro de definições. A documentação não indica uma versão mínima para essa chave. Por isso, definir a chave diretamente é a instrução que vale a pena registar nas suas próprias notas.

Alterei o meu estilo de saída e nada aconteceu. Porquê?

Verifique primeiro a versão. No Claude Code v2.1.251 ou posterior, um estilo alterado durante a sessão aplica-se a partir da mensagem seguinte. Da v2.1.73 até à v2.1.251, a alteração era guardada, mas só era aplicada depois de /clear ou numa sessão nova. No terminal, um ficheiro de estilo personalizado criado ou editado durante a sessão requer um reinício, porque o Claude Code lê os ficheiros de estilo quando arranca. Se continuar sem ser aplicado, confirme que o valor corresponde exatamente ao nome do estilo, incluindo as maiúsculas e minúsculas. Depois, execute /status para ver quais ficheiros de definições foram carregados, uma vez que .claude/settings.local.json substitui .claude/settings.json e ambos substituem ~/.claude/settings.json.

O estilo de saída Concise reduz os custos?

Ele reduz os tokens de saída no sentido esperado, porque instrui o Claude a manter as respostas curtas por predefinição. O valor exato depende dos seus prompts e do seu modelo. Por isso, trate qualquer percentagem publicada como uma medição do trabalho de outra pessoa. Faça a sua própria medição: execute /context numa sessão nova com cada estilo para avaliar o lado da entrada. Depois, execute a mesma tarefa com cada estilo e compare os tokens de saída e o custo estimado. O Concise nunca encurta um relatório de erro nem um aviso de segurança. Assim, as partes que mais precisa de ler permanecem completas.

Um estilo de saída altera a forma como os meus subagents escrevem?

Não. Os estilos de saída aplicam-se apenas à conversa principal, porque um subagent inicia a sua própria conversa com o seu próprio system prompt e o seu próprio conjunto de ferramentas. Um fork da conversa atual é a exceção, porque herda exatamente o system prompt do processo principal. Para alterar a forma como um subagent responde, edite o ficheiro desse agente.

Um estilo de saída pode permitir que o Claude execute comandos sem pedir confirmação?

Não. Um estilo de saída é texto no system prompt, portanto só pode influenciar aquilo que o Claude tenta fazer. O estilo Proactive faz com que o Claude assuma mais decisões e atue em vez de parar perante decisões rotineiras, mas continua sem poder aprovar um comando. O modo de permissões determina o que é executado sem pedir confirmação. É essa a definição que deve verificar antes de deixar uma sessão em execução num servidor.

Este artigo foi útil?