Magpie vs CC Switch: quale gestore di provider per agenti scegliere?

Claude Code, Codex e Gemini CLI sono agenti. Il modello che risponde alle loro richieste e il fornitore che lo rende disponibile sono scelte separate. Gestire queste scelte su più strumenti è il punto in cui software come Magpie, CC Switch, Claude Code Router e CLIProxyAPI diventa utile.

In breve: considera Magpie per un gateway condiviso tra più agenti, CC Switch per uno spazio di lavoro desktop integrato per la configurazione, Claude Code Router per regole esplicite di instradamento delle richieste e CLIProxyAPI per un proxy compatibile basato su account. Sono punti di forza che si sovrappongono, non quattro categorie esclusive. CC Switch offre l’instradamento; Magpie include funzionalità per gli spazi di lavoro; Claude Code Router supporta più di Claude Code.

La domanda utile non è quale prodotto abbia l’elenco di funzionalità più lungo. È quale parte della configurazione dei tuoi agenti vuoi affidargli.

Ambito: documentazione ufficiale consultata il 3 novembre 2026. Questo è un confronto basato sulla documentazione, non un benchmark pratico, un test di affidabilità o un audit di sicurezza. Il supporto dichiarato non dimostra un comportamento identico con ogni agente, fornitore e versione. AIHubMix ha preparato questo confronto; il README di Claude Code Router annovera AIHubMix tra gli sponsor. La presenza nell’elenco viene dichiarata qui e non è considerata una prova tecnica.

Per prima cosa, distingui l’agente dal suo upstream

Un agente fornisce l’ambiente di lavoro: accesso ai file, strumenti shell, regole di approvazione e ciclo della conversazione. Un modello genera le risposte. Un fornitore consente di accedere a quel modello tramite un endpoint, una chiave API oppure, se supportato, un accesso con account.

Cambiare il modello upstream non trasforma Claude Code in Codex. Allo stesso modo, una risposta API riuscita non dimostra che ogni chiamata allo strumento, immagine, campo di ragionamento o conversazione di lunga durata si comporterà nello stesso modo.

Per questo il confronto si concentra sul software che controlla gli agenti di codifica esistenti. Un servizio di modelli ospitato o un gateway per il backend di un’applicazione risolve un problema adiacente; non è necessariamente lo strumento che gestisce la configurazione del tuo agente locale.

È facile confondere cinque operazioni:

• Cambio della configurazione modifica l’endpoint, la chiave o il modello usato da un agente.
• Instradamento locale inserisce un gateway tra l’agente e il suo upstream. Il gateway può selezionare una destinazione o convertire i formati API.
• Aggregazione dei modelli rende disponibili i modelli di più fornitori in un unico elenco di selezione. Non offre automaticamente il failover.
• Pooling degli account seleziona tra credenziali o account. Il round robin è una strategia di distribuzione, non una garanzia che ogni richiesta non riuscita venga recuperata.
• Failover prova un’altra destinazione configurata dopo un errore che soddisfa determinate condizioni. L’ambito e le condizioni dipendono dall’implementazione.

Inizia dall’operazione di cui hai bisogno, poi scegli il prodotto.

Una selezione rapida

Usa questa tabella per decidere da dove iniziare, poi verifica le restrizioni dettagliate riportate sotto.

CCR sta per Claude Code Router. Queste selezioni editoriali si sovrappongono: non rappresentano capacità esclusive né classifiche misurate. Per il failover, Magpie ha bisogno di un’altra destinazione utilizzabile; l’aggregazione di CC Switch non prevede failover; le regole di CCR vanno convalidate; l’app desktop complementare e le statistiche di CLIProxyAPI sono componenti separati. La copertura varia in base all’agente e al fornitore.

Magpie: fai passare più agenti dallo stesso gateway per i modelli

Magpie combina la gestione nativa della configurazione degli agenti con un gateway locale condiviso. Le integrazioni documentate includono Claude Code, Codex, Gemini CLI, OpenCode, Cline e Cursor CLI, tra gli altri. L’interfaccia mostra le installazioni rilevate; anche un client che accetta un URL di base compatibile può usare il gateway, ma questo non equivale a un’integrazione nativa dedicata.

