Claude Code num VPS: vantagens para o seu negócio

Executar o Claude Code num VPS permite entregar tarefas de desenvolvimento a um agente que continua a trabalhar com o seu computador desligado, a partir de qualquer posto, num ambiente separado dos seus dados pessoais. Este é o principal ganho: um assistente de código que passa a ser um recurso de infraestrutura, e deixa de ser apenas uma ferramenta lançada num terminal local.

Este artigo começa por explicar o que isto muda na prática para um programador, uma agência ou uma pequena equipa. A parte técnica vem depois, de propósito mais curta: como dimensionar a máquina, instalá-la corretamente e evitar os erros de segurança mais comuns.

O que ganha ao passá-lo para um servidor

O Claude Code é um agente de linha de comandos da Anthropic. Lê o seu repositório, altera ficheiros, executa testes e comandos. Num portátil, vive e morre com a sua sessão: suspensão, bateria, Wi-Fi de hotel, reinício forçado por uma atualização. Num VPS, corre numa sessão persistente.

Os benefícios resumem-se de forma simples:

• Disponibilidade contínua: uma refatoração, uma migração de dependências ou uma bateria de testes pode correr durante a noite. Revê o resultado de manhã.
• Acesso de qualquer lugar: basta uma ligação SSH, a partir de um segundo computador, de um tablet ou de um posto emprestado. O contexto de trabalho fica no servidor.
• Posto de trabalho libertado: as compilações, os testes e os contentores consomem recursos do VPS, não os da sua máquina. O portátil continua fluido.
• Ambiente limpo e reproduzível: uma máquina dedicada a esta função, com as versões certas de Node, Python ou PHP, sem os resíduos de dez projetos diferentes.
• Custo de infraestrutura previsível: aluga uma máquina com subscrição fixa. Só a utilização do Claude (subscrição ou API) varia consoante o uso.

Uma separação nítida entre o agente e os seus dados

Um agente que executa comandos deve ficar confinado. No seu posto, tem potencialmente acesso à sua pasta pessoal, às chaves SSH, aos navegadores e aos documentos de clientes. Num VPS, só vê o que lá colocou.

É um argumento de peso para agências e freelancers que trabalham com código de clientes. Cria um servidor por cliente ou por projeto, apenas com os repositórios e os segredos necessários. No fim do trabalho, elimina a máquina e o perímetro desaparece com ela.

A configuração continua a ser da sua responsabilidade: um VPS isolado só protege se os acessos estiverem bem geridos. Voltamos a este ponto mais abaixo.

Os usos que rentabilizam mais depressa um VPS

Nem todos os usos têm o mesmo valor. Aqueles em que o servidor traz uma vantagem clara:

1. Tarefas longas: migração de framework, adição de testes a código existente, refatoração em grande escala. Enquanto a tarefa dura, não há razão para manter um portátil aberto.
2. Trabalho em equipa: um servidor comum com um utilizador por pessoa, repositórios partilhados e as mesmas ferramentas. As diferenças de configuração entre postos desaparecem.
3. Manutenção de sites de clientes: atualizações, correções e auditorias de código em vários projetos WordPress ou aplicacionais, a partir de um único ponto de entrada.
4. Implementações próximas da produção: o agente pode preparar e testar as alterações na mesma família de sistema dos seus servidores finais.
5. Trabalho em mobilidade: começa uma tarefa no escritório, acompanha-a no comboio e conclui-a em casa.

Que VPS escolher

O próprio Claude Code é leve: o essencial do cálculo é feito do lado da Anthropic, e a máquina local limita-se a executar os comandos pedidos. O que pesa é o seu projeto: compilação, suites de testes, base de dados, Docker.

A título indicativo, para começar:

Preveja também espaço em disco proporcional: repositórios, dependências e imagens Docker crescem depressa. Uma distribuição Ubuntu LTS ou Debian é uma escolha simples e bem documentada, e é o terreno natural de um VPS Linux.

Quanto à localização, escolha de acordo com as suas restrições. Se os seus clientes ou a sua conformidade exigem que o código permaneça na Europa, veja as ofertas em França ou na Alemanha. A oferta dedicada a este uso está na página VPS para Claude Code, e a gama completa na página VPS.

Instalar o Claude Code em poucos minutos

Assim que o servidor for entregue, ligue-se por SSH e crie um utilizador normal. Evite trabalhar como root: é uma boa prática geral, e um agente que executa comandos deve ter direitos limitados.

Bash
1adduser dev
2usermod -aG sudo dev
3su - dev

Instale depois o Claude Code com o instalador oficial:

Bash
1curl -fsSL https://claude.ai/install.sh | bash
2claude --version

Se preferir usar o npm, é necessário o Node.js (versão 18 ou superior):

Bash
1npm install -g @anthropic-ai/claude-code

Posicione-se no seu projeto e execute claude. No primeiro arranque, a ferramenta propõe que se autentique com uma conta Claude ou uma chave de API. Num servidor sem navegador, mostra um endereço para abrir a partir do seu posto, e depois cola no terminal o código obtido.

Manter a sessão ativa com o tmux

Sem precauções, uma quebra de SSH fecha a sessão e interrompe o agente. O tmux resolve o problema:

Bash
1sudo apt update && sudo apt install -y tmux
2tmux new -s claude
3# execute o claude nesta sessão e depois desligue-se com Ctrl+b e a seguir d
4tmux attach -t claude

O comando attach leva-o exatamente ao ponto onde deixou a sessão, mesmo depois de se voltar a ligar no dia seguinte.

Proteger o servidor antes de deixar um agente trabalhar

Um agente que lê e altera código precisa de um enquadramento. Alguns ajustes chegam para uma base sólida.

• Autenticação apenas por chave SSH. Em /etc/ssh/sshd_config, defina PasswordAuthentication no e PermitRootLogin no, e depois recarregue com sudo systemctl reload ssh.
• Firewall mínima: abra apenas o que for necessário.

Bash
1sudo ufw allow OpenSSH
2sudo ufw enable

• Segredos limitados: guarde na máquina apenas as chaves de que o projeto precisa. Prefira chaves de implementação só de leitura às suas credenciais pessoais de Git.
• Revisão das ações: mantenha o modo de permissões predefinido do Claude Code, que pede confirmação antes de ações sensíveis, enquanto não tiver definido com precisão o perímetro da máquina.
• Cópias de segurança e Git: envie regularmente as alterações para um repositório remoto. O servidor continua a ser uma ferramenta de trabalho, não o único exemplar do seu código.

Se o servidor estiver exposto a outros serviços públicos (site, API), uma proteção anti-DDoS pode também fazer sentido, mas não diz respeito ao Claude Code em si.

Armadilhas a evitar

A primeira: subdimensionar a memória. Um npm install ou uma compilação pode ser terminado pelo sistema se faltar RAM. Um ficheiro de swap ajuda a desenrascar, mas não substitui memória real.

A segunda: misturar projetos de clientes diferentes no mesmo utilizador Unix. Separe por utilizador ou, melhor ainda, por servidor.

A terceira: esquecer que a utilização do Claude tem custo próprio, independente do VPS. Acompanhe o consumo da sua subscrição ou da sua chave de API, sobretudo se o agente trabalhar de noite em tarefas amplas. Defina objetivos precisos em vez de um vago «melhora todo o código».

Para aprofundar a administração de um servidor Linux, os tutoriais do site cobrem SSH, firewalls e gestão de utilizadores.

FAQ