Como pedir explicação ao Claude em vez de resposta pronta quando você está aprendendo

Terminar a sessão com o código rodando e ZERO entendimento é o pior resultado possível de um dia de estudo

Fala aí, beleza? Se você usa o assistente pra aprender e mesmo assim sai da tela sem saber explicar o que acabou de acontecer, o problema quase nunca é o modelo

É o formato do pedido

Quando você pede "resolve isso pra mim", o modelo entrega exatamente o que foi pedido: a solução mastigada, funcionando, e nenhuma linha sobre o porquê daquele caminho

Aí você copia, colou, funcionou, e no dia seguinte não sabe nem por onde começar de novo 😅

A boa notícia é que existe um jeito de virar essa chave em dois níveis: reescrevendo o pedido (funciona em qualquer conversa) e ligando um modo que PROTEGE esse formato pra você não escorregar de volta

Bora ver na prática?

O que você precisa antes de começar

Antes de sair rodando comando, se liga em onde cada caminho vale, porque produto é produto e menu de um não é instrução do outro

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

• Reformular o pedido: vale em qualquer conversa, em qualquer lugar onde você fala com o modelo. É a parte que não depende de versão nem de botão
• Output style e plan mode: são coisas do Claude Code, no terminal
• Estilo Learning do seletor no campo de chat: esse é do Claude.ai, e a abordagem dele é socrática (em vez de dar a resposta, ele conduz por perguntas)

E tem um aviso de versão importante: o comando isolado /output-style NÃO existe mais no Claude Code

Ele foi descontinuado na v2.1.73 e removido na v2.1.91, então a rota atual é rodar /config e selecionar Output style por lá

Se você achou um tutorial mandando digitar /output-style direto, é material velho, ignora essa parte

Como reescrever o pedido para receber raciocínio, e não solução

Essa é a parte que funciona em qualquer lugar e que quase ninguém faz

A ideia é simples: o modelo responde ao que você pediu, então peça o raciocínio de forma explícita, e não como um enfeite no fim da frase

1. Troque o "me dá o código" pelo "me mostra o caminho até o código"

Compara os dois pedidos:

Pedido mastigado:
Corrige essa função de paginação pra mim

Pedido que devolve raciocínio:
Antes de escrever qualquer código, me explica o que está acontecendo
nessa função de paginação, quais são as opções de correção e o que
muda entre elas

O erro comum deste passo: pedir explicação e código na MESMA frase

Quando os dois cabem no mesmo pedido, a solução vem primeiro, você lê o resto no diagonal e o aprendizado morre ali

2. Peça o raciocínio passo a passo com a instrução explícita

A própria documentação de prompt engineering da Anthropic recomenda incluir a instrução "Think step by step" no prompt

Think step by step antes de responder.
Explica cada decisão que te levou até a resposta final

O erro comum deste passo: achar que "explica bem" ou "caprichado" faz o mesmo trabalho

A recomendação da doc é a instrução explícita, não um adjetivo genérico

3. Separe o raciocínio da resposta final com tags XML

A mesma documentação recomenda usar as tags <thinking> para o raciocínio e <answer> para a resposta final

Think step by step.
Coloca todo o seu raciocínio dentro de <thinking></thinking>
e só a resposta final dentro de <answer></answer>

O ganho aqui é prático: você consegue LER o raciocínio inteiro antes de olhar a resposta, e até tapar a parte do <answer> enquanto estuda

O erro comum deste passo: deixar tudo misturado num texto corrido e depois não conseguir separar o que era pensamento do que era conclusão

4. Peça as alternativas descartadas e o porquê

É o passo que mais ensina, na moral

A solução que apareceu é só uma das que existiam, e o aprendizado mora justamente no que ficou de fora

Lista as alternativas que você considerou e descartou,
e explica o motivo de cada descarte

O erro comum deste passo: aceitar a primeira opção como se fosse a única possível

5. Aceite o custo, ele é declarado

A doc é honesta sobre isso: pedir raciocínio passo a passo traz menos erros em matemática, lógica e análise, deixa a resposta mais organizada e ainda mostra onde o SEU prompt está ambíguo

Mas o custo é uma saída mais longa, com impacto em latência

Ou seja: pra estudar é ótimo, pra resposta relâmpago no meio de um dia corrido nem sempre compensa

Como ligar o modo explicativo no Claude Code (Explanatory, Learning e plan mode)

Reformular o pedido funciona, porém tem um problema: na pressa você esquece e volta pro "resolve isso aí"

O output style existe justamente pra travar esse comportamento por padrão

