Справочник команды Copilot Copilot CLI на GitHub

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

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

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

Shortcut	Цель
`@ FILENAME`	Включите содержимое файла в контекст.

          <kbd>Ctrl</kbd>+<kbd>Тогда X</kbd>`/`  | После того как вы начали вводить подстрымку, это позволяет выполнить команду слэш — например, если вы хотите изменить модель без необходимости переписывать подсказку. |

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

Shortcut	Цель
ctrl+o	Хотя в вводном запросе ничего нет, это расширяет недавние элементы в таймлайне ответов Copilot, чтобы показать больше деталей.
ctrl+e	Хотя в вводе запроса нет ничего, это расширяет все элементы в временной шкале ответа Copilot.
ctrl+t	Расширить/свернуть отображение рассуждений в ответах.

Shortcut	Цель

          <kbd>CTRL</kbd>+<kbd>A</kbd>        | Переместитесь к началу строки (при наборе). |

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

Command	Цель
`/add-dir PATH`	Добавьте каталог в разрешённый список для доступа к файлам.
`/agent`	Просматривайте и выбирайте из доступных агентов (если они есть).

          `/allow-all`, `/yolo`                               | Включите все права (инструменты, пути и URL). |

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

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

Вариант	Цель
`--acp`	Запустите сервер протокола Agent Client.
`--add-dir PATH`	Добавьте каталог в разрешённый список для доступа к файлам (можно использовать несколько раз).
`--add-github-mcp-tool TOOL`	Добавьте инструмент для активации сервера GitHub вместо стандартного подмножества CLI (можно использовать несколько раз). Используйте `*` для всех инструментов.
`--add-github-mcp-toolset TOOLSET`	Добавьте набор инструментов для MCP-сервера GitHub вместо стандартного подмножества CLI (можно использовать несколько раз). Используйте `all` для всех наборов инструментов.
`--additional-mcp-config JSON`	Добавьте MCP-сервер только для этой сессии. Конфигурация сервера может быть предоставлена в виде JSON-строки или пути к файлу (префикс ).`@` Дополняет конфигурацию из `~/.copilot/mcp-config.json`. Переопределяет любую установленную конфигурацию сервера MCP с таким же именем.
`--agent AGENT`	Укажите Пользовательский агент для использования.
`--allow-all`	Включить все права (эквивалент `--allow-all-tools --allow-all-paths --allow-all-urls`).
`--allow-all-paths`	Отключите верификацию пути файла и разрешите доступ к любому пути.
`--allow-all-tools`	Разрешить всем инструментам работать автоматически без подтверждения. Требуется при программном использовании CLI (env: `COPILOT_ALLOW_ALL`).
`--allow-all-urls`	Разрешите доступ ко всем URL без подтверждения.
`--allow-tool [TOOLS...]`	Инструменты, которые CLI имеет разрешение использовать. Не буду запрашивать разрешение.
`--allow-url [URLS...]`	Разрешите доступ к определённым URL или доменам.
`--alt-screen [VALUE]`	Используйте альтернативный буфер экрана терминала (`on` или `off`).
`--autopilot`	Включите автопилот в режиме подсказок. См . раздел AUTOTITLE.
`--available-tools [TOOLS...]`	Модели будут доступны только эти инструменты.
`--banner`	Покажите баннер стартапа.
`--bash-env [VALUE]`	Включите `BASH_ENV` поддержку bash-shells (`on` или `off`).
`--config-dir PATH`	Установите каталог конфигурации (по умолчанию: `~/.copilot`).
`--continue`	Возобновите последнюю сессию.
`--deny-tool [TOOLS...]`	Инструменты, на которые CLI не имеет разрешения. Не буду запрашивать разрешение.
`--deny-url [URLS...]`	Отказ в доступе к определённым URL или доменам имеет приоритет над `--allow-url`.
`--disable-builtin-mcps`	Отключите все встроенные MCP-серверы (на данный момент: `github-mcp-server`).
`--disable-mcp-server SERVER-NAME`	Отключите конкретный MCP-сервер (его можно использовать несколько раз).
`--disable-parallel-tools-execution`	Отключите параллельное выполнение инструментов (LLM всё ещё может выполнять параллельные вызовы инструментов, но они будут выполняться последовательно).
`--disallow-temp-dir`	Предотвратить автоматический доступ к временному каталогу системы.
`--enable-all-github-mcp-tools`	Включите все инструменты GitHub MCP-серверы вместо стандартного подмножества CLI. Переопределяет и --add-github-mcp-toolset``--add-github-mcp-tool опции.
`--excluded-tools [TOOLS...]`	Эти инструменты не будут доступны для модели.
`--experimental`	Включите экспериментальные функции (используйте `--no-experimental` для отключения).

          `-h`, `--help`                     | Помощь с отображением. |

