Como Configurar Revisão de Código Multi-LLM com Claude, Codex e Gemini

Todo LLM tem pontos cegos. Claude é forte em arquitetura e padrões de design. Codex captura bugs lógicos e tratamento de erros ausentes. Gemini é minucioso em questões de segurança e casos extremos. Usar apenas um revisor significa que você está obtendo apenas uma perspectiva.

Este tutorial orienta sobre como configurar llm-cli-gateway -- um servidor MCP que envolve os CLIs do Claude Code, Codex e Gemini -- e executar uma revisão de código paralela que combina os três.

Pré-requisitos

Você precisa ter as ferramentas CLI instaladas:

# Claude Code
npm install -g @anthropic-ai/claude-code

# Codex
npm install -g @openai/codex
codex login

# Gemini
npm install -g @google/gemini-cli

Você não precisa dos três. O gateway funciona com qualquer um dos CLIs que você tiver instalado.

Passo 1: Instalar o Gateway

Adicione-o à configuração do seu cliente MCP. Se você usar o Claude Code, edite ~/.claude/settings.json:

{
  "mcpServers": {
    "llm-gateway": {
      "command": "npx",
      "args": ["-y", "llm-cli-gateway"]
    }
  }
}

Essa é toda a configuração. O gateway descobre seus CLIs instalados automaticamente via resolução de PATH (incluindo ~/.local/bin e caminhos NVM).

Passo 2: Verifique sua Configuração

Uma vez conectado, confirme quais CLIs estão disponíveis:

list_models()

Isso retorna os modelos disponíveis para cada CLI detectado. Se um CLI não estiver instalado, ele não aparecerá na saída.

Passo 3: Execute uma Revisão de Código Paralela

Aqui está o fluxo de trabalho principal. Você envia a mesma base de código para os três LLMs, cada um com um prompt ajustado para suas forças.

Claude -- Arquitetura e Qualidade

claude_request({
  "prompt": "Revise as alterações em src/auth/ para arquitetura, padrões de design, manutenibilidade e lacunas na documentação. Leia os arquivos diretamente. Forneça números de linha específicos e sugestões de correções.",
  "optimizePrompt": true,
  "optimizeResponse": true
})

Codex -- Lógica e Correção

codex_request({
  "prompt": "Analise src/auth/ para bugs lógicos, erros de um-off, tratamento de erros ausentes, condições de corrida e lacunas na cobertura de testes. Leia os arquivos diretamente. Classifique cada descoberta: crítica, alta, média ou baixa.",
  "fullAuto": true,
  "optimizePrompt": true,
  "optimizeResponse": true
})

Gemini -- Segurança e Casos Extremos

gemini_request({
  "prompt": "Auditoria de segurança de src/auth/: verifique se há vulnerabilidades de injeção, bypass de autenticação, vazamentos de dados, violações do OWASP Top 10 e casos extremos que causam falhas. Leia os arquivos diretamente.",
  "model": "gemini-2.5-pro",
  "optimizePrompt": true,
  "optimizeResponse": true
})

Em um cliente MCP como o Claude Code, você pode disparar todos os três como chamadas de ferramenta paralelas em uma única vez.

Passo 4: Lidar com Revisões Longas

Revisões de código em arquivos grandes podem levar mais de um minuto. O gateway lida com isso de forma transparente.

Qualquer solicitação de sincronização que exceda 45 segundos automaticamente se torna um trabalho assíncrono. Em vez de expirar, você recebe uma referência de trabalho:

{
  "status": "deferred",
  "jobId": "abc-123",
  "message": "Executando em segundo plano. Consulte com llm_job_status."
}

Verifique:

llm_job_status({ "jobId": "abc-123" })

Quando o status for completed, busque o resultado:

llm_job_result(