Que output style? É uma configuração que entra no system prompt da sessão e muda o JEITO que o Claude Code responde durante a tarefa

1. Rode /config e selecione Output style

/config

Lembrando: o comando isolado /output-style foi descontinuado na v2.1.73 e removido na v2.1.91, então é pelo /config mesmo

2. Escolha entre os quatro estilos embutidos

São eles: Default, Proactive, Explanatory e Learning

A diferença prática entre os dois que interessam pra quem está estudando:

• Explanatory: entrega "Insights" educativos sobre escolhas de implementação e padrões do código ENQUANTO completa a tarefa
• Learning: compartilha os mesmos Insights e ainda insere marcadores TODO(human) no código, pra você implementar aquele trecho

O Learning é o modo de aprender fazendo: a tarefa anda, mas uma parte da escrita sobra pra você 😀

3. Saiba onde a sua escolha fica gravada

A escolha feita pelo /config é salva em .claude/settings.local.json (nível projeto local)

E dá pra definir direto pelo campo outputStyle em um arquivo de settings, se você preferir versionar isso em vez de clicar no menu

4. Rode /clear ou abra uma nova sessão

/clear

Esse passo não é frescura: o output style faz parte do system prompt, que é lido UMA vez no início da sessão

O erro comum deste passo (e é o campeão): trocar o estilo e continuar digitando na mesma conversa, achando que já mudou

A mudança só passa a valer depois do /clear ou em uma nova sessão

5. Use o plan mode quando você quer entender antes de qualquer edição

O plan mode pesquisa, lê arquivos, roda comandos de exploração e escreve um plano, sem editar o código-fonte

É o modo mais honesto pra estudar uma base que você não conhece: ele te mostra o caminho e não mexe em nada

São três formas de entrar:

Shift+Tab            (entra ou sai)
/plan <seu prompt>   (vale só pra esse prompt)
claude --permission-mode plan

A barra de status mostra ⏸ plan mode on quando está ligado

E Ctrl+G abre o plano proposto no seu editor de texto padrão, o que ajuda MUITO quando o plano é grande e você quer anotar em cima

Como deixar o modo de estudo permanente: estilo próprio e plugins oficiais

Se você percebeu que estuda desse jeito toda semana, dá pra parar de configurar na mão

1. Crie o seu próprio output style

É um arquivo Markdown com frontmatter, e o lugar onde você salva define o alcance:

~/.claude/output-styles     (vale para todos os projetos)
.claude/output-styles       (vale só naquele repositório)

Se você conhece a lógica de config global versus config de projeto de outras ferramentas, é exatamente a mesma cabeça: o de usuário te segue pra todo lado, o do repositório fica preso ali

Massa pra quando você tem um repo que é só de estudo e outros que são de trabalho

2. Ou use os plugins oficiais, sem slash command nenhum

A Anthropic mantém os plugins explanatory-output-style e learning-output-style, presentes nos repositórios anthropics/claude-code e anthropics/claude-plugins-official

Dá pra dar uma olhada no repositório do learning-output-style pra ver como ele é montado por dentro

Eles usam hook SessionStart e ativam automaticamente no começo de cada nova sessão

O erro comum deste passo: ficar esperando o plugin perguntar alguma coisa a cada sessão

Ele não pergunta, ele já entra ligado, e é esse o ponto

Qual caminho usar em cada situação de estudo

Cada modo resolve uma intenção diferente, então não existe "o melhor", existe o certo pra hora

Um detalhe do lado do Claude.ai: esse comportamento de ensinar em vez de entregar fica no seletor de estilo dentro do campo de chat

É um bom lugar pra estudar conceito solto, e vale lembrar que ali a resposta às vezes vira um artifact em vez de texto, o que muda bastante como você lê o material depois

E o trade-off, pra fechar sem romantizar: Explanatory e Learning produzem respostas mais longas que o Default POR DESIGN, com aumento de output tokens

É o preço de aprender junto, e você decide quando quer pagar por ele

Conclusão

O entendimento não vem do modelo, vem do formato do pedido

Quem pede solução recebe solução, quem pede raciocínio, alternativas descartadas e passo a passo recebe material pra estudar

O output style e o plan mode não fazem mágica nenhuma: eles só PROTEGEM esse formato nos dias em que você está com pressa e ia escorregar de volta pro "resolve aí"

Próximo passo concreto, e é bem simples: pega um problema pequeno que você JÁ resolveu essa semana

Refaz ele em plan mode ou com o output style Learning, sem olhar a solução antiga

Depois tenta explicar em voz alta o que você fez

A diferença entre as duas experiências responde tudo… 🙂

até o próximo post!