1 15/10/2026 10 min

Prerequisiti che conviene verificare prima di aprire VS Code

GitHub Copilot in Visual Studio Code non si “attiva” con un singolo interruttore magico: prima serve una combinazione coerente di account, licenza, versione dell’editor e connettività verso GitHub. Se uno di questi pezzi manca, l’estensione si installa ma resta inattiva, oppure chiede di autenticarsi e poi non completa il provisioning. Il punto è semplice: il problema non è quasi mai VS Code in sé, ma lo stato dell’account GitHub e il percorso di login.

Prima di procedere, tieni a portata di mano un account GitHub che abbia accesso a Copilot. Può essere un piano individuale, business o enterprise, ma l’utente deve risultare abilitato lato GitHub. In ambienti aziendali, spesso l’accesso viene controllato dall’organizzazione e non basta avere un account valido: il tenant può richiedere autorizzazioni specifiche o un invito esplicito al team. Se non hai visibilità su questo punto, non inseguire il problema dentro VS Code: il collo di bottiglia è lato GitHub.

Come base tecnica, usa una versione recente di Visual Studio Code. Copilot funziona meglio con release aggiornate perché le integrazioni di autenticazione, estensioni e chat evolvono abbastanza spesso. Se stai lavorando su macchine gestite, verifica anche che l’estensione possa parlare con i domini GitHub necessari e che eventuali proxy o filtri TLS non rompano la sessione OAuth.

Installare l’estensione giusta senza confondere il componente base con le funzioni extra

In VS Code la parte operativa è l’estensione ufficiale di GitHub Copilot. In alcuni casi conviene installare anche il componente per la chat o le estensioni collegate, ma il primo obiettivo è far funzionare l’autocompletamento. Il flusso corretto è questo: installi l’estensione, fai login con GitHub, autorizzi l’editor e poi verifichi che l’icona o lo stato dell’estensione indichino Copilot attivo.

  1. Apri Visual Studio Code.
  2. Vai in Extensions con Ctrl+Shift+X su Windows/Linux o Cmd+Shift+X su macOS.
  3. Cerca GitHub Copilot.
  4. Installa l’estensione pubblicata da GitHub.
  5. Se richiesto, installa anche il pacchetto collegato per la chat o le funzionalità aggiuntive.

Se lavori da terminale e vuoi verificare la presenza dell’estensione installata, puoi usare la CLI di VS Code quando disponibile:

code --list-extensions | grep -i copilot

Se il comando non restituisce nulla, l’estensione non è presente. Se invece compare, ma Copilot non propone completamenti, il problema è quasi sempre nell’autenticazione o nella policy dell’organizzazione, non nell’installazione.

Autenticazione GitHub: il passaggio che decide se Copilot resta spento o no

Dopo l’installazione, VS Code avvia il flusso di login. L’obiettivo è collegare il tuo editor all’account GitHub che possiede il diritto di usare Copilot. Il passaggio può avvenire con browser esterno, finestra di autorizzazione interna o device code, a seconda della piattaforma e della versione dell’editor. Non importa troppo il dettaglio grafico: quello che conta è che il token venga emesso e che l’estensione riceva il consenso.

  1. Apri la Command Palette con Ctrl+Shift+P o Cmd+Shift+P.
  2. Cerca GitHub Copilot: Sign In oppure il comando equivalente di accesso GitHub.
  3. Completa il login nel browser.
  4. Autorizza VS Code ad accedere al tuo account.
  5. Rientra nell’editor e verifica che lo stato dell’estensione passi a connesso.

Se il browser ti dice che l’account è autenticato ma VS Code non cambia stato, apri il pannello degli account dell’editor e controlla quale identità è effettivamente selezionata. È un errore classico lavorare con più account GitHub nel browser e far finire l’autenticazione su quello sbagliato. In pratica il sistema ti ha “loggato”, ma non con l’utente che possiede la licenza Copilot.

Se hai più account GitHub, il sintomo tipico è questo: login apparentemente riuscito, ma Copilot resta in stato non disponibile o chiede di sottoscrivere un piano. In quel caso, la prima verifica non è reinstallare l’estensione, ma controllare quale account è stato scelto nel flusso OAuth.

Come capire se Copilot è davvero attivo dentro l’editor

