Source: https://aiprimetech.io/it/learn/use-claude-api-with-github-copilot/ [Home](/it/) / [Impara](/it/learn/) / GitHub Copilot Chat con Claude tramite un gateway: configurazione dell'endpoint personalizzato, modalità agente e soluzioni ai problemi # GitHub Copilot Chat con Claude tramite un gateway: configurazione di Custom Endpoint, modalità agente e soluzioni ai problemi La chat di VS Code può usare modelli forniti da te. Il provider Anthropic integrato accetta soltanto una chiave API, senza un campo per un indirizzo diverso, quindi un gateway va aggiunto tramite il provider Endpoint personalizzato. Scegli il tipo di API Messages ed elenca i modelli in chatLanguageModels.json. È incluso nella versione stabile di VS Code dalla versione 1.122. ## Cosa puoi usare con una chiave personale | Funzionalità | Con il tuo modello | Chat, domande e pianificazione | Sì | Modalità agente, strumenti integrati e server MCP | Sì, se il modello è contrassegnato come toolCalling: true | Suggerimenti in linea (completamenti del codice) e suggerimenti per la modifica successiva | No: questi provengono ancora da GitHub Copilot | Ricerca semantica e altre funzionalità basate sugli embedding | No: queste richiedono ancora un account GitHub A partire da VS Code 1.122, questi modelli funzionano senza accedere a GitHub e senza un piano Copilot. Su Copilot Business ed Enterprise, BYOK è attivo per impostazione predefinita e gli amministratori possono disattivarlo tramite il criterio **Usa la tua chiave per il modello linguistico**. ## Aggiungi il gateway come endpoint personalizzato - Apri la vista chat, apri il selettore dei modelli e scegli **Gestisci modelli linguistici**, oppure esegui **Chat: Gestisci modelli linguistici** dalla tavolozza dei comandi. - Scegli **Aggiungi modelli**, quindi il provider **Endpoint personalizzato**. - Inserisci un nome visualizzato e la tua chiave API del gateway. - Seleziona il tipo di API **Messages**. VS Code apre quindi chatLanguageModels.json per l'elenco dei modelli. ## chatLanguageModels.json chatLanguageModels.jsonCopia ``` [ { "name": "AI Prime Tech", "vendor": "customendpoint", "apiKey": "${input:aiprimeApiKey}", "apiType": "messages", "models": [ { "id": "claude-sonnet-5", "name": "Claude Sonnet 5", "url": "https://aiprimetech.io/v1/messages", "toolCalling": true, "vision": true, "maxInputTokens": 200000, "maxOutputTokens": 32000 }, { "id": "claude-opus-5-5", "name": "Claude Opus 5.5", "url": "https://aiprimetech.io/v1/messages", "toolCalling": true, "vision": true, "maxInputTokens": 200000, "maxOutputTokens": 32000 }, { "id": "claude-haiku-4-5", "name": "Claude Haiku 4.5", "url": "https://aiprimetech.io/v1/messages", "toolCalling": true, "vision": true, "maxInputTokens": 168000, "maxOutputTokens": 32000 } ] } ] ``` | Campo | Motivo | id | L'ID del modello inviato al gateway | url | L'endpoint completo. VS Code usa un URL che termina con /messages così com'è; fornisci il percorso completo per evitare ambiguità | toolCalling: true | Obbligatorio per la modalità agente. Un modello che ne è privo non compare tra quelli disponibili per gli agenti | maxInputTokens + maxOutputTokens | La loro somma non deve superare la finestra di contesto del modello | apiKey: ${input:...} | VS Code richiede la chiave una sola volta e la memorizza, quindi non viene scritta nel file Con il tipo Messages, VS Code invia la chiave nell'header x-api-key , come previsto dal gateway. Gli ID dei modelli devono corrispondere esattamente a quelli del gateway. ## Modelli GPT con la stessa chiave Il provider Custom Endpoint supporta anche i formati OpenAI. Per aggiungere modelli GPT usando una chiave del gruppo Codex del gateway, aggiungi un secondo provider con "apiType": "chat-completions" e URL dei modelli nel formato https://aiprimetech.io/v1/chat/completions. Una chiave consente di accedere solo ai modelli del proprio gruppo, quindi Claude e GPT richiedono in genere voci distinte con chiavi separate. La precedente impostazione github.copilot.chat.customOAIModels e il provider **OpenAI Compatible** sono deprecati a favore di Custom Endpoint. Sposta le vecchie voci in chatLanguageModels.json. ## Risoluzione dei problemi | Che cosa vedi | Causa | Soluzione | Il modello non compare nel selettore | È necessario ricaricare, oppure toolCalling è false, oppure l'area di lavoro è in modalità con restrizioni | Riavvia VS Code, imposta toolCalling: true, considera attendibile l'area di lavoro | L'elenco dei provider non contiene Custom Endpoint | Versione di VS Code precedente alla 1.122, oppure BYOK disabilitato dalla tua organizzazione | Aggiorna VS Code; chiedi all'amministratore informazioni sul criterio BYOK | 401 / chiave API non valida | La chiave memorizzata è errata o appartiene a un altro endpoint | Icona dell'ingranaggio accanto al provider, quindi **Aggiorna chiave API** | Modello non supportato | La id non corrisponde a un ID modello del gateway | Usa un ID della tabella seguente | Errori di contesto o di token | maxInputTokens insieme a maxOutputTokens supera la finestra | Riduci maxInputTokens | Concurrency limit exceeded | Più agenti o finestre in esecuzione contemporaneamente con una sola chiave | Riduci il numero di esecuzioni in parallelo Per maggiori dettagli, esegui **Sviluppatore: imposta livello di log**, scegli **Traccia**, quindi apri **Output** e seleziona **GitHub Copilot Chat**. La vista di debug della chat mostra le richieste esatte. Una riga di log che indica che la registrazione di BYOK provider è stata annullata perché il criterio non li consente segnala un criterio dell'organizzazione. | ID del modello | Usalo per | claude-sonnet-5 | Scelta predefinita per programmazione e attività degli agenti: veloce, potente, di fascia media. | claude-opus-5-5 | Ragionamenti più complessi, refactoring estesi, esecuzioni prolungate degli agenti. | claude-fable-5-1 | Il più capace e il più costoso; riservalo alle attività più difficili. | claude-haiku-4-5 | Economico e rapido: titoli, riepiloghi, classificazione, piccoli passaggi. Preferisci il terminale? La stessa chiave permette di usare [Claude Code in VS Code](/it/claude-code/vscode/) tramite la relativa estensione. ## Domande frequenti Posso usare la mia chiave API Claude in GitHub Copilot? Sì. Nella chat di VS Code scegli Gestisci modelli linguistici, Aggiungi modelli, quindi il provider Anthropic per l'API di Anthropic, oppure Custom Endpoint con il tipo di API Messages per un gateway. Posso cambiare l'URL di base di Anthropic in Copilot? Non nel provider Anthropic integrato, che accetta solo una chiave. Usa il provider Custom Endpoint e imposta il campo url di ogni modello sull'endpoint /v1/messages del gateway. I modelli BYOK funzionano nella modalità agente di Copilot? Sì, quando il modello è contrassegnato con toolCalling: true. Gli strumenti integrati e i server MCP continuano a funzionare; i completamenti del codice in linea provengono ancora da Copilot. Serve un abbonamento a Copilot per usare il mio modello? Non più a partire da VS Code 1.122: i modelli BYOK funzionano senza accedere a GitHub e senza un piano Copilot. Le organizzazioni Business ed Enterprise possono disabilitare questa possibilità tramite un criterio. Inizia a usare Claude in pochi minuti Ottieni una chiave API: non servono un account Anthropic né una lista d'attesa.[Ottieni la tua chiave API](/register) AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari. ## Altre guide all'API di Claude [Come ottenere una chiave API di Claude](/it/learn/how-to-get-a-claude-api-key/)[I prezzi dell'API Claude, spiegati](/it/learn/claude-api-pricing-explained/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Cursor illimitato con l'API Claude](/learn/use-claude-api-with-cursor/)[Accesso illimitato a Claude Code](/it/learn/use-claude-api-with-claude-code/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[Usa Claude con l'SDK OpenAI: endpoint compatibile con OpenAI, streaming, strumenti e limiti](/it/learn/openai-compatible-claude-api/)[I modelli Claude spiegati: un confronto tra Claude Opus, Sonnet, Haiku e Fable — tutti i modelli API Claude, i nomi dei modelli Anthropic e i prezzi (2026)](/it/learn/claude-api-models-compared/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[Cline illimitato con l'API Claude](/it/learn/use-claude-api-with-cline/)[Roo Code illimitato con l'API Claude](/it/learn/use-claude-api-with-roo-code/)[Claude illimitato negli IDE JetBrains](/it/learn/use-claude-api-with-jetbrains/)[Aider con Claude tramite un gateway: ANTHROPIC_API_BASE, file di configurazione, modalità architect e soluzioni ai problemi](/it/learn/use-claude-api-with-aider/)[Claude illimitato in VS Code](/it/learn/use-claude-api-with-vscode/)[Configurazione di OpenCode per Claude: impostazione di opencode.json, modelli ed errori comuni](/it/learn/use-claude-api-with-opencode/)[Hermes Agent con Claude tramite un gateway: configurazione di un provider personalizzato, controllo dei costi e soluzioni ai problemi](/it/learn/run-hermes-agent-with-claude-api/)[Eseguire OpenClaw senza limiti con Claude](/it/learn/run-openclaw-with-claude-api/)[Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[Chiave API di Claude Code — ANTHROPIC_API_KEY: come ottenerla, configurarla e quando usare invece claude setup-token](/it/learn/claude-code-api-key-setup/)[Costi dell'API di Claude Code — Prezzi e come ridurli](/it/learn/claude-code-api-costs/)[Gli errori dell'API Claude spiegati: errore del server 500, sovraccarico 529, limite di frequenza 429, richiesta non valida 400 — e la soluzione per ciascuno](/it/learn/claude-api-errors-troubleshooting/)[Come acquistare crediti per l'API di Claude e perché un credito Claude conviene più di qualsiasi offerta per «acquistare un account Claude»](/it/learn/buy-claude-api-credits/)[API Claude gratuita: esiste una chiave API di Claude gratuita e che cosa è davvero gratuito nel 2026?](/it/learn/claude-api-free-trial/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Codex CLI con un provider personalizzato: config.toml, modelli GPT e Claude, estensione IDE e soluzioni ai problemi](/it/learn/use-claude-api-with-codex/)[Collegare Claude a n8n](/it/learn/use-claude-api-with-n8n/)[Instradare LiteLLM verso Claude](/it/learn/use-claude-api-with-litellm/)[Usare Claude in Kilo Code](/it/learn/use-claude-api-with-kilo-code/)[Collega Zed a Claude tramite il gateway](/it/learn/use-claude-api-with-zed/)[Collega Cherry Studio a Claude](/it/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: importazione, base_url, streaming, strumenti ed errori](/it/learn/use-claude-api-with-langchain/)[SDK Python di Anthropic: installazione, configurazione di base_url, streaming e gestione degli errori](/it/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL di createAnthropic, streaming e soluzioni ai problemi](/it/learn/use-claude-api-with-vercel-ai-sdk/)[Esegui Factory Droid con Claude](/it/learn/use-claude-api-with-factory-droid/)[L'API di Claude Code spiegata](/it/learn/claude-code-api/)[Integrare l'API di Claude nella tua applicazione](/it/learn/claude-api-integration/)[Come ottenere un utilizzo illimitato di Claude e perché non esiste un «Claude Code craccato»](/it/learn/get-unlimited-claude-usage/)