Aula 02: Como o Claude Code funciona · Claude Code na Prática

🖥️ Versão Desktop. Nesta versão do curso, você usa o Claude Code no app Claude Desktop, na aba Code. Quase tudo é feito por janelas e botões. Quando uma aula pedir para digitar um comando, ela mostra exatamente o que digitar.

Objetivos

Ao final desta aula você vai saber:

O que são o prompt, o modelo e o Claude Code, e como os três trabalham juntos
O ciclo de trabalho do agente, o loop agêntico, e onde acompanhar cada passo no app
Como parar ou corrigir o Claude no meio do trabalho
O que são as ferramentas e a janela de contexto
Os quatro modos de permissão do seletor de modo, e qual usar enquanto você aprende

Três palavras para começar

Prompt é o pedido que você escreve para o Claude, na caixa de mensagem da aba Code. "Crie uma página para a minha confeitaria" é um prompt.
Modelo é a inteligência artificial que lê o seu pedido, pensa e decide o que fazer. A Anthropic tem vários, com nomes como Opus, Sonnet e Haiku, e no app você escolhe no seletor de modelo.
Claude Code é o programa que trabalha no seu computador. Ele leva o seu pedido ao modelo e faz as ações que o modelo decide: abrir um arquivo, criar outro, rodar um programa.

💡 Analogia: na Aula 01, o Claude Code era o cozinheiro na sua cozinha. O modelo é a cabeça desse cozinheiro, que pensa a receita. O Claude Code são as mãos, que pegam os ingredientes e usam as panelas. Um não trabalha sem o outro.

O ciclo de trabalho: o loop agêntico

Quando você manda um pedido, o Claude Code não responde de uma vez só. Ele trabalha num ciclo, que tem até nome técnico: loop agêntico (loop quer dizer ciclo, em inglês).

Você escreve o prompt na caixa de mensagem.
Ele junta informação. Abre os arquivos da pasta, procura o que precisa e entende o que já existe.
Ele age. Cria ou muda um arquivo, ou roda um comando, que é uma instrução para o computador, como "abra esta página".
Ele confere o resultado. O arquivo ficou certo? A página abre? Era isso que você pediu?
Se ficou bom, ele termina e espera o seu próximo pedido. Se não ficou, ele volta ao passo 2 e tenta de novo, até chegar a um resultado que dá para conferir.

Pedido → Juntar informação → Agir → Conferir → Pronto
                 ↑                      │
                 └─── não ficou bom ────┘

Um exemplo: você pede "deixe o botão do WhatsApp verde". Ele abre o arquivo da página e acha o botão (junta informação), troca a cor (age) e confere se a troca ficou no lugar certo (confere). Deu certo? Ele avisa que terminou. Não deu? Ele procura o problema e tenta de novo.

No app, você acompanha o ciclo pela conversa: cada arquivo que ele abre e cada comando que ele roda aparecem como um passo. Normalmente esses passos aparecem resumidos. Se quiser ver todos os detalhes, aperte Ctrl + O até chegar ao modo Verbose (detalhado).

Você pode parar ou corrigir a qualquer momento

Durante todo o ciclo, você pode entrar na conversa de dois jeitos:

Parar na hora: clique no botão de parar, ou aperte Esc. O Claude interrompe o que estava fazendo e espera a sua próxima instrução.
Corrigir sem parar: digite a correção e aperte Enter enquanto ele trabalha, por exemplo: "use tons de rosa". A ação em andamento não é interrompida: o Claude lê a sua mensagem assim que ela termina e se ajusta antes do próximo passo.

Ferramentas: as mãos do agente

A maioria das IAs de chat, como a aba Chat do próprio app, só recebe texto e devolve texto. O Claude Code tem ferramentas: cada ação que ele sabe fazer, como ler um arquivo, criar ou editar outro, buscar na internet ou rodar um comando. São elas que transformam a resposta em trabalho feito.

E quem escolhe a ferramenta é ele. Você não precisa dizer "use a ferramenta de editar": basta dizer o que você quer, e ele decide quando usar cada uma.

💡 E quem digita os comandos? Quase sempre, o próprio Claude, e você vê cada um como um passo na conversa. A Aula 00 mostra o que são os primeiros comandos, para você reconhecer quando eles aparecerem.

A janela de contexto: a memória de trabalho

Tudo o que o Claude lê numa conversa fica guardado na janela de contexto: o que você escreveu, o que tem nos arquivos que ele abriu e as respostas dos comandos que ele rodou. É a memória de trabalho que você conheceu na Aula 01: cabe muito, mas tem limite.

Quando ela está quase cheia, o Claude Code compacta a conversa: resume o que é mais antigo e libera espaço para continuar trabalhando. Isso acontece sozinho. No app, o anel de uso, ao lado do seletor de modelo, mostra quanto da memória a conversa já ocupou. Na Aula 07, você aprende a cuidar dela.

Os modos de permissão

