Como Instalar Claude Code: Guia Passo a Passo Completo

Claude Code e um assistente de programacao que roda direto no seu terminal. Ele le seus arquivos, entende o contexto do seu projeto e escreve codigo de verdade. Diferente de chatbots que funcionam no navegador, ele trabalha junto com voce, dentro do seu ambiente de desenvolvimento.

Neste guia, voce vai instalar tudo do zero -- mesmo que nunca tenha aberto um terminal na vida. O processo inteiro leva menos de 15 minutos.

O Que Voce Precisa Antes de Comecar

Antes de instalar o Claude Code, voce precisa reunir quatro coisas. Nada complicado, mas e importante garantir cada uma antes de seguir.

Um computador com macOS, Linux ou Windows

Claude Code roda nos tres sistemas operacionais. No macOS e no Linux, a instalacao e direta. No Windows, ele funciona dentro do WSL (Windows Subsystem for Linux) -- um ambiente Linux integrado ao Windows que a Microsoft oferece gratuitamente. Explicamos como configurar mais abaixo.

Nao importa se seu computador e novo ou antigo. Se ele roda um desses sistemas e consegue abrir um navegador, ele roda Claude Code.

Node.js 18 ou superior

Node.js e o motor que permite rodar programas JavaScript fora do navegador. Claude Code e construido com essa tecnologia. Voce nao precisa saber JavaScript -- pense no Node.js como um pre-requisito silencioso, algo que precisa estar la mas que voce nao vai usar diretamente.

A instalacao e simples e cobrimos cada sistema operacional em detalhe nas secoes seguintes.

Uma conta Anthropic com assinatura ativa

Claude Code exige um plano pago da Anthropic. Ele nao funciona com a versao gratuita do Claude. As opcoes atuais sao:

Pro -- US$ 20/mes. Ideal para comecar e suficiente para a maioria dos projetos pessoais.
Max -- US$ 100/mes ou US$ 200/mes. Para quem usa Claude Code intensivamente, com limites de uso mais generosos.

Crie sua conta em console.anthropic.com antes de prosseguir. O processo de cadastro leva menos de dois minutos.

Um terminal

O terminal (tambem chamado de "linha de comando" ou "shell") e o programa onde voce digita comandos de texto para o computador executar. E a interface que desenvolvedores usam no dia a dia, e e onde Claude Code vive.

Se voce nunca usou um terminal, nao se preocupe. Voce so precisa saber digitar comandos e apertar Enter. Veja onde encontrar o terminal no seu sistema:

macOS: Abra o Finder, va em Aplicativos > Utilitarios > Terminal. Ou pressione Cmd + Espaco, digite "Terminal" e pressione Enter.
Linux: Procure por "Terminal" no menu de aplicativos. Na maioria das distribuicoes, o atalho Ctrl + Alt + T tambem funciona.
Windows: Apos instalar o WSL (explicado abaixo), procure por "Ubuntu" no menu Iniciar.

Instalacao no macOS

1. Instalar Node.js

A forma mais simples e baixar o instalador oficial do site do Node.js.

Acesse nodejs.org
Clique no botao da versao LTS (Long Term Support). Essa e a versao estavel recomendada.
Abra o arquivo .pkg que foi baixado e siga o assistente de instalacao. Clique em "Continuar" ate finalizar.

Para verificar se a instalacao funcionou, abra o Terminal e digite:

node --version

Voce deve ver algo como v22.x.x. Qualquer versao a partir da v18 funciona.

Alem do Node.js, o instalador tambem instala o npm (Node Package Manager), que e a ferramenta que voce vai usar para instalar o Claude Code no proximo passo.

Alternativa com Homebrew: Se voce ja usa o Homebrew (gerenciador de pacotes do macOS), pode instalar com um unico comando:

brew install node

2. Instalar Claude Code

Com o Node.js instalado, rode este comando no terminal:

npm install -g @anthropic-ai/claude-code

Vamos decompor esse comando:

npm -- o gerenciador de pacotes do Node.js (ja vem instalado junto com o Node.js)
install -- o comando para instalar um pacote
-g -- a flag "global", que torna o Claude Code disponivel em qualquer pasta do computador
@anthropic-ai/claude-code -- o nome do pacote oficial da Anthropic

