Início › Escolha › Ambiente
Passo 1 de 8
Fase 1 — Escolha

Onde você vai instalar
o Claude Code?

Escolha o ambiente de instalação. O tutorial vai se adaptar automaticamente ao seu setup.

✓
💻
Minha Máquina
Instalar no meu computador pessoal ou notebook.
Avançado
✓
☁️
Servidor / VPS
Instalar em um servidor remoto na nuvem, rodando 24/7.
Qual é o seu sistema operacional?
Popular
✓
🪟
Windows
Windows 10 ou 11. WSL2 recomendado.
Nativo
✓
🍎
macOS
Intel ou Apple Silicon (M1/M2/M3/M4).
Dev
✓
🐧
Linux
Ubuntu, Debian, Fedora e outras distros.
Início › Instalação › Windows
Passo 2 de 8
Fase 2 — Instalação

Instalar no Windows

Instalação completa do Claude Code no Windows, passo a passo.

🖥️
Requisitos
Windows 10 ou 11 atualizado. Para verificar sua versão: pressione Win + R, digite winver e pressione Enter.
1
Instale o Git for Windows
Obrigatório

O Git é obrigatório para o Claude Code funcionar. Sem ele, nada funciona no Windows.
Baixe em: git-scm.com/download/win

PowerShell
# Após instalar, abra o PowerShell e verifique: $ git --version git version 2.47.1.windows.1
2
Instale o Node.js
Obrigatório

Necessário para MCP Servers e plugins do Claude Code.
Baixe a versão LTS em: nodejs.org

PowerShell
# Após instalar, FECHE e reabra o PowerShell: $ node --version v20.11.0 $ npm --version 10.2.4
3
Instale o Claude Code
Linha única

Com Git e Node.js instalados, rode o comando abaixo no PowerShell:

PowerShell
$ irm https://claude.ai/install.ps1 | iex Setting up Claude Code... Claude Code successfully installed!
4
Adicione ao PATH
Importante

O PATH diz ao Windows onde encontrar o programa. Sem isso, o comando claude vai dar erro.

⚡ PowerShell
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";" + "$env:USERPROFILE\.local\bin", "User")
⚠️
Atenção: Após rodar o comando acima, feche o PowerShell completamente (clique no X) e abra um novo. Não basta fechar uma aba — o PATH só atualiza em uma nova janela.
5
Verifique e Faça Login
Último passo

No novo PowerShell que você abriu:

PowerShell — nova janela
$ claude --version 2.x.x (Claude Code) $ claude # 1. Confirme que confia na pasta (Trust) # 2. Faça login pelo navegador que vai abrir # 3. Escolha "High effort" quando perguntado
✅ Verificação Final — marque cada item conforme concluir
Git instalado — git --version funciona no terminal
Node.js instalado — node --version funciona no terminal
Claude Code instalado — script rodou sem erros
PATH configurado — terminal fechado e reaberto
Login realizado — tela de boas-vindas do Claude apareceu
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md
Início › Validação › Validação Final
Passo 8 de 8
Fase Final — Validação

Validação Final

Verifique que todas as ferramentas estão instaladas e funcionando corretamente.

🩺
Teste Geral
Rode o diagnóstico automático do Claude Code
Terminal
$ claude doctor # Verifica todas as dependências automaticamente # Se aparecer tudo verde, você está pronto ✓
✅
Checklist Final
Selecione o tipo de instalação que você fez
Itens concluídos 0 / 6
Git instalado — git --version funciona
Node.js instalado — node --version funciona
Claude Code instalado — claude --version funciona
PATH configurado — comando funciona após reabrir terminal
Login realizado — tela de boas-vindas aparece
claude doctor sem erros
Itens concluídos 0 / 8
Conexão SSH funcionando — ssh root@IP
Sistema atualizado — apt update && apt upgrade
Git instalado no VPS
Node.js 20+ instalado no VPS
Usuário não-root criado
Claude Code instalado no VPS
Login via link realizado
tmux instalado para manter sessões
Itens concluídos 0 / 5
Chave SSH gerada no computador
Chave pública adicionada na Hostinger
Arquivo ~/.ssh/config criado
ssh hostinger funciona sem pedir senha
Claude Code consegue executar comandos na VPS
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md
Início › Instalação › macOS
Passo 2 de 8
Fase 2 — Instalação

Instalar no macOS

Instalação completa do Claude Code no macOS.

🍎
Requisitos
macOS 10.15 (Catalina) ou superior. O Git já vem instalado no Mac — não precisa instalar separado.
1
Abra o Terminal
Simples

Pressione ⌘ Command + Espaço, digite Terminal e pressione Enter.

2
Instale o Homebrew
Se não tiver

O Homebrew é o gerenciador de pacotes do Mac. Cole o comando abaixo no Terminal:

