Claude Code para iniciantes: como sair do terminal vazio para a primeira sessão?

O que é o Claude Code, e por que ele mora no terminal?

O Claude Code é um agente de programação. Você descreve uma tarefa em português, e ele lê os arquivos do projeto, roda comandos, edita o código e mostra o que fez. Ele não é um chat que devolve um trecho para você copiar: ele age na pasta em que você o abriu.

Existem duas formas de mandar num computador. Apontar, com botões e ícones, é ótimo para descobrir. Escrever é melhor em três coisas: repetir, combinar (a saída de um comando vira a entrada do outro) e guardar (uma ação escrita cabe num arquivo, um clique não cabe em lugar nenhum).

E o agente não tem mãos. Ele não move o seu mouse nem clica no seu botão: tudo o que ele faz na sua máquina é escrever comando e ler o que o comando respondeu. Aprender terminal virou aprender a língua em que você e ele conversam sobre a mesma máquina.

O Claude Code também existe como app para desktop, extensão de editor e na web. O terminal é onde dá para ver, linha por linha, o que ele faz.

Qual é o mínimo de terminal que você precisa saber?

Abra o seu agora. No macOS, Command mais espaço e escreva Terminal. No Windows, procure PowerShell no menu Iniciar. No Linux, Control, Alt e T.

Antes de digitar, olhe a linha que já está na tela, o prompt. Ela diz quem você é, em qual máquina, em que pasta, e termina num $ ou %, que quer dizer que é a sua vez. A pasta é metade da confusão de quem começa: todo comando acontece na pasta em que você está.

pwd
whoami
mkdir teste

O pwd responde o caminho da pasta atual. O whoami responde o seu usuário. O mkdir teste cria uma pasta e não responde nada. Isso assusta no começo e é a melhor notícia do dia: no terminal, silêncio quer dizer que deu certo. Quando ele fala, quase sempre é um destes três:

• command not found: o programa não existe na sua máquina ou ainda não foi instalado. O conserto é instalar, não insistir.
• No such file or directory: não está aqui. Quase sempre você está numa pasta diferente da que imaginava.
• Permission denied: existe, e o sistema não deixa você mexer. É o único dos três em que a pressa custa caro.

O hábito que vale para sempre: leia a linha inteira antes de reagir. Ela é uma frase, não um código.

Onde eu estou? A pergunta que organiza os comandos

O computador guarda tudo numa árvore, com uma raiz, que é uma barra sozinha. O terminal te coloca em um ponto só dessa árvore, e todo comando ou responde onde você está, ou muda essa resposta.

• / no começo: comece pela raiz. É um caminho absoluto, vale de qualquer lugar.
• ~ é a sua pasta pessoal, . é a pasta atual e .. é um galho acima.
• Sem barra na frente, o caminho parte de onde você está. Por isso o mesmo comando funciona numa hora e falha na outra: o ponto de partida mudou.

Os comandos do dia a dia são poucos: ls lista (e ls -la mostra também os arquivos escondidos, como .git e .env), cd entra numa pasta, mkdir cria pasta, touch cria arquivo vazio, cat mostra o conteúdo, cp copia e mv move. Mover para o mesmo lugar com outro nome é renomear.

O Tab completa nomes, e se ele não completa, aquele nome não existe ali. A seta para cima traz de volta o último comando: corrigir a linha anterior é melhor que redigitar um caminho longo.

Monte agora a pasta onde você vai abrir o agente:

cd ~
mkdir projetos
cd projetos
mkdir primeiro
cd primeiro
touch README.md
pwd

O comando rm apaga sem mandar para a lixeira e sem perguntar. Antes de usar, rode ls no mesmo caminho e veja o que sumiria. Quando der, mova para uma pasta de descarte: mover tem volta.

Como instalar e entrar na sua conta?

A instalação leva poucos minutos e tem um comando por sistema. O passo a passo para Windows, macOS e Linux está em como instalar o Claude Code. O teste é sempre o mesmo: claude --version precisa responder um número.

