Opțiunile din linia de comandă ale copilot (referință) în GitHub Copilot

copilot [OPȚIUNI]

Ce face Opțiunile din linia de comandă ale copilot (referință)

Tabelul urmează referința oficială a comenzilor Copilot CLI. Opțiunile cu TOOL ..., URL ... sau VAR ... acceptă mai multe valori într-o listă între ghilimele, separată prin virgule. Lista completă pentru versiunea instalată o vezi cu copilot help.

Opțiunile care acordă toate permisiunile (--allow-all-tools, --allow-all-paths, --allow-all-urls, --allow-all, --yolo) sunt ignorate când setarea permissions.disableBypassPermissionsMode are valoarea disable, fie din setările tale, fie din politica gestionată sau MDM. O politică de organizație poate impune sandbox-ul chiar dacă dai --no-sandbox.

Documentația de prezentare a CLI-ului mai descrie copilot --cloud, care pornește sesiunea într-un sandbox în cloud (public preview); opțiunea nu apare în tabelul de referință.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--acp	Pornește CLI-ul ca server Agent Client Protocol.
--add-dir=PATH	Permite accesul la un director și încarcă .github/skills și .github/agents din el ca configurații de încredere (se poate repeta).
--add-github-mcp-tool=TOOL	Activează o unealtă a serverului GitHub MCP peste subsetul implicit (* pentru toate).
--add-github-mcp-toolset=TOOLSET	Activează un set de unelte GitHub MCP (all pentru toate).
--additional-mcp-config=JSON	Server MCP doar pentru sesiune, ca JSON sau fișier cu prefixul @.
--agent=AGENT	Agentul personalizat folosit.
--allow-all	Toate permisiunile (unelte, căi, URL-uri).
--allow-all-mcp-server-instructions	Include de la început instrucțiunile tuturor serverelor MCP în promptul de sistem.
--allow-all-paths	Dezactivează verificarea căilor de fișiere.
--allow-all-tools	Permisiuni complete pentru unelte, fără evaluare și fără confirmări; regulile de refuz se aplică (env: COPILOT_ALLOW_ALL).
--allow-all-urls	Acces la toate URL-urile fără confirmare.
--allow-tool=TOOL ...	Unelte permise fără confirmare.
--allow-url=URL ...	URL-uri sau domenii permise.
--assisted-approval	Permisiuni asistate pentru rulări neinteractive (env: COPILOT_ASSISTED_APPROVAL).
--attachment PATH	Atașează un fișier la promptul inițial (se poate repeta).
--autopilot	Agentul continuă până apelează task_complete, apoi revine în modul interactiv.
--available-tools=TOOL ...	Doar aceste unelte sunt disponibile modelului.
--banner, --no-banner	Afișează sau ascunde bannerul de pornire.
--bash-env, --no-bash-env	Activează sau dezactivează suportul BASH_ENV.
-C DIRECTORY	Schimbă directorul de lucru înainte de orice altceva.
--config-dir=DIRECTORY	Depreciat; folosește variabila COPILOT_HOME.
--connect[=SESSION-ID]	Conectare directă la o sesiune la distanță.
--context TIER	Nivelul ferestrei de context: default sau long_context.
--continue	Reia cea mai recentă sesiune din directorul curent.
--deny-tool=TOOL ...	Unelte interzise.
--deny-url=URL ...	URL-uri interzise; au prioritate față de --allow-url.
--disable-builtin-mcps	Dezactivează serverele MCP încorporate (acum github-mcp-server).
--disable-client-telemetry	Dezactivează telemetria trimisă de CLI.
--disable-mcp-server=SERVER-NAME	Dezactivează un server MCP (se poate repeta).
--disallow-temp-dir	Fără acces automat la directorul temporar al sistemului.
--effort=LEVEL, --reasoning-effort=LEVEL	Efortul de raționament: low, medium, high, xhigh, max.
--enable-all-github-mcp-tools	Toate uneltele serverului GitHub MCP.
--enable-mcp-server=SERVER-NAME	Reactivează pentru sesiune un server dezactivat în setări.
--enable-memory	Activează memoria în modul prompt (implicit oprită).
--enable-reasoning-summaries	Depreciat, acceptat dar ignorat.
--excluded-tools=TOOL ...	Unelte indisponibile pentru model.
--experimental, --no-experimental	Activează sau dezactivează funcțiile experimentale.
--extension-sdk-path DIRECTORY	Folosește un copilot-sdk/ local în locul SDK-ului inclus pentru extensii.
--fleet	Rulează promptul în modul fleet (subagenți în paralel); cere un prompt din -i, -p sau pipe.
-h, --help	Afișează ajutorul.
-i PROMPT, --interactive=PROMPT	Pornește o sesiune interactivă și rulează imediat promptul.
--log-dir=DIRECTORY	Directorul jurnalelor (implicit ~/.copilot/logs/).
--log-level=LEVEL	none, error, warning, info, debug, all, default.
--max-ai-credits=CREDITS	Limită soft de AI Credits pentru fiecare răspuns.
--max-autopilot-continues=COUNT	Numărul maxim de continuări în autopilot (implicit nelimitat).
--mode=MODE	Modul inițial: interactive, plan, autopilot; --plan --mode autopilot trece singur din plan în autopilot.
--model=MODEL	Modelul AI; auto lasă Copilot să aleagă.
--mouse[=VALUE], --no-mouse	Suport pentru mouse în interfață (on implicit sau off).
-n NAME, --name=NAME	Numele sesiunii noi, folosit de --resume și /resume.
--no-ask-user	Dezactivează unealta ask_user; agentul nu mai pune întrebări.
--no-auto-update	Fără descărcarea automată a actualizărilor.
--no-color	Fără culori.
--no-custom-instructions	Nu încarcă instrucțiunile din AGENTS.md și fișierele înrudite.
--no-remote	Eliminat; folosește /remote off.
--no-remote-export / --remote-export	Redenumite în --sync-session=off / --sync-session=on.
--output-format=FORMAT	text (implicit) sau json (JSONL).
-p PROMPT, --prompt=PROMPT	Rulează un prompt programatic și iese.
--plan	Pornește în modul plan; prescurtare pentru --mode plan.
--plain-diff	Dezactivează afișarea bogată a diff-urilor.
--plugin-dir=DIRECTORY	Încarcă un plugin dintr-un director local (se poate repeta).
--remote	Nu este suportat la pornirea interactivă sau cu -p; folosește /remote on.
-r, --resume[=VALUE]	Reia o sesiune după ID, prefix de ID sau nume; fără valoare deschide selectorul.
-s, --silent	Doar răspunsul agentului, fără statistici.
--sandbox, --no-sandbox	Pornește sau oprește sandbox-ul doar pentru sesiunea curentă.
--screen-reader	Optimizări pentru cititoare de ecran.
--secret-env-vars=VAR ...	Ascunde variabile de mediu din mediile shell și MCP.
--session-id ID	Folosește exact un ID de sesiune sau de task.
--share=PATH	După o sesiune programatică, salvează-o în Markdown.
--share-gist	După o sesiune programatică, salvează-o într-un gist secret.
--stream=MODE	Afișare progresivă a răspunsului: on (implicit) sau off.
--sync-session[=on|off]	Sincronizarea read-only a istoricului sesiunii.
--trust-folder	Încredere în hooks, servere MCP și setările de plugin ale directorului, doar pentru o sesiune neinteractivă nouă.
-v, --version	Afișează versiunea.
-w, --worktree[=NAME]	Creează sau reutilizează un worktree Git izolat și pornește sesiunea în el.
--yolo	Toate permisiunile (echivalent cu --allow-all).

Exemple practice

Exemplul 1: Toate comenzile git, fără git push

Regulile au forma Kind(argument): shell, read, write, url, memory sau numele unui server MCP. Sufixul :* potrivește comanda urmată de spațiu, deci shell(git:*) nu potrivește gitea. Regulile de refuz au mereu prioritate, chiar și cu --allow-all.

copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

Exemplul 2: Plan, apoi autopilot fără aprobarea planului

copilot --plan --mode autopilot

Exemplul 3: Sesiune într-un worktree separat

copilot -w fix-login

Greșeli frecvente și bune practici

• Combini --resume cu --continue sau --connect. Opțiunile de alegere a sesiunii se exclud reciproc.
• Folosești --yolo pe mașina de lucru zilnică. Documentația recomandă opțiunile allow-all doar în medii izolate.
• Pui --plan împreună cu --autopilot. Combinația este refuzată; folosește --plan --mode autopilot.

Comenzi înrudite

• copilot-cli-unificat
• copilot-prompt
• cli-slash-permissions