Magpie vs CC Switch: que gerenciador de provedores para agentes você deve usar?

Claude Code, Codex e Gemini CLI são agentes. O modelo que responde às solicitações deles — e o provedor que disponibiliza esse modelo — são escolhas separadas. É para gerenciar essas escolhas em várias ferramentas que softwares como Magpie, CC Switch, Claude Code Router e CLIProxyAPI são úteis.

Resposta curta: considere Magpie para um gateway compartilhado entre agentes, CC Switch para um espaço de trabalho integrado para configurações em desktop, Claude Code Router para regras explícitas de roteamento de solicitações e CLIProxyAPI para um proxy compatível vinculado a contas. Esses pontos fortes se sobrepõem; não são quatro categorias exclusivas. CC Switch tem roteamento; Magpie tem recursos de espaço de trabalho; Claude Code Router oferece suporte a mais do que apenas Claude Code.

A pergunta útil não é qual produto tem a lista de recursos mais longa. É qual parte da configuração dos seus agentes você quer que ele gerencie.

Escopo: documentação oficial consultada em 3 de novembro de 2026. Esta é uma comparação baseada em documentação, não um benchmark prático, teste de confiabilidade ou auditoria de segurança. O suporte listado não comprova comportamento idêntico em todos os agentes, provedores e versões. A AIHubMix preparou esta comparação; o README do Claude Code Router lista a AIHubMix entre seus patrocinadores. Essa relação é divulgada aqui, e não tratada como evidência técnica.

Primeiro, diferencie o agente do serviço upstream

Um agente fornece o ambiente de trabalho: acesso a arquivos, ferramentas de shell, regras de aprovação e o ciclo da conversa. Um modelo fornece respostas. Um provedor dá acesso ao modelo por meio de um endpoint, uma chave de API ou, quando há suporte, um login de conta.

Mudar o modelo upstream não transforma Claude Code em Codex. Da mesma forma, uma resposta bem-sucedida da API não comprova que todas as chamadas de ferramenta, imagens, campos de raciocínio ou conversas longas funcionarão de maneira idêntica.

Por isso, esta comparação se concentra em softwares que controlam agentes de programação existentes. Um serviço de modelos hospedado ou um gateway para o backend de um aplicativo resolve um problema relacionado, mas não é necessariamente a ferramenta que gerencia a configuração do seu agente local.

É fácil confundir cinco operações:

• Troca de configuração altera o endpoint, a chave ou o modelo usado pelo agente.
• Roteamento local coloca um gateway entre o agente e o serviço upstream. O gateway pode selecionar um destino ou converter formatos de API.
• Agregação de modelos expõe modelos de vários provedores em uma única lista de seleção. Isso não oferece failover por si só.
• Conjunto de contas seleciona entre credenciais ou contas. A distribuição em rodízio é uma estratégia de distribuição, não uma promessa de que toda solicitação com falha será recuperada.
• Failover tenta outro destino configurado após uma falha que atenda aos critérios. O escopo e as condições dependem da implementação.

Comece pela operação de que precisa e, em seguida, escolha o produto.

Uma lista rápida

Use esta tabela para decidir por onde começar e, em seguida, confira as restrições detalhadas abaixo.

CCR significa Claude Code Router. Essas listas editoriais se sobrepõem; não são conjuntos exclusivos de recursos nem classificações baseadas em medições. O Magpie precisa de outro destino utilizável para o failover; a agregação do CC Switch não oferece failover; as regras do CCR precisam ser validadas; a interface complementar para desktop e as estatísticas do CLIProxyAPI são componentes separados. A compatibilidade varia de acordo com o agente e o provedor.

Magpie: coloque vários agentes atrás de um único gateway de modelos

Magpie combina o gerenciamento nativo da configuração de agentes com um gateway local compartilhado. As integrações documentadas incluem Claude Code, Codex, Gemini CLI, OpenCode, Cline e Cursor CLI, entre outros. A interface mostra as instalações detectadas; um cliente que aceite um URL base compatível também pode usar o gateway, o que é diferente de ter uma integração nativa dedicada.

