Como Instalar Claude Code: Tutorial Passo a Passo (Mac, Windows e Linux)
Instalar o Claude Code leva menos de 5 minutos. Você precisa de Node.js e um terminal. Neste tutorial, mostramos o passo a passo completo para Mac, Windows e Linux, incluindo erros comuns e como resolver.
Requisitos
- ✓ Node.js 18+ — baixe em nodejs.org
- ✓ Terminal — Terminal (Mac), PowerShell (Windows) ou Bash (Linux)
- ✓ Conta Claude — crie grátis em claude.ai
- ✓ Internet — necessária para comunicação com a API
Passo 1: Verificar Node.js
Abra o terminal e verifique se tem Node.js instalado:
$ node --version
v22.4.0
Se aparecer uma versão 18 ou superior, pule para o Passo 2. Caso contrário, baixe o Node.js em nodejs.org.
Passo 2: Instalar Claude Code
Rode o comando de instalação global:
$ npm install -g @anthropic-ai/claude-code
# Aguarde a instalação (30-60 segundos)
added 1 package in 45s
Erro de permissão? No Mac/Linux use: sudo npm install -g @anthropic-ai/claude-code. No Windows, abra o PowerShell como Administrador.
Passo 3: Primeiro Uso
Navegue até a pasta do seu projeto e inicie o Claude Code:
$ cd ~/meu-projeto
$ claude
Welcome to Claude Code v1.0
Powered by Claude Opus 4.6
? Please log in to your Anthropic account...
Na primeira vez, ele abre o navegador para login. Faça login com sua conta Claude e autorize o acesso.
Instalação por Sistema Operacional
Mac (macOS)
# Instalar Node.js via Homebrew (se não tiver)
$ brew install node
$ npm install -g @anthropic-ai/claude-code
$ claude
Funciona no Terminal nativo, iTerm2 ou terminal do VS Code.
Windows
# Baixe Node.js de nodejs.org e instale
# Abra PowerShell como Administrador
PS> npm install -g @anthropic-ai/claude-code
PS> claude
Funciona no PowerShell, CMD e Windows Terminal. WSL é opcional.
Linux (Ubuntu/Debian)
# Instalar Node.js via NodeSource
$ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
$ sudo apt-get install -y nodejs
$ sudo npm install -g @anthropic-ai/claude-code
$ claude
Funciona em qualquer distribuição Linux com Node.js 18+.
Comandos Essenciais
| Comando | O que faz |
|---|---|
| claude | Inicia o Claude Code no diretório atual |
| /help | Mostra todos os comandos disponíveis |
| /compact | Compacta o contexto para economizar tokens |
| /clear | Limpa a conversa e começa do zero |
| /commit | Cria um commit Git com mensagem automática |
| Ctrl+C | Cancela a operação atual |
| Esc | Sai do Claude Code |
Erros Comuns e Soluções
EACCES: permission denied
Use sudo no Mac/Linux ou abra como Administrador no Windows.
command not found: claude
Node.js não está no PATH. Reinstale o Node.js ou adicione o caminho do npm ao PATH do sistema.
engine node: incompatible
Sua versão do Node.js é antiga. Atualize para Node.js 18+ em nodejs.org.
Instalou o Claude Code? Agora Verifique Quem Tem Acesso ao Seu Código
Se você trabalha com freelancers ou colaboradores, consulte antecedentes antes de compartilhar acesso ao repositório.
Verificar Antecedentes AgoraPerguntas Frequentes
Preciso instalar algo antes do Claude Code?
Claude Code funciona no Windows sem WSL?
Como atualizar o Claude Code?
Claude Code funciona no VS Code?
Dá erro de permissão ao instalar, o que fazer?
Claude Code funciona offline?
Artigos Relacionados
Como instalar claude code. Instalar claude code. Claude code download. Claude code terminal. Claude code mac. Claude code windows. Claude code linux. npm install claude code. Tutorial claude code instalação.