Una volta completata l’autenticazione, serve una verifica concreta. Apri un file di codice riconoscibile, scrivi poche righe di contesto e osserva se compaiono suggerimenti inline. Copilot non deve per forza “sparare” codice subito: a volte aspetta che il contesto sia abbastanza chiaro. Se però non vedi alcun segnale, fai una verifica più esplicita con un file semplice, per esempio JavaScript o Python, evitando file di testo generico dove l’editor ha meno indizi semantici.

  1. Crea un file come test.js o test.py.
  2. Scrivi una funzione incompleta, per esempio un wrapper di logging o una validazione banale.
  3. Attendi il suggerimento inline.
  4. Se il suggerimento non arriva, apri i log dell’estensione.

Un controllo utile è aprire il pannello Output di VS Code e selezionare i canali legati a GitHub Copilot o all’estensione GitHub. Lì trovi spesso messaggi più utili della UI: errori di autenticazione, problemi di sessione, autorizzazioni negate, oppure mancanza di accesso al servizio. Non serve interpretare ogni riga, ma se vedi riferimenti a 401, 403 o a richieste bloccate, hai già una direzione precisa.

Se l’estensione risulta attiva ma i completamenti sono sporadici, controlla anche i settaggi dell’editor. Alcune configurazioni riducono l’auto-suggest o la sovrascrivono con altri strumenti. Non è raro avere conflitti con estensioni di completamento alternative, che cambiano il comportamento dei suggerimenti e fanno sembrare Copilot “rotto” quando in realtà è solo secondario rispetto a un altro motore di autocomplete.

Impostazioni utili da controllare senza trasformare il setup in una caccia al tesoro

GitHub Copilot funziona bene quando VS Code gli lascia spazio. Questo significa verificare alcune impostazioni pratiche, non fare tuning ossessivo. In molti casi la strada più rapida è aprire le impostazioni e cercare Copilot o suggest. Se l’auto-completion globale è disabilitata, Copilot può risultare presente ma poco visibile. Se invece la funzione inline è disattivata, perdi il principale vantaggio dell’estensione.

  1. Apri Settings in VS Code.
  2. Cerca Copilot.
  3. Verifica che le opzioni di completamento automatico siano abilitate.
  4. Cerca editor.inlineSuggest.enabled e controlla che sia attivo se vuoi i suggerimenti inline.
  5. Controlla eventuali eccezioni per linguaggio o workspace.

Se lavori in un repository condiviso, alcune configurazioni possono essere definite anche a livello di workspace. Questo è utile in team, ma può confondere se hai una policy locale che disattiva il comportamento che ti aspetti. In questi casi apri il file di configurazione del progetto, per esempio .vscode/settings.json, e verifica se ci sono override specifici.

{ "editor.inlineSuggest.enabled": true, "github.copilot.enable": { "*": true, "plaintext": false }
}

Il blocco sopra è un esempio tipico di attivazione per tutti i linguaggi con esclusione del testo puro. Non prenderlo come ricetta universale: il punto è capire dove intervenire quando un workspace sovrascrive il comportamento globale.

Se Copilot non funziona: diagnosi rapida per layer

Quando qualcosa non va, conviene ragionare per livelli. Il primo è l’account GitHub: senza licenza o autorizzazione, non c’è nulla da fare dentro l’editor. Il secondo è la rete: proxy, SSL inspection, firewall o DNS possono interrompere le chiamate verso i servizi GitHub. Il terzo è l’estensione stessa: se è corrotta, vecchia o in conflitto con altre estensioni, il comportamento diventa intermittente. Il quarto è la configurazione locale: workspace settings, policy aziendali e disabilitazioni per linguaggio.

  1. Account: accedi su GitHub nel browser e controlla la pagina Copilot del profilo o dell’organizzazione.
  2. Connessione: prova ad aprire GitHub da browser e verifica eventuali proxy o blocchi TLS.
  3. Estensione: disinstalla e reinstalla solo se i log indicano problemi locali chiari.
  4. Configurazione: controlla .vscode/settings.json e le impostazioni globali.

Per una verifica rapida della connettività, puoi lanciare un test verso GitHub dal terminale. Non sostituisce il traffico reale dell’estensione, ma aiuta a capire se il problema è grossolano, per esempio un DNS o un proxy che intercetta tutto.

curl -I https://github.com
curl -I https://api.github.com

Se questi comandi falliscono da rete aziendale ma funzionano da una connessione diversa, hai una pista evidente. In quel caso non serve smanettare in VS Code: bisogna sistemare la policy di rete, il proxy o l’ispezione TLS. Se i comandi funzionano ma l’estensione no, allora il problema si sposta su autenticazione o state locale dell’editor.

