Skip to main content

#REF! Copilot Справочник команды CLI

Найдите команды и клавишные комбинации, которые помогут вам эффективно использовать Интерфейс командной строки Copilot.

Команды командной строки

CommandЦель
copilotЗапустите интерактивный пользовательский интерфейс.
copilot help [topic]Покажите справочную информацию. Темы помощи включают: , , , , и .
copilot initИнициализуйте Copilot пользовательские инструкции для этого репозитория.
copilot updateСкачайте и установите последнюю версию.
copilot versionОткажите информацию о версии и проверьте обновления.
copilot loginАутентифицироваться с помощью Copilot через поток устройств OAuth. Принимает указать GitHub хост-адрес (по умолчанию: ).
copilot logoutВыйдите из GitHub и удалите сохранённые учетные данные.
copilot pluginУправляйте плагинами и маркетплейсами плагинов.

Глобальные ярлыки в интерактивном интерфейсе

ShortcutЦель
@ FILENAMEВключите содержимое файла в контекст.
CtrlТогда XПосле того как вы начали вводить подстрымку, это позволяет выполнить команду слэш — например, если вы хотите изменить модель без необходимости переписывать подсказку.
EscОтменить текущую операцию.
! COMMANDВыполните команду в вашей локальной оболочке, обходя Copilot.
CTRLCОтменить операцию / очистить вход. Нажмите дважды, чтобы выйти.
CTRLDОтключение.
CTRLLОчистите экран.
ShiftВкладкаПереключайтесь между стандартным, планным и автопилотным режимами.

Ярлыки временной линии в интерактивном интерфейсе

ShortcutЦель
ctrl+oХотя в вводном запросе ничего нет, это расширяет недавние элементы в таймлайне ответов Copilot, чтобы показать больше деталей.
ctrl+eХотя в вводе запроса нет ничего, это расширяет все элементы в временной шкале ответа Copilot.
ctrl+tРасширить/свернуть отображение рассуждений в ответах.
ShortcutЦель
CTRLAПереместитесь к началу строки (при наборе).
CTRLBПерейти к предыдущему персонажу.
CTRLEПереместитесь в конец строки (при наборе).
CTRLFПерейти к следующему персонажу.
CTRLGОтредактируйте запрос во внешнем редакторе.
CTRLHУдалить предыдущего персонажа.
CtrlКУдалить с курсора до конца строки.
CTRLUУдалить с курсора в начало строки.
CtrlЖУдалить предыдущее слово.
домПереходите к началу текущей линии.
КонецПереместитесь к концу текущей линии.
CtrlДомаПерейдите к началу текста.
CtrlКонецПерейдём к концу текста.
Мета←→Двигайте курсор на слово.
↑↓Просматривайте историю команд.

Команды Slash в интерактивном интерфейсе