Il gateway converte i formati OpenAI Chat, OpenAI Responses, Anthropic Messages e Gemini. Tra i fornitori possono esserci servizi con chiave API, endpoint personalizzati compatibili, server di modelli locali e account in abbonamento supportati. I profili salvano con un unico nome le configurazioni di più agenti.

L’idea distintiva è un gruppo di instradamento: diversi modelli o fornitori presentati all’agente come un’unica scelta. Le modalità documentate includono:

• order: usa il primo membro finché non può rispondere, poi prova il successivo.
• rotate: passa a un altro membro a ogni turno.
• usage: preferisce il membro meno utilizzato.
• smart: tra gli abbonamenti idonei con quota residua, preferisce quello la cui quota si azzera prima.
• pace: seleziona in base alla capacità settimanale residua rispetto al tempo che manca al ripristino.

I gruppi possono essere annidati. Magpie descrive anche una funzione che mantiene la conversazione sull’account che ha risposto, quando vale la pena preservarne la cache dei prompt. È una policy di instradamento, non una prova che cambi arbitrari di fornitore preservino lo stato memorizzato nella cache. L’instradamento facoltativo basato sull’intento usa un modello scelto dall’utente per leggere i nuovi turni; la documentazione non dimostra che questo faccia sempre risparmiare.

C’è un limite semplice ma importante al failover: deve esistere un’altra destinazione utilizzabile. Il README specifica che, se c’è un solo account e nessun gruppo di instradamento, non esiste una destinazione alternativa e l’errore viene restituito all’agente.

Magpie non è solo un router. La sua Library gestisce istruzioni, server MCP, skill e subagenti. Documenta anche viste per utilizzo, quota, costi e sessioni. Offre interfacce desktop, terminale, browser e CLI, con macOS, Windows, Linux, Docker e Termux indicati tra gli ambienti supportati.

I controlli per la privacy richiedono una valutazione a parte

La mascheratura di Magpie è disattivata per impostazione predefinita. Se attivata, rileva localmente i valori sensibili supportati, li sostituisce con segnaposto prima della trasmissione e li ripristina nelle risposte, inclusi gli argomenti degli strumenti. Il rilevamento può sbagliare; il modello non può esaminare il valore originale di ciò che è stato mascherato. Se la mascheratura attivata non può essere eseguita, il README indica che la richiesta viene bloccata con HTTP 503.

Questo non garantisce che venga rilevato ogni segreto. Leggi la documentazione sulla privacy, compreso il comportamento di individuazione degli account: Magpie può leggere gli accessi esistenti degli agenti e questa individuazione può essere disattivata.

Il README descrive anche la telemetria delle build di rilascio, inviata ogni giorno, che include un identificatore casuale, la versione, il sistema e identificatori relativi all’uso del prodotto. Le impostazioni della privacy o DO_NOT_TRACK=1 possono disattivare questa telemetria. I clic sui link dei partner e il recupero dell’elenco dei partner vengono conteggiati indipendentemente da questi controlli; secondo il README, tali conteggi non conservano identificatori né indirizzi. «Gateway locale» non significa quindi «nessun’altra attività di rete».

Prendi in considerazione Magpie se: vuoi che più agenti condividano le scelte di fornitori, modelli e instradamento degli account. Il compromesso è assumerti la responsabilità delle policy di instradamento, dell’accesso alle credenziali e delle impostazioni della privacy, non limitarti a scegliere un modello da un menu.

CC Switch: uno spazio di lavoro desktop che instrada anche le richieste

Definire CC Switch soltanto uno strumento per cambiare configurazione non rende giustizia all’ambito documentato. Oltre alla gestione dei fornitori, offre MCP, skill, librerie di prompt, configurazioni di progetto, sessioni, monitoraggio dell’utilizzo, backup e sincronizzazione. Tra i client elencati figurano Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode e altri, ma la copertura delle funzionalità varia da un client all’altro.

Le sue tre modalità di connessione chiariscono buona parte del confronto:

Diretta collega l’agente al fornitore selezionato. Il cambio modifica i campi relativi alla connessione, mentre il progetto dichiara che hook, plugin, impostazioni MCP e commenti non correlati vengono mantenuti.

