Tecnologie

GitHub Copilot CLI e SDK: Guida Completa 2026

Scopri come installare e usare GitHub Copilot CLI e gli SDK per integrare l'AI nelle tue app. Guida completa con esempi pratici per sviluppatori.

Cosmin-Anton Mihoc
9 min di lettura
GitHub Copilot CLI e SDK: Guida Completa 2026

Indice dei contenuti

GitHub ha rivoluzionato il modo in cui gli sviluppatori interagiscono con l'intelligenza artificiale. Con il rilascio di GitHub Copilot CLI e del nuovo Copilot SDK, ora puoi portare la potenza dell'AI direttamente nel tuo terminale e integrarla nelle tue applicazioni. In questa guida completa scoprirai come installare, configurare e sfruttare al massimo questi strumenti per velocizzare il tuo workflow di sviluppo.

Come sviluppatore full stack con oltre 9 anni di esperienza, ho testato approfonditamente questi tool e posso confermare che rappresentano un salto di qualità significativo per chi lavora quotidianamente con codice e automazioni.

Cos'è GitHub Copilot CLI

GitHub Copilot CLI è uno strumento a riga di comando che porta l'assistente AI di GitHub direttamente nel tuo terminale. A differenza dell'estensione per editor, la CLI ti permette di interagire con un agente autonomo capace di leggere, scrivere ed eseguire codice senza mai lasciare la shell.

Le caratteristiche principali includono: sviluppo nativo nel terminale senza context switching, integrazione completa con GitHub per accedere a repository, issue e pull request usando il linguaggio naturale, supporto multi-modello con Claude Sonnet 4.5, GPT-5 e altri, ed esecuzione agentica autonoma per task complessi come debug, refactoring e creazione di progetti.

La CLI funziona con lo stesso harness agentico che alimenta GitHub Copilot nell'editor, ma ottimizzato per workflow da terminale. Ogni azione richiede la tua approvazione esplicita, quindi mantieni sempre il pieno controllo. Questo approccio è simile a quello che ho descritto nell'articolo su GitHub Security Lab Taskflow Agent, dove l'AI viene usata per automatizzare task di sicurezza.

Requisiti di Sistema

Prima di procedere con l'installazione, assicurati di avere i seguenti requisiti: un abbonamento attivo a GitHub Copilot (Pro, Pro+, Business o Enterprise), Node.js versione 22 o superiore per l'installazione via npm, sistema operativo macOS, Linux o Windows (via WSL), e PowerShell 6+ per utenti Windows.

Se il tuo account Copilot è gestito da un'organizzazione, l'amministratore deve abilitare le funzionalità di preview per poter usare la CLI.

Come Installare GitHub Copilot CLI

Esistono diversi metodi per installare Copilot CLI. Ecco le opzioni disponibili in ordine di semplicità.

Installazione via npm (Tutti i sistemi)

Il metodo più universale è tramite npm. Apri il terminale e esegui npm install -g @github/copilot per installare globalmente. Al primo avvio, la CLI ti guiderà attraverso l'autenticazione con il tuo account GitHub.

Installazione via Homebrew (macOS e Linux)

Se preferisci Homebrew, puoi installare con brew install github/gh/copilot. Questo metodo si aggiorna automaticamente con brew upgrade.

Installazione via WinGet (Windows)

Su Windows, usa Windows Package Manager con winget install GitHub.CopilotCLI. È disponibile anche un installer MSI scaricabile dalla pagina delle release.

Installazione via Script (macOS e Linux)

Per un'installazione rapida senza dipendenze, usa lo script ufficiale con curl -fsSL https://gh.io/copilot-install | bash. Per installare in una directory specifica, imposta la variabile PREFIX prima di eseguire lo script.

Primo Avvio e Autenticazione

Dopo l'installazione, avvia la CLI digitando copilot nel terminale. Al primo avvio vedrai un banner animato di benvenuto. Se non sei già autenticato, usa il comando /login e segui le istruzioni per autenticarti tramite browser.

In alternativa, puoi autenticarti usando un Personal Access Token (PAT) con i permessi Copilot Requests. Imposta il token nella variabile d'ambiente GH_TOKEN o GITHUB_TOKEN e la CLI lo userà automaticamente.

Comandi e Funzionalità Principali

La CLI offre tre modalità operative principali che coprono diversi casi d'uso.

