# Workspaces remotos: rode seus agentes numa máquina mais forte via SSH

> Um workspace remoto do Tallos é um workspace que fica em outra máquina, acessada via SSH. Git, terminais e agentes de código rodam nesse host, enquanto a barra lateral, o editor, a revisão de diff e o navegador ficam no app do Tallos no seu Mac ou PC com Windows. Os agentes seguem rodando quando o notebook dorme ou cai a conexão, e o Tallos se reconecta quando você volta.

- Canonical: https://runtallos.com/pt/recursos/workspaces-remotos
- English: https://runtallos.com/features/remote-workspaces.md
- Atualizado em: 2026-09-29
- Section: Recursos

## Em resumo

- Qualquer máquina que você acessa via SSH
- Agentes seguem rodando com queda de conexão e reinício do app
- Importa hosts do `~/.ssh/config`, jump hosts e proxy commands
- Encaminhamento de porta em um clique para servidores de dev remotos
- Só máquinas suas: o Tallos não vende hospedagem

## O que é um workspace remoto no Tallos?

Um **workspace remoto** é um workspace do Tallos cujos arquivos, worktree do git, terminais e agentes ficam num host remoto conectado via SSH. Você escolhe o host ao criar o workspace; o resto funciona como um [workspace paralelo local](https://runtallos.com/pt/recursos/workspaces-paralelos).

Use quando o notebook não é o lugar certo para o trabalho: builds longos, suítes de teste grandes, uma máquina com GPU, o desktop mais forte do escritório ou uma VM na nuvem que já tem seu repositório, ferramentas e credenciais. Rodar vários agentes ao mesmo tempo pesa, e um host remoto deixa você [rodar mais agentes em paralelo](https://runtallos.com/pt/rodar-agentes-de-ia-em-paralelo) sem o cooler do notebook disparar.

| Parte | Roda no host remoto | Aparece no seu computador |
| --- | --- | --- |
| Worktree do git, branches, commits | Sim | Status, diffs e ações de commit |
| CLIs dos agentes e seus logins | Sim | Chat e terminal, estado do agente ao vivo |
| Terminais e servidores de dev | Sim | Abas, splits e histórico |
| Editor | Os arquivos são salvos no host | A edição acontece no Tallos |
| Portas | Seu servidor escuta lá | Encaminhadas para a sua máquina |

_O que roda onde_

## Como adiciono um host SSH no Tallos?

1. **Abra Configurações → SSH** — Clique em **Adicionar Alvo**. O formulário do host abre numa janela de diálogo.
2. **Preencha ou importe o host** — Informe host ou alias, usuário, porta e, se quiser, um arquivo de identidade (por padrão usa o SSH agent). Ou abra o seletor de config do OpenSSH, busque no `~/.ssh/config`, incluindo arquivos de `Include`, e preencha o formulário a partir de um host.
3. **Desbloqueie a chave** — Se a chave tiver passphrase, o Tallos pergunta na primeira vez. A passphrase fica em memória durante a sessão.
4. **Teste e salve** — Clique em **Testar** para checar a conexão e depois em **Salvar**.

> **As chaves do host são verificadas** — O Tallos confere os hosts nos seus arquivos `known_hosts` do OpenSSH. Uma chave alterada ou revogada é rejeitada antes de o Tallos pedir qualquer senha ou passphrase, e o erro mostra o comando `ssh-keygen -R` exato para resolver uma divergência conhecida.

## Como rodo um agente numa máquina remota?

1. **Adicione o projeto** — Adicione o repositório com o host SSH como local, ou abra qualquer pasta remota pelo seletor de arquivos. O git precisa estar instalado no host para workspaces de repositório.
2. **Crie um workspace no host** — Escolha o host em **Executar em**. O Tallos roda `git worktree add` no remoto, então cada tarefa ganha branch e cópia de trabalho próprias lá. Nunca usou worktrees? Leia [git worktrees para agentes de IA](https://runtallos.com/pt/aprenda/git-worktrees-para-agentes-de-ia).
3. **Inicie o agente** — Abra o Claude Code, o Codex ou qualquer outro agente. Ele roda no host remoto, então instale e faça login nele lá; os logins do seu notebook não vão junto.
4. **Revise e entregue** — Edite arquivos direto, leia o diff, faça commit e push pelo Tallos como sempre.

## Tire o trabalho pesado do seu notebook

> Adicione um host SSH, crie um workspace nele e rode seus agentes onde está o poder de processamento. → https://runtallos.com/signup

## O que acontece quando a conexão cai?

Nada se perde. O agente continua rodando no host. Workspaces remotos mostram o status ao vivo (conectado, reconectando, desconectado) e, quando a conexão volta, o Tallos reconecta os terminais e reexibe a saída, inclusive interfaces de agente em tela cheia.

- **Sobrevive ao fechar o app.** As sessões de terminal remotas continuam rodando depois que você fecha o Tallos e voltam conectadas, com histórico, quando você reconecta.
- **Sem contagem regressiva por padrão.** **Manter terminais ativos até redefinir** vem ligado em todo host. Desligue para definir um tempo limite após a desconexão, de 60 segundos a 7 dias.
- **Pare quando quiser.** Encerre as sessões encerrando os terminais remotos, redefinindo o relay, removendo o host ou fechando a aba.

> **Confira antes de duplicar** — Perder contato com o host não quer dizer que o trabalho parou. Confira o host antes de iniciar um segundo agente no mesmo workspace.

## Como abro no navegador um servidor de dev remoto?

Use a aba **Portas** na barra lateral direita. O Tallos lista as portas em que seus processos remotos estão escutando, e um clique encaminha a porta para a sua máquina. Dá também para adicionar, editar ou remover encaminhamentos na mão. Eles sobrevivem a reinícios do app e reconexões, e portas privilegiadas do remoto são remapeadas localmente (a 80 remota vira a 10080 local).

O [navegador integrado](https://runtallos.com/pt/recursos/navegador-integrado) também funciona com workspaces remotos. Uma configuração define se o tráfego e o DNS dele passam pelo host SSH ou pelo seu computador.

## Funciona com jump host, proxy e chave de segurança?

Funciona. Abra a **Conexão Avançada** do host para configurar.

| Necessidade | Como o Tallos resolve |
| --- | --- |
| Bastion ou jump host | Campo **Jump Host**, equivalente a `ProxyJump` / `ssh -J` |
| Túneis como o Cloudflare Access | Campo **Proxy Command**, por exemplo `cloudflared access ssh --hostname %h` |
| Setup mais rápido | **Reutilizar conexão SSH para configuração mais rápida** usa multiplexação do OpenSSH, ligada por padrão |
| Kerberos / GSSAPI | Hosts com `GSSAPIAuthentication yes` conectam pelo OpenSSH do sistema |
| Chaves de segurança FIDO2 | Chaves `ed25519-sk` e `ecdsa-sk` usam o OpenSSH do sistema, então toque e PIN funcionam |
| Abrir no VS Code | **Abrir em → VS Code** inicia o Remote-SSH no mesmo host e caminho |


Também dá para baixar um arquivo remoto, ou uma pasta inteira quando a conexão suporta SFTP, com o botão direito no explorador de arquivos. [Automações](https://runtallos.com/pt/recursos/automacoes) agendadas também podem rodar em hosts SSH.

## Do que a máquina remota precisa?

- **Acesso SSH** com chave, SSH agent, chave de segurança ou Kerberos.
- **Git**, para workspaces de repositório.
- **As CLIs dos seus agentes**, instaladas e com login feito no host.
- **Ferramentas de build em alguns hosts.** Na primeira conexão, o Tallos instala um pequeno relay no remoto. Se o host precisar compilá-lo e não tiver `make`, um compilador C++ e `python3`, arquivos, git e editor funcionam, mas os terminais remotos só funcionam depois que você instalar essas ferramentas e reconectar.

O Tallos não vende nem hospeda máquinas remotas. Workspaces remotos sempre usam hosts que você controla, e seus agentes continuam usando as assinaturas e chaves de API que você já tem. Os terminais se comportam igual ao [terminal do Tallos](https://runtallos.com/pt/recursos/terminal) local.

## Perguntas frequentes

### Consigo rodar o Claude Code ou o Codex num servidor remoto com o Tallos?

Consegue. Adicione o servidor em Configurações → SSH, crie um workspace escolhendo esse host em Executar em e inicie o agente. Ele roda no servidor enquanto você acompanha e revisa no Tallos.

### Os agentes remotos param se o notebook dormir?

Não. O agente segue rodando no host. Quando a conexão volta, o Tallos reconecta o terminal e reexibe a saída.

### Os terminais remotos sobrevivem quando fecho o Tallos?

Sobrevivem. As sessões remotas continuam rodando depois que você fecha o app e voltam conectadas, com histórico. Por padrão ficam ativas até você encerrar; dá para definir um tempo limite de 60 segundos a 7 dias.

### O Tallos usa minha configuração de SSH atual?

Usa. O seletor de config do OpenSSH busca no `~/.ssh/config`, incluindo os arquivos incluídos, e preenche o host. Jump hosts e proxy commands são suportados.

### Como vejo um app web que está rodando no host remoto?

Abra a aba Portas e encaminhe a porta com um clique, depois abra no navegador integrado ou no seu navegador. Os encaminhamentos persistem entre reinícios e reconexões.

### O Tallos fornece a máquina remota?

Não. O Tallos se conecta via SSH a máquinas que você já controla. Ele não vende hospedagem, e seus agentes usam suas próprias assinaturas ou chaves de API.

### Preciso instalar meus agentes no host remoto?

Precisa. Os agentes rodam no host, então instale e faça login em cada CLI de agente lá. Os logins do seu notebook não vão junto.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)