| -i PROMPT, --interactive PROMPT | Начните интерактивную сессию и автоматически выполните этот запрос. | | --log-dir DIRECTORY | Установите каталог файлов журналов (по умолчанию: ~/.copilot/logs/). | | --log-level LEVEL | Установите уровень логарифма (выборы: none, error, warning, info, debug, all, ). default | | --max-autopilot-continues COUNT | Максимальное количество сообщений продолжения в режиме автопилота (по умолчанию: неограниченно). См . раздел AUTOTITLE. | | --model MODEL | Задайте модель ИИ, которую хотите использовать. | | --no-alt-screen | Отключите буфер альтернативного экрана терминала. | | --no-ask-user | Отключите ask_user инструмент (агент работает автономно, не задавая вопросов). | | --no-auto-update | Отключите автоматическую загрузку обновлений CLI. | | --no-bash-env | Отключите BASH_ENV поддержку bash-shells. | | --no-color | Отключите все цветовые выводы. | | --no-custom-instructions | Отключите загрузку пользовательских инструкций из AGENTS.md и связанных файлов. | | --no-experimental | Отключите экспериментальные функции. | | -p PROMPT, --prompt PROMPT | Выполните запрос программно (выходит после завершения). | | --plain-diff | Отключите рендеринг rich diff (выделение синтаксиса через инструмент diff, указанный в конфигурации git). | | --resume [SESSION-ID] | Возобновите предыдущую интерактивную сессию, выбрав из списка (по желанию укажите идентификатор сессии). | | -s, --silent | Выводите только ответ агента (без статистики использования), что полезно для скриптов с -p. | | --screen-reader | Включите оптимизацию экранных читателей. | | --share [PATH] | Поделитесь сессией с файлом Markdown после завершения программной сессии (по умолчанию путь: ./copilot-session-<ID>.md). | | --share-gist | Поделитесь сессией с секретным GitHub gist после завершения программной сессии. | | --stream MODE | Включите или отключите режим стриминга (выбор режима: on или off). | | -v, --version | Покажите информацию о версии. | | --yolo | Включить все права (эквивалент --allow-all). |

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

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

Опции и --deny-tool принимают --allow-tool шаблоны разрешений в формате Kind(argument). Аргумент необязательн — его исключение соответствует всем подобным инструментам.

Kind	Description	Примеры паттернов
`shell`	Выполнение команд shell

          `shell(git push)`, , `shell(git:*)``shell` |

