Claude Code em uma VPS: rode em um servidor Linux e controle pelo celular

Do que você precisa

• Um servidor Linux em que você consiga entrar por SSH, de um provedor como DigitalOcean ou OVHcloud. Qualquer distribuição serve para a CLI do Claude Code; o Claude Desktop exige Ubuntu 22.04 ou mais recente, ou Debian 12 ou mais recente.
• Um plano Claude Pro, Max, Ultra, Team ou Enterprise. O Remote Control não funciona com chaves de API, e nos planos Team ou Enterprise um Owner precisa ativá-lo antes.
• O app do Claude no celular (iOS ou Android), ou o claude.ai/code em um navegador.
• Opcionalmente, um ambiente de desktop e uma área de trabalho remota no servidor, para as vezes em que o Claude precisa de um site em que você tem que fazer login.

Como configurar o Claude Code em uma VPS Linux

1. Alugue um servidor e conecte-se a ele

   Crie um servidor Linux em um provedor como DigitalOcean ou OVHcloud e conecte-se a ele por SSH. Escolher Ubuntu 22.04+ ou Debian 12+ mantém o Claude Desktop como opção; em qualquer outra distribuição, você usa a CLI.

2. Instale o Claude Code e faça login

   Instale a CLI do Claude Code com o script de instalação da Anthropic. Ela roda em um terminal (a Anthropic lista Ubuntu 20.04+ e Debian 10+ entre os sistemas suportados), então combina com um servidor headless que você só acessa por SSH. No Ubuntu 22.04+ ou no Debian 12+, você pode instalar o Claude Desktop no lugar dela, com apt; ele está em beta no Linux (veja Claude Desktop no Linux). Depois rode claude e faça login com a sua conta do Claude, não com uma chave de API.

   curl -fsSL https://claude.ai/install.sh | bash

3. Inicie o Remote Control em modo servidor

   Na pasta do projeto, rode claude remote-control. Ele inicia um servidor que pode hospedar várias sessões do Claude Code ao mesmo tempo, e você pode abrir cada uma delas pelo celular. Adicione --chrome para ativar a integração com o Chrome nessas sessões. Para que, em vez disso, toda sessão interativa se conecte, defina remoteControlAtStartup como true em ~/.claude/settings.json.

   # Start a tmux session, so the server keeps running after you close SSH
   tmux new -s claude
   
   # Inside tmux, from your project folder: run the Remote Control server and
   # restart it whenever it exits (it gives up after ~10 minutes offline)
   cd ~/my-project
   while true; do claude remote-control; sleep 10; done
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t claude

4. Mantenha-o rodando depois de sair

   O Remote Control só funciona enquanto o processo claude roda: feche o terminal e as sessões dele ficam offline. Rode-o dentro do tmux ou do screen para que ele sobreviva ao fechamento da conexão SSH, ou como um serviço. O modo servidor também encerra depois de cerca de 10 minutos sem rede, então reinicie-o automaticamente, como faz o loop acima. Para modos de permissão e limites de uso em execuções longas, veja como rodar o Claude Code 24/7.

5. Abra pelo celular

   Abra o app do Claude no iOS ou no Android, ou o claude.ai/code, e escolha uma sessão. O Claude roda no servidor; o celular mostra a conversa e envia as suas mensagens. Detalhes de configuração e soluções estão no guia do Remote Control. Para mandar mensagens ao Claude Code pelo Telegram, veja channels do Claude Code.

Fonte: documentação do Remote Control da Anthropic

Adicione uma área de trabalho para fazer login em sites

Um servidor acessado por SSH não tem tela, o que não é problema até o Claude precisar de um site em que é preciso fazer login. Adicione uma área de trabalho remota e você pode fazer esse login por conta própria, e depois deixar o Claude usar o navegador.

• Instale um ambiente de desktop e um servidor de área de trabalho remota na VPS, e conecte-se pelo notebook quando precisar fazer login em algum lugar.
• Instale o Google Chrome ou o Microsoft Edge com a extensão Claude in Chrome e faça login nos sites que o Claude deve usar. O Claude in Chrome funciona no Linux; ele não é suportado no WSL.
• Inicie o servidor com claude remote-control --chrome para que as sessões dele possam usar esse navegador.
• Acesse a área de trabalho remota via Tailscale, que coloca os seus dispositivos em uma rede privada, uma tailnet, em que só eles conseguem se alcançar. Veja o que é o Tailscale.
• Com um desktop no Ubuntu ou no Debian, o Claude Desktop também é uma opção, além da CLI.

O que um servidor Linux não faz

Se algum destes pontos importar, use um Mac mini em casa, a configuração que quem fundou o Crewmark usa.

• Sem uso do computador. O Claude não consegue operar apps e a tela no Linux: na CLI, o uso do computador é só no macOS, e no Claude Desktop é uma prévia de pesquisa no macOS e no Windows.
• Sem desenvolvimento para iOS. O Xcode e o iOS Simulator rodam só no macOS, então um servidor Linux não consegue compilar nem rodar um app para iPhone.
• Um app desktop mais limitado. O Claude Desktop no Linux é um beta para Ubuntu e Debian, sem uso do computador, Cowork nem ditado.
• Um processo que precisa ficar de pé. Como em qualquer configuração do Remote Control, as sessões só ficam acessíveis enquanto o claude roda no servidor.

Mac mini vs VPS Linux para o Claude Code

Dê ao servidor um trabalho fixo

Um servidor que nunca dorme responde sempre que você manda uma mensagem, e espera quando você não manda. O Crewmark transforma uma conversa do Claude Code nele em um funcionário de IA com cargo, metas, horário de trabalho e um heartbeat: durante o horário de trabalho, a CLI crewmark, que roda no Linux e também no macOS e no Windows, acorda o funcionário para avançar nas issues dele em um quadro compartilhado. O computador em que ele roda precisa ficar ligado, e uma VPS fica.

1. Contrate um funcionário

   Escolha um cargo entre os cargos de funcionários de IA, como engenheiro de software ou especialista em SEO, e escreva as metas e os KPIs dele.

2. Conecte o Claude Code do servidor

   Cole o link de configuração em uma conversa do Claude Code na VPS. Ele instala a CLI crewmark e vincula essa conversa ao funcionário. O Codex também funciona.

3. Defina o horário de trabalho e um heartbeat

   Só em dias úteis ou todos os dias, um horário que pode passar da meia-noite e um despertar a cada 15, 30, 60, 120 ou 240 minutos.

4. Atribua issues pelo celular

   Crie e atribua issues no quadro em crewmark.ai de qualquer navegador; atribuir uma acorda o funcionário na hora. Quando precisa de uma revisão ou de uma decisão, ele marca a issue como Needs action e pergunta a você ali mesmo. Trabalhos para dar a ele estão em casos de uso do Claude Code.

Perguntas frequentes