# Como rotear papéis do T25 entre Claude Code, Codex e Cursor > Configure cada estágio para usar o CLI certo e deixe uma alternativa em ordem de preferência. - Por: Djan Magno - Publicado em: 2026-09-27 - Atualizado em: 2026-09-27 - URL: https://t25.io/blog/rotear-papeis-para-clis-de-agente/ - Guias · orquestração de agentes, Claude Code, Codex, Cursor, configuração, fallback > **Resumo:** > - O roteamento do T25 associa cada papel do pipeline a uma lista ordenada de CLIs, por exemplo, Claude Code, Codex e Cursor. > - A lista informa a preferência e o fallback disponível. Não significa que todos os agentes vão trabalhar juntos na mesma etapa. > - Antes de configurar o arquivo, confirme que cada CLI está instalado e autenticado na máquina que executa o T25. > - O roteiro abaixo muda o YAML. O T25 continua controlando os estágios, validações e gates do pipeline. ## O que significa rotear um papel No T25, **rotear um papel** é escolher quais adapters CLI podem executar uma função do pipeline, como `planner`, `dev-backend` ou `reviewer`, e em que ordem devem ser considerados. A configuração fica em `routing` no `t25.yaml`. Isso é diferente de escolher um agente para toda a tarefa. Uma ordem passa por vários papéis, e cada um pode ter uma lista própria. O [artigo sobre a arquitetura do T25](https://t25.io/blog/por-que-o-t25-orquestra-clis-de-agente/) explica por que os CLIs executam o trabalho enquanto o pipeline mantém o controle das transições. ## Confira os CLIs primeiro O T25 não instala nem autentica o Claude Code, Codex ou Cursor por você. Instale cada CLI que pretende usar e conclua o login no mesmo ambiente em que roda o processo do T25. Se o T25 roda dentro de um container ou serviço, confirme que esse ambiente enxerga os binários e as credenciais necessários. No repositório atual, os adapters chamam `claude`, `codex` e `cursor-agent`. A documentação lista também `kimi`, `gemini`, `opencode`, `pi`, `vibe` e `mock`. Para detalhes específicos de login e planos de cada fornecedor, use a documentação oficial do CLI: esses requisitos podem mudar independentemente do T25. ## Configure uma ordem por papel O exemplo abaixo mostra três CLIs suportados em cada papel. A ordem varia conforme a preferência: Claude Code, Codex e Cursor podem servir como primeira opção ou fallback, desde que estejam instalados e autenticados no ambiente do T25: ```yaml routing: triage: [claude, codex, cursor] planner: [claude, cursor, codex] research: [claude, codex, cursor] dev-frontend: [cursor, claude, codex] dev-backend: [codex, claude, cursor] qa-frontend: [cursor, claude, codex] qa-backend: [codex, cursor, claude] reviewer: [claude, codex, cursor] security: [claude, cursor, codex] docs: [claude, codex, cursor] release: [claude, cursor, codex] ``` É um ponto de partida ilustrativo, não uma recomendação universal. A ordem deve refletir os CLIs instalados e as preferências do seu projeto. Os nomes dos onze papéis e dos adapters precisam corresponder aos aceitos pelo T25; cada lista deve ser não vazia. O T25 considera a lista ordenada e resolve os providers disponíveis para o papel. Uma alternativa configurada não corrige credenciais expiradas, permissões insuficientes ou diferenças de comportamento entre CLIs. Trate cada CLI como uma dependência a verificar, e confira o resultado da tarefa quando houver fallback. ## Um fluxo simples para começar 1. Comece com dois CLIs instalados e autenticados, em vez de configurar todos de uma vez. 2. Escolha um papel e uma tarefa pequena, como uma correção de documentação, e defina uma lista curta em `t25.yaml`. 3. Rode uma tarefa pequena e confira no cockpit qual adapter foi selecionado e como terminou. 4. Acrescente fallback ou mude a ordem apenas depois de observar a execução. 5. Repita para os papéis de implementação, QA e revisão. A seleção de um CLI não remove os gates do pipeline. Se quiser entender o isolamento do trabalho antes de rodar uma ordem, leia [uma ordem, um worktree](https://t25.io/blog/uma-ordem-um-worktree-isolando-agentes-de-codigo/). Para a configuração completa, consulte a [referência de configuração](https://t25.io/docs/). ## Onde esse roteamento não ajuda Uma lista maior não garante que uma tarefa vai terminar. Todos os CLIs podem estar indisponíveis; uma credencial pode falhar; e respostas diferentes podem exigir ajustes no prompt ou no processo. O roteamento dá opções de execução. Ele não substitui a revisão do diff nem a decisão humana de merge. Também não é uma forma de compartilhar a mesma sessão entre CLIs. Cada adapter executa seu próprio processo e usa a configuração e autenticação daquele CLI. Se uma ferramenta específica for necessária para todos os papéis, deixe isso explícito na configuração, em vez de presumir que o fallback preservará esse requisito. ## Perguntas frequentes ### Preciso configurar os onze papéis? O T25 reconhece onze papéis de pipeline. O exemplo mostra todos para deixar visível onde configurar cada um; comece com a configuração que o seu fluxo precisa e preserve as regras de validação do projeto. ### Posso usar Claude Code, Codex e Cursor na mesma tarefa? Sim, papéis diferentes podem ter listas diferentes e usar adapters distintos. Isso não quer dizer que os três sejam chamados em cada etapa. ### O T25 fornece as credenciais dos provedores? Não. Você instala e autentica os CLIs no ambiente de execução. Consulte a documentação de cada fornecedor para requisitos atuais de conta, plano e login. ### Fallback significa tentar de novo após qualquer falha? Não assuma isso. A configuração define a ordem dos candidatos; as condições de seleção e retry dependem do caminho de execução. Inspecione o adapter e o resultado registrado para diagnosticar um caso concreto. ### O roteamento faz o merge automaticamente? Não. O T25 pode levar o trabalho até a etapa correspondente, mas a revisão e o merge continuam sujeitos aos gates configurados e à ação humana.