Terminal
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Vai pedir sua senha do Mac. Ao digitar, nada aparece — é normal. $ brew --version Homebrew 4.x.x
3
Instale o Node.js
Obrigatório

Necessário para MCP Servers e plugins do Claude Code.

Terminal
$ brew install node $ node --version && npm --version v20.x.x 10.x.x
4
Instale o Claude Code
Escolha uma opção

Escolha a opção que preferir:

Opção A Recomendada
Via Homebrew
$ brew install --cask claude-code
Opção B
Via curl
$ curl -fsSL https://claude.ai/install.sh | bash
5
Feche o Terminal e Verifique
Importante

Feche o Terminal com ⌘ Command + Q, abra um novo e verifique:

Terminal — nova janela
$ claude --version 2.x.x (Claude Code)
⚠️
Se aparecer "command not found", rode o comando abaixo para adicionar ao PATH do zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
6
Faça Login
Último passo

Navegue até a pasta do seu projeto e inicie o Claude Code:

Terminal
$ cd ~/MeuProjeto && claude # 1. Confirme que confia na pasta (Trust) # 2. Faça login pelo navegador que vai abrir # 3. Escolha "High effort" quando perguntado
✅ Verificação Final — marque cada item conforme concluir
Homebrew instalado — brew --version funciona
Node.js instalado — node --version funciona
Claude Code instalado — claude --version funciona
Login realizado — tela de boas-vindas aparece
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md
Início › Validação › Validação Final
Passo 8 de 8
Fase Final — Validação

Validação Final

Verifique que todas as ferramentas estão instaladas e funcionando corretamente.

🩺
Teste Geral
Rode o diagnóstico automático do Claude Code
Terminal
$ claude doctor # Verifica todas as dependências automaticamente # Se aparecer tudo verde, você está pronto ✓
✅
Checklist Final
Selecione o tipo de instalação que você fez
Itens concluídos 0 / 6
Git instalado — git --version funciona
Node.js instalado — node --version funciona
Claude Code instalado — claude --version funciona
PATH configurado — comando funciona após reabrir terminal
Login realizado — tela de boas-vindas aparece
claude doctor sem erros
Itens concluídos 0 / 8
Conexão SSH funcionando — ssh root@IP
Sistema atualizado — apt update && apt upgrade
Git instalado no VPS
Node.js 20+ instalado no VPS
Usuário não-root criado
Claude Code instalado no VPS
Login via link realizado
tmux instalado para manter sessões
Itens concluídos 0 / 5
Chave SSH gerada no computador
Chave pública adicionada na Hostinger
Arquivo ~/.ssh/config criado
ssh hostinger funciona sem pedir senha
Claude Code consegue executar comandos na VPS
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md
Início › Instalação › Comprar VPS
Passo 2 de 8
Fase 2 — Instalação

Comprar VPS Hostinger

Comprar e configurar uma VPS Ubuntu na Hostinger para rodar o Claude Code 24h.

🖥️
O que é uma VPS?
Uma VPS (Virtual Private Server) é um servidor virtual privado — basicamente um computador na nuvem que fica ligado 24h por dia. Com ela você pode hospedar sites, rodar bots, instalar softwares e muito mais, sem depender do seu computador pessoal.
1
Acesse o Site da Hostinger
Compra

Abra seu navegador e acesse: hostinger.com.br/servidor-vps

Para começar
KVM 1
R$27,99/mês
1 vCPU
4 GB RAM
50 GB SSD
KVM 2
R$38,99/mês
2 vCPUs
8 GB RAM
100 GB SSD
KVM 4
R$54,99/mês
4 vCPUs
16 GB RAM
200 GB SSD
Configuração durante a compra
1
Escolha o plano — KVM 1 para começar
2
Crie sua conta na Hostinger
3
Sistema operacional: Ubuntu 22.04 LTS
4
Localização: São Paulo (Brasil) — menor latência
5
Crie uma senha root FORTE e anote em local seguro
6
Período: anual (até 60% desconto) ou mensal
7
Pague com PIX para ativação imediata
🔐
ANOTE A SENHA ROOT!
Sem a senha root você perde acesso ao servidor. Guarde em local seguro — gerenciador de senhas, papel, qualquer coisa. Não tem como recuperar depois.
2
Acesse o hPanel
Pós-compra

Após o pagamento, acesse hpanel.hostinger.com e clique em VPS no menu lateral.

3
Colete os Dados
Importante

No painel da VPS, anote os seguintes dados — você vai precisar deles no próximo passo:

①
IP do servidor — ex: 185.xxx.xxx.xxx
②
Usuário: root
③
Porta SSH: 22
④
Senha root — a que você criou na compra
✅ Verificação — marque cada item conforme concluir
VPS comprada e ativa
IP do servidor anotado
Senha root anotada em local seguro
hPanel acessível em hpanel.hostinger.com
Início › Instalação › Instalar na VPS
Passo 3 de 8
Fase 2 — Instalação

