GitHub Copilot CLI si SDK: ghid complet pentru 2026

GitHub Copilot CLI si Copilot SDK sunt doua instrumente stabile, dar au scopuri diferite. CLI aduce un agent AI in terminal, unde poate analiza repository-ul, modifica fisiere si rula teste. SDK-ul iti permite sa integrezi acelasi runtime agentic intr-o aplicatie, un serviciu backend sau o automatizare.

Raspunsul rapid: alege Copilot CLI daca vrei sa lucrezi tu cu agentul; alege Copilot SDK daca vrei sa construiesti un produs care foloseste agentul. Le poti combina: validezi workflow-ul in terminal, apoi il transformi intr-un proces repetabil prin SDK.

GitHub Copilot CLI si SDK: ce s-a schimbat in 2026

• 25 februarie 2026: GitHub Copilot CLI a devenit general available.
• 2 iunie 2026: Copilot SDK a iesit din preview si a primit API stabil pentru productie.
• 23 iunie 2026: noua interfata pentru terminal a devenit disponibila general.
• 1 iulie 2026: GitHub a introdus limite de AI credits pentru fiecare sesiune CLI si SDK.
• 12 august 2026: Agent Plugins 1.0 a extins aceleasi pluginuri intre CLI, SDK, VS Code si alte suprafete Copilot.

Aceste schimbari conteaza. Primele articole despre Copilot CLI si SDK le descriau ca experimente. In august 2026 pot fi folosite in workflow-uri reale, dar trebuie controlate permisiunile si bugetul.

In actualizarea din septembrie am adaugat modul Autopilot, diferenta fata de --yolo (intrebarea pe care o primesc cel mai des), toate metodele de instalare si preturile planurilor.

Ce este GitHub Copilot CLI?

GitHub Copilot CLI este un mediu de dezvoltare agentic care ruleaza in terminal. Agentul poate explora proiectul, propune un plan, edita mai multe fisiere, executa comenzi si verifica rezultatul.

Cand pornesti o sesiune intr-o carpeta, Copilot cere sa confirmi ca ai incredere in fisierele din acel loc. Avertismentul este important: in sesiune, agentul poate incerca sa citeasca, sa modifice si sa execute fisiere aflate in acel director sau subdirectoare.

Cand este utila CLI

• Debug: combina loguri, cod si dependinte fara sa parasesti shell-ul.
• Refactorizare: planifica si modifica mai multe fisiere, apoi ruleaza testele.
• GitHub: lucreaza cu repository-uri, issue-uri si pull request-uri.
• Code review: foloseste agenti specializati pentru analiza modificarilor.
• Automatizare: poate primi prompturi din scripturi sau GitHub Actions.

Cum instalezi GitHub Copilot CLI

Ai nevoie de un cont GitHub cu un plan Copilot, de Node.js 22 sau mai nou daca instalezi cu npm si de PowerShell 6 sau mai nou pe Windows. Ai patru metode:

• npm (orice sistem): npm install -g @github/copilot
• Homebrew (macOS si Linux): brew install --cask copilot-cli
• WinGet (Windows): winget install GitHub.Copilot
• Script (macOS si Linux): curl -fsSL https://gh.io/copilot-install | bash

Homebrew, WinGet si scriptul se actualizeaza singure; cu npm faci update ruland din nou aceeasi comanda. Daca in ~/.npmrc ai ignore-scripts=true, instalarea cu npm nu se termina: foloseste npm_config_ignore_scripts=false npm install -g @github/copilot.

Verifica versiunea si porneste interfata:

copilot --version
copilot

La prima folosire scrie /login si urmeaza autentificarea in browser. Pentru CI si servere poti folosi un token cu permisiuni limitate in variabila COPILOT_GITHUB_TOKEN. Daca abonamentul este administrat de companie, politica organizatiei trebuie sa permita Copilot CLI. Pentru metode alternative si cerinte actualizate, consulta documentatia oficiala de instalare.

GitHub Copilot CLI pe Windows

Copilot CLI este disponibil pe Windows. Cel mai comod il instalezi cu winget install GitHub.Copilot, care il si actualizeaza automat; merge si npm, iar Microsoft Store poate afisa pachetul dedicat. Intr-un mediu corporate verifica PATH-ul, politicile PowerShell si daca autentificarea organizatiei permite CLI.

Cum folosesti Copilot CLI fara sa pierzi controlul

