Sua primeira conversa com o agente

Abrir o Claude Code na pasta certa

O primeiro passo prático e abrir o terminal já dentro da pasta do projeto em que você quer trabalhar. Isso importa porque o Claude Code enxerga os arquivos a partir de onde ele foi iniciado: se você abrir na pasta certa, ele já tem o contexto do projeto na mão. Com o terminal na pasta certa, digite claude e aperte Enter. A ferramenta inicia e mostra uma linha esperando o seu pedido. Você acabou de abrir uma sessão, ou seja, uma conversa em que o agente vai lembrar do contexto até você sair.

claude
# ou já com um pedido:
claude "explique o que este projeto faz"

Dentro da pasta do projeto, inicie a sessão (e opcional já mandar o pedido junto).

O primeiro pedido e a aprovação

Um bom primeiro pedido e algo simples e sem risco, só para sentir a ferramenta. Pedir uma explicação e ideal, porque não muda nada no projeto: escreva algo como explique o que este projeto faz e por onde eu começaria a estudar. O agente vai ler alguns arquivos e responder em português. Repare que, para só ler e explicar, ele geralmente não precisa da sua aprovação, porque leitura não altera nada. A aprovação entra quando ele quer mudar um arquivo ou rodar um comando que faz alguma coisa.

Quando você pedir algo que exige ação, como corrija este erro, o comportamento muda. O Claude Code vai mostrar exatamente o que pretende fazer, por exemplo a mudança que fara num arquivo, e esperar a sua decisão. Você le com calma e escolhe: aprovar, para ele seguir; recusar, para ele parar ou tentar outro caminho; ou reformular o pedido, se perceber que ele entendeu diferente do que você queria. Essa pausa não é burocracia, e o seu volante. Nos primeiros dias, leia cada aprovação com atenção; e assim que você aprende o que ele faz.

Vale um lembrete do módulo anterior: quanto mais claro o pedido, melhor a conversa. Em vez de conserta ai, prefira o botao de salvar não funciona quando o campo de e-mail esta vazio, investigue e corrija. O agente ganha um alvo e um jeito de saber que terminou. E, como tudo passa pela sua aprovação, um pedido claro também torna mais fácil para você revisar se a ação proposta realmente resolve o que você queria.

Interromper, pedir ajuda e sair

Três controles básicos deixam você a vontade desde o primeiro dia. Para interromper o agente no meio de uma ação, aperte a tecla ESC: ele para e preserva o que já foi feito, sem bagunca. Isso é útil quando você percebe que ele pegou o caminho errado e quer reformular. Para pedir ajuda a qualquer momento, digite barra help e aperte Enter: aparece a lista de comandos disponíveis dentro da ferramenta. E, para encerrar a sessão, digite barra sair, ou use o atalho de sair do terminal; o progresso do seu projeto fica salvo nos arquivos normalmente.

Com esses controles, o receio de não conseguir sair ou de travar a máquina desaparece. Se algo der errado, ESC interrompe; se você se perder, barra help mostra o caminho; se quiser parar, barra sair encerra. Nada disso apaga o seu projeto. A partir daqui, os próximos módulos vao aprofundar cada peca desta primeira conversa: como falar melhor com o agente, como ele decide as ações, como configurar permissões e como dar a ele memória do seu projeto. Você já deu o passo mais difícil, que é o primeiro.