Modalità Ask

Usa questa modalità per ottenere spiegazioni, definizioni, confronti o guide passo-passo. Basta descrivere cosa vuoi sapere e Copilot risponderà in modo conversazionale. È perfetta per capire come funziona un flag, cosa fa una pipeline, o perché uno script sta fallendo.

Modalità Edit

Quando hai bisogno di modificare file, la modalità Edit ti permette di descrivere le modifiche desiderate. Copilot genererà un diff che potrai revisionare e approvare prima che venga applicato.

Modalità Agent

La modalità più potente è quella agentica. L'AI pianifica ed esegue task multi-step in autonomia: può fare debug, modificare file, creare strutture di progetto e gestire workflow complessi. Ogni azione critica richiede comunque la tua approvazione.

Comandi Slash Utili

La CLI supporta diversi comandi slash per azioni rapide: /model per cambiare modello AI, /review per analizzare le modifiche al codice, /session per gestire la sessione corrente, /cwd per cambiare directory di lavoro, e /share gist per condividere snippet. Digita / in qualsiasi momento per vedere tutti i comandi disponibili.

Sub-Agenti Specializzati

A partire da gennaio 2026, Copilot CLI include sub-agenti specializzati per task comuni. L'agente Explore è ottimizzato per l'analisi rapida del codebase e risponde a domande sul codice senza intasare il contesto principale. L'agente Task esegue comandi come test e build. Copilot delega automaticamente ai sub-agenti appropriati e può eseguire più agenti in parallelo per massimizzare l'efficienza.

Modelli AI Disponibili

Di default, Copilot CLI usa Claude Sonnet 4.5, ma puoi scegliere tra diversi modelli. Usa il comando /model per vedere e selezionare le opzioni disponibili, che includono Claude Sonnet 4, GPT-5, GPT-5 mini e GPT-4.1. I modelli GPT-5 mini e GPT-4.1 sono inclusi nell'abbonamento e non consumano richieste premium.

Cos'è GitHub Copilot SDK

Se vuoi integrare le capacità di Copilot direttamente nelle tue applicazioni, il Copilot SDK fa al caso tuo. Rilasciato in Technical Preview a gennaio 2026, espone lo stesso engine che alimenta Copilot CLI come runtime programmabile.

L'SDK gestisce automaticamente l'orchestrazione: tu definisci il comportamento dell'agente, Copilot si occupa di pianificazione, invocazione di tool, modifiche ai file e molto altro. È disponibile per quattro linguaggi: Node.js/TypeScript, Python, Go e .NET.

Installazione degli SDK

Prima di usare qualsiasi SDK, devi avere Copilot CLI installato e disponibile nel PATH. Gli SDK comunicano con la CLI in modalità server via JSON-RPC.

SDK Node.js / TypeScript

Installa con npm install @github/copilot-sdk. Questo SDK è ideale per progetti Node.js esistenti e applicazioni TypeScript. Se lavori con web app o automazioni in JavaScript, questa è la scelta naturale.

SDK Python

Installa con pip install github-copilot-sdk. Perfetto per script di automazione, progetti di data science o backend Django/Flask. L'integrazione con l'ecosistema Python è fluida e ben documentata.

SDK Go

Installa con go get github.com/github/copilot-sdk/go. Ottimo per CLI personalizzate, microservizi e applicazioni cloud-native ad alte prestazioni.

SDK .NET

Installa con dotnet add package GitHub.Copilot.SDK. La scelta ideale per applicazioni enterprise .NET, servizi Azure e integrazione con l'ecosistema Microsoft.

Architettura degli SDK

Tutti gli SDK condividono un'architettura comune basata su JSON-RPC. La tua applicazione comunica con il client SDK, che a sua volta si connette a Copilot CLI in modalità server. L'SDK gestisce automaticamente il ciclo di vita del processo CLI, ma puoi anche connetterti a un server CLI esterno per scenari più avanzati.

Le funzionalità principali degli SDK includono: conversazioni multi-turn con storico della sessione per interazioni context-aware, esecuzione di tool con la possibilità di definire tool custom che il modello può invocare, e controllo completo del lifecycle per gestire client e sessioni programmaticamente.

Esempio Pratico: SDK Node.js