Uso corretto in team: differenza tra account personale, aziendale e organizzazione

In contesti professionali la parte più delicata non è l’installazione, ma la governance. Se l’azienda usa GitHub Enterprise, Copilot può essere soggetto a policy centrali. Questo significa che un utente può avere accesso al repository ma non al servizio di assistenza AI, oppure viceversa. Conviene quindi distinguere chiaramente tre livelli: identità personale, accesso all’organizzazione e diritto effettivo a usare Copilot. Mischiarli porta a ticket inutili e diagnosi sbagliate.

Un’altra abitudine utile è documentare nel team il percorso di attivazione standard, compreso il canale di supporto interno. Se tutti usano versioni diverse di VS Code, plugin diversi e account multipli, il supporto diventa ingestibile. Meglio fissare una baseline: versione minima dell’editor, estensione ufficiale, modalità di login preferita e canale di log da consultare quando qualcosa si rompe.

Buone pratiche operative dopo l’attivazione

Una volta attivo, Copilot va usato con un minimo di disciplina. Non è un sostituto della revisione del codice, e in un contesto tecnico serio non conviene trattarlo come fonte di verità. Il modello può proporre snippet plausibili ma sbagliati, soprattutto quando il contesto del progetto è incompleto o quando il linguaggio ha pattern ambigui. Il vantaggio reale arriva quando lo usi per accelerare boilerplate, test, trasformazioni ripetitive e scaffolding, non per delegare ragionamenti architetturali critici.

  1. Rivedi sempre il codice suggerito prima di accettarlo.
  2. Non incollare segreti, token o configurazioni sensibili nel contesto dell’editor.
  3. Usa file di esempio o repository di test per valutare il comportamento prima di adottarlo in produzione.
  4. Se lavori su codice proprietario, verifica le policy aziendali su invio del contesto a servizi esterni.

Dal punto di vista della sicurezza, il tema non è solo il contenuto scritto dall’utente, ma anche ciò che l’estensione può vedere del progetto. Se il repository contiene file con segreti in chiaro, il problema esiste già e Copilot lo rende solo più visibile. La soluzione rimane la stessa: rimuovere i segreti dal codice, ruotarli se esposti e spostarli in secret manager o variabili d’ambiente gestite correttamente.

Procedura sintetica per attivarlo da zero su una macchina pulita

Se vuoi una sequenza asciutta, questa è quella che uso per ridurre gli errori operativi:

  1. Aggiorna Visual Studio Code a una versione recente.
  2. Installa l’estensione ufficiale GitHub Copilot.
  3. Avvia il login GitHub dalla Command Palette.
  4. Autorizza l’editor sul browser.
  5. Verifica che l’account abbia diritto a Copilot.
  6. Apri un file di codice e controlla i suggerimenti inline.
  7. Se non funziona, apri i log dell’estensione e controlla il canale Output.

In un ambiente amministrato, aggiungo sempre un passaggio in più: verifico se il profilo utente o il workspace hanno policy che disattivano l’estensione. È il tipo di problema che fa perdere tempo perché l’app sembra sana, ma il comportamento è stato volutamente limitato da configurazione locale o aziendale.

Quando conviene fermarsi e aprire un ticket invece di tentare altri workaround

Se il login fallisce con errori chiari lato GitHub, se l’organizzazione non ha assegnato la licenza, o se il proxy aziendale blocca sistematicamente i domini necessari, insistere in VS Code non porta valore. In quei casi conviene raccogliere evidenza concreta: screenshot della pagina account GitHub, messaggi del pannello Output, esito di curl -I https://api.github.com e versione dell’editor. Con questi dati il ticket diventa risolvibile, mentre una segnalazione generica del tipo “Copilot non va” no.

Se invece l’errore è locale, per esempio estensione corrotta o preferenze incoerenti, la correzione più pulita è rimuovere e reinstallare il plugin dopo aver salvato le impostazioni rilevanti. Anche qui vale la solita regola: cambia una cosa alla volta, verifica subito, e non accumulare modifiche che poi non riesci più a isolare.

Alla fine l’abilitazione di GitHub Copilot in Visual Studio Code è un’operazione semplice solo in apparenza. Se la tratti come un problema di editor risolvi metà dei casi; se la tratti come un flusso composto da account, rete, policy e configurazione, risolvi quasi tutti gli altri senza perdere ore in tentativi casuali.