Agent Relay permite que Claude Code envie uma mensagem direta para Codex e que Codex a leia sem você copiar texto entre terminais. É uma camada de mensageria open source (Apache-2.0) para agentes de IA: canais, DMs, threads, reações e ações tipadas, com cada mensagem escrita diretamente na sessão ativa do agente que a recebe.
No momento de publicação desta nota (25 de outubro de 2026), a versão mais recente é a v14.0.0, de 13 de outubro. O projeto publica versões maiores a cada poucas semanas, então confira o changelog antes de copiar comandos de tutoriais mais antigos.
O que é Agent Relay e para que serve?
Agent Relay é a camada de comunicação para quando você executa vários agentes de IA ao mesmo tempo. O README a apresenta como a infraestrutura tipo Slack que falta aos agentes: canais, threads, DMs, reações, arquivos, busca e eventos em tempo real, sem que você precise construir nada de chat.
Não substitui seus agentes nem é um framework de agentes. Claude Code, Codex e OpenCode continuam fazendo o trabalho. Relay lhes dá um espaço de trabalho compartilhado onde podem se encontrar, passar tarefas e informar progresso. Em inglês, isso é comunicação agent-to-agent dentro de um sistema multi-agent.
Há quatro formas de se conectar:
- O CLI
agent-relay, que lança agentes na sua máquina e os coloca no relay. agent-relay mcp, um servidor MCP que dá a qualquer agente ferramentas de mensageria comosend_dm,post_message,reply_to_threadecheck_inbox.@agent-relay/sdk, para sua própria app ou runtime.- Um prompt de uma linha que pede a um agente ler
https://agentrelay.com/skill.mde montar o time por conta própria.
Como se comunicam os agentes de IA entre si?
Todos os agentes entram no mesmo workspace, e cada mensagem é armazenada lá como um registro durável antes de avisar a ninguém. A documentação resume assim: primeiro o registro, depois o evento em tempo real.
O fluxo é este:
- Um agente envia uma mensagem para um canal, thread, DM ou DM em grupo.
- Relay resolve quem deve recebê-la e cria uma entrega para cada destinatário.
- Na sua máquina, um pequeno runtime em Rust (o broker) escreve a mensagem na sessão de terminal do destinatário e confirma que chegou.
- Se o destinatário está desconectado, a mensagem aguarda na sua caixa de entrada até que volte.
O passo 3 é o que o projeto chama de wake on message: você não precisa de um loop de polling. Uma sessão de Codex que está inativa recebe a mensagem injetada no seu prompt e começa a trabalhar. Os DMs também têm modo de entrega: wait injeta quando o agente fica livre, e steer injeta imediatamente e pode interromper o que está fazendo.
Cada agente no relay tem nome, handle, um ID estável e um estado: active, idle, blocked, waiting ou offline. Assim um agente líder sabe qual worker está livre.
Como se instala Agent Relay?
Você precisa de Node.js 22 ou superior. Instale o CLI globalmente:
npm install -g agent-relay
agent-relay --version
Confirme que você tem a 11.3.1 ou posterior. Versões anteriores mostravam a chave do workspace na saída de node up e node status.
Levante o broker local a partir da raiz do seu projeto e verifique que está rodando:
agent-relay node up --background --verbose
agent-relay node status --wait-for 10
Lance um agente líder e aponte-o para a skill de onboarding:
agent-relay node agent spawn claude --name Lead --task "Use https://agentrelay.com/skill. Start the workspace, coordinate workers, and report progress."
Da mesma forma, lance um worker de Codex dentro de um canal:
agent-relay node agent spawn codex --name reviewer --channels reviews --task "Review the docs."
Para observá-los, direcioná-los ou interrompê-los:
agent-relay node tail --agent Lead
agent-relay node agent attach Lead --mode drive
agent-relay node agent list
agent-relay node agent release reviewer
agent-relay node down
O teste mais rápido é o one-liner do próprio README. Cole-o em uma sessão de agente que você já tenha aberta e acrescente seu problema no final:
Use this skill https://agentrelay.com/skill.md to spin up a team of agents on the relay so we can work on this problem:
Como conectar um agente por MCP?
Se um agente não deve incorporar o SDK, levante o servidor MCP com a chave do seu workspace:
agent-relay workspace create support-triage
RELAY_WORKSPACE_KEY="$RELAY_WORKSPACE_KEY" agent-relay mcp
O agente chama uma vez register_agent e a partir daí pode entrar em canais, publicar, enviar DMs e revisar sua caixa de entrada. A chave do workspace (rk_live_…) é uma credencial administrativa, e a documentação é explícita: nunca a coloque em uma URL. Se quer que uma pessoa observe, use agent-relay observer, que gera um link de apenas leitura com vencimento.
O que mais precisa um sistema multiagente além do chat?
Três funções transformam o Relay de sala de chat em ferramenta de orquestração.
- Ações. Você registra uma função tipada com um esquema Zod e todos os agentes a veem como uma ferramenta MCP. O README traz dois exemplos: uma ação
spawn-claudepara que um agente lance outro, e uma açãosubmit-votepara que um time de agentes chegue a uma decisão estruturada. As ações são fire-and-forget: o agente recebe um aviso de recebimento e o resultado chega como um eventoaction.completed. - Listeners de eventos. Você reage a mudanças de estado a partir do seu código. Por exemplo: quando o agente engenheiro passa para
idle, publicar em#generalque está livre para a próxima tarefa. - Webhooks. Webhooks de entrada convertem eventos do GitHub Actions, Sentry ou Prometheus em mensagens de canal. Os de saída enviam eventos do Relay para seus serviços com assinatura HMAC.
Agent Relay funciona em local ou na nuvem?
Em ambos. O broker que executa seus agentes é local, mas o hub de mensageria está hospedado pelo projeto. A documentação de arquitetura localiza o motor em cast.agentrelay.com e esclarece que não existe um local. Em 25 de outubro de 2026, a documentação não descrevia nenhuma forma de auto-hospedar esse motor. As mensagens dos seus agentes passam pelo serviço de Agent Relay, então leve isso em conta antes de colocar código interno ou credenciais em um canal.
A introdução indica que você não precisa de uma API key para criar um workspace. No momento de publicação desta nota, as páginas que consultamos não publicavam preços do serviço hospedado.
A telemetria vem ativada por padrão. Conforme TELEMETRY.md, o CLI envia eventos de uso com um ID de máquina anônimo e com hash. Se você fizer login com agent-relay cloud login, também anexa os IDs da sua conta e organização. O projeto afirma que não coleta o conteúdo das mensagens, nomes de arquivos nem segredos. Para desativá-la:
agent-relay telemetry disable
Você também pode usar DO_NOT_TRACK=1 ou AGENT_RELAY_TELEMETRY_DISABLED=1. O comando agent-relay telemetry status mostra o que está sendo atribuído e a quem.
Agent Relay funciona no Windows?
Não de forma nativa para o runtime local. A partir da versão 12.1.0, node up se recusa a iniciar fora de macOS e Linux. WSL conta como Linux, então no Windows o caminho é executá-lo dentro de WSL.
Agent Relay ou Paperclip AI?
Eles resolvem camadas distintas, e você pode usar ambos. Paperclip AI modela uma organização: funções, um quadro de tarefas, orçamentos por agente e aprovações, e você hospeda. Agent Relay é o cabo que passa por baixo: quem pode escrever para quem e como essa mensagem chega de forma confiável a uma sessão ativa.
Se seu problema é “meus agentes não conseguem conversar entre si”, Relay é a solução mais pequena e direta. Se seu problema é “vinte agentes gastam dinheiro e ninguém sabe quem faz o quê”, você precisa da camada de gestão.
Também é diferente de Claude Code Channels, que permite que você escreva para uma sessão de Claude Code a partir de Telegram ou Discord. Relay é de agente para agente, entre provedores distintos. E se você ainda está escolhendo com qual trabalhar, nossa comparação Claude Code vs Codex explica como executar os dois com suas próprias chaves.
E você? Como coordena hoje o trabalho quando tem mais de um agente de IA aberto ao mesmo tempo?
- Copio e colo entre terminais
- Uso os subagentes do Claude Code
- Uso um orquestrador como Paperclip
- Prefiro outra opção (nos conte qual)
Comente abaixo ou, se este artigo chegou até você por email, responda diretamente ao email: sua resposta é publicada aqui.
Relacionado: Paperclip AI: o que é e como orquestar Claude Code, Codex e Cursor como um único time