Como instalar o Claude Code do zero
Esse guia escrito acompanha o vídeo. Se você nunca programou, é aqui que você começa, com as 4 decisões que ninguém te avisa antes e os 7 passos práticos pra ter o Claude Code rodando no seu computador hoje. Comandos prontos pra copiar, sem assumir que você sabe o que é terminal.
00Antes de começar: as 4 decisões críticas
A maioria dos tutoriais pula essa parte e te joga direto no comando de instalação. Pra não-programador, isso é problema. Sem essas 4 escolhas no lugar, você instala, fica confuso, gasta dinheiro errado e abandona. Lê com calma, decide cada uma, depois parte pros passos.
O Claude Code roda no terminal, mas o terminal pode estar dentro de várias coisas. Pra não-programador, isso é a primeira bifurcação que confunde. As 3 opções práticas:
O Claude Code funciona nos 3, mas no Windows tem uma escolha extra: rodar nativo ou rodar dentro do WSL (Linux dentro do Windows). Cada uma tem trade-off.
Essa é a decisão que mais queima dinheiro de quem escolhe errado. Existem 2 caminhos de cobrança:
Quando o Claude Code rodar pela primeira vez, ele vai pedir permissão pra TUDO: ler arquivos, criar arquivos, rodar comandos. Existem 3 modos de permissão:
passo 01Instalar o Node.js
O Claude Code é distribuído via npm, que vem junto com o Node.js. Sem Node, sem Claude Code. É um download e instalador padrão. Não precisa entender o que é Node pra usar.
O que fazer
- Abre nodejs.org
- Baixa a versão LTS (a verde, que diz "Recommended For Most Users")
- Roda o instalador. Próximo, próximo, finalizar (pode aceitar tudo padrão).
- Pra confirmar que instalou, abre o terminal e roda:
node --version
# deve mostrar algo tipo: v20.18.1
passo 02Instalar o VSCode
Conforme decidimos na Decisão 01, vamos rodar o Claude Code dentro do VSCode. É grátis e tem terminal embutido. Você não precisa de outro programa.
O que fazer
- Abre code.visualstudio.com
- Baixa pra seu sistema operacional
- Instala (próximo, próximo, finalizar)
- Abre o VSCode
- Cria uma pasta vazia em algum lugar do seu computador (ex:
C:\meus-testes-claudeou~/meus-testes-claude) e abre essa pasta no VSCode (File → Open Folder)
passo 03Instalar o Claude Code
Com Node.js instalado e VSCode aberto, instalar o Claude Code é um comando único.
O que fazer
- No VSCode, abre o terminal embutido: menu Terminal → New Terminal (ou atalho
Ctrl+`no Windows /⌃+`no Mac) - Cola o comando abaixo e dá Enter:
npm install -g @anthropic-ai/claude-code
Vai rodar por 30-60 segundos. No final, sem erros = instalado.
claude --version
# deve mostrar algo tipo: 2.1.x
sudo ao comando: sudo npm install -g @anthropic-ai/claude-code. No Windows, abre o terminal "como administrador" e roda de novo.passo 04Criar conta na Anthropic + escolher plano
Conforme decidimos na Decisão 03, vamos no plano Claude Max $20/mês. Se você prefere outra opção, o caminho é o mesmo, só muda a tela de seleção do plano.
O que fazer
- Abre claude.com
- Cria conta (Google ou e-mail funciona)
- No menu do canto superior, vai em Settings → Plans
- Escolhe Claude Max (o $20/mês cobre o uso pra começar; o $100/mês libera o modelo Opus e mais limites)
- Cadastra cartão de crédito e confirma a assinatura
passo 05Primeira execução + autenticação
Hora de conectar o Claude Code instalado no seu computador com a conta que você criou. É um comando + um clique no navegador.
O que fazer
- No terminal do VSCode (ainda dentro da pasta de testes que você criou), roda:
claude
- Vai aparecer uma tela de boas-vindas. Ele vai te pedir pra autenticar.
- Abre o link que ele mostra (ou ele abre o navegador sozinho)
- Faz login com a mesma conta da Anthropic
- Autoriza o Claude Code a acessar sua conta
- Volta pro VSCode e vai ver a confirmação no terminal
A partir daqui, sempre que você rodar claude dentro de uma pasta, ele inicia o assistente conectado à sua conta.
passo 06Configurar o permission mode
Conforme a Decisão 04, vamos começar no modo ask, onde o Claude pergunta antes de cada ação. Por padrão, ele já vem nesse modo, então normalmente você não precisa mexer em nada.
Como confirmar / mudar
Dentro do Claude Code (depois de rodar claude), você pode mudar o modo de permissão usando os slash commands:
# pra ver o modo atual e configurações: /config # pra mudar pra accept-edits (intermediário): # tecla Shift+Tab dentro do prompt alterna entre modos
bypass-permissions dentro de pasta com arquivos importantes sem backup. Esse modo aceita TUDO sem perguntar: ótimo pra projetos isolados, perigoso no resto.passo 07Seu primeiro teste
Vamos confirmar que tudo está funcionando com uma tarefa simples: criar um arquivo de texto. Se chegou aqui, é um minuto.
O que fazer
- Com o
clauderodando no terminal, digita o pedido abaixo e dá Enter:
Cria um arquivo chamado primeiro-teste.md com o conteúdo
"Meu primeiro teste com Claude Code: funcionou!"
- O Claude vai te pedir permissão pra criar o arquivo. Aceita.
- Vai aparecer o arquivo na barra lateral do VSCode.
- Abre o arquivo pra confirmar que o conteúdo está lá.
Se chegou aqui, parabéns: está oficialmente rodando o Claude Code.
passo 08Checklist final
Antes de seguir pra próxima fase, confirma que tudo abaixo está OK:
Tudo deveria estar funcionando se:
passo 09Próximo passo
Você tem o Claude Code rodando. Próximo nível: ensinar ele a entender VOCÊ: o que você faz, como você fala, o que esperar do canal/empresa/cliente. Isso se faz com um arquivo só, e é o tema do próximo vídeo da série.
O arquivo mais importante no seu Claude Code
O CLAUDE.md é o arquivo que faz o Claude saber quem você é, o que você faz, e como ele deve se comportar. Sem ele, o Claude é genérico. Com ele, ele vira um assistente sob medida.
inscrever pra não perder →