Para usar, você precisa de uma conta paga: em setembro de 2026, a documentação oficial diz que o plano gratuito do Claude não inclui o Claude Code. Vale Pro, Max, Team, Enterprise ou uma conta de API. Quem está começando entra pela assinatura, porque previsibilidade vale mais que otimização. A comparação está em quanto custa o Claude Code.

Como abrir a primeira sessão do Claude Code?

Instalar não é o que trava as pessoas. O que trava é a primeira sessão aberta na pasta errada, pedindo a coisa errada.

A pasta em que você roda o comando é o mundo do agente. Ele lê, busca e edita ali dentro. Isso não é limitação, é a sua cerca. Então entre no projeto primeiro, e só depois chame o Claude Code:

cd ~/projetos/primeiro
claude

Nunca abra na sua pasta pessoal: o mundo dele vira tudo o que você tem no computador, e ele gasta contexto passeando pelos seus downloads. Se o projeto tiver git, melhor ainda, porque fica trivial ver o que ele mudou e desfazer.

O primeiro pedido não deve ser código. Deve ser entendimento. Algo como explique a estrutura deste projeto em dez linhas, ou leia o README e me diga o que falta para rodar. Enquanto ele trabalha, cada linha na tela tem nome: Glob varre os arquivos, Read abre um deles, Grep procura um texto. São as ferramentas dele, uma por linha.

Você aprende duas coisas de uma vez: como ele trabalha e se ele entendeu o seu projeto. Se o resumo estiver errado, você descobriu agora, de graça, antes de deixar ele escrever uma linha.

O que aparece na tela, e como manter o controle?

Ao abrir, o Claude Code mostra a versão, o modelo em uso e a pasta de trabalho. Embaixo fica a linha onde você escreve.

• Esc interrompe o que ele está fazendo sem fechar a sessão. Quanto mais cedo você corta um caminho errado, menos contexto desperdiça.
• Ctrl+C interrompe; com nada rodando, apertar duas vezes fecha o programa. /exit também sai.
• Shift+Tab troca o modo de permissão, que decide o que ele pode fazer sem perguntar.

O modo de permissão merece atenção logo no primeiro dia. No modo Manual, antes de editar arquivo ou rodar comando que muda algo, ele para, mostra o que quer fazer e espera a sua resposta. É o coração do controle. Só que, nos planos Pro, Max e Team, a sessão começa por padrão no modo auto, em que um segundo modelo aprova as ações no seu lugar. Para aprender vendo cada passo, abra no modo Manual:

claude --permission-mode default

Com a sessão já aberta, um Shift+Tab a partir do modo auto leva para o Manual. Cinco comandos cobrem a primeira semana: /help lista tudo, /status mostra versão, modelo e conta, /clear limpa a conversa para uma tarefa nova, /model troca o modelo e /init cria o arquivo de memória do projeto. A lista comentada está em comandos do Claude Code.

Quais são as armadilhas do primeiro dia?

Quase todo mundo cai em duas juntas: abrir o agente na pasta pessoal e pedir algo enorme e vago no primeiro minuto, do tipo cria um app pra mim. O certo é uma pasta pequena, com git, e um pedido que você confere em trinta segundos.

A terceira é de hábito e pega gente experiente: copiar um comando da internet e colar sem ler, principalmente quando ele começa com sudo, que quer dizer faça isso como dono da máquina. O antídoto é simples, e você tem a ferramenta certa aberta: cole o comando e pergunte ao Claude Code o que ele faz, antes de rodar.

Continue lendo

• Como instalar o Claude Code no Windows, Mac e Linux?Instalação do Claude Code no Windows (com ou sem WSL), macOS e Linux, o teste que confirma, o login e a primeira sessão na pasta certa. Atualizado em 2026.
• Claude Code é pago? Preço, planos e limites em setembro de 2026Quanto custa o Claude Code em setembro de 2026: Pro, Max, Team, Enterprise e API, os limites de uso e a conta de tokens que decide o seu gasto.
• Comandos do Claude Code: quais usar e em que momento?Os comandos de barra e atalhos do Claude Code organizados pelo momento de uso: começar, contexto, modelo e esforço, retomar e custo. Atualizado em 2026.