Gestisci adattatori e modelli

Questa guida mostra come collegare i fornitori di modelli e scegliere su cosa viene eseguito un agente.

Tutto ciò che segue sta su un’unica pagina: Impostazioni → Server → Fornitori di modelli. La voce della sotto-barra laterale è «Fornitori di modelli»; il titolo della pagina è «Adattatori».

Che cos’è un adattatore

Un adattatore è il runner che esegue un turno di un agente. Ce ne sono due e l’elenco è fisso: non puoi aggiungerne un terzo.

Adattatore	CLI	Trasporto
Control Center (built-in)	nessuno	Ciclo di agente in-process, che comunica con i fornitori via HTTP
Claude Code	claude	claude -p --output-format stream-json

Cursor, Codex, Anthropic, OpenAI e gli altri sono fornitori dell’adattatore integrato, non CLI separate. Ciò che puoi aggiungere è un altro fornitore: qualsiasi endpoint compatibile con OpenAI o con Anthropic. È l’argomento della sezione successiva.

Il rilevamento sonda il server, non la tua macchina

La scheda Runner rilevati elenca ciò che cc_server ha trovato nel PATH dell’host del server. Su un client leggero o web si tratta di una macchina diversa da quella che stai guardando. Installa la CLI sulla macchina che esegue cc_server.

Collega un fornitore di modelli

L’adattatore integrato ha bisogno di almeno un fornitore collegato prima di poter funzionare. Nel catalogo ne sono inclusi quattordici.

1. Vai su Impostazioni → Server → Fornitori di modelli
2. Scorri fino a Provider e modelli
3. Trova il tuo fornitore e collegalo:

Fornitore	Come collegarlo
Anthropic	Chiave API. Un abbonamento Claude Pro/Max non è un accesso API di Anthropic: per quel piano usa l’adattatore Claude Code
OpenAI, Codex, Cursor	Accesso OAuth dal browser oppure una chiave API. Codex è ChatGPT Plus/Pro tramite il backend Codex Responses, non l’avvio di una CLI
Kimi Code	Solo OAuth dal browser: un flusso con codice dispositivo. È un piano a tariffa fissa, quindi non ha un prezzo per token
OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API)	Chiave API

Verifica: il badge della riga passa a «Connesso» e, espandendola, vengono elencati i modelli serviti da quel fornitore, ciascuno con il prezzo per milione di token e la finestra di contesto.

I token OAuth finiscono nell’archivio delle credenziali del server stesso e vengono rinnovati prima della scadenza. Le credenziali dei fornitori sono globali per l’host: sono condivise da ogni spazio di lavoro dell’installazione, non limitate a uno.

Aggiungi un fornitore personalizzato

Usalo per Ollama, LM Studio, vLLM o un deployment privato.

