O Claude Code é a ferramenta oficial da Anthropic que transforma o Claude num assistente que executa tarefas direto no seu computador — lê arquivos, escreve código, acessa a web e muito mais. Neste tutorial você aprende a instalar em qualquer ambiente.
🪟 Windows (~8 min)
Passo 1 — Instalar Git for Windows
Baixe em https://git-scm.com/download/win e execute o instalador clicando “Next” em todas as telas sem modificar nada.
Passo 2 — Abrir PowerShell novo
Feche todas as janelas PowerShell abertas. Abra uma nova pelo Menu Iniciar digitando “PowerShell”.
Passo 3 — Liberar execução de scripts
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -ForceAutoriza scripts assinados rodarem no seu usuário sem precisar de admin.
Passo 4 — Instalar Claude Code
irm https://claude.ai/install.ps1 | iexAguarde 1-3 minutos.
Passo 5 — Login
Abra um novo PowerShell, digite claude, faça login via navegador com sua conta Anthropic e selecione o modelo de alta capacidade.
⚠️ Erros comuns
• “Claude não é reconhecido” → feche todas as janelas PowerShell e abra uma nova
• Antivírus bloqueando → desative temporariamente Avast, AVG, McAfee ou Norton durante a instalação
🍎 Mac (~3 min)
Passo 1 — Abrir Terminal
Command + Space → digite “Terminal” → Enter
Passo 2 — Instalar Claude Code
curl -fsSL https://claude.ai/install.sh | bashAguarde a mensagem: “Claude Code successfully installed!”
Passo 3 — Fechar e reabrir o Terminal
Command + Q para fechar completamente, depois abra novamente.
Passo 4 — Login
Digite claude → confirme confiança na pasta (digite: yes) → navegador abre automaticamente → autorize → volte ao Terminal → selecione modelo de alta capacidade.
⚠️ Erros comuns
• “command not found: claude” → feche o Terminal e abra novo. Se persistir:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc• “Command Line Developer Tools required” → clique em Instalar e aguarde 5-10 minutos
• Senha aparece invisível → comportamento normal de segurança — digite normalmente e pressione Enter
🐧 Linux (~3 min)
Passo 1 — Abrir Terminal
Ctrl + Alt + T ou pelo menu de aplicativos.
Passo 2 — Instalar Claude Code
curl -fsSL https://claude.ai/install.sh | bashAguarde: “Claude Code successfully installed!”
Passo 3 — Fechar e reabrir Terminal (obrigatório)
Passo 4 — Login
Digite claude → autentique via navegador com conta Anthropic → selecione modelo de alta capacidade.
⚠️ Erros comuns
• “claude: command not found” → abra novo Terminal e execute:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc• “git: command not found” → instale com:
sudo apt install -y git🖥️ VPS — ex: Hostinger (6 etapas)
Passo 1 — Conectar via SSH
ssh root@SEU_IP_DO_VPSSenha aparece invisível — comportamento normal.
Passo 2 — Atualizar sistema
apt update && apt upgrade -yPasso 3 — Instalar Git e Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs git
node --version && npm --versionEsperado: v20.x.x e 10.x.x
Passo 4 — Criar usuário não-root (segurança)
adduser claude-user
usermod -aG sudo claude-user
su - claude-userNunca instale como root.
Passo 5 — Instalar Claude Code
curl -fsSL https://claude.ai/install.sh | bash
claude --versionEsperado: 2.x.x
Passo 6 — Login e tmux
sudo apt install -y tmux
tmux new -s claude
claudeO VPS não tem navegador — copie o link OAuth gerado e abra no seu computador local para autenticar.
Para sair do tmux sem encerrar: Ctrl+B depois D
✅ Validação Final
Diagnóstico automático
claude doctorVerifica automaticamente todas as dependências do sistema de uma vez.
Checklist — Instalação Local (Mac/Windows/Linux)
☐ Git instalado
☐ Node.js instalado
☐ Claude Code instalado
☐ PATH configurado corretamente
☐ Login realizado com conta Anthropic
☐ claude doctor rodou sem erros
Checklist — VPS
☐ SSH conectado
☐ Sistema atualizado
☐ Git instalado
☐ Node.js 20+ instalado
☐ Usuário não-root criado (claude-user)
☐ Claude Code instalado
☐ Login via link OAuth realizado
☐ tmux instalado e funcionando
Comandos úteis para começar
claude # inicia o assistente
claude --version # verifica versão (esperado: 2.x.x)
claude doctor # diagnóstico completo
claude update # atualiza para versão mais recente✅ Pronto! Você completou a instalação e está pronto para criar seus primeiros projetos com Claude Code.
About the Author