O gateway converte os formatos OpenAI Chat, OpenAI Responses, Anthropic Messages e Gemini. Os provedores podem incluir serviços que usam chaves de API, endpoints personalizados compatíveis, servidores de modelos locais e contas de assinatura compatíveis. Os perfis salvam a configuração de vários agentes com um único nome.

A ideia que o diferencia é um grupo de roteamento: vários modelos ou provedores apresentados ao agente como uma única opção. Os modos documentados incluem:

• order: usa o primeiro membro até que ele não consiga responder; depois tenta o próximo.
• rotate: passa a outro membro a cada turno.
• usage: prioriza o membro menos utilizado.
• smart: entre as assinaturas elegíveis que ainda têm cota, prioriza aquela cuja cota será renovada primeiro.
• pace: seleciona conforme a capacidade semanal restante em relação ao tempo até a renovação.

Os grupos podem ser aninhados. O Magpie também descreve como manter uma conversa na conta que respondeu, preservando o cache de prompt, quando isso for vantajoso. Essa é uma política de roteamento, não uma prova de que mudanças arbitrárias de provedor preservam o estado em cache. O roteamento opcional por intenção usa um modelo escolhido pelo usuário para ler novos turnos; a documentação não comprova que isso sempre reduza custos.

Há um limite simples, mas importante, para o failover: é preciso haver outro destino utilizável. O README afirma explicitamente que, sem um grupo de roteamento, uma única conta não oferece outro destino para o failover; portanto, o erro chega ao agente.

O Magpie não é apenas um roteador. Sua Library gerencia instruções, servidores MCP, habilidades e subagentes. Também documenta visualizações de uso, cota, custos e sessões. Oferece interfaces para desktop, terminal, navegador e CLI, e lista macOS, Windows, Linux, Docker e Termux entre os ambientes compatíveis.

Os controles de privacidade merecem uma decisão à parte

A mascaragem do Magpie vem desativada por padrão. Quando ativada, detecta localmente valores confidenciais compatíveis, substitui-os por marcadores antes da transmissão e os restaura nas respostas, inclusive nos argumentos de ferramentas. A detecção pode falhar; o modelo não pode examinar o valor original de algo que foi mascarado. Se a mascaragem estiver ativada, mas não puder ser executada, o README descreve o bloqueio da solicitação com HTTP 503.

Isso não garante que todos os segredos serão detectados. Leia a documentação de privacidade, incluindo as informações sobre detecção de contas: o Magpie pode ler logins existentes dos agentes, e essa detecção pode ser desativada.

O README também descreve uma telemetria diária nas versões de lançamento, que inclui um identificador aleatório, a versão, o sistema e identificadores de uso do produto. As configurações de privacidade ou DO_NOT_TRACK=1 podem desativar essa telemetria. Cliques em links de parceiros e consultas à lista de parceiros são contabilizados independentemente desses controles; segundo o README, esses dados não retêm identificadores nem endereços. Portanto, “gateway local” não deve ser interpretado como “nenhuma outra atividade de rede”.

Considere o Magpie se: você quiser que vários agentes compartilhem escolhas de provedor, modelo e roteamento de contas. A contrapartida é assumir a responsabilidade pelas políticas de roteamento, pelo acesso às credenciais e pelas configurações de privacidade — não apenas escolher um modelo em um menu.

CC Switch: um espaço de trabalho para desktop que também roteia solicitações

Dizer que o CC Switch é apenas um alternador de configurações subestima o escopo documentado. Além do gerenciamento de provedores, ele oferece MCP, habilidades, bibliotecas de prompts, configurações de projetos, sessões, acompanhamento de uso, backups e sincronização. Entre os clientes listados estão Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode e outros, mas a disponibilidade de recursos varia conforme o cliente.

Seus três modos de conexão explicam boa parte da comparação:

Direto conecta o agente ao provedor selecionado. A troca altera os campos relacionados à conexão, enquanto o projeto informa que hooks, plugins, configurações de MCP e comentários não relacionados são mantidos.