Cada conversa que você abre na aba Code se chama sessão. Em toda sessão, você decide o quanto o Claude pode fazer sem perguntar, no seletor de modo, na linha abaixo da caixa de mensagem. São quatro modos:

Modo	O que ele faz sem perguntar	Bom para
Manual	Só olhar: abrir arquivos e rodar comandos que apenas leem, como listar uma pasta. Para mudar um arquivo ou rodar outro comando, ele pede licença, e você vê o diff (o antes e o depois) de cada mudança para aceitar ou recusar	Quando você está começando, ou mexendo em algo importante
Accept edits (aceitar edições)	Mudar arquivos e fazer tarefas simples com eles dentro da pasta do projeto, como criar uma pasta, mover, copiar ou apagar arquivos. Os outros comandos ainda pedem licença	Quando você já confia no rumo e prefere conferir no fim
Plan (plano)	Só estudar: ele lê os arquivos, pode rodar comandos para explorar e monta um plano. Nada muda até você aprovar	Pedidos grandes, ou para entender uma pasta que você não conhece
Auto	Ler e mudar arquivos na pasta do projeto. As outras ações passam por um segundo modelo, chamado classificador, que revisa cada uma antes de ela acontecer, sem interromper você, para barrar o que não dá para desfazer, o que destrói coisas e o que manda algo para fora do seu computador. Quando algo é barrado, o Claude costuma achar um caminho mais seguro, ou pede a sua licença	Tarefas longas, com menos interrupções

Você pode trocar de modo antes da primeira mensagem ou a qualquer momento: clique no seletor, ou aperte Cmd + Shift + M no Mac (Ctrl + Shift + M no Windows) para abrir o menu. O app lembra o modo que você escolheu para cada pasta. A exceção é o Plan, que vale só para a sessão atual.

O Auto só aparece no seletor quando está disponível: ele exige um modelo compatível, e uma empresa pode desligá-lo para quem usa a conta dela.

Enquanto você aprende, prefira o Manual. Ele pede licença antes de cada mudança, e você vê o que vai acontecer antes de acontecer. Quando ele pedir licença para algo que você não entende, pergunte antes de aceitar: "explique em português simples o que isso faz". A Aula 05 volta a esse assunto.

⚠️ Existe ainda um modo que pula todas as permissões. No app, ele se chama Bypass permissions (pular permissões) e só aparece depois de ser ligado nas configurações. Não ligue. Com ele, o Claude roda os comandos sem pedir licença, e um erro pode virar estrago antes de você conseguir ver.

🔧 Para ir além (para quem já programa; pode pular): para definir o modo das sessões locais novas, use permissions.defaultMode no arquivo de configurações (settings.json); o app lê os mesmos arquivos que o terminal. O claude --permission-mode é da versão terminal e não vale no app. O Bypass permissions só aparece no seletor depois que você liga Allow bypass permissions mode em Settings → Claude Code (nos planos Pro e Max; no Team e no Enterprise, quem decide é a organização), e só faz sentido em contêineres ou máquinas virtuais isolados.

Na prática

Você ainda não instalou o app (isso é na Aula 03). Então este exercício é no papel, e vale a pena: ele te ajuda a pensar como o agente.

Pegue o texto que você escreveu na Aula 01, com a sua ideia.
Imagine que você mandou esse texto como prompt. Anote, em tópicos, o que você acha que o Claude vai fazer em cada etapa do ciclo:
- Juntar informação: o que ele precisa saber? Por exemplo: os doces, os preços e o número do WhatsApp.
- Agir: que arquivos ele provavelmente vai criar?
- Conferir: como ele, ou você, pode saber que ficou certo? Por exemplo: a página abre no navegador e o botão chama no WhatsApp.
Olhe o que você anotou em "juntar informação". O que ele não tem como descobrir sozinho, como os seus preços, é você quem precisa dizer no pedido. Acrescente isso ao seu texto.
Escolha o modo com que você vai começar. A sugestão é o Manual, enquanto você aprende.
Guarde as anotações. Na Aula 03, depois de instalar, você vai mandar o pedido de verdade e comparar com o que o Claude fizer.

Resumo

O prompt é o seu pedido, o modelo é a IA que pensa, e o Claude Code é o programa que leva o pedido ao modelo e faz as ações no seu computador.
Ele trabalha num ciclo, o loop agêntico: juntar informação, agir e conferir, repetindo até ficar pronto. No app, cada passo aparece na conversa.
Você para com o botão de parar ou Esc, e corrige sem parar digitando e apertando Enter.
As ferramentas são as mãos do agente, e ele escolhe sozinho qual usar.
A janela de contexto é a memória de trabalho: tem limite e é resumida sozinha quando enche. O anel de uso mostra quanto dela a conversa já ocupou.
Os modos de permissão (Manual, Accept edits, Plan e Auto, no seletor da linha abaixo da caixa de mensagem) definem o quanto ele faz sem perguntar. O app lembra a escolha para cada pasta, menos o Plan. Enquanto aprende, prefira o Manual, e nunca ligue o Bypass permissions.

Aula 02Como o Claude Code funciona