CommandЦель
/add-dir PATHДобавьте каталог в разрешённый список для доступа к файлам.
/agentПросматривайте и выбирайте из доступных агентов (если они есть).
,Включите все права (инструменты, пути и URL).
,Очистите историю разговоров.
/compactКратко изложите историю переписки, чтобы уменьшить использование контекстного окна.
/contextПокажите использование токена контекстного окна и визуализацию.
,Измените рабочий каталог или отобразите текущий каталог.
/delegate [PROMPT]Делегировать изменения в удалённый репозиторий с помощью пулл-запроса, сгенерированного ИИ.
/diffПроверьте изменения, внесённые в текущий каталог.
,Выйдите из CLI.
/experimental [on|off]Переключайте или включайте/выключайте экспериментальные функции.
/feedbackДайте обратную связь о CLI.
/fleet [PROMPT]Включить параллельное выполнение субагентов для выполнения частей задачи. См . раздел AUTOTITLE.
/helpПокажите помощь по интерактивным командам.
/ideПодключитесь к рабочему пространству IDE.
/initИнициализировать Copilot пользовательские инструкции и агентные функции для этого репозитория.
/list-dirsОтобразите все каталоги, для которых разрешён доступ к файлам.
/loginВойдите в Copilot.
/logoutВыйти из Copilot.
/lsp [show|test|reload|help] [SERVER-NAME]Управляйте конфигурацией сервера языка.
/mcp [show|add|edit|delete|disable|enable] [SERVER-NAME]Управление конфигурацией сервера MCP.
,Выберите модель ИИ, которую хотите использовать.
/plan [PROMPT]Создайте план реализации перед написанием кода.
/plugin [marketplace|install|uninstall|update|list] [ARGS...]Управляйте плагинами и маркетплейсами плагинов.
/rename NAMEПереименуйте текущую сессию (псевдоним ).
/reset-allowed-toolsСбросьте список разрешённых инструментов.
/resume [SESSION-ID]Переключитесь на другую сессию, выбрав из списка (по желанию укажите идентификатор сессии).
/review [PROMPT]Запустите агент проверки кода для анализа изменений.
/session [checkpoints [n]|files|plan|rename NAME]Покажите информацию о сессии и резюме рабочего пространства. Используйте подкоманды для подробностей.
/share [file|gist] [PATH]Поделитесь сессией в файл Markdown или #REF! gist.
/skills [list|info|add|remove|reload] [ARGS...]Управляйте навыками для расширения возможностей.
/terminal-setupНастройте терминал для поддержки многолинейного входа (ShiftEnter и CtrlEnter).
/theme [show|set|list] [auto|THEME-ID]Просмотрите или настройте тему терминала.
/usageОтображайте метрики и статистику использования сессий.
/user [show|list|switch]Управлять текущим GitHub пользователем.

Для полного списка доступных команд слэш введите в интерактивный интерфейс CLI.

Параметры командной строки

ВариантЦель
--acpЗапустите сервер протокола Agent Client.
--add-dir PATHДобавьте каталог в разрешённый список для доступа к файлам (можно использовать несколько раз).
--add-github-mcp-tool TOOLДобавьте инструмент для активации сервера GitHub вместо стандартного подмножества CLI (можно использовать несколько раз). Используйте для всех инструментов.
--add-github-mcp-toolset TOOLSETДобавьте набор инструментов для MCP-сервера GitHub вместо стандартного подмножества CLI (можно использовать несколько раз). Используйте для всех наборов инструментов.
--additional-mcp-config JSONДобавьте MCP-сервер только для этой сессии. Конфигурация сервера может быть предоставлена в виде JSON-строки или пути к файлу (префикс ). Дополняет конфигурацию из . Переопределяет любую установленную конфигурацию сервера MCP с таким же именем.
--agent AGENTУкажите Пользовательский агент для использования.
--allow-allВключить все права (эквивалент ).
--allow-all-pathsОтключите верификацию пути файла и разрешите доступ к любому пути.
--allow-all-toolsРазрешить всем инструментам работать автоматически без подтверждения. Требуется при программном использовании CLI (env: ).
--allow-all-urlsРазрешите доступ ко всем URL без подтверждения.
--allow-tool [TOOLS...]Инструменты, которые CLI имеет разрешение использовать. Не буду запрашивать разрешение.
--allow-url [URLS...]Разрешите доступ к определённым URL или доменам.
--alt-screen [VALUE]Используйте альтернативный буфер экрана терминала ( или ).
--autopilotВключите автопилот в режиме подсказок. См . раздел AUTOTITLE.
--available-tools [TOOLS...]Модели будут доступны только эти инструменты.
--bannerПокажите баннер стартапа.
--bash-env [VALUE]Включите поддержку bash-shells ( или ).
--config-dir PATHУстановите каталог конфигурации (по умолчанию: ).
--continueВозобновите последнюю сессию.
--deny-tool [TOOLS...]Инструменты, на которые CLI не имеет разрешения. Не буду запрашивать разрешение.
--deny-url [URLS...]Отказ в доступе к определённым URL или доменам имеет приоритет над .
--disable-builtin-mcpsОтключите все встроенные MCP-серверы (на данный момент: ).
--disable-mcp-server SERVER-NAMEОтключите конкретный MCP-сервер (его можно использовать несколько раз).
--disable-parallel-tools-executionОтключите параллельное выполнение инструментов (LLM всё ещё может выполнять параллельные вызовы инструментов, но они будут выполняться последовательно).
--disallow-temp-dirПредотвратить автоматический доступ к временному каталогу системы.
--enable-all-github-mcp-toolsВключите все инструменты GitHub MCP-серверы вместо стандартного подмножества CLI. Переопределяет и опции.
--excluded-tools [TOOLS...]Эти инструменты не будут доступны для модели.
--experimentalВключите экспериментальные функции (используйте для отключения).
,Помощь с отображением.
,Начните интерактивную сессию и автоматически выполните этот запрос.
--log-dir DIRECTORYУстановите каталог файлов журналов (по умолчанию: ).
--log-level LEVELУстановите уровень логарифма (выборы: , , , , , , ).
--max-autopilot-continues COUNTМаксимальное количество сообщений продолжения в режиме автопилота (по умолчанию: неограниченно). См . раздел AUTOTITLE.
--model MODELЗадайте модель ИИ, которую хотите использовать.
--no-alt-screenОтключите буфер альтернативного экрана терминала.
--no-ask-userОтключите инструмент (агент работает автономно, не задавая вопросов).
--no-auto-updateОтключите автоматическую загрузку обновлений CLI.
--no-bash-envОтключите поддержку bash-shells.
--no-colorОтключите все цветовые выводы.
--no-custom-instructionsОтключите загрузку пользовательских инструкций из и связанных файлов.
--no-experimentalОтключите экспериментальные функции.
,Выполните запрос программно (выходит после завершения).
--plain-diffОтключите рендеринг rich diff (выделение синтаксиса через инструмент diff, указанный в конфигурации git).
--resume [SESSION-ID]Возобновите предыдущую интерактивную сессию, выбрав из списка (по желанию укажите идентификатор сессии).
,Выводите только ответ агента (без статистики использования), что полезно для скриптов с .
--screen-readerВключите оптимизацию экранных читателей.
--share [PATH]Поделитесь сессией с файлом Markdown после завершения программной сессии (по умолчанию путь: ).
--share-gistПоделитесь сессией с секретным GitHub gist после завершения программной сессии.
--stream MODEВключите или отключите режим стриминга (выбор режима: или ).
,Покажите информацию о версии.
--yoloВключить все права (эквивалент ).

