Vai al contenuto principale
Usa questa guida per collegare Claude Desktop Cowork su inferenza di terze parti a CometAPI. Questa configurazione consente a Claude Desktop di inviare richieste API Claude Messages a CometAPI da Cowork, Projects e dai flussi di lavoro desktop supportati. Riferimenti ufficiali:
L’inferenza di terze parti di Claude Desktop richiede un gateway compatibile con Anthropic. CometAPI supporta i modelli Claude tramite Anthropic Messages API.
I contenuti che invii da Claude Desktop vengono elaborati da CometAPI e dal provider del modello selezionato. Non inviare dati riservati a meno che la tua organizzazione non consenta questo flusso di lavoro.

​
Prerequisiti

  • Claude Desktop installato da claude.com/download
  • Una build di Claude Desktop che includa Developer mode e Configure third-party inference
  • Un account CometAPI con una API key attiva
  • Accesso ai modelli Claude in CometAPI
  • Un percorso di rete che possa raggiungere https://api.cometapi.com
Inizia dalla schermata di accesso di Claude Desktop. Se hai già effettuato l’accesso con un account Anthropic, esci prima di configurare l’inferenza di terze parti.

​
Configurazione

1

Abilita la modalità sviluppatore

Apri Claude Desktop e resta nella schermata di accesso. Nel menu dell’applicazione, apri Help → Troubleshooting, quindi seleziona Enable Developer Mode.Su Windows, il menu può essere difficile da raggiungere prima dell’accesso. Metti a fuoco il campo email, premi Tab finché il menu non è focalizzato, quindi premi Enter.
2

Apri le impostazioni di inferenza di terze parti

Dopo aver abilitato la modalità sviluppatore, apri Developer → Configure third-party inference.La finestra di configurazione si apre con diverse sezioni nella barra laterale sinistra. Usa la sezione Connection per le impostazioni di CometAPI.
3

Configura il gateway

Nella sezione Connection, inserisci i valori CometAPI qui sotto:
CampoValore
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.cometapi.com
Gateway API keyLa tua API key CometAPI, ad esempio <COMETAPI_KEY>
Gateway auth schemeBearer
Gateway extra headersLascia vuoto
Mantieni il base URL esattamente come mostrato. Claude Desktop richiede un base URL HTTPS.La schermata seguente mostra la sezione Connection compilata con i valori CometAPI.Impostazioni Connection di Claude Desktop con il gateway base URL di CometAPI, il campo API key e lo schema di autenticazione bearer compilati
4

Aggiungi i model ID

In Model list, aggiungi manualmente questi model ID:
Model IDUso consigliato
claude-opus-4-7Pianificazione complessa e attività agent
claude-sonnet-4-6Uso desktop generale
claude-haiku-4-5-20251001Prompt leggeri e bozze rapide
Il primo modello nell’elenco diventa il modello predefinito. Metti claude-sonnet-4-6 per primo se vuoi un’impostazione predefinita generica.
La disponibilità dei modelli può cambiare. Se un modello non appare in Claude Desktop dopo la configurazione, verifica l’accesso nella pagina Models di CometAPI.
La schermata seguente mostra l’elenco dei modelli con i tre model ID Claude configurati per CometAPI.Elenco modelli di Claude Desktop che mostra claude-opus-4-7, claude-sonnet-4-6 e claude-haiku-4-5-20251001 per CometAPI
5

Applica la configurazione localmente

Fai clic su Apply locally. Claude Desktop scrive la configurazione selezionata nel profilo utente locale e riavvia l’app.Se l’app non si riavvia, chiudi completamente Claude Desktop e aprilo di nuovo.
6

Avvia una sessione Cowork

Nella schermata di accesso, scegli l’opzione per Cowork su inferenza di terze parti. Apri Cowork o Projects, seleziona uno dei modelli Claude configurati e invia un breve prompt di test.Una risposta riuscita conferma che Claude Desktop sta usando CometAPI per le chiamate al modello.

​
Verifica la configurazione

Usa un prompt breve che non richieda strumenti esterni: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Se Claude Desktop restituisce una risposta, allora il base URL, la API key e l’elenco dei modelli sono configurati correttamente. La schermata seguente mostra una risposta Cowork riuscita tramite CometAPI. Risposta Cowork di Claude Desktop tramite CometAPI dopo la configurazione dell'inferenza di terze parti Per ispezionare le impostazioni rilevate, apri Help → Troubleshooting → Copy Managed Configuration Report. I valori segreti vengono oscurati nel report copiato.

​
Risoluzione dei problemi

Conferma di aver selezionato Help → Troubleshooting → Enable Developer Mode. Quindi chiudi completamente Claude Desktop e aprilo di nuovo.Se l’opzione manca, installa una build di Claude Desktop che includa la configurazione dell’inferenza di terze parti.
Controlla questi elementi:
  • Inference provider è impostato su Gateway.
  • Gateway base URL è https://api.cometapi.com.
  • Gateway API key contiene la tua API key CometAPI senza spazi aggiuntivi.
  • Hai fatto clic su Apply locally e riavviato completamente Claude Desktop.
Conferma che il base URL inizi con https://. Claude Desktop non accetta URL gateway HTTP semplici.Conferma inoltre che il tuo account CometAPI abbia accesso ai modelli Claude e che la API key non sia stata eliminata o disabilitata.
Riapri Developer → Configure third-party inference e controlla le voci di Model list. I model ID devono corrispondere agli ID esposti da CometAPI.Aggiungi ogni model ID come voce separata. Non includere virgolette, virgole o spazi aggiuntivi nei campi dell’interfaccia.
L’inferenza di terze parti di Claude Desktop per questo flusso si aspetta un gateway compatibile con Anthropic. Usa https://api.cometapi.com e i model ID Claude elencati sopra.
La scheda Code usa il motore Claude Code all’interno di Claude Desktop. Alcune impostazioni desktop potrebbero non applicarsi alle sessioni Code nello stesso modo in cui si applicano a Cowork.Per l’uso standalone da terminale, consulta la guida all’integrazione di Claude Code.