Instradamento inoltra localmente le richieste tramite CC Switch. Converte i formati Anthropic Messages, OpenAI Chat Completions, OpenAI Responses e Gemini Native, e supporta code di failover per singolo strumento, interruttori automatici e monitoraggio dello stato dei fornitori.

Aggregazione, per Claude Code e Codex, mostra i modelli di più fornitori nel selettore di modelli del client. Le richieste vengono inviate al fornitore del modello scelto. L’aggregazione non offre failover. Presenta inoltre restrizioni sui fornitori, tra cui l’esclusione degli abbonamenti ufficiali Claude dall’aggregazione. In generale, i fornitori con accesso tramite account ufficiale non possono essere usati in modalità Instradamento; OpenAI Official per Codex è un’eccezione documentata.

CC Switch è quindi una scelta credibile sia per cambiare configurazioni in modo semplice, sia per l’instradamento locale. L’attenzione allo spazio di lavoro desktop è un motivo editoriale per inserirlo nella selezione, non la prova che le alternative siano prive di librerie o viste delle sessioni.

I limiti pratici contano più del numero di preset

CC Switch documenta il cambio al volo per Claude Code. Per Codex, Gemini CLI e Grok Build, di norma le modifiche dirette al fornitore richiedono un riavvio; anche l’Instradamento può richiederne uno quando cambia il modello. Le modifiche all’elenco di aggregazione di Codex richiedono il riavvio del daemon, dell’applicazione o dell’ambiente dell’editor pertinente. Pianifica queste operazioni al di fuori di un’attività in corso.

Un’altra distinzione utile compare nelle FAQ: il test di connettività della scheda del fornitore verifica la raggiungibilità, non il funzionamento della chiave API o del modello. Un segno di spunta verde non è un test di accettazione end-to-end.

Per impostazione predefinita, i dati si trovano in ~/.cc-switch, con un database SQLite e i file associati. Il README descrive backup della configurazione originale prima della prima riscrittura, backup automatici e sincronizzazione compatibile con WebDAV/S3. Alcune impostazioni del dispositivo, lo stato e i backup della configurazione originale restano locali e non rientrano nella sincronizzazione cloud. Non dare per scontato che sincronizzare l’app trasferisca ogni elemento necessario per recuperare i dati.

L’app ufficiale è pensata per desktop con interfaccia grafica su macOS, Windows e Linux. Consulta il manuale utente per la matrice esatta delle funzionalità per agente e le restrizioni delle modalità.

Prendi in considerazione CC Switch se: le modifiche ai fornitori fanno parte di un flusso di lavoro desktop più ampio che comprende MCP, skill, prompt e progetti. Se ti serve soltanto un proxy riutilizzabile senza interfaccia grafica, valuta questo requisito separatamente anziché presumere che le funzionalità siano equivalenti su desktop.

Claude Code Router: rendi esplicite le decisioni di instradamento

Claude Code Router, o CCR, ora si definisce un gateway multi-agente e un piano di controllo. Il README elenca Codex, OpenCode, Pi, Kimi CLI, Grok CLI e altri client, oltre a Claude Code.

Le funzionalità documentate pongono al centro le policy sulle richieste: condizioni basate su intestazioni e corpi delle richieste, prefissi, riscrittura delle richieste, tentativi e modelli di fallback ordinati. I pool di credenziali e la rotazione delle chiavi si affiancano ai profili degli agenti, alle sostituzioni dei modelli e alle impostazioni dell'ambiente.

Questa combinazione è utile quando «selezionare un altro fornitore» è troppo vago. Potresti voler associare una specifica condizione della richiesta a uno specifico upstream e poi dover verificare perché la regola è stata applicata.

CCR documenta i dettagli di richieste e risposte, il fornitore/modello/credenziale effettivamente selezionati, lo stato, la latenza, i token, il costo stimato, le chiamate agli strumenti e le tracce. Le stime dei costi non corrispondono alla fattura dell'upstream. I log permettono di esaminare una policy, ma non dimostrano che migliori la qualità delle attività.

Il progetto offre download desktop per macOS, Windows e Linux, una CLI npm con interfaccia di gestione via browser e la distribuzione tramite Docker. La CLI npm richiede Node.js 22 o versioni successive. La guida ai fornitori descrive endpoint personalizzati, selezione del protocollo e pool di credenziali; avverte inoltre che i test di connessione inviano richieste agli upstream e possono consumare l'utilizzo o i limiti di richieste.