Instalar Claude Code na VPS

Instalar o Claude Code direto no seu VPS para rodar agentes de IA 24h.

1
Conecte via SSH
Primeiro acesso

Abra o PowerShell (Windows) ou Terminal (Mac/Linux) e conecte ao seu servidor:

Terminal / PowerShell
$ ssh root@SEU_IP_DO_VPS # Quando perguntar "Are you sure...?" digite: yes # Digite a senha root (nada aparece na tela — é normal)
2
Atualize o Sistema
Recomendado

Atualize todos os pacotes antes de instalar qualquer coisa:

VPS — root
$ apt update && apt upgrade -y # Se perguntar algo, aperte Y e Enter
3
Instale Git e Node.js
Obrigatório

Instale as dependências necessárias para o Claude Code funcionar:

VPS — root
$ git --version || apt install git -y $ curl -fsSL https://deb.nodesource.com/setup_20.x | bash - $ apt install -y nodejs $ node --version && npm --version v20.x.x 10.x.x
4
Crie um Usuário Não-Root
Importante

Instalar como root pode causar problemas. Crie um usuário dedicado:

VPS — root
$ adduser claude-user # Defina uma senha e aperte Enter nas perguntas opcionais $ usermod -aG sudo claude-user $ su - claude-user
5
Instale o Claude Code
Obrigatório

Como usuário normal — NÃO root, NÃO use sudo:

VPS — claude-user
$ curl -fsSL https://claude.ai/install.sh | bash $ source ~/.bashrc $ claude --version 2.x.x (Claude Code)
6
Faça Login via Link
VPS não tem navegador

Como o VPS não tem navegador, o login é feito por link:

VPS — claude-user
$ claude # 1. Confirme que confia na pasta # 2. Ele mostra um link como: https://claude.ai/oauth/... # 3. Copie esse link e cole no navegador do seu computador # 4. Faça login e autorize # 5. Volte ao terminal — ele detecta automaticamente
⚡ Manter rodando após desconectar — use tmux
apt install tmux -y instalar tmux
→tmux new -s claude criar sessão
→claude rode dentro do tmux
→Ctrl+B depois D desconectar sem parar
→tmux attach -t claude reconectar depois
✅ Verificação — marque cada item conforme concluir
SSH conectado ao VPS
Sistema atualizado — apt update && apt upgrade rodou
Git instalado — git --version funciona
Node.js 20+ instalado — node --version funciona
Usuário não-root criado — claude-user
Claude Code instalado — claude --version funciona
Login via link realizado
tmux instalado para manter sessões
Início › Instalação › Controle Remoto
Passo 4 de 8
Fase 2 — Instalação

Controle Remoto

Configure o SSH sem senha para que o Claude Code do seu computador controle a VPS automaticamente.

⚠️
Pré-requisito: Você já deve ter o Claude Code instalado no seu computador (Windows ou Mac) E na VPS (Instalar na VPS). Se não fez, volte e faça primeiro.
1
Gere uma Chave SSH
No seu computador

A chave SSH permite conexão segura sem precisar digitar senha toda vez.

Terminal
$ ssh-keygen -t ed25519 -f ~/.ssh/hostinger -N "" $ cat ~/.ssh/hostinger.pub # Copie TUDO que aparecer (começa com ssh-ed25519...)
⚡ PowerShell
ssh-keygen -t ed25519 -f "$env:USERPROFILE\.ssh\hostinger" -N "" type "$env:USERPROFILE\.ssh\hostinger.pub" # Copie TUDO que aparecer
2
Adicione no Painel da Hostinger
No hPanel

Coloque a chave pública no servidor via painel da Hostinger:

1
Acesse hpanel.hostinger.com
2
Clique na sua VPS → Gerenciar
3
No menu lateral: Chave SSH
4
Clique em "Adicionar chave SSH"
5
Cole a chave pública copiada
6
Dê um nome (ex: "Meu PC") e clique Salvar
3
Crie o Arquivo SSH Config
Atalho permanente

Isso cria um atalho para não precisar digitar o IP toda vez.

📄 ~/.ssh/config
Host hostinger HostName SEU_IP_AQUI User root IdentityFile ~/.ssh/hostinger
🍎
Mac/Linux: Crie com nano ~/.ssh/config → cole o conteúdo → Ctrl+X → Y → Enter. Depois rode: chmod 600 ~/.ssh/config
4
Teste a Conexão
Verificação

Teste se o acesso sem senha está funcionando:

Terminal / PowerShell
$ ssh hostinger # Digite "yes" na primeira vez # Se aparecer o prompt do servidor → FUNCIONOU! $ exit
5
Use o Claude Code para Controlar
Pronto!

