Como rodar vários agentes Claude Code em paralelo
Trabalho paralelo com Claude Code precisa de isolamento, visibilidade e uma forma rápida de encontrar a sessão que precisa de input. O cmux dá a cada tarefa um workspace visível e mantém as sessões Claude legíveis enquanto rodam lado a lado.
Fluxo paralelo seguro
Crie uma ramificação, árvore de trabalho, checkout, pasta repo ou espaço de trabalho personalizado por tarefa, abra cada um no cmux, execute o agente normalmente e, em seguida, use atalhos não lidos e notificações cmux de ganchos, notificação OSC ou cmux para revisar as sessões que precisam de você. Claude Code, Codex e OpenCode permanecem como agentes; cmux cuida da superfície de supervisão.
| Abordagem | Isolamento | Visibilidade | Melhor uso |
|---|---|---|---|
| Uma aba de terminal por tarefa | Manual | Fraca | Experimentos pequenos |
| Panes do tmux | Manual | Média | Fluxos de shell remoto |
| Git worktrees manuais | Forte | Manual | Trabalho paralelo cuidadoso |
| Workspaces do cmux | Funciona com seu setup de branch/worktree | Forte | Muitas sessões Claude visíveis no macOS |
| cmux claude-teams | Mapeamento nativo de panes para sessões teammate | Forte | Equipes de agentes Claude Code com divisões cmux nativas em vez de painéis tmux/iTerm2 |
Dê uma casa visível a cada tarefa
O principal modo de falha de agentes paralelos é perder o controle de qual terminal pertence a qual tarefa. Workspaces do cmux mantêm branch, diretório, portas e output mais recente visíveis na sidebar.
Use anéis de notificação como fila de revisão
Quando um agente emite uma notificação cmux por meio de ganchos, notificação OSC 99/777 ou cmux, cmux marca o espaço de trabalho como não lido e toca o painel. Cmd+Shift+U salta para o último item não lido. Cmd+Control+U marca o item atual como não lido mais antigo e salta para o próximo item não lido mais recente, o que é útil quando vários agentes terminam ao mesmo tempo.
Mantenha Claude Code inalterado
cmux não substitui Claude Code, Codex ou OpenCode. Você executa os mesmos CLIs com suas contas e configurações existentes, enquanto o cmux adiciona espaços de trabalho, notificações e automação de soquete em torno da sessão do terminal.
Use teammate mode quando fizer sentido
Para o teammate mode do Claude Code, o cmux pode traduzir panes teammate no estilo tmux em splits nativos do cmux, para que spawned teammates continuem visíveis com metadados na sidebar e notificações.
FAQ
O cmux cria Git worktrees automaticamente?
Não por padrão. cmux pode ser programado para criar espaços de trabalho em torno de seu branch, árvore de trabalho, multi-repo, no-git, code-to-main ou fluxo de desenvolvimento remoto, para que você possa manter a configuração do repositório que se adapta ao seu projeto.
Claude Code e Codex podem rodar lado a lado?
Sim. O cmux é agnóstico a agentes, então Claude Code, Codex, OpenCode e outros agentes CLI podem rodar em workspaces separados ao mesmo tempo.
Qual atalho é mais importante para agentes paralelos?
Cmd+Shift+U é o atalho principal de supervisão porque salta para o item não lido mais recente. Cmd+Control+U é útil quando você deseja marcar o item atual como não lido mais antigo e pular para o próximo item não lido mais recente.
O cmux é gratuito e de código aberto para macOS.