Ecco un esempio base di come usare l'SDK Node.js per creare un agente semplice. Importi il client dall'SDK, crei una nuova istanza, avvii una sessione e invii messaggi. L'SDK si occupa di tutto il resto: gestione della connessione, parsing delle risposte e gestione degli errori.

Puoi anche definire tool custom che l'agente può utilizzare durante le conversazioni. Questo permette di estendere le capacità di Copilot con logica specifica per la tua applicazione, come accedere a database proprietari o chiamare API interne.

Configurazione Avanzata

La CLI supporta file di configurazione in ~/.copilot/config per personalizzare il comportamento. Puoi definire pattern per URL consentiti e negati (utili per il tool web_fetch), configurare l'integrazione con server MCP esterni, e impostare preferenze per l'auto-compaction dello storico.

Il supporto per MCP (Model Context Protocol) permette di estendere Copilot con context e tool aggiuntivi. I server MCP possono ora autenticarsi via OAuth 2.0 con gestione automatica dei token, e i plugin possono includere server MCP che si caricano automaticamente all'installazione.

Integrazione con GitHub

Uno dei punti di forza di Copilot CLI è l'integrazione nativa con GitHub. Autenticandoti con il tuo account, l'agente diventa repository-aware: puoi fare domande e azioni relative ai tuoi progetti specifici usando il linguaggio naturale.

Puoi chiedere di trovare le good first issues in un repository e classificarle per difficoltà, oppure creare pull request con descrizioni generate automaticamente. Questo è particolarmente utile per chi gestisce più progetti o contribuisce a repository open source, un tema che ho approfondito parlando di sicurezza nelle pipeline CI/CD.

Costi e Billing

L'accesso a Copilot CLI è incluso negli abbonamenti Copilot Pro, Pro+, Business ed Enterprise. Non servono chiavi API separate o billing aggiuntivo. Ogni interazione con l'agente consuma dalla tua quota di richieste premium del piano.

Per l'SDK, il modello di billing è lo stesso: ogni prompt viene contato verso la tua quota di richieste premium. Esiste anche un tier gratuito della CLI con utilizzo limitato per chi vuole provare lo strumento.

Il supporto BYOK (Bring Your Own Key) è disponibile per chi ha requisiti di sicurezza specifici: puoi configurare l'SDK per usare le tue chiavi di crittografia.

Confronto con Altri Tool

Rispetto a tool simili come Gemini CLI o Claude Code, Copilot CLI si distingue per l'integrazione nativa con GitHub e il supporto multi-modello. Puoi scegliere tra modelli di Anthropic, OpenAI e Google senza cambiare strumento. L'accesso a repository, issue e PR direttamente dalla shell è un vantaggio significativo per chi lavora intensivamente con GitHub. Ho parlato di un workflow simile nell'articolo su Antigravity e Open Code.

Best Practice per Sviluppatori

Per sfruttare al meglio questi strumenti, ti consiglio di usare la CLI per task ripetitivi come setup di progetti, analisi di codebase nuovi e creazione di boilerplate. Integra l'SDK nelle tue applicazioni quando hai bisogno di assistenza AI programmabile e sfrutta i sub-agenti per task specializzati invece di sovraccaricare il contesto principale.

Ricorda che ogni file change e comando richiede la tua approvazione: approfitta di questo per revisionare e imparare dalle soluzioni proposte dall'AI. E se lavori con dati sensibili, configura attentamente i pattern di URL permessi e negati.

Leggi anche

Conclusioni

GitHub Copilot CLI e SDK rappresentano un'evoluzione significativa nel modo in cui gli sviluppatori possono interagire con l'AI. La CLI porta la potenza di Copilot direttamente nel terminale con un'esperienza fluida e GitHub-native, mentre l'SDK apre possibilità infinite per integrare capacità agentiche nelle tue applicazioni.

Se stai cercando di automatizzare il tuo workflow di sviluppo o vuoi creare tool AI-powered per i tuoi clienti, questi strumenti meritano sicuramente un'esplorazione approfondita. Se hai bisogno di aiuto per integrare queste tecnologie nei tuoi progetti o vuoi una consulenza personalizzata su come sfruttare l'AI nello sviluppo, contattami per discuterne insieme.

Condividi questo articolo
Hai domande? Contattami

Pronto a dare vita al tuo progetto?

Contattami per discutere della tua idea e ricevere una consulenza gratuita.

Iniziamo insieme