Roteamento encaminha as solicitações localmente pelo CC Switch. Ele converte os formatos Anthropic Messages, OpenAI Chat Completions, OpenAI Responses e Gemini Native, além de oferecer filas de failover por ferramenta, circuit breaker e monitoramento da integridade dos provedores.

Agregação, para Claude Code e Codex, coloca modelos de vários provedores no seletor de modelos do cliente. As solicitações vão para o provedor do modelo escolhido. A agregação não oferece failover. Ela também tem restrições quanto aos provedores, incluindo a impossibilidade de usar assinaturas oficiais do Claude na agregação. Em geral, provedores com login oficial não podem usar o modo Roteamento; o OpenAI Official do Codex é uma exceção documentada.

Isso faz do CC Switch uma opção válida tanto para a simples troca de configurações quanto para o roteamento local. O foco em um espaço de trabalho para desktop é um motivo editorial para incluí-lo na lista, não uma evidência de que as alternativas não tenham bibliotecas ou visualizações de sessões.

Os limites práticos importam mais do que a quantidade de predefinições

O CC Switch documenta a troca a quente para Claude Code. Em geral, a alteração direta de provedor no Codex, Gemini CLI e Grok Build exige uma reinicialização; o Roteamento ainda pode exigir uma quando o modelo muda. Alterações na lista de agregação do Codex exigem reiniciar o daemon, aplicativo ou ambiente de editor relevante. Planeje isso fora de uma tarefa em andamento.

Outra distinção útil aparece nas perguntas frequentes: o teste de conectividade do cartão de provedor verifica se o serviço pode ser alcançado, não se a chave de API ou o modelo funciona. Uma marca verde não é um teste de aceitação de ponta a ponta.

Por padrão, os dados ficam em ~/.cc-switch, com um banco de dados SQLite e arquivos associados. O README descreve backups da configuração original antes da primeira regravação, backups automáticos e sincronização compatível com WebDAV/S3. Algumas configurações de dispositivo, o estado e os backups da configuração original permanecem locais e fora da sincronização em nuvem. Não presuma que a sincronização do aplicativo transfira todos os dados necessários para recuperar o estado.

O aplicativo oficial foi desenvolvido para desktops com interface gráfica no macOS, Windows e Linux. Consulte o manual do usuário para ver a matriz exata de recursos por agente e as restrições dos modos.

Considere o CC Switch se: as mudanças de provedor fizerem parte de um fluxo de trabalho mais amplo no desktop, que envolva MCP, habilidades, prompts e projetos. Se tudo o que você precisa é de um proxy reutilizável sem interface gráfica, avalie esse requisito separadamente em vez de presumir que os recursos para desktop sejam equivalentes.

Claude Code Router: torne explícitas as decisões de roteamento

Claude Code Router, ou CCR, agora se descreve como um gateway multiagente e plano de controle. Seu README lista Codex, OpenCode, Pi, Kimi CLI, Grok CLI e outros clientes, além do Claude Code.

Os recursos documentados colocam as políticas de requisição no centro: condições em cabeçalhos e corpos de requisição, prefixos, reescrita de requisições, novas tentativas e modelos alternativos em ordem. Pools de credenciais e rotação de chaves coexistem com perfis de agente, substituições de modelo e configurações de ambiente.

Essa combinação é útil quando “selecionar outro provedor” é vago demais. Talvez você queira que uma condição específica de requisição selecione um upstream específico e, depois, precise verificar por que essa regra foi acionada.

O CCR documenta detalhes de requisições e respostas, o provedor/modelo/credencial resolvido, status, latência, tokens, custo estimado, chamadas de ferramenta e rastreamentos. As estimativas de custo não correspondem à fatura do upstream. Os logs permitem inspecionar uma política; não comprovam que ela melhora a qualidade das tarefas.