Com tudo configurado, no Claude Code do seu computador você pode pedir coisas como:

🤖
"Execute no servidor: ls -la /var/www"
"Instale o nginx no servidor hostinger"
"Reinicie o serviço na VPS"
✅ Verificação — marque cada item conforme concluir
Chave SSH gerada no computador
Chave pública adicionada na Hostinger
Arquivo ~/.ssh/config criado com alias "hostinger"
ssh hostinger funciona sem pedir senha
Claude Code consegue executar comandos na VPS
Início › Validação › Validação Final
Passo 8 de 8
Fase Final — Validação

Validação Final

Verifique que todas as ferramentas estão instaladas e funcionando corretamente.

🩺
Teste Geral
Rode o diagnóstico automático do Claude Code
Terminal
$ claude doctor # Verifica todas as dependências automaticamente # Se aparecer tudo verde, você está pronto ✓
✅
Checklist Final
Selecione o tipo de instalação que você fez
Itens concluídos 0 / 6
Git instalado — git --version funciona
Node.js instalado — node --version funciona
Claude Code instalado — claude --version funciona
PATH configurado — comando funciona após reabrir terminal
Login realizado — tela de boas-vindas aparece
claude doctor sem erros
Itens concluídos 0 / 8
Conexão SSH funcionando — ssh root@IP
Sistema atualizado — apt update && apt upgrade
Git instalado no VPS
Node.js 20+ instalado no VPS
Usuário não-root criado
Claude Code instalado no VPS
Login via link realizado
tmux instalado para manter sessões
Itens concluídos 0 / 5
Chave SSH gerada no computador
Chave pública adicionada na Hostinger
Arquivo ~/.ssh/config criado
ssh hostinger funciona sem pedir senha
Claude Code consegue executar comandos na VPS
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md
Início › Instalação › Linux
Passo 2 de 8
Fase 2 — Instalação

Instalar no Linux

Instalação do Claude Code em Ubuntu/Debian.

🐧
Requisitos
Ubuntu 20.04+ ou Debian 10+. Para verificar: lsb_release -a
1
Abra o Terminal
Simples

Use o atalho Ctrl + Alt + T ou procure "Terminal" nos aplicativos.

2
Instale o Node.js
Obrigatório

Cole os comandos abaixo, um por vez:

Terminal
$ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - $ sudo apt install -y nodejs $ node --version && npm --version v20.x.x 10.x.x
3
Instale o Claude Code
Não use sudo

NÃO use sudo para instalar o Claude Code — instale como usuário normal:

Terminal
$ curl -fsSL https://claude.ai/install.sh | bash
4
Feche o Terminal e Verifique
Importante

Feche completamente e abra um novo terminal:

Terminal — nova janela
$ claude --version 2.x.x (Claude Code)
⚠️
Se aparecer "command not found", rode o comando abaixo para adicionar ao PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
5
Faça Login
Último passo

Navegue até seu projeto e inicie o Claude Code:

Terminal
$ cd ~/meu-projeto && claude # 1. Confirme que confia na pasta (Trust) # 2. Faça login pelo navegador que vai abrir # 3. Escolha "High effort" quando perguntado
✅ Verificação Final — marque cada item conforme concluir
Node.js instalado — node --version funciona
Claude Code instalado — claude --version funciona
Login realizado — tela de boas-vindas aparece
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md
Início › Validação › Validação Final
Passo 8 de 8
Fase Final — Validação

Validação Final

Verifique que todas as ferramentas estão instaladas e funcionando corretamente.

🩺
Teste Geral
Rode o diagnóstico automático do Claude Code
Terminal
$ claude doctor # Verifica todas as dependências automaticamente # Se aparecer tudo verde, você está pronto ✓
✅
Checklist Final
Selecione o tipo de instalação que você fez
Itens concluídos 0 / 6
Git instalado — git --version funciona
Node.js instalado — node --version funciona
Claude Code instalado — claude --version funciona
PATH configurado — comando funciona após reabrir terminal
Login realizado — tela de boas-vindas aparece
claude doctor sem erros
Itens concluídos 0 / 8
Conexão SSH funcionando — ssh root@IP
Sistema atualizado — apt update && apt upgrade
Git instalado no VPS
Node.js 20+ instalado no VPS
Usuário não-root criado
Claude Code instalado no VPS
Login via link realizado
tmux instalado para manter sessões
Itens concluídos 0 / 5
Chave SSH gerada no computador
Chave pública adicionada na Hostinger
Arquivo ~/.ssh/config criado
ssh hostinger funciona sem pedir senha
Claude Code consegue executar comandos na VPS
Comandos úteis
claude iniciar
claude --version versão
claude doctor diagnóstico
claude update atualizar
/init criar CLAUDE.md