Claude Code, SSH e tmux: retome suas sessões remotas

O que determina se o trabalho continua é a máquina que o executa. O tmux mantém uma sessão de terminal mesmo quando a conexão cai. Ele não faz um notebook em suspensão continuar processando, não mantém um servidor desligado em funcionamento nem reinicia um processo do Claude que falhou. A Anthropic recomenda explicitamente tmux ou screen para sessões remotas do Claude que precisam sobreviver à queda de uma conexão SSH. Documentação do Remote Control da Anthropic.

Comece pela configuração de tmux recomendada na documentação

Faça a configuração na máquina que executa o Claude Code. Se o trabalho é remoto, o arquivo a editar é o ~/.tmux.conf do host remoto. Se necessário, instale o tmux pelo gerenciador de pacotes desse host e confira ali as saídas de tmux -V e claude --version antes de continuar.

Incorpore este bloco ao ~/.tmux.conf. As primeiras três linhas são a configuração documentada pela Anthropic; a preferência de mouse, comentada, é opcional e não é uma exigência da Anthropic.

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

# Optional preference: enable mouse interaction in tmux.
# set -g mouse on

O passthrough permite que notificações e atualizações de progresso cheguem ao terminal externo. As teclas estendidas permitem ao tmux distinguir Shift+Enter de Enter. Para aplicar a configuração a um servidor tmux em execução, use tmux source-file ~/.tmux.conf; um novo servidor carrega o arquivo ao iniciar. Configuração do terminal na documentação da Anthropic.

Se ainda não houver um servidor tmux, crie a primeira sessão seguindo o exemplo abaixo antes de executar o comando de recarga. Deixe os plugins de terceiros de fora da configuração inicial: nenhum é necessário para este fluxo.

Crie uma sessão nomeada para cada worktree

Um worktree do Git é outro checkout, com seus próprios arquivos e branch, que compartilha o histórico do repositório. Uma sessão do tmux reúne janelas de terminal sob um nome; um painel é uma subdivisão de uma janela. Pense no worktree como a bancada de trabalho e no tmux como a sala da qual você pode sair e à qual pode voltar. Guia de worktrees da Anthropic.

Adote nomes correspondentes para que o nome da sessão indique em qual checkout você está entrando. A organização abaixo é uma sugestão deste guia, não um padrão do Claude Code:

O exemplo de configuração inicial a seguir pressupõe que já exista um repositório em ~/src/project, com pelo menos um commit, e que os nomes de branches, diretórios e sessões ainda não estejam em uso. Substitua dev@devbox e o caminho do projeto. Comece no shell comum do notebook, fora do tmux. Os comandos de worktree seguem o fluxo manual da Anthropic; a organização em sessões nomeadas é a proposta deste guia.

ssh dev@devbox
cd ~/src/project

git worktree add ../project-feature-a -b feature-a
git worktree add ../project-bugfix -b bugfix

tmux new-session -d -s cc-feature-a -n claude -c "$HOME/src/project-feature-a"
tmux new-session -d -s cc-bugfix -n claude -c "$HOME/src/project-bugfix"

tmux attach-session -t cc-feature-a
# Now inside the feature worktree's tmux shell:
claude

Depois que o SSH conectar, execute os comandos restantes no host remoto. As duas sessões iniciadas sem um cliente conectado contêm, de início, apenas shells. Ao se conectar a uma delas e executar claude, você inicia a sessão de programação de forma visível, incluindo as solicitações normais de configuração. Quando quiser ativar a segunda tarefa, saia da primeira sessão sem encerrá-la, conecte-se a cc-bugfix e execute claude ali.

Cada worktree precisa da sua própria preparação do projeto, incluindo dependências e qualquer configuração local necessária. Confira o diretório e a branch antes de pedir ao Claude que edite arquivos. Fluxo manual de worktrees da Anthropic.

Se quiser um shell adicional para testes no checkout da funcionalidade, execute tmux new-window -t cc-feature-a -n checks -c "$HOME/src/project-feature-a" em um shell do host. Mantenha as verificações junto da tarefa à qual pertencem. Evite usar o checkout principal como área de trabalho compartilhada pelos dois agentes.

Se você também usa Codex, nosso guia de worktrees no Codex CLI aborda o fluxo dessa ferramenta separadamente.

Claude Code, SSH e tmux: como sair e voltar à sessão

Com o prefixo padrão do tmux, pressione Ctrl+B, solte as duas teclas e pressione D. Isso desconecta o cliente da sessão e devolve você ao shell remoto. Agora você pode encerrar a conexão SSH. Deixe o Claude em execução dentro da sessão.

Quando voltar, execute ssh dev@devbox, depois tmux list-sessions e, por fim, tmux attach-session -t cc-feature-a. Use o mesmo host remoto e a mesma conta de usuário. A partir do notebook, o equivalente em um único comando é ssh -t dev@devbox 'tmux attach-session -t cc-feature-a'.

Esses atalhos usam o prefixo padrão. Se você já o alterou, use o prefixo configurado. Dentro do tmux, troque de sessão em vez de abrir outro cliente tmux dentro do atual.