Inserisci CCR nella rosa dei candidati se: hai bisogno di regole di instradamento esplicite e di una spiegazione del percorso effettivamente seguito. Il compromesso è la policy da mantenere. Più condizioni e percorsi di fallback significano più combinazioni da convalidare, non risultati automaticamente migliori.

CLIProxyAPI: partire dagli account e da un proxy compatibile

CLIProxyAPI parte da un modello di server proxy. Espone a client e SDK interfacce compatibili con OpenAI, incluse Responses, interfacce compatibili con Gemini, incluse Interactions, e interfacce compatibili con Claude.

Il README documenta il supporto OAuth per Codex e Claude Code, l'accesso agli account Gemini e il bilanciamento round-robin multi-account per diversi fornitori. Accetta anche upstream compatibili con OpenAI configurati e offre un SDK Go riutilizzabile.

È un punto di partenza utile quando il requisito principale è un endpoint compatibile supportato da account o credenziali. Non dimostra che il progetto principale modifichi in modo nativo i profili di ogni agente.

Due dettagli di distribuzione incidono sulla scelta:

• Il README consiglia un'app desktop complementare separata, EasyCLIProxyAPI, per la configurazione grafica, gli aggiornamenti, i controlli dalla barra delle applicazioni e l'avvio/arresto del servizio.
• Dalla v6.10.0, CLIProxyAPI e CPAMC non includono più statistiche di utilizzo integrate; il README rimanda a progetti separati per statistiche e gestione.

Nel calcolare la manutenzione, considera il proxy, l'app desktop complementare e il servizio di analisi come componenti separati. Non dedurre che CLIProxyAPI sia privo di tentativi o controlli di ripristino: verifica la configurazione della versione scelta. Allo stesso modo, non confondere la distribuzione degli account round-robin con una policy di fallback garantita tra modelli.

Inserisci CLIProxyAPI nella rosa dei candidati se: ti serve un proxy basato su account e ti va bene scegliere separatamente i componenti di gestione circostanti.

Prima di collegare un progetto reale

Questi strumenti sono a stretto contatto con le credenziali, il contesto del codice sorgente e le azioni eseguibili degli agenti. Anche un processo locale rientra nel perimetro di fiducia.

Per prima cosa, distingui una chiave API da un accesso tramite abbonamento. Il fatto che un software supporti un flusso OAuth non significa che il fornitore consenta ogni utilizzo da client diversi. CC Switch avverte esplicitamente del rischio legato all'uso dell'abbonamento al di fuori dei client ufficiali. Verifica i termini aggiornati del fornitore e le regole della tua organizzazione; un manager non conferisce ulteriori autorizzazioni né rimuove i limiti.

Secondo, decidi chi è responsabile di ciascun file di configurazione. Come precauzione operativa, evita che più manager riscrivano automaticamente le stesse impostazioni dell'agente. Fai una copia di backup dei file originali e assicurati di sapere come ripristinare l'accesso diretto. Questa raccomandazione non afferma che sia stato dimostrato un difetto di questi prodotti.

Terzo, verifica la gestione delle credenziali e dei log. Questo confronto non ha verificato la cifratura dei dati inattivi. Esamina le autorizzazioni, l'ambito di backup/sincronizzazione, l'individuazione degli account e i contenuti dei log delle richieste prima di importare credenziali di produzione. Se abiliti l'accesso remoto, controlla l'autenticazione e le impostazioni di esposizione: non considerare le impostazioni predefinite locali una garanzia di sicurezza.

Infine, verifica il comportamento dei protocolli, non solo i loro nomi. OpenAI Chat Completions e Responses sono API diverse; Anthropic Messages e Gemini hanno strutture proprie. La dichiarazione di una conversione non garantisce un comportamento senza perdite per ogni strumento, campo di ragionamento o immagine.

Un piccolo test di accettazione

Quello che segue è un esercizio proposto ai lettori, non un test eseguito per questo articolo:

