Claude in Copilot. Due eleganti strumenti da disegno lavorano fianco a fianco su un foglio di codice, con un piccolo connettore API esterno, a suggerire la programmazione collaborativa.

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

[
  {
    "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 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

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.