Ao se reconectar, você volta ao processo de terminal existente. Se esse processo terminou, recuperar a conversa é outra operação: claude --continue retoma a conversa mais recente no diretório atual, enquanto claude --resume abre um seletor. Nenhum dos dois substitui manter o processo original em execução. Fluxo de sessões na documentação da Anthropic.

Para acessar pelo celular ou navegador, veja o Claude Code Remote Control. A execução continua no host, que precisa permanecer ligado. Remote Control da Anthropic.

Use uma equipe de agentes quando as tarefas exigirem coordenação

As equipes de agentes são experimentais e vêm desativadas por padrão. Em um shell do tmux, inicie uma nova sessão interativa do líder com CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude --teammate-mode tmux. A variável de ambiente habilita as equipes nessa inicialização; a opção seleciona a divisão em painéis. Configuração de equipes de agentes da Anthropic.

O padrão atual é in-process. A opção auto usa painéis separados quando está dentro do tmux e recorre a outro modo quando necessário; tmux seleciona o modo de painéis separados com detecção do terminal. Para salvar essa preferência, use teammateMode em ~/.claude/settings.json. Os painéis separados dão a cada integrante um terminal visível próprio. A Anthropic lista o terminal integrado do VS Code, o Windows Terminal e o Ghostty como incompatíveis com esse modo. Modos de exibição e limitações na documentação da Anthropic.

Para um primeiro teste, eu daria ao líder esta tarefa bem delimitada:

As sessões cc-feature-a e cc-bugfix que você iniciou manualmente não viram integrantes de uma equipe só porque ambas estão no tmux. Criar uma equipe é uma decisão à parte sobre quem distribui as tarefas e concilia as conclusões. Prefira os subagentes do Claude Code quando quiser delegar tarefas específicas dentro de uma única sessão.

Um painel não é um checkout separado. Distribua arquivos diferentes entre os agentes ou use worktrees separados para edições independentes. Equipes também consomem mais tokens; o tmux não reduz esse consumo. Reconectar-se à sessão preserva o acesso a um terminal em execução, enquanto /resume não restaura os integrantes que rodavam no mesmo processo. Orientações da Anthropic sobre equipes.

Cinco situações em que essa organização faz sentido

Eu priorizaria os usos abaixo nesta ordem. Cada um descreve um fluxo possível, não um ganho de produtividade medido.

Meça o custo das interrupções antes de acrescentar mais automação. Como exemplo, cinco interrupções que exigem quatro minutos cada para reconstruir o contexto custam vinte minutos por semana. São valores hipotéticos, não resultados de benchmark. Registre seu próprio tempo de retomada, preparação e revisão; o fluxo se justifica se reduzir o tempo total. Mais agentes simultâneos não significam automaticamente uma relação melhor entre custo e benefício.

Duas ferramentas pequenas que vale a pena criar a partir desse fluxo

A oportunidade mais promissora é um inicializador de worktrees e sessões para equipes de desenvolvimento. Uma equipe de plataforma poderia pagar pela padronização de nomes de tarefas, caminhos de checkout e comandos de conexão entre seus desenvolvedores. A menor versão útil criaria ou localizaria um worktree, abriria sua sessão nomeada do tmux e mostraria a branch e o caminho antes de iniciar o Claude. Ela deveria pedir confirmação antes de remover um checkout.

A estimativa de palavras-chave do DataForSEO para os Estados Unidos, consultada em 12 de outubro de 2026, é de 480 buscas mensais por “tmux claude code”. É um sinal restrito de interesse na configuração, não uma contagem de compradores. O desafio é que um script interno curto pode bastar; um produto pago precisa oferecer configuração ou suporte específico para a equipe que poupe trabalho recorrente.

Um inventário de sessões remotas seria um segundo produto, de escopo mais restrito. Uma pequena equipe de engenharia poderia ter um lugar único para registrar aliases de hosts aprovados, nomes de sessões e caminhos de checkout, com um comando de conexão por SSH pronto para copiar. Comece pela descoberta e navegação; só acrescente controles de ciclo de vida se os usuários precisarem deles.

A mesma consulta ao DataForSEO estima 1,600 buscas mensais nos Estados Unidos por “claude code remote” e 70 por “claude code remote ssh”. A consulta mais ampla inclui pessoas à procura de outras interfaces remotas, portanto não valida, por si só, um produto de SSH. O desafio aqui é a gestão de acesso: o inventário precisa respeitar as permissões que cada desenvolvedor já tem nos hosts. Converse com equipes que priorizam o trabalho remoto antes de criar um painel.

Dúvidas que aparecem na prática

Para colocar em prática na segunda-feira: escolha uma tarefa remota, crie seu worktree e sua sessão nomeada e confirme que consegue sair e voltar à sessão antes de deixá-la sem supervisão. Só acrescente uma segunda tarefa independente depois que esse processo virar rotina.

Se sua equipe precisa incorporar esse fluxo ao ambiente de desenvolvimento, nós criamos sistemas de IA em produção.