No capítulo anterior, dividimos as ferramentas de coding com IA em 3 tipos e, dentre eles, escolhemos como protagonista deste curso o Claude Code, que permite delegar boa parte da implementação. Neste capítulo, finalmente pomos a mão na massa. Seguindo com cuidado a sequência instalação → execução → login → primeira instrução → aprovar o diff, ponto a ponto onde costuma travar, levamos você até o Claude Code rodando no seu terminal.
A meta é "fazer o Claude Code cumprir a primeira tarefa no seu ambiente"
O que é o Claude Code (revisão do capítulo anterior)
Reafirmando em uma frase, o Claude Code é um "agente de CLI" feito pela Anthropic. Em vez de copiar e colar código num chat de navegador, ele lê, reescreve e executa comandos nos arquivos do projeto e roda testes, diretamente dentro do seu terminal. Basta você dizer em linguagem natural "quero que faça assim" para a IA montar o próprio plano e avançar o trabalho atravessando vários arquivos. É exatamente o parceiro que senta ao seu lado e trabalha junto.
📖 Dois oficiais para ler primeiro. Os passos deste capítulo são um roteiro de iniciação. Os requisitos de sistema exatos, o método de instalação mais recente e os planos de preço, confira sempre na fonte primária — deixar nos favoritos a documentação oficial code.claude.com/docs e a página do produto anthropic.com/claude-code vai lhe servir daqui por diante.
Instalar — a instalação
O Claude Code é instalado e usado em um ambiente Node.js. Não precisa de preparação complicada. Primeiro, deixe prontos os 2 pré-requisitos.
A base que faz o Claude Code rodar. Se ainda não tem, instale a versão LTS pelo oficial nodejs.org. Para checar se já está instalado, rode node -v: se aparecer a versão, está OK.
A tela onde você digita comandos. No macOS é o "Terminal", no Windows o "PowerShell" ou WSL, no Linux o terminal padrão. Basta saber as operações básicas que vimos no capítulo anterior.
Com tudo pronto, digite no terminal a seguinte linha de comando. É só usar o npm (o gerenciador de pacotes que vem com o Node.js) para instalar o Claude Code de modo que fique disponível em todo o sistema.
npm install -g @anthropic-ai/claude-code
O -g significa "instalar globalmente (ou seja, para poder ser chamado a partir de qualquer pasta)". Quando terminar, inicie com o comando a seguir.
claude
⚠️ Se aparecer claude: command not found. A instalação deu certo, mas o comando não é reconhecido — é um tropeço clássico com que os iniciantes esbarram logo de cara. Na maioria das vezes a causa é a configuração de PATH do Node.js/npm, e a solução é bem definida. No artigo "command not found / erro de instalação" reunimos como resolver em cada sistema operacional.
Requisitos de sistema mais específicos, procedimentos recomendados por sistema operacional e métodos alternativos de instalação variam conforme o ambiente. Para as informações mais recentes e exatas, confira sempre a documentação oficial code.claude.com/docs.
Primeira execução e login
Ao iniciar pela primeira vez com claude, será pedido o login (autenticação) com a conta Anthropic. Na maioria dos casos, basta seguir as instruções na tela: o navegador abre, você faz o sign in ali, a autenticação se conclui e você volta ao terminal.
Digite claude no terminal. Na primeira vez, aparece a tela para escolher o método de login.
Seguindo as instruções, faça o sign in na conta Anthropic no navegador. Ao autorizar, a autenticação passa.
Ao voltar ao terminal, aparece a tela aguardando entrada. Essa é a porta de entrada do diálogo. A seguir, dar a instrução.
Para fazer login, há o método de entrar com uma assinatura do Claude que tenha o plano contratado e o método de entrar com uma API key. Como qual está disponível e como surge a cobrança dependem do plano, aqui não afirmamos categoricamente. Confira na documentação oficial o método adequado ao seu contrato.
🔑 Se não conseguir logar ou der erro de autenticação. O navegador não abre, o código colado é rejeitado, o processo trava no meio — a área de autenticação também é um ponto clássico de travamento. Reunimos o tratamento por causa no artigo "erro de login / autenticação". Se mesmo assim não resolver, veja também o Capítulo 5 "Sair dos travamentos", que trata dos travamentos de forma sistemática.
Dar a primeira instrução — o loop básico
Concluída a autenticação, chega a hora do trabalho de verdade. O primeiro ponto importante é iniciar o Claude Code dentro da pasta do projeto em que você quer trabalhar. Como o Claude Code reconhece "a pasta em que você está agora" como alvo do trabalho, errar isso faz você mexer em outro lugar.
cd my-project
claude
Depois, é só dizer em linguagem natural o que você quer que seja feito. Dá para pedir com palavras comuns, como "leia o README e explique o que este projeto faz" ou "adicione um formulário de contato na página inicial". A partir daqui, os 4 passos a seguir se tornam o loop básico que se repete o tempo todo.
Diga em linguagem natural o que quer. Quanto mais concreto (em vez de vago), mais o resultado sai como você pretende.
A IA lê os arquivos relacionados, monta o roteiro do que mudar e como, e começa a agir.
Quais linhas serão reescritas e como aparece em um diff. Verde é adição, vermelho é remoção.
Se você concorda com o conteúdo, aprova e ele é aplicado. Se não, rejeita, diz em palavras a correção e tenta de novo.
O ponto-chave é o "conferir o diff" do LOOP 3. Antes de reescrever o arquivo, o Claude Code mostra primeiro o diff "vou mudar isto aqui assim" e espera pela sua aprovação para aplicar. Ler o conteúdo aqui e julgar se ele bate com a intenção é o papel humano. Como vimos no capítulo anterior, ler o código que sai e distinguir o que é bom do que é ruim é o seu trabalho.
✅ O primeiro movimento vem de "algo pequeno e verificável". Não peça uma reforma enorme de cara; acostume-se com pedidos pequenos, cujo resultado dê para conferir com os olhos, como "explique este arquivo" ou "adicione uma pequena função". Deu certo, amplie aos poucos o que delega — esse é o jeito de não dar voltas.
O jeito de pedir em si (a escolha entre o "vibe coding", que delega de forma solta, e o "desenvolvimento orientado a especificação", que fixa a spec antes de mandar criar) vamos aprofundar com calma no Capítulo 4 "Pedir bem". Por ora, basta conseguir rodar este loop de 4 passos.
O básico dos modos de permissão — delegar com segurança
"A IA não vai apagar arquivos por conta própria nem executar comandos perigosos?" — é uma preocupação legítima. O Claude Code é projetado justamente para isso e funciona de modo a sempre inserir uma confirmação antes de operações com impacto, como editar arquivos ou executar comandos. Isso é o modo de permissão.
O comportamento se divide em alguns níveis. Aqui, vamos apenas captar o conceito, de forma geral.
Pede confirmação a cada edição ou execução de comando. Como você aprova um a um, é o mais seguro. Comece se acostumando com este.
Sem alterar nada de fato, faz apenas o plano de "o que vai fazer". Útil quando você quer fixar a direção antes de um trabalho grande.
Pula as confirmações a cada passo e avança automaticamente um certo escopo de operações. É rápido, mas, como você vê o conteúdo menos vezes, exige cautela.
Modo potente que pula todas as confirmações e executa. O ideal para iniciantes é evitar. Veja as situações de uso e os riscos no aviso abaixo.
💡 "Como confirmar é chato, deixo tudo em bypass" é proibido. O modo que pula todas as confirmações é potente, mas, do outro lado da moeda, não consegue barrar remoções ou execuções de comando indesejadas. Se você quer velocidade com segurança, o caminho correto não é ir direto ao bypass, e sim primeiro montar regras de permissão que autorizem apenas as operações confiáveis. Também existe a opção de "sandbox", que isola o trabalho e o roda com segurança.
Aqui basta guardar que "o Claude Code não sai do controle por conta própria, ele insere confirmações" e "esse comportamento pode ser ajustado pelo modo". Para mais detalhes, você pode aprofundar em artigos e guias dedicados.
As diferenças entre os modos e como alternar estão em modos de permissão explicados a fundo.
Como escrever regras de permitir/negar está em regras de permissão e configurações.
O conceito de sandbox está em introdução ao sandbox.
O básico do CLAUDE.md e das configurações
Ao usar bastante o Claude Code, você começa a sentir que "é chato ter de dar sempre os mesmos avisos". "Use 2 espaços de indentação", "não mexa nesta pasta", "responda em português" — pedir isso toda vez, essas regras comuns ao projeto, é ineficiente.
É aí que entra o CLAUDE.md. Se você deixar na raiz do projeto um arquivo com esse nome, o Claude Code o lê automaticamente ao iniciar e trabalha levando em conta as regras escritas nele. É, por assim dizer, o "manual de instruções deste projeto" que você entrega ao parceiro.
# Sobre este projeto
- Linguagem: TypeScript / Framework: Next.js
- Escrever respostas e comentários em português
- Indentação com 2 espaços
- Não mexer em src/legacy/ e abaixo
- Passar no npm run lint antes de commitar
O ponto é escrever "curto, concreto e só o que você realmente quer que seja cumprido". Se for longo demais ou vago demais, acaba sendo menos cumprido. Comece com algumas linhas e vá acrescentando o que perceber que "estou dizendo toda vez" — é o jeito certo de fazê-lo crescer.
💡 Escreveu no CLAUDE.md, mas ele não cumpre? O comum são casos de regras em excesso, abstratas demais ou contraditórias. Reunimos as causas e como corrigir no artigo "quando as regras do CLAUDE.md não pegam". Conhecer as "dicas para fazê-las valer" estabiliza bastante a precisão da IA.
A configuração não é só o CLAUDE.md. As regras de permissão de antes, a escolha do modelo e diversos comportamentos também podem ser ajustados em detalhe por arquivos de configuração, mas isso fica para depois. Só de "escrever no CLAUDE.md algumas linhas de regras do projeto", a sensação de uso já muda.
- O Claude Code é um agente de CLI feito pela Anthropic. Instale no ambiente Node.js com
npm install -g @anthropic-ai/claude-codee inicie comclaude. - Na primeira vez, faça login (autenticação) com a conta Anthropic. Travou? Vá aos artigos de command not found / erro de autenticação.
- O básico é o loop pedir → planejar → conferir o diff → aprovar. Ler o diff e julgar o que é bom ou ruim é trabalho humano.
- Os modos de permissão evitam que saia do controle. Iniciantes devem evitar o bypass e ampliar o que delegam conferindo cada passo.
- Escrever algumas linhas de regras do projeto no CLAUDE.md faz a IA seguir com mais facilidade.
Com isso, o Claude Code roda no seu terminal e você já consegue confiar a ele a primeira tarefa. No próximo Capítulo 3 "Comparar e escolher entre ferramentas", organizamos as diferenças em relação a companheiros como Cursor, GitHub Copilot e Codex e aprendemos a escolher conforme cada situação.