PASSO 8·15 min

Instalar Claude Code na VPS

SSH + Node.js + Claude Code no servidor

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

Passo 1 — Conecte via SSH

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

Terminal
ssh root@SEU_IP_DO_VPS
# Quando perguntar "Are you sure...?" digite: yes
# Digite a senha root (nada aparece na tela — e normal)

Passo 2 — Atualize o Sistema

Atualize todos os pacotes:

Terminal
apt update && apt upgrade -y
# Se perguntar algo, aperte Y e Enter

Passo 3 — Instale Git e Node.js

Instale as dependencias necessarias:

Terminal
git --version || apt install git -y
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs
node --version && npm --version
# Esperado: v20.x.x e 10.x.x

Passo 4 — Crie um Usuario Nao-Root

Instalar como root pode causar problemas. Crie um usuario dedicado:

Terminal
adduser claude-user
# Defina uma senha e aperte Enter nas perguntas opcionais
usermod -aG sudo claude-user
su - claude-user

Passo 5 — Instale o Claude Code

Como usuario normal (NAO root, NAO use sudo):

Terminal
curl -fsSL https://claude.ai/install.sh | bash
source ~/.bashrc
claude --version
# Esperado: 2.x.x (Claude Code)

Passo 6 — Faca Login (via Link)

Como o VPS nao tem navegador, o login e por link:

Terminal
claude
# Confirme que confia na pasta
# Ele mostra um link como: https://claude.ai/oauth/...
# Copie esse link e cole no navegador do seu computador
# Faca login e autorize
# Volte ao terminal — ele detecta automaticamente

Manter rodando apos desconectar

Use tmux: apt install tmux -y → tmux new -s claude → rode claude dentro → Ctrl+B depois D para desconectar. Reconectar: tmux attach -t claude

Verificacao

  • SSH conectado ao VPS
  • Sistema atualizado
  • Git instalado
  • Node.js 20+ instalado
  • Usuario nao-root criado
  • Claude Code instalado
  • Login via link realizado
  • tmux instalado