Porneste comanda copilot in radacina proiectului. Pentru un task complex, intra mai intai in Plan mode cu Shift+Tab. Astfel, agentul explica pasii inainte sa scrie cod.

Un prompt bun include obiectiv, limite si verificare:

Analizeaza proiectul si propune un plan pentru rate limiting. Nu modifica baza de date si nu adauga servicii externe. Ruleaza testele API, apoi arata-mi diff-ul.

Poti opri o operatie aflata in executie cu Esc. Pentru automatizari, CLI accepta si prompt direct prin optiunile -p sau --prompt, dar un proces non-interactiv necesita limite mai stricte.

Comenzile slash de care ai nevoie

• /model: schimbi modelul in timpul sesiunii.
• /context: vezi cati tokeni folosesti.
• /compact: comprimi conversatia cand contextul se umple.
• /diff si /review: verifici modificarile inainte sa le accepti.
• /mcp: listezi serverele MCP conectate.
• /sandbox enable: pornesti sandbox-ul local.

Modul Autopilot: ce este si cum il pornesti

Cu Shift+Tab treci intre trei moduri: interactiv, care cere confirmare inainte de unelte sensibile; Plan, care scrie un plan inainte sa atinga codul; Autopilot, care dupa primul prompt merge singur, pas cu pas, pana termina, da de o problema, atinge limita de pasi sau apesi Ctrl+C.

Din linia de comanda pornesti Autopilot asa:

copilot --autopilot --yolo --max-autopilot-continues 10 -p "repara testele care pica"

Autopilot sau --yolo: care e diferenta

• --yolo (acelasi lucru cu --allow-all) tine de permisiuni: aproba automat unelte, cai si URL-uri, dar agentul ramane interactiv si se opreste la punctele de decizie.
• Autopilot tine de continuitate: agentul merge singur pe mai multi pasi. Fara permisiuni complete refuza uneltele care ar cere aprobare si se poate bloca.
• --no-ask-user elimina doar intrebarile de clarificare, dar nu face agentul autonom.

Autopilot plus --yolo inseamna un agent care lucreaza singur, cu toate permisiunile. E puternic si tocmai de aceea trebuie tinut intr-un tarc. In plus, creditele AI se consuma si cand nu te uiti.

Cum folosesc Autopilot fara riscuri

1. Intai planul: il las sa scrie planul in modul Plan, il citesc si abia apoi trec pe Autopilot.
2. Limita de pasi: setez mereu --max-autopilot-continues, mai ales in CI.
3. Sandbox: pornesc /sandbox enable local sau folosesc --cloud pentru o sesiune izolata.
4. Interdictii clare: folosesc --deny-tool pentru comenzile care nu trebuie sa ruleze niciodata, pentru ca are prioritate fata de permisiunile acordate.
5. Date de test: in fixtures nu pun niciodata CNP-uri, adrese sau telefoane reale ale clientilor; GDPR si regulile ANSPDCP raman valabile si cand scrie codul un agent.

Nu il confunda cu Microsoft Copilot Autopilot

Pe 25 septembrie 2026 Microsoft a prezentat noua aplicatie Copilot cu Home, Code si Autopilot. Acel Autopilot este un agent pentru munca de birou care continua task-urile si cand nu esti la calculator si intra in preview privat pentru programul Frontier.

Nu are legatura directa cu modul Autopilot din Copilot CLI, care lucreaza pe cod, in terminal. In ghidul asta vorbesc doar despre unealta pentru programatori.

Functii importante in 2026

• Selectie automata a modelului: alege un model compatibil cu planul si politica. Din septembrie 2026 are trei niveluri: eficienta, echilibru si inteligenta.
• Modele noi: in ultimele versiuni au aparut si Claude Fable 5.1 si Kimi K3, pe care le alegi cu /model.
• Subagenti: separa cercetarea, review-ul sau alte taskuri de conversatia principala.
• Auto-compaction: reduce istoricul cand contextul devine mare.
• Skills si Agent Plugins: adauga proceduri si integrari reutilizabile.
• MCP si LSP: conecteaza instrumente externe si inteligenta specifica limbajului.
• BYOK: permite configurarea unui provider propriu, inclusiv endpoint-uri compatibile.
• Limita de sesiune: opreste consumul dupa bugetul de AI credits stabilit.