Для полного списка команд и опций запустите .

Шаблоны разрешений инструментов

Опции и принимают шаблоны разрешений в формате . Аргумент необязательн — его исключение соответствует всем подобным инструментам.

KindDescriptionПримеры паттернов
shellВыполнение команд shell, ,
writeСоздание или модификация файлов,
readЧтение файлов или каталогов,
SERVER-NAMEВызов инструмента MCP-сервера,
urlДоступ к URL через web-fetch или shell,
memoryХранение фактов в памяти агентаmemory

Для правил суффикс совпадает с командным стволом, за которым следует пробел, предотвращая частичные совпадения. Например, совпадение и но не совпадает с .

Правила отказа всегда имеют приоритет над правилами допуска, даже если они установлены.

# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deny-tool 'shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool 'MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool 'MyMCP'

Переменные среды

VariableDescription
COPILOT_MODELЗадайте модель ИИ.
COPILOT_ALLOW_ALLУстановите на автоматическое разрешение всех разрешений (эквивалентно ).
COPILOT_AUTO_UPDATEНастройте на отключение автоматических обновлений.
COPILOT_CUSTOM_INSTRUCTIONS_DIRSСписок дополнительных каталогов для пользовательских инструкций, разделённых запятой.
COPILOT_SKILLS_DIRSСписок дополнительных каталогов с разделёнными запятой для навыков.
COPILOT_EDITORКоманда редактора для интерактивного редактирования (проверено после и ). По умолчанию — если ничего не установлено.
COPILOT_GITHUB_TOKENМаркер проверки подлинности. Имеет приоритет над и .
GH_TOKENМаркер проверки подлинности. Имеет приоритет над .
GITHUB_TOKENМаркер проверки подлинности.
XDG_CONFIG_HOMEПереопределите каталог конфигурации. По умолчанию: .
XDG_STATE_HOMEОтменить справочник штата. По умолчанию: .
USE_BUILTIN_RIPGREPНастройте на использование системного ripgrep вместо комплектной версии.
PLAIN_DIFFНастройте на отключение рендеринга rich diff.
COLORFGBGЗапасной вариант для обнаружения фона на тёмных/светлых терминалах.
COPILOT_CLI_ENABLED_FEATURE_FLAGSСписок флагов признаков с разделёнными запятой для включения (например, ).