1. Usa un repository sacrificabile e credenziali di test con privilegi limitati. Acquisisci la configurazione originale dell'agente.
2. Collega un agente a un fornitore. Verifica una risposta semplice e controlla quale fornitore/modello è stato effettivamente selezionato.
3. Chiedigli di leggere un file innocuo e proporre una piccola modifica. Verifica un ciclo completo di chiamata allo strumento e risultato, nonché il completamento dello streaming, prima di consentire le scritture.
4. Aggiungi una seconda route solo se necessario. Con un mock locale sicuro o una configurazione di test autorizzata, verifica la condizione di errore prevista e se viene selezionata la destinazione alternativa documentata. Evita di esaurire intenzionalmente le quote a pagamento.
5. Verifica che i tentativi o le procedure di ripristino non causino la ripetizione di azioni degli strumenti con effetti collaterali nel tuo flusso di lavoro. È un criterio di accettazione, non un bug osservato del prodotto.
6. Arresta il manager e verifica la procedura documentata per tornare all'accesso diretto o ripristinare la configurazione. Controlla i requisiti di riavvio, quindi confronta le stime di utilizzo con i dati del fornitore.

Scegli la configurazione più semplice che supera questo test. Se un agente collegato al fornitore ufficiale soddisfa già le tue esigenze, aggiungere un gateway locale potrebbe non risolvere alcun problema.

Il verdetto: scegli chi se ne occupa, non un vincitore

Per l'instradamento condiviso di modelli e account tra agenti, parti da Magpie. Per la configurazione desktop e la gestione degli spazi di lavoro, parti da CC Switch. Per policy esplicite sulle richieste e l'ispezione dei percorsi, parti da CCR. Per un proxy riutilizzabile basato su account, parti da CLIProxyAPI e considera anche i suoi componenti complementari.

Queste raccomandazioni descrivono gli ambiti messi in evidenza dalla documentazione, non una superiorità misurata. La configurazione giusta è quella che ti permette di spiegare quale modello ha gestito una richiesta, quali credenziali ha usato, cosa succede in caso di errore e come annullare la modifica.

Domande frequenti

CC Switch serve solo a cambiare configurazione?
No. Documenta le modalità Direct, Routing e Aggregation, inclusa la conversione locale dei formati e le code di failover per ciascuno strumento. La disponibilità varia a seconda del client e del fornitore.

L'aggregazione offre automaticamente il fallback?
No. CC Switch distingue esplicitamente l'aggregazione dal failover. Un selettore di modelli combinato non è una policy di ripristino.

Magpie mantiene tutte le richieste in locale?
No. Il suo gateway viene eseguito localmente, ma l'inferenza tramite fornitori remoti invia le richieste agli upstream. Il README documenta anche controlli di telemetria e il conteggio separato degli eventi dei partner. La mascheratura facoltativa è disattivata per impostazione predefinita e può non rilevare o classificare correttamente alcuni valori.

Cambiare modello modifica gli strumenti e le autorizzazioni dell'agente?
Non di per sé. L'ambiente degli strumenti e le regole di autorizzazione restano sotto la responsabilità dell'agente; occorre comunque convalidare come il nuovo modello gestisce tali strumenti.

Un accesso tramite abbonamento può sostituire una chiave API in qualsiasi client?
Non darlo per scontato. Il supporto tecnico all'accesso, i modelli disponibili, le autorizzazioni associate all'account e i permessi concessi dal fornitore sono questioni diverse. Verifica i termini aggiornati e le policy dell'organizzazione.

Quale prodotto è più veloce o più sicuro?
Questo confronto non può stabilirlo. Si basa sulla documentazione ufficiale e non include benchmark indipendenti delle prestazioni, misurazioni dell'affidabilità o audit di sicurezza.

Fonti

Fonti ufficiali consultate il 3 novembre 2026:

1. README di Magpie — gateway, agenti, gruppi, Library e gestione della privacy.
2. README di CC Switch — modalità di connessione, copertura per agente, riavvii e archiviazione.
3. README di Claude Code Router — profili degli agenti, instradamento, credenziali e distribuzione.
4. README di CLIProxyAPI — interfacce compatibili, account, software complementare e limiti delle statistiche.
5. Guida ai fornitori di CCR — protocolli upstream, fornitori personalizzati, pool di credenziali e costi delle richieste di test.