Pentru comparatie cu alti agenti, citeste Claude Code vs OpenCode vs Codex. Diferenta principala nu este doar modelul, ci modul in care agentul gestioneaza fisiere, permisiuni si taskuri cloud.

Ce este GitHub Copilot SDK?

GitHub Copilot SDK este kitul oficial pentru integrarea runtime-ului Copilot intr-o aplicatie. Poate gestiona sesiuni multi-turn, streaming, tool calling, hook-uri, fisiere si telemetrie de utilizare.

Cu CLI, dezvoltatorul discuta direct cu agentul. Cu SDK, aplicatia ta porneste sesiunea, trimite promptul, expune instrumentele permise si proceseaza raspunsul.

Limbaje suportate

Documentatia actuala ofera exemple pentru sase ecosisteme:

• TypeScript: npm install @github/copilot-sdk
• Python: pip install github-copilot-sdk
• Go: go get github.com/github/copilot-sdk/go
• Rust: cargo add github-copilot-sdk --features derive
• .NET: dotnet add package GitHub.Copilot.SDK
• Java: pachetul Maven/Gradle com.github:copilot-sdk-java

Pentru Go, Java si Rust trebuie sa verifici separat runtime-ul Copilot CLI cerut de SDK. TypeScript, Python si .NET pot gestiona mai automat aceasta dependinta, in functie de configuratie.

Exemplu minim Copilot SDK in TypeScript

Un client de baza creeaza o sesiune, trimite promptul, asteapta raspunsul si opreste procesul:

import { CopilotClient } from "@github/copilot-sdk";

const client = new CopilotClient();
const session = await client.createSession({ model: "auto" });
const response = await session.sendAndWait({
  prompt: "Analizeaza eroarea API si propune un fix"
});
console.log(response?.data.content);
await client.stop();

Intr-o aplicatie reala trebuie sa adaugi autentificare, timeout, limite de cost, loguri, tratarea erorilor si o lista stricta de instrumente. SDK-ul nu transforma automat un demo intr-un serviciu sigur.

Autentificarea Copilot SDK

SDK-ul poate detecta tokenurile din variabilele de mediu suportate. Pentru un serviciu server-to-server, GitHub recomanda tokenuri cu durata scurta, iar in GitHub Actions trebuie preferat GITHUB_TOKEN cu permisiuni minime.

Nu incorpora un token personal in cod si nu il trimite in frontend. Credentialele trebuie sa ramana pe server sau intr-un manager de secrete. Daca folosesti BYOK, verifica separat politica providerului si costurile modelului.

Copilot CLI vs Copilot SDK

Criteriu	Copilot CLI	Copilot SDK
Utilizator	Dezvoltator in terminal	Aplicatie sau serviciu
Scop	Scriere, debug, review, GitHub	Produs agentic si automatizare
Integrare	Comenzi si repository local	API, hook-uri, tool-uri, streaming
Control	Interactiune si aprobari	Politici implementate in cod
Risc principal	Comenzi sau fisiere nepermise	Tokenuri, costuri si tool-uri expuse

Alege CLI pentru munca zilnica de dezvoltare. Alege SDK pentru un asistent intern, un agent de suport tehnic, automatizarea documentatiei sau un serviciu care executa taskuri controlate.

Daca vrei sa transformi un prototip intr-un produs, pagina despre aplicatii web si automatizari explica tipul de integrare pe care il pot construi.

Copilot CLI poate folosi modele locale?

Da, Copilot CLI poate fi configurat cu un provider propriu. GitHub documenteaza endpoint-uri compatibile, inclusiv scenarii cu Ollama sau vLLM. Modelul trebuie sa suporte functiile necesare agentului, in special streaming si tool calling.

Un model local nu ofera automat aceeasi calitate sau viteza ca un model cloud. Trebuie sa verifici contextul, memoria disponibila, suportul pentru instrumente si daca datele raman cu adevarat locale. Pentru hardware, vezi ghidul despre cel mai bun computer pentru AI local.

Cat costa GitHub Copilot CLI si SDK?

CLI este inclusa in planurile Copilot, inclusiv Free cu limite. Utilizarea agentica poate consuma GitHub AI Credits. Conform paginii oficiale, 1 AI credit valoreaza 0,01 USD, iar fiecare plan include o alocare lunara.

• Free: 0 dolari pe luna, cu utilizare limitata.
• Pro: 10 dolari pe luna.
• Pro+: 39 de dolari pe luna.
• Max: 100 de dolari pe luna.

