Skip to content

Um servidor Ubuntu vazio, pronto para o Claude Code com um comando.

Um único comando instala o Claude Code, um desktop KDE Plasma que você acessa por RDP, SSH seguro e as mesmas configurações que eu uso todo dia. Quando você muda algo no seu computador, o servidor também é atualizado.

$curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash
Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦
1comando
9etapas de instalação
~10minutos
11idiomas
Como funciona

Nove etapas, tudo em bash que você pode ler.

01/09
==> base
✓ base system ready
Ver cada etapa em detalhe →
  1. 01

    base

    Atualiza o sistema, instala as ferramentas básicas e o swap, e liga as atualizações automáticas de segurança.

  2. 02

    user

    Cria um usuário com sudo que entra com a sua chave SSH.

  3. 03

    ssh

    Desliga o login por senha, inclusive para o root. Essa regra vale mesmo sobre as configurações padrão da imagem do provedor.

  4. 04

    firewall

    Liga o firewall e deixa abertas só as portas de SSH e RDP.

  5. 05

    desktop

    Instala o desktop KDE Plasma. O servidor não tem tela, então não é instalada uma tela de login.

  6. 06

    rdp

    Coloca o xrdp na porta 53389. Ao conectar, o Plasma abre sem pedidos de senha desnecessários.

  7. 07

    apps

    Instala Docker, GitHub CLI e Chrome.

  8. 08

    claude

    Instala o Claude Code pelo instalador oficial e configura as notificações no celular.

  9. 09

    dotfiles

    Aplica o seu layout do KDE, as configurações do Claude, os hooks e a configuração do tmux.

O que vem junto

Tudo o que um Claude que trabalha por horas precisa.

claude

Claude Code sempre rodando

Com o tmux, o Claude continua trabalhando mesmo se a sua conexão SSH cair. Suas configurações, hooks e barra de status já vêm prontos.

plasma

O seu KDE, do seu jeito

Painéis, atalhos, organização das janelas e perfis do Konsole são copiados do seu computador e aplicados iguais no servidor.

security

Seguro desde o início

O SSH só aceita chaves, o root não entra com senha, e o firewall e as atualizações automáticas ficam ligados.

ntfy

Avisos no celular

Quando o Claude pergunta alguma coisa, chega uma notificação no seu celular pelo ntfy. Você não precisa ficar na frente do computador.

tools

Ferramentas de desenvolvimento

Docker, GitHub CLI, Node, ripgrep, ferramentas de compilação e Chrome já vêm instalados.

idempotent

Pode rodar de novo

Cada etapa confere primeiro o que já está instalado. Você pode rodar o script de novo quando quiser, ou só uma etapa com --only.

Sincronização

Mude no seu computador, e o servidor recebe.

Todas as configurações ficam no repositório. Você publica do seu computador e o servidor baixa de tempos em tempos.

01

Seu computador

claude-vps publish

Coleta as configurações do KDE e do Claude, remove os caminhos pessoais, faz commit e push.

02

GitHub

git push

As configurações ficam como arquivos comuns em dotfiles/home. Fica fácil ver o que mudou.

03

Servidor

claude-vps sync

Baixa as mudanças e aplica, guardando uma cópia dos arquivos que substitui. Também pode fazer isso sozinho a cada 30 minutos.

FAQ

Perguntas frequentes

Dá para rodar o Claude Code em uma VPS?

Sim. O Claude Code é um app de terminal e funciona em qualquer servidor Linux. Você faz login uma vez por um link que abre no seu próprio aparelho, e dentro do tmux ele continua rodando mesmo depois que você desconecta.

Que servidor eu preciso para o Claude Code?

Só para o terminal, 2 vCPU e 4 GB de RAM bastam. Com o desktop KDE Plasma, 4 vCPU e 8 GB de RAM já parecem uma estação de trabalho de verdade.

Quais versões do Ubuntu são suportadas?

Ubuntu 24.04 LTS ou mais recente, incluindo a 26.04 LTS. Em amd64 tudo é instalado, em arm64 tudo menos o Chrome.

Preciso de uma assinatura do Claude?

Você precisa de um plano que inclua o Claude Code (Pro ou Max) ou de uma chave de API da Anthropic. O claude-vps em si é gratuito e tem licença MIT.

É seguro deixar o RDP aberto na internet?

O xrdp criptografa a sessão e usa uma porta diferente da padrão. Se preferir, com --rdp-private a porta fica fechada e você conecta por um túnel SSH.

Posso usar minhas próprias configurações do KDE e do Claude?

Sim. Faça um fork do repositório, rode claude-vps capture no seu computador e aponte o instalador para o seu fork. O servidor recebe cada mudança que você publicar.

Seu próximo servidor fica pronto em dez minutos.

Hetzner, DigitalOcean ou um computador sobrando em casa: funciona em qualquer máquina com Ubuntu 24.04 ou mais recente.

$curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash

MIT licensed. Not affiliated with Anthropic.