Conteúdo detalhado
🛡️ Modelo x Ambiente — a armadura do Homem de Ferro
O Claude Code traz a IA para dentro do seu computador, em vez de você só conversar com ela num site. Pense assim: o modelo é o Tony Stark (o cérebro, a inteligência) e o ambiente é a armadura do Homem de Ferro — o corpo que deixa o cérebro ler arquivos, rodar comandos e mexer nas coisas de verdade.
O modelo é a inteligência; o ambiente (ou IDE) é onde essa inteligência age — lendo, executando e criando coisas na sua máquina.
Sem esse conceito, tudo vira mágica confusa. Com ele, você entende por que a mesma IA roda em lugares diferentes e por que escolher o ambiente importa.
Modelo · ambiente · IDE · "uma tarefa, uma janela".
✓ O modelo (Tony Stark)
- ✓É o cérebro: raciocina, escreve, decide.
- ✓Sozinho é genial, mas não age no mundo.
- ✓Você pode trocar de modelo sem trocar de ambiente.
✓ O ambiente (a armadura / IDE)
- ✓Dá "corpo" ao modelo: lê e cria arquivos.
- ✓Executa comandos e conecta outras ferramentas.
- ✓Existem várias "armaduras" — você troca quando quiser.
💡 Não trave no termo "IDE"
IDE quer dizer "ambiente integrado de desenvolvimento". Por enquanto, pense em IDE só como "o lugar onde o assistente trabalha". Nada além disso.
💻 Instalando o Claude Code
Hora de tirar a IA do navegador e colocar na sua máquina. A instalação é o pré-requisito de tudo: sem instalar, não há prática. Um aviso importante antes de começar — o Claude Code exige plano pago; o plano gratuito não o inclui.
Baixar e instalar o aplicativo oficial do Claude Code e conectar sua conta.
É o ponto de partida obrigatório. Tudo que vem depois assume o app instalado e logado.
Instalação · login com a conta Claude · plano pago obrigatório.
Acesse o site oficial
Abra claude.com/claude-code — a fonte oficial da instalação.
Baixe para o seu sistema
Escolha a versão de Windows, macOS ou Linux. Funciona nos três.
Instale e abra o aplicativo
Siga o instalador padrão do seu sistema e abra o app.
Entre com sua conta Claude
Use a mesma conta do site e confirme que ela tem plano pago.
🧭 A interface por dentro
Antes de comandar, conheça a tela. Saber onde fica cada botão evita travar logo no começo: histórico de conversas, seletor de modelo, modo de permissão, indicador de uso e a janela de contexto.
O tour da tela: painel de conversas, seletor de modelo, indicador de uso do plano e a janela de contexto.
Localizar os controles é o que te tira do "não sei nem por onde começar".
Painel de conversas · seletor de modelo · indicador de uso · janela de contexto · microfone · anexar arquivos.
🔎 Onde olhar primeiro
- •O histórico de projetos costuma ficar de um lado da tela.
- •O seletor de modelo e o modo de permissão ficam perto da caixa de digitação.
- •O indicador de uso do plano e do contexto aparece junto ao campo de mensagem.
🔐 Modos de permissão
O modo de permissão controla quanto de liberdade você dá ao assistente — quanto ele pode fazer sozinho, sem te perguntar. É a sua trava de segurança: liberdade demais cedo é receita para sustos.
O controle de quanto o assistente age por conta própria, do mais cauteloso ao mais ousado.
É a diferença entre experimentar com tranquilidade e bagunçar arquivos importantes sem querer.
Quatro modos: perguntar antes · aceitar edições · modo plano · ignorar permissões.
✓ Seguro para começar
- ✓Perguntar antes: confirma cada edição e cada comando. Ideal para projetos desconhecidos.
- ✓Aceitar edições: edita sozinho, mas ainda pede para comandos sensíveis. Recomendado para começar.
- ✓Modo plano: não executa; pensa e propõe um plano primeiro.
✗ Perigoso para iniciantes
- ✗Ignorar permissões: não pergunta nada. Poderoso e perigoso.
- ✗Use só em ambiente isolado, quando souber exatamente o que faz.
- ✗Nunca num computador "de verdade" com dados importantes.
💡 Dica de ouro
Comece em "aceitar edições". É seguro o bastante para ganhar fluidez sem ter que aprovar cada passo, e ainda te protege nos comandos mais sensíveis.
🧠 Janela de contexto e o "apodrecimento"
Imagine uma pessoa genial, de QI altíssimo, mas com amnésia. A janela de contexto é o quanto da conversa o modelo consegue lembrar com precisão. Quanto mais longa a conversa, pior ele lembra — fenômeno chamado de "apodrecimento de contexto" (context rot). Daí a regra de ouro: uma tarefa, uma janela.
O limite de quanto da conversa o modelo lembra bem — e por que conversas longas pioram a qualidade.
Gerenciar contexto separa quem tem resultados confiáveis de quem recebe respostas "confiantemente erradas".
Janela de contexto · tokens · context rot · alucinação · "uma tarefa, uma janela".
📊 Na prática: cuidado com a alucinação
- •O modelo pode alucinar (inventar com convicção) entre ~1% e ~10% das vezes.
- •É pior em conversas longas — quanto mais lotada a janela, maior o risco.
- •Seja protetor do seu contexto: comece nova conversa por tarefa.
Higiene rápida de contexto
/context # vê quanto da janela já foi usada /compact # resume a conversa, preservando o essencial /clear # zera tudo e começa do zero (refresh total)
⌨️ Slash commands e o modo plano
Slash commands são comandos digitados com / que controlam a conversa e o contexto — suas ferramentas de higiene diária. E para tarefas grandes existe o modo plano: o assistente raciocina e propõe um plano antes de executar qualquer coisa.
Comandos rápidos para limpar, resumir, medir e trocar coisas — mais um modo que planeja antes de agir.
Economizam tempo e tokens, e o modo plano reduz erros e retrabalho em tarefas difíceis.
/clear · /compact · /context · /model · /cost · /init · /memory · modo plano · intenção declarada.
Os comandos essenciais do dia a dia
/clear apaga a conversa e começa do zero /compact resume a conversa preservando o essencial /context mostra quanto da janela já foi usada /model troca o modelo em uso /cost mostra uso de tokens e custo da sessão /init pede para o assistente conhecer a pasta/projeto /memory abre e edita os arquivos de memória (CLAUDE.md)
🗺️ O truque que funciona no modo plano
Sempre diga sua intenção real. Algo como: "Minha intenção declarada é X. Estou te pedindo isto porque o que quero que seja verdade é ___." Deixar a intenção explícita melhora muito a resposta.
Indo mais fundo (opcional): /compact vs /clear
Use /clear quando trocar de tarefa por completo — quer uma janela limpa. Use /compact quando ainda está na mesma tarefa, mas a conversa esticou: ele resume o que importa (decisões e objetivo) e libera espaço sem perder o fio. Pequena diferença, grande impacto na qualidade.
Auto-checagem (opcional): você terminou uma tarefa e vai começar outra, bem diferente. Qual comando usar?
✏️ Exercícios
1. Instalação concluída (fácil)
Instale o Claude Code e faça login. Critério: o app abre conectado à sua conta e você consegue enviar uma mensagem.
2. Primeiro arquivo (fácil)
Peça à IA para criar uma pasta com dois arquivos .md (como no exemplo guiado). Critério: a pasta e os dois arquivos existem no computador, com conteúdo.
3. Higiene de contexto (médio)
Inicie uma conversa, rode /context, depois /clear, e rode /context de novo. Critério: você vê o contexto cair para perto de zero após o /clear.
4. Modo plano (médio)
Ative o modo plano e peça um plano para "organizar minha pasta de Downloads" — sem executar. Critério: o assistente devolve um plano em etapas, sem mexer em nada.
5. Intenção declarada (médio)
Refaça o exercício 4 incluindo "Minha intenção declarada é...". Critério: o plano fica visivelmente mais alinhado ao que você quer.
⌨️ Prompts prontos
Agora você já pode rodar estes de verdade. Eles cobrem do primeiro arquivo ao modo plano e à higiene de contexto. O banco completo está na Biblioteca → Prompts.
Seu primeiro comando (cria arquivos)
Crie uma pasta chamada "cafe-gelado" na minha área de trabalho e escreva dois arquivos .md dentro: "por-que-cafe-e-otimo.md" e "por-que-cafe-nao-e-otimo.md". Três frases curtas em cada.
Modo plano, sem executar
Minha pasta de Downloads está bagunçada. Sem executar nada ainda, me devolva um PLANO em etapas para organizá-la por tipo de arquivo. Vou aprovar antes de você agir.
Intenção declarada (canônico)
Minha intenção declarada é: quero entender, não só receber pronto. Me explique o que é a "janela de contexto" do Claude Code em 3 frases simples, como se eu nunca tivesse programado.
Original (EN):
My stated intention is ___. I'm asking you to do this because the thing I want to be true is ___.
Familiarizar com um projeto
Familiarize-se com esta pasta (rode a inicialização) e me diga, em 5 bullets, para que serve este projeto e quais são os arquivos mais importantes.
⚠️ Erros comuns
- ✗Achar que o plano gratuito basta. Não basta — o Claude Code exige plano pago. Sem isso, você instala mas não usa.
- ✗Deixar a conversa virar um monstro. Misturar dez tarefas numa janela só leva ao apodrecimento de contexto. Use
/clearentre tarefas. - ✗Começar em "ignorar permissões". Num computador real, é pedir para apagar ou bagunçar algo. Comece em "aceitar edições".
- ✗Confiar cegamente. O modelo pode alucinar. Revise resultados importantes — principalmente em conversas longas.
- ✗Encher o
CLAUDE.mdde texto. Acima de ~200 palavras começa a poluir o contexto. Seja curto e direto.
✅ Resumo do módulo
Checklist de conclusão
- ☐ Claude Code instalado e conectado à minha conta (plano pago).
- ☐ Entendo a diferença entre modelo (Tony Stark) e ambiente/IDE (armadura).
- ☐ Sei localizar: seletor de modelo, modo de permissão, indicador de uso e janela de contexto.
- ☐ Criei minha primeira pasta e arquivos pedindo à IA.
- ☐ Usei /context, /clear e /compact pelo menos uma vez.
- ☐ Experimentei o modo plano com uma intenção declarada.
- ☐ Sei que "uma tarefa, uma janela" é a regra de ouro.
Próximo módulo:
1.3 — Sistema de memória: como o CLAUDE.md dá contexto duradouro ao assistente