Настройки конфигурационных файлов

Пользовательские настройки хранятся в . Настройки на уровне проекта могут быть размещены в (закреплены в репозитории) или (личные перенастройки — добавить в ). Настройки каскадно переходят от пользователя к проекту и к локальному, при этом более конкретные сферы объёма переключаются на более общие. Флаги командной строки и переменные среды всегда имеют наибольшее значение.

КлючТипПо умолчаниюDescription
allowed_urlsstring[][]URL или домены разрешены без подсказки.
alt_screenbooleanfalseИспользуйте буфер альтернативного экрана терминала.
auto_updatebooleantrueАвтоматически скачивайте обновления CLI.
banner"always" | "once" | "never""once"Частота анимированного отображения баннеров.
bash_envbooleanfalseВключите поддержку bash-shells.
beepbooleantrueВоспроизведите звуковой сигнал, когда требуется внимание.
compact_pastebooleantrueСверните большие пасты в компактные токены.
custom_agents.default_local_onlybooleanfalseИспользуйте только местных кастомных агентов.
denied_urlsstring[][]URL или домены, заблокированные (имеют приоритет над ).
experimentalbooleanfalseВключить экспериментальные функции.
include_coauthorbooleantrueДобавьте трейлер к git-коммитам, сделанным агентом.
launch_messagesstring[][]Пользовательские сообщения отображаются случайным образом при запуске.
log_level"none" | "error" | "warning" | "info" | "debug" | "all" | "default""default"Веду многословность.
modelstringvariesМодель ИИ для использования (см. команду).
reasoning_effort"low" | "medium" | "high" | "xhigh""medium"Уровень усилий для рассуждения для расширенного мышления. Более высокие уровни требуют больше вычислений.
render_markdownbooleantrueRender Markdown на выходе терминала.
screen_readerbooleanfalseВключите оптимизацию экранных читателей.
streambooleantrueВключите потоковые ответы.
store_token_plaintextbooleanfalseСохраняйте токены аутентификации в открытом тексте в конфигурационном файле, когда системный ключ недоступен.
streamer_modebooleanfalseСкрыть имена моделей и детали квот (полезно при записи).
theme"auto" | "dark" | "light""auto"Терминальная цветовая тема.
trusted_foldersstring[][]Папки с предварительно предоставленным доступом к файлам.
update_terminal_titlebooleantrueПокажите текущее намерение в названии терминала.

Ссылка на Hooks

Хуки — это внешние команды, которые выполняются в определённых жизненных точках сессии, обеспечивая индивидуальную автоматизацию, управление безопасностью и интеграции. Файлы конфигурации крюков загружаются автоматически из вашего репозитория.

Формат конфигурации крючка

Конфигурационные файлы крючков используют формат JSON с версией :

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}
ПолеТипОбязательноDescription
type"command"ДаЭтот параметр должен содержать значение .
bashструнаОдин изКоманда shell для Unix.
powershellструнаОдин изКоманда shell для #REF!.
cwdструнанетРабочая папка для команды (относительно корня репозитория или абсолюта).
envобъектнетПеременные среды для установки (поддерживает расширение переменных).
timeoutSecчисло/номернетВремя ожидания в секундах. По умолчанию: .

События с крючками

EventПожары, когдаОбработка выхода
sessionStartНачинается новая или возобновлённая сессия.нет
sessionEndСессия заканчивается.нет
userPromptSubmittedПользователь отправляет запрос.нет
preToolUseПеред тем, как каждый инструмент сработает.Да — можно разрешать, отрицать или изменять.
postToolUseПосле завершения каждого инструмента.нет
agentStopГлавный агент завершает ход.Да — может блокировать и заставлять продолжение.
subagentStopСубагент завершает.Да — может блокировать и заставлять продолжение.
errorOccurredОшибка возникает во время выполнения.нет

Контроль принятия решений

Крюк может управлять выполнением инструмента, записывая JSON-объект в stdout.

