← Aprenda grátis // tutorial · primeira sessão

Primeiros passos no Claude Code: sua primeira sessão

Você instalou o Claude Code e agora está olhando pro terminal sem saber o que digitar. Normal. A boa notícia: ele não sai mexendo em nada sozinho, toda alteração passa pela sua aprovação. Este guia mostra uma primeira sessão completa, do primeiro comando até sair. Dá pra fazer em uns 10 minutos, com calma.

Antes de começar

• O Claude Code precisa estar instalado e logado. Se ainda não está, comece pelo nosso guia de instalação do Claude Code.
• Escolha uma pasta pra trabalhar. Pode ser um projeto de código, mas não precisa: uma pasta com textos, planilhas exportadas ou arquivos de trabalho também serve. Pra primeira vez, prefira uma pasta que não seja crítica.

Passo 1. Abra o terminal na pasta certa

Esse é o detalhe que mais confunde quem está começando: o Claude Code enxerga a pasta onde você o abre. Abrir na pasta errada é como chamar um consultor pra reunião e deixar os documentos em outra sala.

No terminal, use o comando cd (de "change directory") pra entrar na pasta:

cd caminho/da/sua/pasta

Se você usa um editor como o VS Code, há um atalho: abra a pasta no editor e use o terminal embutido dele, que já abre no lugar certo.

Passo 2. Rode o comando

claude

A primeira tela é simples: uma caixa de texto esperando você escrever. Sem botões, sem menus. Você escreve em português normal, aperta Enter e ele responde ali mesmo.

Passo 3. Primeiro pedido: peça pra ele explicar

Antes de pedir qualquer mudança, deixe ele provar que entendeu onde está. Um primeiro pedido que funciona bem:

Explique o que tem nesta pasta e o que este projeto faz.

Ele vai ler os arquivos e resumir. Nessa etapa nada é alterado, é só leitura. Aproveite pra conferir: a explicação bate com o que você sabe da pasta? Se bater, você já sabe que ele está olhando pro lugar certo.

Passo 4. Peça uma mudança pequena (e revise)

Agora sim, um pedido que altera algo. Comece pequeno e específico:

Corrija os erros de português do arquivo README.md, sem mudar o sentido do texto.

E aqui entra a parte mais importante deste guia: o Claude Code pede permissão antes de mexer. Ele mostra o que pretende fazer, qual arquivo, o que sai, o que entra. E espera você aprovar ou recusar. Esse é o modo de permissão padrão, e no começo é seu melhor amigo.

Crie o hábito desde a primeira sessão: leia a proposta antes de aceitar. Se não entendeu o que ele quer fazer, pergunte. "explique essa mudança antes" é um pedido válido. Recusar também é. Você é quem decide, sempre.

Passo 5. Conheça o /help e saia

Comandos que começam com barra falam com a ferramenta em vez de falar com a IA. O primeiro que vale conhecer:

/help

Ele lista o que está disponível na sua versão. E pra encerrar a sessão, dois caminhos: digite /exit ou aperte Ctrl+C duas vezes. Pode sair sem medo, seus arquivos ficam como estavam na última mudança que você aprovou.

Problemas comuns

"Ele não achou meu projeto"

Quase sempre você abriu o terminal numa pasta diferente da que imaginava. Digite pwd (Mac e Linux) pra ver em que pasta você está, saia com /exit, use cd pra ir ao lugar certo e rode claude de novo.

"Tenho medo de ele quebrar alguma coisa"

Esse medo é saudável, e é por isso que o padrão da ferramenta é perguntar antes de cada alteração. Enquanto você não aprovar, nada muda. Se a pasta for um projeto com Git, melhor ainda: todo o histórico fica guardado e dá pra voltar atrás. Na dúvida, comece numa pasta de teste.

"A resposta veio errada ou fora do que pedi"

Acontece, e não é sinal de que você errou. É uma conversa: diga o que ficou errado e o que você esperava, com mais contexto. Pedidos específicos ("corrija só o título do arquivo X") funcionam melhor que pedidos vagos ("melhore tudo").

Próximo passo

Sessão feita, primeira mudança aprovada. Você já saiu do zero. O caminho agora é repetir esse ciclo em tarefas reais do seu dia: pedir, revisar, aprovar. Ainda não instalou? Os guias de instalação do Claude Code e de instalação do Codex estão aqui do lado.

// continue daqui

Quer saber por onde começar no seu caso?

Cada pessoa chega num ponto diferente. O nosso diagnóstico gratuito leva 2 minutos e indica o próximo passo pro seu momento. E se você quer aprender com método, as Formações da Xentory estão chegando.