# CodeRouter

CodeRouter è il router di modelli dietro cmux. I tuoi agenti di programmazione inviano le richieste a CodeRouter, che inoltra ciascuna a un abbonamento o a una chiave API aggiunta dal tuo team. Quando un account è limitato, rifiutato o non disponibile, CodeRouter sposta il lavoro su un altro account, così gli agenti continuano a funzionare.

## Perché usarlo

-   Unisci più abbonamenti ChatGPT, Claude e OpenCode Go e chiavi API, e condividili con il tuo team.
-   Mantieni attivo un agente quando un account raggiunge il suo limite di utilizzo.
-   Dai alle macchine cmux Cloud l'accesso ai modelli senza memorizzare credenziali sulla macchina.
-   Visualizza l'utilizzo di token per account, per chiave API e per macchina Cloud.

## Account supportati

Ogni account serve gli agenti che parlano l'API del suo provider. Codex e Pi condividono un pool; Claude Code usa un pool separato di account Claude.

| Account | Serve | Come aggiungerlo |
| --- | --- | --- |
| Abbonamento ChatGPT (workspace personale o di team) | Codex, Pi | `cr add codex` |
| Chiave API OpenAI | Codex, Pi | Dashboard di CodeRouter |
| Chiave API OpenRouter | Codex, Pi | Dashboard di CodeRouter |
| Abbonamento OpenCode Go | OpenCode | `cr add opencode` |
| Claude Max o Pro (token di configurazione di Claude Code) | Claude Code | `cr add claude` |
| Chiave API Anthropic | Claude Code | `cmux coderouter claude add api-key` |
| Credenziali Amazon Bedrock | Claude Code | `cmux coderouter claude add bedrock` |

La dashboard di CodeRouter può anche aggiungere chiavi API, token Claude e credenziali Bedrock. Elenca ogni account con il suo stato, il periodo di pausa e le sessioni attive: [cmux.com/dashboard/coderouter](https://cmux.com/it/dashboard/coderouter)

## Come funziona l'instradamento

Ogni sessione di un agente resta su un account finché quell'account funziona, così la cache dei prompt del provider resta calda. Una nuova sessione va all'account con meno sessioni attive.

Quando un provider restituisce un limite di frequenza, rifiuta una credenziale o non risponde, CodeRouter mette quell'account in pausa e riprova la richiesta su un altro account. Riprova solo prima che l'output del modello raggiunga il tuo agente, quindi una risposta già in streaming non viene mai inviata due volte.

La richiesta al provider parte dal servizio ospitato di CodeRouter. Il traffico verso il provider proviene quindi da CodeRouter, non dal tuo Mac o dalla tua macchina Cloud.

## Avvio rapido su un Mac

1.  Installa la CLI di CodeRouter. Si installa sia come coderouter sia come cr. Puoi anche eseguire cmux cr, che la prima volta propone di installarla.
2.  Accedi con il tuo account cmux. cr login apre il browser; approva il codice che mostra.
3.  Aggiungi un abbonamento. cr add apre un menu di provider, e cr add codex ti fa accedere a ChatGPT nel browser.
4.  Esegui un agente tramite CodeRouter con cr codex, cr opencode o cr pi. Gli argomenti dopo il nome dell'agente vengono passati all'agente.

```
curl -fsSL https://cmux.com/coderouter/install.sh | sh
cr login
cr add codex
cr codex
```

## Sulle macchine cmux Cloud

Ogni macchina Cloud viene collegata a CodeRouter alla creazione. Claude Code, Codex, OpenCode e Pi sulla macchina usano gli account del tuo team senza accesso e senza configurazione.

[Come sono configurati gli agenti sulle macchine Cloud](https://cmux.com/it/docs/coderouter/agents#cloud)

## Team e condivisione

Gli account appartengono al team a cui hai effettuato l'accesso. cr org list mostra i tuoi team, e cr org switch cambia il team usato da cr. I comandi cmux coderouter accettano --team <id>.

Un account aggiunto a un'organizzazione è condiviso con il team, quindi tutti i membri e le macchine Cloud del team possono usarlo. Nella dashboard, Rendi privato lo limita alla persona che l'ha aggiunto e Condividi con il team annulla la modifica.

Nel tuo team personale i nuovi account sono privati e i tuoi account privati servono anche le tue macchine Cloud. Le macchine Cloud di un'organizzazione usano solo account condivisi, quindi un account privato va condiviso prima che una macchina possa usarlo.

Qualsiasi membro del team può aggiungere, rinominare, disattivare, trasferire e rimuovere gli account condivisi del team. cr transfer sposta un account in un altro team dopo la tua conferma.

```
cr org list
cr org switch <name-or-id>
cr accounts
cr transfer [account] [--to <team>]
cr remove [account]
```

## Utilizzo e limiti

Ogni provider conteggia l'utilizzo sull'account che ha servito una richiesta, secondo il piano e i limiti di quell'account. CodeRouter distribuisce il lavoro tra gli account ma non aumenta il limite di nessun singolo account.

cr mostra lo stato della quota di ogni abbonamento. Aggiungi --watch per aggiornarlo ogni 30 secondi, o --json per gli script.

cmux coderouter machines mostra l'utilizzo di token degli ultimi 30 giorni e il valore equivalente in API per ogni macchina Cloud. All'interno di una macchina, cmux coderouter usage suddivide l'utilizzo di quella macchina per giorno, workspace, agente e modello.

Il valore equivalente in API è una stima ai prezzi di listino pubblici. Non è una fattura.

```
cr
cr usage --watch
cmux coderouter machines
```

## Credenziali e privacy

-   Le credenziali dei provider vengono cifrate prima di essere memorizzate. Nessuna API o vista della dashboard di CodeRouter restituisce una credenziale memorizzata; gli account mostrano solo un'etichetta, un'email o una chiave mascherata.
-   cr add e cmux coderouter claude add non accettano mai una credenziale del provider come argomento del comando, dove finirebbe nella cronologia della shell. La leggono da una variabile d'ambiente, dallo standard input o da un prompt nascosto.
-   cr add codex e cr add opencode effettuano l'accesso al provider nel browser. cr codex passa le impostazioni di CodeRouter a Codex solo per quell'esecuzione e lascia invariati il tuo accesso e la tua configurazione abituali di Codex.
-   Le macchine Cloud non contengono credenziali. Gli agenti su una macchina inviano una chiave segnaposto pubblica a un indirizzo privato di CodeRouter, e l'edge di rete della macchina aggiunge una credenziale firmata legata a quella macchina. CodeRouter rifiuta quella credenziale da qualsiasi altra macchina e la revoca quando la macchina viene eliminata.
-   Ogni risposta di CodeRouter contiene un header x-coderouter-request-id che identifica la richiesta.

## Passaggi successivi

-   [Agenti e modelli: configura ogni agente su un Mac e sulle macchine Cloud](https://cmux.com/it/docs/coderouter/agents)
-   [CLI e risoluzione dei problemi: tutti i comandi e gli errori comuni](https://cmux.com/it/docs/coderouter/cli)
-   [cmux Cloud](https://cmux.com/it/docs/cloud)

Canonical: https://cmux.com/it/docs/coderouter

Documentation index: https://cmux.com/llms.txt