A instalacao pode levar de 30 segundos a alguns minutos, dependendo da velocidade da sua internet.

3. Verificar a instalacao

claude --version

Se aparecer o numero da versao (algo como 1.x.x), a instalacao esta completa. Pode seguir para a secao "Primeira Execucao e Autenticacao".

Instalacao no Linux (Ubuntu/Debian)

1. Instalar Node.js

A versao do Node.js nos repositorios padrao do Ubuntu costuma ser antiga demais para o Claude Code. A maneira mais confiavel e usar o nvm (Node Version Manager), uma ferramenta que gerencia versoes do Node.js.

Primeiro, instale o nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Esse comando baixa e executa o script de instalacao do nvm. Apos a execucao, feche e reabra o terminal para que as alteracoes sejam carregadas.

Agora instale a versao LTS do Node.js:

nvm install --lts

O nvm vai baixar, compilar (se necessario) e configurar tudo automaticamente. Verifique a instalacao:

node --version

Voce deve ver v22.x.x ou similar. Alem do Node.js, o nvm tambem instala o npm.

Vantagem do nvm: Alem de facilitar a instalacao, o nvm resolve automaticamente problemas de permissao que costumam aparecer ao instalar pacotes globais com npm. Se voce nao quiser lidar com erros de permissao depois, use o nvm.

2. Instalar Claude Code

npm install -g @anthropic-ai/claude-code

3. Verificar a instalacao

claude --version

Instalacao no Windows (via WSL)

Claude Code nao roda diretamente no Windows. Ele precisa do WSL (Windows Subsystem for Linux), que cria um ambiente Linux completo dentro do Windows. Parece complicado, mas a Microsoft tornou a instalacao em um unico comando.

1. Instalar o WSL

Abra o PowerShell como administrador. Para isso, clique com o botao direito no menu Iniciar e selecione "Terminal (Admin)" ou "PowerShell (Admin)". Depois, rode:

wsl --install

Este comando instala o WSL 2 e a distribuicao Ubuntu automaticamente. O processo pode levar alguns minutos. Ao finalizar, reinicie o computador.

Apos reiniciar, o Ubuntu vai abrir automaticamente e pedir para voce criar um nome de usuario e uma senha. Escolha algo simples e que voce consiga lembrar -- voce vai precisar dessa senha ocasionalmente para instalar programas.

Importante: Ao digitar a senha no terminal Linux, os caracteres nao aparecem na tela. Isso e normal -- e uma medida de seguranca. Continue digitando e pressione Enter.

2. Instalar Node.js no WSL

A partir de agora, todos os comandos devem ser executados dentro do terminal do Ubuntu (WSL), nao no PowerShell ou CMD do Windows.

Instale o nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Feche e reabra o terminal Ubuntu. Depois instale o Node.js:

nvm install --lts

Verifique:

node --version

3. Instalar Claude Code

npm install -g @anthropic-ai/claude-code

4. Verificar a instalacao

claude --version

Dica para usuarios Windows: A partir daqui, use sempre o terminal do Ubuntu (WSL) para trabalhar com Claude Code. Seus arquivos do Windows ficam acessiveis dentro do WSL pelo caminho /mnt/c/Users/SeuNome/. Porem, para melhor performance, recomendamos criar seus projetos dentro do sistema de arquivos do Linux (em ~/projetos/, por exemplo).

Alternativa: Executar Sem Instalar

Se voce quer apenas testar rapidamente sem instalar globalmente, use o npx:

npx @anthropic-ai/claude-code

O npx baixa e executa o pacote temporariamente. Toda vez que voce rodar esse comando, ele verifica se ha uma versao nova. E util para um teste rapido, mas para uso regular a instalacao global e mais pratica porque inicia mais rapido.

Primeira Execucao e Autenticacao

Com o Claude Code instalado, chegou a hora de conectar sua conta Anthropic. Esse passo so precisa ser feito uma vez.

1. Iniciar o Claude Code

Abra o terminal e digite:

claude

2. Autenticar via navegador

Na primeira execucao, o Claude Code vai exibir uma mensagem pedindo autenticacao. Ele abrira automaticamente o seu navegador padrao na pagina de login da Anthropic.

Faca login com sua conta Anthropic (a que tem a assinatura Pro ou Max)
Clique em "Autorizar" para permitir que o Claude Code acesse sua conta
Volte ao terminal -- ele ja estara conectado automaticamente

Se o navegador nao abrir automaticamente (comum em ambientes WSL), copie a URL exibida no terminal e cole no navegador manualmente. Apos autorizar no navegador, o terminal vai reconhecer a autenticacao em segundos.

3. Confirmar que esta funcionando

Apos autenticar, o Claude Code exibira um prompt interativo esperando seu comando. Digite qualquer coisa para confirmar:

> Ola, confirme que esta funcionando

Se ele responder com uma mensagem, parabens. Esta tudo pronto.

Configuracao Inicial

Na primeira execucao, Claude Code faz algumas perguntas de configuracao. Sao escolhas simples que voce pode alterar depois.

Tema visual

Ele pergunta qual tema voce prefere para a exibicao das respostas. Escolha dark se seu terminal tem fundo escuro, ou light se tem fundo claro. Isso nao afeta o funcionamento, apenas a legibilidade.

Modo de permissoes

Claude Code pode ler arquivos, executar comandos e editar codigo no seu computador. Ele pergunta como voce quer controlar essas acoes:

Ask (padrao recomendado) -- pede sua confirmacao antes de cada acao. Voce ve exatamente o que ele quer fazer e pode aprovar ou recusar. Ideal para quem esta comecando.
Auto-allow -- executa acoes automaticamente sem pedir confirmacao. Mais rapido, mas exige que voce confie no que esta pedindo. Recomendado apenas para usuarios experientes.

Comece com Ask. Conforme voce ganhar confianca, pode mudar para Auto-allow digitando /permissions dentro de uma sessao do Claude Code.

O arquivo CLAUDE.md

O CLAUDE.md e um arquivo especial que voce coloca na raiz do seu projeto. Ele funciona como um "manual de instrucoes" para o Claude Code. Toda vez que voce inicia uma sessao em um projeto, ele le esse arquivo automaticamente.

Nele voce descreve coisas como a stack do projeto, convencoes de codigo, comandos importantes e qualquer regra que Claude Code deve seguir. E isso que faz ele gerar codigo consistente com o resto do seu projeto.

Nao vamos aprofundar aqui -- temos um artigo dedicado sobre como criar um CLAUDE.md eficiente que cobre tudo em detalhe.

Problemas Comuns e Solucoes

A instalacao costuma ser tranquila, mas alguns problemas podem aparecer. Aqui estao os mais frequentes e como resolve-los.

"command not found: node"

O sistema nao encontra o Node.js. Se voce usou nvm para instalar, o problema mais comum e o terminal nao ter carregado as configuracoes do nvm. Feche e reabra o terminal. Depois rode:

nvm use --lts

Se voce instalou pelo site oficial e ainda recebe esse erro, o instalador pode nao ter adicionado o Node.js ao PATH do sistema. Tente reinstalar seguindo os passos da sua plataforma.

"command not found: claude"

O npm instalou o Claude Code, mas o terminal nao consegue encontrar o executavel. Primeiro, confirme que o pacote foi instalado:

npm list -g @anthropic-ai/claude-code

Se o pacote aparece na lista, o problema e de PATH. O diretorio onde o npm instala pacotes globais nao esta no caminho de busca do sistema. No Linux/macOS, adicione ao seu ~/.bashrc ou ~/.zshrc:

export PATH="$(npm config get prefix)/bin:$PATH"

Depois recarregue o arquivo de configuracao:

source ~/.bashrc

Erros de permissao no npm (EACCES)

Se voce receber erros como EACCES: permission denied ao instalar globalmente, nao use sudo. Instalar pacotes npm com sudo cria problemas de permissao maiores no futuro.

Em vez disso, configure o npm para instalar em um diretorio dentro do seu usuario:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

