# Como fazer o Claude Code acessar o SSH da sua VPS

> O Claude Code roda no seu computador e usa o ssh do seu terminal. Configure uma chave SSH e um apelido para a VPS no ~/.ssh/config, teste com ssh minhavps "uptime" e peça ao Claude, por exemplo, conecte em minhavps por ssh e veja o uso de disco.

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\config`
   Resultado: 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 rodando`
   Resultado: 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

---
Fonte: https://help.staycloud.com/artigos/como-fazer-o-claude-code-acessar-o-ssh-da-sua-vps