Execute o Claude Code no tmux ou Herdr e controle-o pelo celular

Uma conexão SSH cai e o Claude Code termina junto. O teclado de terminal do celular não tem as teclas Esc e Ctrl. Você volta uma hora depois e o Claude Code ficou ocioso o tempo todo aguardando aprovação em um prompt.

Este guia resolve os três problemas. Execute o Claude Code no tmux ou Herdr para que ele continue ativo após quedas de conexão. Em seguida, adicione o Collie para priorizar sessões em espera no seu celular e fornecer as teclas que faltam.

Mantenha o Claude Code rodando no tmux

Inicie o Claude Code dentro de uma sessão do tmux. Ele continua rodando no host quando a sua conexão cai.

tmux new -s claude       # start a session named claude
claude                   # run Claude Code inside it

Desconecte com Ctrl+b e depois d. Faça login mais tarde de qualquer máquina e reconecte:

tmux attach -t claude

O servidor do tmux é o dono da sessão, não o seu login SSH; portanto, uma conexão perdida não interrompe o Claude Code. Execute tmux ls para listar as sessões no host.

Herdr

O Herdr é um gerenciador de workspace de terminal feito para coding agents. Ele funciona da mesma maneira.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr                                           # start Herdr, or reattach to it
claude                                          # in the pane Herdr opens

Desconecte com Ctrl+b e depois q, ou feche o terminal. O servidor do Herdr mantém seus painéis e o Claude Code em execução. Execute herdr novamente para reconectar.

zellij

Execute zellij -s claude, inicie claude, desconecte com Ctrl o e depois d, e reconecte com zellij attach claude. O Collie espelha apenas uma sessão do zellij. Veja observações sobre o zellij.

Execute várias sessões do Claude Code ao mesmo tempo

Dê a cada sessão sua própria janela e checkout para que dois agentes não editem os mesmos arquivos.

# a second checkout, on its own branch
git worktree add ~/src/app-review -b review
tmux new-window -t claude -n review -c ~/src/app-review
claude                                     # in the new window

Dentro do tmux, pressione Ctrl+b e depois c para abrir uma janela, e Ctrl+b e depois w para listá-las. Pressione Ctrl+b e depois % para dividir um painel horizontalmente, e Ctrl+b e depois " para dividir verticalmente.

No Herdr, dê a cada agente seu próprio workspace enquanto o Herdr roda:

herdr workspace create --label review --cwd ~/src/app-review

Executar várias sessões cria múltiplos prompts em espera. O Collie coloca os painéis que precisam de entrada no topo do dashboard, agrupando os demais por workspace. Mantenha uma linha pressionada para fixar aquele painel no topo. No tmux e no zellij, essa ordenação requer os beacon hooks de etapa 3.

Controle tudo do seu celular com o Collie

O Collie roda no seu host e espelha seus painéis do Herdr, tmux ou zellij para o navegador do seu celular. Os mesmos passos funcionam para Codex, OpenCode e qualquer outro agente de terminal. Apenas o comando no painel muda.

Nota. O Collie fornece acesso shell remoto à sua máquina por design. Leia Segurança antes de instalá-lo.

• —
  O Claude Code roda no seu host em um painel do Herdr, tmux ou zellij. Nenhum código de agente roda no celular.
• —
  Seu celular abre o Collie em um navegador através da sua tailnet. O dashboard lista os painéis e coloca as sessões em espera primeiro.
• —
  Você lê a saída, envia respostas e usa Esc, Tab, setas ou modificadores a partir da barra Keys. Você não precisa de um cliente SSH.
• —
  Notificações push opcionais alertam você quando um agente precisa de entrada.

O que você precisa

• —
  Um host Linux ou macOS com o Claude Code instalado.
• —
  Um multiplexador de terminal: Herdr, tmux ou zellij. O Herdr detecta agentes diretamente. No tmux e zellij, o Collie usa beacon hooks, que exigem Linux.
• —
  Tailscale instalado no host e no celular, com HTTPS ativado na sua tailnet. Para outras configurações, veja Implantação.
• —
  Um iPhone ou um celular Android.

1. Instale o Collie

curl -fsSL https://colliepwa.dev/install.sh | sh

No Herdr, você pode instalar o plugin diretamente: herdr plugin install AltanS/collie. O Instalação cobre ambos os métodos.

2. Inicie-o

collie start

A primeira execução verifica a presença do Herdr, tmux e zellij, e grava sua escolha em .env. Ela inicia o tailscale serve e exibe uma URL tailnet. Consulte Inicie o serviço.

3. Execute o Claude Code em um painel

No Herdr, abra um painel e execute claude. O Herdr sinaliza o painel como um agente para o Collie.

No tmux ou zellij, instale os ganchos do beacon uma vez por host. Isso permite que o Collie diferencie agentes de shells comuns. Em seguida, abra uma janela ou aba na sessão que o Collie espelha e inicie o Claude Code:

collie hooks install claude    # once per host, Linux only
tmux new-window -n claude      # or: zellij action new-tab --name claude
claude

O Collie espelha o servidor tmux padrão, a menos que você defina COLLIE_MUX_ENDPOINT_TMUX. A sessão claude acima aparece automaticamente.

Instâncias do Claude Code em execução não recarregam configurações automaticamente. Reinicie o Claude Code após instalar os ganchos. Consulte O Collie grava hooks nas próprias configurações do Claude.

4. Abra-o no celular

Execute collie qr no host para escanear o código ou abra o link de collie url. Mantenha o celular na mesma tailnet.

1. 01
   Emparelhe o celular. Execute collie pair no host e escaneie o código QR. O emparelhamento concede ao celular acesso de gravação aos seus painéis (Parear um dispositivo).
2. 02
   Adicione à tela de início. No Android, toque em Instalação na parte superior de Configurações. No iPhone, toque na planilha de compartilhamento do Safari.

5. Responda ao Claude Code

• —
  O painel de controle classifica os painéis que precisam de entrada no topo. Toque em um para abri-lo.
• —
  O editor usa um campo de texto padrão, portanto a digitação por voz do celular funciona nele.
• —
  Toque em Teclas na barra de ações acima do teclado. A bandeja inclui Esc, teclas de seta, Enter, Tab, Space, modificadores, dígitos e F1 a F12. Combinações com Esc e Ctrl não dependem do teclado do celular.
• —
  Os botões do Claude Code ficam na mesma linha: Model, Effort, Compact e Resume. Consulte Configuração.

6. Receba notificações (opcional)

collie push-keys     # writes the VAPID keys to your .env
collie restart

Ative as notificações nas Configurações do Collie no celular. O Needs input vem ativado por padrão. Em um iPhone, instale o Collie na sua tela de início primeiro. O Safari restringe o Web Push a aplicativos web na tela de início. Consulte Web Push.

Outras formas de acessar o Claude Code pelo celular

• —
  O Claude Code Remote Control conecta o app Claude ou claude.ai/code a uma sessão do Claude Code na sua máquina, e o tráfego passa pela API da Anthropic (Documentação da Anthropic). Em vez disso, o Collie espelha os painéis do terminal, portanto funciona com qualquer agente no seu multiplexador e permanece na sua tailnet.
• —
  Um App de SSH como Termius, Moshi ou Termux expõe o terminal completo. Isso funciona, mas os controles de terminal em teclados virtuais são pouco práticos. Esc, Ctrl e teclas de seta exigem soluções alternativas.