Como fazer o Claude Code acessar o SSH da sua VPS

O Claude Code roda no seu computador e executa comandos no seu terminal, inclusive o ssh. Para ele acessar a VPS, basta que o seu terminal consiga entrar nela sem pedir senha: configure uma chave SSH, crie um apelido (como minhavps) e peça ao Claude, por exemplo, "conecte em minhavps por ssh e veja o uso de disco".

Antes de começar

• Uma VPS ativa na StayCloud e o acesso por SSH funcionando. Veja "Como acessar sua VPS por SSH pelo terminal (Linux, Windows e Mac)".
• O Claude Code instalado no seu computador, com a sua conta da Anthropic.
• Uma chave SSH configurada para a VPS. O Claude Code não consegue digitar a senha root por você, então o acesso precisa ser por chave. Veja "Como acessar a VPS por chave SSH em vez de senha".
• Faça um snapshot da VPS pelo painel antes de pedir mudanças. Veja "Como criar um snapshot da sua VPS antes de uma mudança".

Como funciona

O Claude Code não fica instalado na VPS e a StayCloud não dá a ele nenhum acesso especial. Ele usa o mesmo comando ssh que você usaria no terminal, com a sua chave e as suas permissões. Tudo o que ele roda na VPS passa pelo seu computador e aparece na tela para você aprovar.

Configurar o apelido da VPS

1. No seu computador, abra o arquivo de configuração do SSH:
   • Linux e Mac: nano ~/.ssh/config
   • Windows (PowerShell): notepad $env:USERPROFILE\.ssh\configResultado: abre o arquivo, vazio se ele ainda não existia.
2. Acrescente o bloco abaixo, trocando o IP. Se você entra com um usuário próprio, troque root por ele:

   Host minhavps
       HostName <IP_DA_VPS>
       User root
       IdentityFile ~/.ssh/id_ed25519
   

   Resultado: o apelido minhavps fica configurado.
3. Salve e feche o arquivo.Resultado: o prompt do terminal volta.

Se você já criou o apelido seguindo "Como acessar a VPS por chave SSH em vez de senha", pule esta etapa.

Testar o acesso sem senha

1. No terminal do seu computador, rode:

   ssh minhavps "uptime"
   

   Resultado: aparece uma linha como 14:02:11 up 12 days, 3:41, 1 user, load average: 0.35, 0.40, 0.38, sem pedir senha, e o terminal volta para o seu computador.

Se a sua chave tem senha (passphrase), carregue-a antes no agente do SSH com ssh-add. Assim, o Claude Code consegue usar a chave sem precisar da senha dela. Se o terminal pedir alguma senha neste teste, o Claude Code também vai travar nesse ponto.

Pedir ao Claude Code

1. Abra o Claude Code no terminal do seu computador:

   claude
   

   Resultado: abre a sessão do Claude Code.
2. Peça usando o apelido e diga que é por SSH. Exemplos:
   • conecte em minhavps por ssh e me diga o uso de CPU, memória e disco
   • conecte em minhavps por ssh e veja por que o nginx parou
   • conecte em minhavps por ssh e liste os contêineres Docker que estão rodandoResultado: o Claude Code propõe comandos como ssh minhavps "df -h" e pede a sua aprovação antes de rodar cada um.
3. Leia cada comando antes de aprovar.Resultado: o comando roda na VPS e o Claude Code mostra o resultado e o que concluiu.

Boas práticas

• Snapshot antes de mudanças. Antes de pedir para instalar, atualizar, apagar ou mudar configuração, faça um snapshot da VPS pelo painel. Se algo der errado, você volta ao estado anterior.
• Revise antes de aprovar. Leia cada comando. Desconfie de rm -rf, de mudanças no SSH (/etc/ssh/sshd_config) e no firewall (ufw), que podem derrubar o site ou trancar você para fora.
• Comece pedindo só para olhar. Peça um diagnóstico primeiro ("veja e me diga, sem mudar nada") e autorize a correção depois.
• Não cole senhas no chat. Nunca envie a senha root, a chave privada (id_ed25519) ou tokens na conversa. A chave fica no seu computador e o ssh a usa sozinho.
• Prefira um usuário próprio. Para o dia a dia, use um usuário com sudo em vez do root. Veja "Como criar um usuário com sudo e entrar sem root na VPS via SSH".

Como saber se deu certo

Peça ao Claude Code: conecte em minhavps por ssh e rode hostname. Ele deve propor ssh minhavps "hostname" e, depois de você aprovar, mostrar o nome da sua VPS.

Se algo der errado

O Claude Code fica parado esperando senha

Causa: o acesso ainda é por senha ou a chave tem senha que não foi carregada. Solução: configure a chave SSH e, se ela tiver senha, rode ssh-add antes de abrir o Claude Code. Teste com ssh minhavps "uptime": não pode pedir nada.

"ssh: Could not resolve hostname minhavps"

Causa: o apelido não está no ~/.ssh/config, ou o nome está diferente. Solução: confira o arquivo e use exatamente o nome da linha Host.

"Permission denied (publickey)."

Causa: a VPS não reconhece a chave. Solução: repita a cópia da chave pública, como em "Como acessar a VPS por chave SSH em vez de senha".

Relacionados

• Como acessar a VPS por chave SSH em vez de senha
• Como acessar sua VPS por SSH pelo terminal (Linux, Windows e Mac)
• Como criar um snapshot da sua VPS antes de uma mudança
• Como criar um usuário com sudo e entrar sem root na VPS via SSH
• Como conectar a central de ajuda da StayCloud ao Claude Code