| write | Создание или модификация файлов | write, write(src/*.ts) | | read | Чтение файлов или каталогов | read, read(.env) | | SERVER-NAME | Вызов инструмента MCP-сервера | MyMCP(create_issue), MyMCP | | url | Доступ к URL через web-fetch или shell | url(github.com), url(https://*.api.com) | | memory | Хранение фактов в памяти агента | memory |

Для shell правил суффикс :* совпадает с командным стволом, за которым следует пробел, предотвращая частичные совпадения. Например, shell(git:*) совпадение git push и git pull но не совпадает giteaс .

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

# 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'

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

Variable	Description
`COPILOT_MODEL`	Задайте модель ИИ.
`COPILOT_ALLOW_ALL`	Установите на `true` автоматическое разрешение всех разрешений (эквивалентно `--allow-all`).
`COPILOT_AUTO_UPDATE`	Настройте на `false` отключение автоматических обновлений.
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	Список дополнительных каталогов для пользовательских инструкций, разделённых запятой.
`COPILOT_SKILLS_DIRS`	Список дополнительных каталогов с разделёнными запятой для навыков.
`COPILOT_EDITOR`	Команда редактора для интерактивного редактирования (проверено после `$VISUAL` и `$EDITOR`). По умолчанию `vi` — если ничего не установлено.
`COPILOT_GITHUB_TOKEN`	Маркер проверки подлинности. Имеет приоритет над `GH_TOKEN` и `GITHUB_TOKEN`.
`GH_TOKEN`	Маркер проверки подлинности. Имеет приоритет над `GITHUB_TOKEN`.
`GITHUB_TOKEN`	Маркер проверки подлинности.
`XDG_CONFIG_HOME`	Переопределите каталог конфигурации. По умолчанию: `$HOME/.copilot`.
`XDG_STATE_HOME`	Отменить справочник штата. По умолчанию: `$HOME/.copilot`.
`USE_BUILTIN_RIPGREP`	Настройте на `false` использование системного ripgrep вместо комплектной версии.
`PLAIN_DIFF`	Настройте на `true` отключение рендеринга rich diff.
`COLORFGBG`	Запасной вариант для обнаружения фона на тёмных/светлых терминалах.
`COPILOT_CLI_ENABLED_FEATURE_FLAGS`	Список флагов признаков с разделёнными запятой для включения (например, `"SOME_FEATURE,SOME_OTHER_FEATURE"`).

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

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

Ключ	Тип	По умолчанию	Description
`allowed_urls`	`string[]`	`[]`	URL или домены разрешены без подсказки.
`alt_screen`	`boolean`	`false`	Используйте буфер альтернативного экрана терминала.
`auto_update`	`boolean`	`true`	Автоматически скачивайте обновления CLI.
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | Частота анимированного отображения баннеров. |

Ссылка на Hooks

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

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

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

{
  "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"`	Да	Этот параметр должен содержать значение `"command"`.
`bash`	струна	Один из `bash`/`powershell`	Команда shell для Unix.
`powershell`	струна	Один из `bash`/`powershell`	Команда shell для Windows.
`cwd`	струна	нет	Рабочая папка для команды (относительно корня репозитория или абсолюта).
`env`	объект	нет	Переменные среды для установки (поддерживает расширение переменных).
`timeoutSec`	число/номер	нет	Время ожидания в секундах. По умолчанию: `30`.

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

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

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

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

Поле	Ценности	Description
`permissionDecision`

          `"allow"`, , `"deny"``"ask"` | Работает ли инструмент. Пустой выход использует стандартное поведение. |

          `agentStop`
           / 
          `subagentStop` Контроль принятия решений

Поле	Ценности	Description
`decision`

          `"block"`, `"allow"` | 
          `"block"` заставляет другого агента поступить, используя `reason` это как подсказку. |

| reason | струна | Подсказка для следующего хода, когда decision ."block" |

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

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

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

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

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

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

Тип	Description	Обязательные поля
`local` / `stdio`	Локальный процесс связывается через stdin/stdout.

          `command`, `args` |

| http | Удалённый сервер с использованием потокового HTTP-транспорта. | url | | sse | Удалённый сервер с использованием Server-Sent Events Transport. | url |

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

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

          `"local"` или `"stdio"`. По умолчанию: `"local"`. |

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

Поле	Обязательно	Description
`type`	Да

          `"http"` или `"sse"`. |

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

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

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

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

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

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

Используйте --disable-builtin-mcps для отключения всех встроенных серверов или --disable-mcp-server SERVER-NAME для отключения конкретного сервера.

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

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

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

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

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

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

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

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

Команды являются альтернативой навыкам, хранящимся в отдельных .md файлах в .claude/commands/. Имя команды происходит от имени файла. Командные файлы используют упрощённый формат (поле не name требуется) и поддерживают description, allowed-tools, и disable-model-invocation. Команды имеют меньший приоритет, чем умения с таким же названием.

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

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

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

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

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

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

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

Область действия	Местоположение
Проект

          `.github/agents/` или `.claude/agents/` |

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

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

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

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

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

Flag	Тир	Description
`AUTOPILOT_MODE`	`experimental`	Режим автономной работы.
`BACKGROUND_AGENTS`	`staff`	Запускайте агентов на заднем плане.
`QUEUED_COMMANDS`	`staff`	Команды очереди во время работы агента.
`LSP_TOOLS`	`on`	Инструменты протокола Language Server.
`PLAN_COMMAND`	`on`	Интерактивный режим планирования.
`AGENTIC_MEMORY`	`on`	Постоянная память между сессиями.
`CUSTOM_AGENTS`	`on`	Индивидуальные определения агентов.