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.
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 bashAtualiza o sistema, instala as ferramentas básicas e o swap, e liga as atualizações automáticas de segurança.
Cria um usuário com sudo que entra com a sua chave SSH.
Desliga o login por senha, inclusive para o root. Essa regra vale mesmo sobre as configurações padrão da imagem do provedor.
Liga o firewall e deixa abertas só as portas de SSH e RDP.
Instala o desktop KDE Plasma. O servidor não tem tela, então não é instalada uma tela de login.
Coloca o xrdp na porta 53389. Ao conectar, o Plasma abre sem pedidos de senha desnecessários.
Instala Docker, GitHub CLI e Chrome.
Instala o Claude Code pelo instalador oficial e configura as notificações no celular.
Aplica o seu layout do KDE, as configurações do Claude, os hooks e a configuração do tmux.
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.
Painéis, atalhos, organização das janelas e perfis do Konsole são copiados do seu computador e aplicados iguais no servidor.
O SSH só aceita chaves, o root não entra com senha, e o firewall e as atualizações automáticas ficam ligados.
Quando o Claude pergunta alguma coisa, chega uma notificação no seu celular pelo ntfy. Você não precisa ficar na frente do computador.
Docker, GitHub CLI, Node, ripgrep, ferramentas de compilação e Chrome já vêm instalados.
Cada etapa confere primeiro o que já está instalado. Você pode rodar o script de novo quando quiser, ou só uma etapa com --only.
Todas as configurações ficam no repositório. Você publica do seu computador e o servidor baixa de tempos em tempos.
claude-vps publishColeta as configurações do KDE e do Claude, remove os caminhos pessoais, faz commit e push.
git pushAs configurações ficam como arquivos comuns em dotfiles/home. Fica fácil ver o que mudou.
claude-vps syncBaixa as mudanças e aplica, guardando uma cópia dos arquivos que substitui. Também pode fazer isso sozinho a cada 30 minutos.
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.
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.
Ubuntu 24.04 LTS ou mais recente, incluindo a 26.04 LTS. Em amd64 tudo é instalado, em arm64 tudo menos o Chrome.
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.
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.
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.
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