ПолеЦенностиDescription
permissionDecision, ,Работает ли инструмент. Пустой выход использует стандартное поведение.
permissionDecisionReasonструнаАгенту показали разум. Требуется при принятии решения .
modifiedArgsобъектЗамените аргументы инструментов вместо оригиналов.

Контроль принятия решений

ПолеЦенностиDescription
decision,заставляет другого агента поступить, используя это как подсказку.
reasonструнаПодсказка для следующего хода, когда .

Имена инструментов для подбора крючков

Имя инструментаDescription
bashВыполнять команды оболочки (Unix).
powershellВыполнять команды shell (#REF!).
viewЧтение содержимого файла.
editИзменять содержимое файла.
createСоздавайте новые файлы.
globИщите файлы по шаблону.
grepПоиск по содержимому файла.
web_fetchЗагружайте веб-страницы.
taskЗапускайте задачи субагентов.

Если настраивать несколько хуков одного типа, они выполняются по порядку. Для , если какой-либо крюк возвращается , инструмент блокируется. Сбои с крючками (ненулевые коды выхода или тайм-ауты) фиксируются и пропускаются — они никогда не блокируют выполнение агентов.

Конфигурация сервера MCP

MCP-серверы предоставляют дополнительные инструменты агенту CLI. Настройте постоянные серверы в . Используйте для добавления серверов на одну сессию.

Типы транспорта

ТипDescriptionОбязательные поля
local / stdioЛокальный процесс связывается через stdin/stdout.,
httpУдалённый сервер с использованием потокового HTTP-транспорта.url
sseУдалённый сервер с использованием Server-Sent Events Transport.url

Поля конфигурации локального сервера

ПолеОбязательноDescription
commandДаКоманда запускать сервер.
argsДаАргументы команд (массивы).
toolsДаИнструменты для включения: для всех, или список конкретных названий инструментов.
envнетпеременные среды Поддержка , , и расширение.
cwdнетРабочая директория сервера.
timeoutнетТайм-аут вызова инструментов — в миллисекундах.
typeнетили . По умолчанию: .

Поля конфигурации удалённых серверов

ПолеОбязательноDescription
typeДаили .
urlДаURL сервера.
toolsДаИнструменты для включения.
headersнетHTTP-заголовки. Поддерживает переменное расширение.
oauthClientIdнетСтатический идентификатор клиента OAuth (пропускает динамическую регистрацию).
oauthPublicClientнетЯвляется ли клиент OAuth публичным. По умолчанию: .
timeoutнетТайм-аут вызова инструментов — в миллисекундах.

Фильтровое отображение

Контролировать, как обрабатывается вывод инструмента MCP с помощью поля в конфигурации сервера.

РежимDescription
noneБез фильтрации.
markdownФорматируйте выход как Markdown.
hidden_charactersУдалите скрытые или управляющие символы. Default.

Встроенные MCP-серверы

CLI включает встроенные MCP-серверы, доступные без дополнительной настройки.

СерверDescription
github-mcp-serverGitHub Интеграция API: проблемы, pull requests, коммиты, поиск по коду и GitHub Actions.
playwrightАвтоматизация браузера: навигация, клик, ввод, скриншот и обработка форм.
fetchHTTP-запросы через инструмент .
timeВременные утилисы: и .

Используйте для отключения всех встроенных серверов или для отключения конкретного сервера.

Справочник по навыкам

Навыки — это файлы Markdown, которые расширяют возможности CLI. Каждый навык находится в отдельном каталоге с файлом. При вызове (через агента или автоматически) содержание навыка вводится в разговор.

Фронтматические поля навыков

ПолеТипОбязательноDescription
nameструнаДаУникальный идентификатор навыка. Только буквы, цифры и дефисы. Максимум 64 символов.
descriptionструнаДаЧто делает навык и когда его использовать. Максимум 1024 символов.
allowed-toolsstring или string[]нетСписок инструментов с разделёнными запятыми или YAML-массив инструментов, которые автоматически разрешены, когда навык активен. Используйте для всех инструментов.
user-invocableбулевыйнетМогут ли пользователи вызвать навык с помощью . По умолчанию: .
disable-model-invocationбулевыйнетПомешайте агенту автоматически вызвать этот навык. По умолчанию: .

Места навыков

Навыки загружаются из этих мест в порядке приоритета (первым найденным выигрывает дублирующиеся имена).

МестоположениеОбласть действияDescription
.github/skills/ПроектНавыки, специфичные для проекта.
.agents/skills/ПроектАльтернативное местоположение проекта.
.claude/skills/ПроектМесто, совместимое с Claude.
РодительInheritedПоддержка родительского каталога Monorepo.
~/.copilot/skills/ПерсональныйЛичные навыки для всех проектов.
~/.claude/skills/ПерсональныйЛичное местоположение, совместимое с Клод.
Каталоги плагиновПлагинНавыки из установленных плагинов.
COPILOT_SKILLS_DIRSCustomДополнительные каталоги (разделены запятой).

Команды (альтернативный формат навыка)

Команды являются альтернативой навыкам, хранящимся в отдельных файлах в . Имя команды происходит от имени файла. Командные файлы используют упрощённый формат (поле не требуется) и поддерживают , , и . Команды имеют меньший приоритет, чем умения с таким же названием.

Ссылка на таможенных агентов

Пользовательские агенты — это специализированные AI-агенты, определённые в файлах Markdown. Имя файла (без расширения) становится идентификатором агента. Используйте или как расширение файла.

Встроенные агенты

АгентМодель по умолчаниюDescription
code-reviewКлод-сонет-4.5Высокий анализ кодов по соотношению сигнал/шум. Анализирует различия на наличие ошибок, проблем с безопасностью и логических ошибок.
exploreКлод-хайку-4.5Быстрое исследование кодовой базы. Ищет файлы, читает код и отвечает на вопросы. Возвращает сфокусированные ответы менее 300 слов. Безопасно запускать параллельно.
general-purposeКлод-сонет-4.5Полноценный агент для сложных многоступенчатых задач. Работает в отдельном контекстном окне.
researchКлод-сонет-4.6Агент глубоких исследований. Генерирует отчёт на основе информации из вашей кодовой базы, в соответствующих репозиториях и в интернете.
taskКлод-хайку-4.5Выполнение команд (тесты, сборки, ворсы). Возвращает краткое резюме по успеху, полный результат по неудачам.

Фронтматэрные поля пользовательского агента

ПолеТипОбязательноDescription
descriptionструнаДаОписание указано в списке агентов и инструменте.
inferбулевыйнетРазрешить автоматическую делегацию основным агентом. По умолчанию: .
mcp-serversобъектнетMCP-серверы для подключения. Использует ту же схему, что и .
modelструнанетМодель ИИ для этого агента. Когда не установлено, наследует модель внешнего агента.
nameструнанетОтображаемое имя. По умолчанию используется имя файла.
toolsстрока[]нетИнструменты, доступные агенту. По умолчанию: (все инструменты).

Местоположение кастомных агентов

Область действияМестоположение
Проектили
Пользовательили
Плагин<plugin>/agents/

Агенты на уровне проекта имеют приоритет над агентами пользовательского уровня. Агенты плагинов имеют самый низкий приоритет.

Ответы на одобрение разрешений

Когда CLI запросит разрешение на выполнение операции, вы можете ответить следующими клавишами.

КлючЭффект
yРазрешите этот конкретный запрос один раз.
nОткажитесь в этой конкретной просьбе один раз.
!Разрешите все похожие запросы до конца сессии.
#Отклоняйте все подобные запросы до конца сессии.
?Покажите подробную информацию о запросе.

Одобрения сессий сбрасываются, когда вы запускаете или начинаете новую сессию.

FlagТирDescription
AUTOPILOT_MODEexperimentalРежим автономной работы.
BACKGROUND_AGENTSstaffЗапускайте агентов на заднем плане.
QUEUED_COMMANDSstaffКоманды очереди во время работы агента.
LSP_TOOLSonИнструменты протокола Language Server.
PLAN_COMMANDonИнтерактивный режим планирования.
AGENTIC_MEMORYonПостоянная память между сессиями.
CUSTOM_AGENTSonИндивидуальные определения агентов.