Resumo
- O "controle remoto" oficial do Claude Code é prático, mas oferece apenas uma UI de chat, então não dá para operar o terminal livremente
- Com a combinação SSH + tmux, você tem independência de plano, persistência de sessão e o próprio terminal. Porém, apps SSH para Android não lidam direito com entrada CJK como coreano/japonês
- Então eu fiz um. Um app SSH com todos os recursos necessários, incluindo explorador de arquivos SFTP, comandos personalizados e execução automática ao conectar
Contexto: os limites do controle remoto oficial
O Claude Code ganhou um recurso de controle remoto. Ao executar claude remote-control, um QR code é exibido e você pode acessar a sessão pelo app Claude no smartphone.
É conveniente, mas há algumas limitações:
- Só oferece UI de chat – você só vê a conversa com o Claude Code e não pode operar o terminal em si
- Não é possível executar comandos diretos no terminal como
git logouls - Não dá para verificar arquivos gerados em visualização em árvore, ler com destaque de sintaxe ou fazer download
SSH + tmux vs controle remoto
| Controle remoto | SSH + tmux (SSH Term) | |
|---|---|---|
| Quando a rede cai | Sessão encerrada após ~10 min | Sessão persistente com tmux. Dá para voltar mesmo horas depois |
| Ao fechar o terminal | Sessão encerrada | O tmux mantém a sessão. Basta reconectar |
| Escopo de operação | Só chat do Claude Code | O próprio terminal (vale tudo) |
| Verificação de arquivos | Só via Claude Code | Explorador SFTP + destaque de sintaxe + download |
| Múltiplas sessões | Difícil identificar nomes de sessão | Gerenciamento simultâneo por abas |
| Setup | Uma linha com claude remote-control |
Exige configurar servidor SSH + adotar tmux |
Por que eu fiz isso
Eu queria acessar um Mini PC via SSH para dar instruções ao Claude Code, mas os apps SSH existentes no Android não tratavam corretamente entrada CJK (coreano, japonês etc.). Às vezes o teclado nem aparecia; em outras, os caracteres digitados não eram enviados direito. Testei vários apps e nenhum resolveu.
Então decidi fazer eu mesmo.
SSH Term
Já foi lançado tanto para iOS quanto para Android. É um cliente de terminal especializado em operar agentes de coding AI baseados em CLI a partir do smartphone. Claro, também pode ser usado como um cliente SSH comum.
Principais recursos
Modo IME – suporte a entrada CJK
No Android, há surpreendentemente poucos apps SSH em que a digitação em coreano/japonês/chinês funciona direito. O SSH Term inclui um modo IME que, ao ser ativado, permite enviar texto CJK ao terminal normalmente.
Explorador de arquivos SFTP + destaque de sintaxe + download
Ler no celular o código gerado pelo Claude Code usando cat no terminal simplesmente não é realista.
O SSH Term traz um explorador de arquivos SFTP integrado:
- Destaque de sintaxe para mais de 40 linguagens (Dart, Python, JS/TS, Go, Rust, Shell etc.)
- Download de arquivos – salva os resultados gerados no dispositivo
- Favoritos – acesso com um toque aos diretórios mais usados
- No iPad, é possível usar visualização em 2 painéis para ver lista de arquivos e prévia ao mesmo tempo
Comandos de texto personalizados
Na barra de assistência de entrada, você pode registrar comandos usados com frequência como botões:
git status\n→ executa com um toquetmux attach -t main\n→ entra direto na sessão tmuxcd ~/projects/my-app && claude\n→ da troca de diretório até iniciar o Claude Code, tudo de uma vez
Também é possível combinar vários comandos em etapas.
Execução automática de comandos ao conectar / reconectar
No perfil de conexão, você pode definir comandos para executar após conectar. Por exemplo:
wsl→ inicia o WSLcd ~/projects/my-app→ vai para o diretório de trabalhotmux new -s main→ inicia a sessão tmux
Também dá para configurar separadamente comandos ao reconectar, então se a rede cair e voltar, o app retorna automaticamente com tmux attach -t main. Mesmo passando por um túnel no metrô, você volta à sessão original em poucos segundos.
Manutenção da conexão em segundo plano
Mesmo trocando de app, a conexão SSH é mantida. Se o Claude Code estiver processando algo, você pode usar outros apps e depois voltar para ver o resultado na hora. Também inclui bloqueio por biometria/PIN.
Outros
- Múltiplas abas – em uma, Claude Code; em outra, monitoramento de logs com
tail -f - Geração de chaves dentro do app – Ed25519 (recomendado), RSA 2048/4096. Dá para copiar a chave pública para a área de transferência e registrar direto em
authorized_keys - 8 temas – Dracula, Nord, Tokyo Night, Monokai, Solarized Dark, Gruvbox, Catppuccin Mocha, One Dark
- Mais de 10 fontes monoespaçadas – incluindo Fira Code e JetBrains Mono. Também suporta Nerd Font (ícones de Starship e Powerlevel10k podem ser exibidos)
- Barra de assistência de entrada – insere com um toque Ctrl+C, Tab, Escape, setas, F1~F12 etc.
Resumo dos recursos
| Categoria | Recurso |
|---|---|
| Entrada | Modo IME (entrada CJK), barra de assistência de entrada, comandos de texto personalizados |
| Arquivos | Explorador de arquivos SFTP, destaque de sintaxe (40+ linguagens), download de arquivos, favoritos |
| Conexão | Reconexão automática, manutenção em segundo plano, comandos ao conectar, comandos ao reconectar, bloqueio de tela |
| Sessão | Múltiplas abas, atalhos para tmux |
| Autenticação | Senha, chave pública (Ed25519/RSA), keyboard-interactive, geração de chaves no app |
| Aparência | 8 temas, mais de 10 fontes, suporte a Nerd Font |
Fluxo de uso real
- Deixar o Claude Code sempre pronto no Mini PC de casa
- Na rua, conectar via SSH pelo smartphone (com comandos iniciais automatizando WSL → diretório de trabalho → conexão ao tmux)
- Dar instruções em linguagem natural, como "adicione este recurso"
- Enquanto o Claude Code processa, deixar o app em segundo plano
- Voltar depois de um tempo e conferir o resultado
- Usar o explorador de arquivos para pré-visualizar o código gerado e, se necessário, fazer download
- Se estiver tudo certo, passar a próxima instrução
Mesmo se a rede cair, os comandos de reconexão trazem você de volta automaticamente. Seu projeto continua avançando no metrô só com linguagem natural.
iOS e Android já disponíveis:
Feedbacks são bem-vindos.
Ainda não há comentários.