Adicione o novo diretorio ao PATH no seu ~/.bashrc ou ~/.zshrc:

export PATH="~/.npm-global/bin:$PATH"

Recarregue o terminal e tente instalar novamente:

source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Alternativa mais simples: Use o nvm (descrito na secao Linux). Quando voce instala o Node.js via nvm, ele coloca tudo em diretorios do seu usuario, eliminando completamente problemas de permissao.

Versao do Node.js muito antiga

Claude Code exige Node.js 18 ou superior. Verifique qual versao voce tem:

node --version

Se for inferior a v18, atualize. Com nvm, basta rodar:

nvm install --lts
nvm use --lts

Se voce instalou pelo site oficial, baixe novamente a versao LTS em nodejs.org e reinstale.

WSL nao esta instalado (Windows)

Se o comando wsl --install falhar, verifique dois pontos:

Virtualizacao habilitada na BIOS. O WSL 2 precisa de virtualizacao de hardware. Reinicie o computador, entre na BIOS (geralmente pressionando F2, F12 ou Del durante a inicializacao) e procure por "Virtualization Technology", "VT-x" ou "SVM Mode". Habilite a opcao e salve.
Windows atualizado. O WSL 2 requer Windows 10 versao 2004 ou superior, ou Windows 11. Va em Configuracoes > Atualizacao e Seguranca para verificar.

Erro na autenticacao OAuth

Se o navegador abre mas a autenticacao falha ou o terminal nao reconhece o login:

Verifique se sua assinatura Anthropic esta ativa em console.anthropic.com
Tente limpar os cookies do navegador para o dominio da Anthropic e tentar novamente
Se estiver usando VPN ou proxy corporativo, tente desconectar temporariamente -- alguns proxies interferem no fluxo OAuth
Em ambientes WSL, se o navegador nao abriu, copie a URL manualmente e cole no navegador do Windows

Firewall ou proxy bloqueando a conexao

Em redes corporativas ou educacionais, o firewall pode bloquear o Claude Code. Verifique com o time de TI se as conexoes para api.anthropic.com estao liberadas.

Se voce usa proxy, configure as variaveis de ambiente no terminal antes de rodar o Claude Code:

export HTTPS_PROXY=http://seu-proxy:porta
export HTTP_PROXY=http://seu-proxy:porta

Para tornar essa configuracao permanente, adicione essas linhas ao seu ~/.bashrc.

Verificacao Final

Para confirmar que tudo esta funcionando corretamente, rode estes comandos:

claude --version

Isso confirma que o executavel esta acessivel. Agora, crie uma pasta de teste e inicie uma sessao:

mkdir -p ~/teste-claude && cd ~/teste-claude
claude

Dentro da sessao, faca uma pergunta simples:

> Crie um arquivo hello.txt com o conteudo "Ola, Claude Code!"

Se ele criar o arquivo, sua instalacao esta completa e funcional. Voce pode apagar a pasta de teste depois:

rm -rf ~/teste-claude

Mantendo o Claude Code Atualizado

A Anthropic lanca atualizacoes frequentes do Claude Code com novos recursos e melhorias. Para atualizar, rode o mesmo comando de instalacao:

npm install -g @anthropic-ai/claude-code

O npm detecta que o pacote ja existe e atualiza para a versao mais recente. Recomendamos verificar atualizacoes a cada uma ou duas semanas.

Proximos Passos

Com Claude Code instalado e funcionando, voce ja pode comecar a construir. Recomendamos seguir com:

Seu primeiro app com Claude Code -- crie um projeto do zero em minutos
O que e CLAUDE.md -- aprenda a configurar o contexto do seu projeto para resultados melhores
10 comandos essenciais -- domine os comandos mais uteis do dia a dia

Referências

Quickstart — Claude Code Docs — Guia oficial de início rápido
Advanced setup — Claude Code Docs — Configuração avançada, requisitos de sistema e instalação por plataforma
Terminal guide for new users — Claude Code Docs — Guia do terminal para iniciantes
Troubleshooting — Claude Code Docs — Resolução de problemas comuns
Node.js — Site oficial do Node.js para download