1. In Provider e modelli, sotto Provider personalizzati, premi Aggiungi provider
2. Compila un Nome, scegli il Tipo di API (compatibile con OpenAI o con Anthropic) e indica l’URL di base (ad esempio http://localhost:11434/v1)
3. Aggiungi una Chiave API se l’endpoint la richiede, poi premi Aggiungi provider

Un fornitore personalizzato compare nello stesso elenco, con un pulsante di eliminazione che i suoi fratelli integrati non hanno.

Scegli un modello per un agente

1. Vai su Impostazioni → Spazio di lavoro → Agenti e seleziona l’agente
2. Nella scheda Impostazioni, scegli l’Adattatore
3. Scegli il Modello dal menu a discesa accanto

Per l’adattatore integrato il menu a discesa viene composto in tempo reale dal catalogo di ogni fornitore collegato. Un fornitore senza credenziale memorizzata contribuisce con zero modelli: per questo un menu a discesa vuoto significa quasi sempre «niente ancora collegato» e non «niente disponibile».

models.dev è un arricchimento, mai una fonte di id

Il catalogo models.dev incluso fornisce prezzo e finestra di contesto per un modello già presente nell’elenco in tempo reale. Non aggiunge mai un id di modello. Se un modello che ti aspetti manca, l’endpoint del fornitore non lo restituisce.

Gli id dei modelli per l’adattatore integrato sono qualificati provider/model e possono portare una catena di fallback separata da |. In caso di fallback, il costo è calcolato sul modello che ha effettivamente servito il turno, non su quello che hai richiesto.

Un agente senza adattatore viene eseguito sul ciclo integrato

Ogni spazio di lavoro viene popolato inizialmente con cinque agenti — un CEO più qa, architect, engineer e librarian — senza adattatore e senza modello. L’invio ricade su Control Center (built-in), non sull’impostazione Runner predefiniti di questa pagina, che è una preferenza lato client che il percorso di invio non legge mai. Il log di esecuzione registra cc-harness per quelle esecuzioni, così la trascrizione indica che cosa è stato effettivamente eseguito.

Non essendoci nemmeno un modello, il ciclo integrato chiede ad Anthropic il suo modello predefinito. Un agente lasciato del tutto non configurato, quindi, viene eseguito se hai collegato un account Anthropic, altrimenti fallisce con No credential for provider "anthropic".

Completare il passaggio dell’adattatore dell’onboarding applica a posteriori a ogni agente a cui manca ancora un adattatore o un modello — CEO e specialisti, in ogni spazio di lavoro esistente in quel momento — la coppia che hai scelto. Gli spazi di lavoro creati in seguito popolano comunque tutti e cinque non configurati. Imposta esplicitamente adattatore e modello su ogni agente che intendi usare.

Installa la CLI di un runner

L’adattatore integrato non richiede alcuna installazione. Per Claude Code, installa la sua CLI sull’host del server con il gestore di pacchetti di quello strumento, ad esempio:

npm install -g @anthropic-ai/claude-code

Poi premi Aggiorna in cima alla pagina. Ogni riga rilevata mostra la versione risolta e il percorso, più i chip che indicano se supporta la modalità JSON e la selezione del modello.

Una CLI esterna conserva le proprie credenziali, nella propria configurazione, sull’host del server. Control Center non le gestisce.

Gli argomenti aggiuntivi e le variabili d’ambiente dell’adattatore restano su questo dispositivo

Ogni riga dell’adattatore offre un campo Argomenti aggiuntivi e una finestra di dialogo Variabili d’ambiente. Quei valori sono memorizzati sul tuo dispositivo. Il server legge argv ed env di avvio dal proprio archivio delle impostazioni. Metti le chiavi dei fornitori sul server (OAuth o il campo della chiave nella pagina Fornitori di modelli), non in quei due campi.

Limita i fornitori che uno spazio di lavoro può usare

La governance dei fornitori è per spazio di lavoro e viene valutata con la regola «last-match-wins».

1. In Provider e modelli, disattiva l’interruttore Consenti su una riga di un fornitore

Così viene scritta un’istruzione deny per quel fornitore nello spazio di lavoro attivo e i suoi modelli escono dal catalogo per quello spazio. Riattivando l’interruttore, l’istruzione viene rimossa.

Risoluzione dei problemi

Un runner risulta «Non trovato»

• Controlla che la CLI sia nel PATH dell’host del server, non solo nel tuo
• Un’app desktop lanciata dalla GUI avvia il proprio server con un PATH minimale; una CLI installata in un percorso disponibile solo da una shell può risultare invisibile
• Premi Aggiorna dopo l’installazione

Il menu a discesa dei modelli è vuoto

• L’adattatore è quello integrato e non è collegato alcun fornitore: collegarne uno in Provider e modelli
• Oppure il fornitore è collegato ma negato dall’interruttore di governance di questo spazio di lavoro

Un modello viene eseguito ma il prezzo risulta sconosciuto

L’elenco dei modelli in tempo reale contiene l’id; prezzo e contesto provengono da models.dev. Un modello nuovissimo, o uno di un fornitore personalizzato, non ha ancora una voce nel catalogo.

Guide correlate

• Crea e configura un agente
• Gestisci le chiavi API
• Diagnostica un agente
• Gestisci i costi

Concetti correlati

• Il modello degli agenti
• Ciclo di vita dell’invio degli agenti