Pentru o firma din Romania conteaza ca platesti in dolari, deci costul in lei depinde de curs. In planurile Business si Enterprise CLI este inclusa, dar administratorul trebuie sa activeze politica.

Chat-ul, agentii, Copilot CLI si aplicatiile Copilot consuma credits. Completarea de cod si next edit suggestions nu consuma credits si raman nelimitate pe planurile platite. Numarul de credits pentru un task depinde de model si complexitate.

Preturile si alocarile planurilor se pot modifica. Verifica planurile GitHub Copilot la checkout, mai ales inainte sa lansezi un serviciu SDK.

Limita de credits pe sesiune

GitHub permite stabilirea unui plafon pentru fiecare sesiune CLI sau SDK. Este una dintre cele mai importante protectii pentru automatizari fara supraveghere. Cand bugetul este atins, agentul nu ar trebui lasat sa cumpere automat utilizare suplimentara.

Monitorizeaza tokenii, utilizarea contextului, costul in AI credits si cota contului. Copilot SDK expune aceste valori pentru observabilitate.

Securitate: controale obligatorii

• Trusted directories: nu porni agentul intr-o carpeta necunoscuta.
• Permisiuni pentru tool-uri: permite doar comenzile, URL-urile si caile necesare.
• Secrete: protejeaza .env, cheile cloud si tokenurile GitHub.
• Plan mode: verifica strategia inainte de modificari mari.
• Budget: seteaza limita de AI credits pe sesiune.
• Review: verifica diff-ul si testele inainte de merge sau deploy.
• GitHub Actions: trateaza cu atentie workflow-urile pornite din fork-uri.

GitHub avertizeaza ca folosirea directa a CLI intr-un workflow poate oferi acces larg la mediul runnerului. Foloseste permisiuni minime si nu expune secrete unui pull request extern.

GitHub Copilot CLI merita in 2026?

Da, mai ales daca GitHub este centrul workflow-ului tau. CLI este matura, se integreaza cu repository-uri si pull request-uri, foloseste plan mode si poate fi extinsa cu pluginuri, skills, MCP si provideri proprii.

SDK-ul este mai valoros pentru echipele care vor sa construiasca o aplicatie agentica fara sa implementeze de la zero sesiuni, streaming si tool calling. Dar productia necesita observabilitate, autentificare corecta si limite de cost.

Ralph Loop si alte bucle autonome au alt scop: repeta acelasi task pana la un criteriu. Pentru aceasta tehnica vezi ghidul Ralph Loop Claude Code.

Intrebari frecvente

GitHub Copilot CLI este gratuit?

Este disponibila si cu planul Copilot Free, in limitele sale. Taskurile agentice pot consuma AI credits inclusi in plan.

Copilot SDK mai este in preview?

Nu. GitHub a anuntat disponibilitatea generala a Copilot SDK pe 2 iunie 2026.

Ce limbaje suporta Copilot SDK?

Documentatia ofera exemple pentru TypeScript, Python, Go, Rust, .NET si Java.

Am nevoie de Copilot CLI pentru SDK?

Depinde de limbaj si configuratie. Pentru Go, Java si Rust runtime-ul CLI este cerut separat; alte SDK-uri il pot gestiona automat.

Care e diferenta dintre Autopilot si --yolo?

--yolo, acelasi lucru cu --allow-all, aproba automat toate permisiunile, dar agentul ramane interactiv. Autopilot face agentul sa continue singur pe mai multi pasi. Impreuna dau un agent autonom cu toate permisiunile: limiteaza pasii cu --max-autopilot-continues si foloseste sandbox-ul.

Copilot CLI functioneaza pe Windows?

Da, cu PowerShell 6 sau mai nou. Cel mai comod o instalezi cu winget install GitHub.Copilot, dar merge si npm.

Copilot CLI poate folosi Ollama?

Da, prin configurarea unui provider compatibil. Modelul local trebuie sa suporte streaming si tool calling pentru un workflow agentic complet.

Concluzie

GitHub Copilot CLI si SDK au trecut de la preview la instrumente concrete. CLI este alegerea directa pentru terminal; SDK-ul este alegerea potrivita cand construiesti o aplicatie sau o automatizare controlata.

Daca vrei sa integrezi un agent AI intr-un produs, vezi pagina despre agenti AI pentru afaceri sau contacteaza-ma pentru arhitectura, permisiuni si estimarea costurilor.