O projeto oferece downloads para desktop no macOS, Windows e Linux, uma CLI npm com interface de gerenciamento no navegador e implantação via Docker. A CLI npm requer Node.js 22 ou posterior. Seu guia de provedores aborda endpoints personalizados, seleção de protocolo e pools de credenciais; também alerta que os testes de conexão enviam requisições ao upstream e podem consumir uso ou limites de requisições.

Inclua o CCR na lista de opções se: você precisa de regras de roteamento explícitas e de uma explicação da rota resolvida. A contrapartida é a política que você terá de manter. Mais condições e caminhos alternativos significam mais combinações para validar, não resultados automaticamente melhores.

CLIProxyAPI: comece com contas e um proxy compatível

CLIProxyAPI parte de um modelo de servidor proxy. Ele oferece interfaces compatíveis com OpenAI, incluindo Responses, interfaces compatíveis com Gemini, incluindo Interactions, e interfaces compatíveis com Claude para clientes e SDKs.

Seu README documenta suporte a OAuth para Codex e Claude Code, acesso a contas Gemini e balanceamento round-robin entre várias contas de diversos provedores. Também aceita upstreams configurados compatíveis com OpenAI e oferece um SDK reutilizável em Go.

Este é um ponto de partida útil quando o requisito central é um endpoint compatível respaldado por contas ou credenciais. Isso não comprova que o projeto principal edite nativamente os perfis de todos os agentes.

Dois detalhes de empacotamento afetam a decisão:

• O README recomenda um aplicativo complementar para desktop separado, o EasyCLIProxyAPI, para configuração gráfica, atualizações, controles na bandeja do sistema e inicialização/parada do serviço.
• Desde a v6.10.0, CLIProxyAPI e CPAMC não incluem mais estatísticas de uso integradas; o README aponta para projetos separados de estatísticas e gerenciamento.

Considere o proxy, o aplicativo complementar para desktop e o serviço de análise como componentes separados ao estimar a manutenção. Não conclua que o CLIProxyAPI não oferece controles de novas tentativas ou recuperação: confira a configuração da versão escolhida. Da mesma forma, não confunda a distribuição round-robin entre contas com uma política garantida de fallback entre modelos.

Inclua o CLIProxyAPI na lista de opções se: o que você precisa é do proxy baseado em contas e você se sente à vontade para escolher separadamente os componentes de gerenciamento ao redor dele.

Antes de conectar um projeto real

Essas ferramentas ficam próximas das credenciais, do contexto do código-fonte e das ações executáveis dos agentes. Um processo local ainda faz parte do seu limite de confiança.

Primeiro, diferencie uma chave de API de um login por assinatura. O fato de um software oferecer suporte a um fluxo OAuth não significa que o provedor permita qualquer uso entre clientes. O CC Switch alerta explicitamente contra o uso da assinatura fora dos clientes oficiais. Confira os termos atuais do provedor e as regras da sua organização; um gerenciador não concede direitos adicionais nem remove limites.

Em segundo lugar, decida quem é responsável por cada arquivo de configuração. Como precaução operacional, evite que vários gerenciadores reescrevam automaticamente as mesmas configurações de agente. Faça cópias de segurança dos arquivos originais e saiba como voltar ao acesso direto. Essa recomendação não afirma que tenha sido demonstrado algum defeito nesses produtos.

Em terceiro lugar, verifique como as credenciais e os logs são tratados. Esta comparação não verificou a criptografia em repouso. Revise as permissões, o escopo de backup/sincronização, a descoberta de contas e o conteúdo dos logs de requisições antes de importar credenciais de produção. Se habilitar o acesso remoto, revise as configurações de autenticação e exposição, em vez de tratar uma configuração local padrão como garantia de segurança.

Por fim, teste o comportamento dos protocolos, não apenas seus nomes. OpenAI Chat Completions e Responses são APIs diferentes; Anthropic Messages e Gemini têm estruturas próprias. Uma alegação de conversão não garante um comportamento sem perdas para todas as ferramentas, campos de raciocínio ou imagens.

Um pequeno exercício de aceitação

O exercício a seguir é uma proposta para o leitor, não um teste realizado para este artigo:

1. Use um repositório descartável e credenciais de teste com poucos privilégios. Guarde uma cópia da configuração original do agente.
2. Conecte um agente a um provedor. Verifique uma resposta simples e confira qual provedor/modelo foi realmente selecionado.
3. Peça ao agente que leia um arquivo inofensivo e proponha uma pequena alteração. Verifique um ciclo completo de chamada de ferramenta/resultado e a conclusão do streaming antes de permitir gravações.
4. Adicione uma segunda rota somente se necessário. Com um mock local seguro ou uma configuração de teste autorizada, verifique a condição de falha prevista e se o destino alternativo documentado é selecionado. Evite esgotar intencionalmente cotas pagas.
5. Confirme que as novas tentativas ou a recuperação não provocam ações repetidas de ferramentas com efeitos colaterais no seu fluxo de trabalho. Este é um critério de aceitação, não um bug observado no produto.
6. Pare o gerenciador e verifique o procedimento documentado para voltar ao acesso direto ou restaurar a configuração. Confira os requisitos de reinicialização e, em seguida, compare as estimativas de uso com os registros do provedor.

Escolha a configuração mais simples que passe neste exercício. Se um agente usando seu provedor oficial já atende às suas necessidades, adicionar um gateway local talvez não resolva problema algum.

Veredito: escolha um responsável, não um vencedor

Para roteamento compartilhado de modelos e contas entre agentes, comece pelo Magpie. Para configuração para desktop e gerenciamento de espaços de trabalho, comece pelo CC Switch. Para políticas explícitas de requisição e inspeção de rotas, comece pelo CCR. Para um proxy reutilizável baseado em contas, comece pelo CLIProxyAPI e leve em conta seus componentes complementares.

Estas recomendações descrevem os aspectos enfatizados na documentação, não uma superioridade mensurada. O resultado certo é uma configuração em que você consegue explicar qual modelo processou uma requisição, quais credenciais usou, o que acontece em caso de falha e como desfazer a alteração.

Perguntas frequentes

O CC Switch é apenas um alternador de configurações?
Não. Ele documenta os modos Direct, Routing e Aggregation, incluindo conversão local de formatos e filas de failover por ferramenta. A disponibilidade varia de acordo com o cliente e o provedor.

A agregação oferece fallback automaticamente?
Não. O CC Switch diferencia explicitamente agregação de failover. Um seletor de modelos combinado não é uma política de recuperação.

O Magpie mantém todas as requisições locais?
Não. Seu gateway é executado localmente, mas a inferência com provedores remotos envia requisições ao upstream. O README também documenta controles de telemetria e a contagem separada de eventos de parceiros. A ocultação opcional fica desativada por padrão e pode não detectar alguns valores ou classificá-los incorretamente.

Trocar de modelo altera as ferramentas e permissões do agente?
Não por si só. O agente continua responsável pelo ambiente de ferramentas e pelas regras de permissão; ainda é preciso validar como o novo modelo lida com essas ferramentas.

Um login por assinatura pode substituir uma chave de API em qualquer cliente?
Não presuma que sim. O suporte técnico ao login, os modelos disponíveis, os direitos da conta e a autorização do provedor são questões diferentes. Confira os termos atuais e as políticas da organização.

Qual produto é o mais rápido ou seguro?
Esta comparação não pode determinar isso. Ela se baseia na documentação oficial e não inclui benchmark de desempenho independente, medição de confiabilidade ou auditoria de segurança.

Fontes

Fontes oficiais consultadas em November 3, 2026:

1. README do Magpie — gateway, agentes, grupos, Library e comportamento de privacidade.
2. README do CC Switch — modos de conexão, cobertura por agente, reinicializações e armazenamento.
3. README do Claude Code Router — perfis de agente, roteamento, credenciais e implantação.
4. README do CLIProxyAPI — interfaces compatíveis, contas, software complementar e limites das estatísticas.
5. Guia de provedores do CCR — protocolos upstream, provedores personalizados, pools de credenciais e custos das requisições de teste.