Как пользоваться GitHub Copilot CLI: руководство

Чтобы пользоваться GitHub Copilot CLI, установите его (npm install -g @github/copilot, Homebrew, WinGet или скрипт установки), запустите copilot в папке проекта, подтвердите, что доверяете папке, войдите командой /login и опишите задачу обычными словами. Copilot читает ваш код, предлагает правки и команды и спрашивает разрешение, прежде чем что-то запустить.

Это основной цикл. В руководстве — всё, что понадобится после первой сессии: какой план нужен, интерактивная и программная работа, права на инструменты, полезные слэш-команды, модели, MCP-серверы и пользовательские инструкции. Всё описанное соответствует официальной документации GitHub на docs.github.com по состоянию на октябрь 2026 года. Если вы ещё выбираете агента, в статье Copilot CLI или Claude Code они сравниваются бок о бок; здесь — практическое руководство.

Что такое Copilot CLI

Copilot CLI — это агент для программирования от GitHub для терминала. Он работает с папкой, из которой вы его запустили: читает и меняет файлы, выполняет команды оболочки и общается с GitHub через встроенный MCP-сервер GitHub, так что может смотреть и issues, и pull requests. Он работает в Linux, macOS и Windows (PowerShell и WSL).

Шаг 1: проверьте свой план

По состоянию на октябрь 2026 года на странице планов GitHub указано, что Copilot CLI входит во все планы Copilot. Использование считается в GitHub AI Credits, а скорость их расхода зависит от модели и объёма работы.

Если Copilot выдан организацией, администратор может отключить CLI, так что проверьте это первым делом, если он не запускается. В статье-сравнении кредиты и цены разобраны подробнее.

Шаг 2: установите Copilot CLI

В Windows нужен PowerShell 6 или новее. Если в настройках npm включён ignore-scripts, ставьте командой npm_config_ignore_scripts=false npm install -g @github/copilot. Команда /update внутри сессии обновляет CLI.

Шаг 3: запустите и войдите

cd ~/code/my-project
copilot

Когда вы впервые запускаете Copilot в папке, он спрашивает, доверяете ли вы её файлам. Можно доверять только в этой сессии, доверять и запомнить выбор или отказаться. Доверенные папки — это места, где Copilot может читать, менять и запускать файлы, поэтому запускайте его в папке проекта, а не в домашней.

Если вы не вошли, введите /login и пройдите вход в браузере. Из обычной оболочки то же делает copilot login, а --device-code подойдёт для машин без браузера. Для автоматизации Copilot читает токен из COPILOT_GITHUB_TOKEN, затем GH_TOKEN, затем GITHUB_TOKEN; fine-grained personal access token должен иметь разрешение «Copilot Requests». /user показывает или переключает аккаунт, а /logout выполняет выход.

Шаг 4: интерактивная работа

Напишите, что нужно:

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

Несколько приёмов ввода:

• @path/to/file добавляет файл в промпт.
• !command выполняет команду оболочки напрямую, не отправляя её модели.
• Shift+Tab переключает режимы. В режиме плана Copilot задаёт уточняющие вопросы и составляет план, прежде чем писать код. /plan делает то же из строки ввода.
• /autopilot даёт Copilot работать самостоятельно до завершения задачи, а /ask (или /btw) позволяет задать побочный вопрос, не сбивая задачу.

Для всего, что затрагивает больше пары файлов, сначала составьте план:

/plan Раздели OrderService на 900 строк на сервисы поменьше. Сохрани
публичный API без изменений и перечисли все файлы, которые затронешь.

Шаг 5: подтверждения и права на инструменты

Когда Copilot хочет запустить инструмент, который может что-то изменить (команду оболочки, запись файла, загрузку URL), он спрашивает. Можно одобрить один раз, одобрить этот инструмент до конца сессии или отказать и объяснить, что сделать вместо этого.

Чтобы решить заранее, используйте шаблоны прав вида Kind(argument):

# git is fine, pushing is not
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

# allow everything except deleting files and pushing
copilot --allow-all-tools --deny-tool='shell(rm)' --deny-tool='shell(git push)'

Запрещающие правила всегда побеждают, даже при --allow-all. Внутри сессии /permissions переключает режимы прав (default, assisted, allow-all), а /permissions show показывает текущий режим; /sandbox enable включает песочницу. --allow-all (алиас --yolo) убирает все запросы, так что оставьте его для одноразовых контейнеров. Почему — объясняет статья о безопасности AI-агентов для программирования.

Шаг 6: программная работа с -p

Для скриптов и CI -p выполняет один промпт и завершает работу. -s выводит только ответ, а поскольку подтверждать некому, инструменты разрешаются заранее:

copilot -p 'Write a commit message in plain text for the staged changes' \
  -s --allow-tool='shell(git:*)'

copilot -p 'Write unit tests for src/utils/validators.ts' \
  --allow-tool='write, shell(npm:*), shell(npx:*)'

Промпт можно и передать через конвейер: echo "Explain this file: ./complex.ts" | copilot. Полезные дополнения: --no-ask-user запрещает Copilot задавать вопросы, --output-format=json выводит строки JSON, а --share=PATH сохраняет сессию в Markdown. В конце запуска Copilot печатает подсказку copilot --resume=SESSION-ID, чтобы можно было продолжить интерактивно.

В GitHub Actions положите токен с разрешением Copilot Requests в COPILOT_GITHUB_TOKEN:

- name: Coverage summary
  env:
    COPILOT_GITHUB_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
  run: copilot -p "Run the test suite and produce a coverage summary" -s --allow-tool='shell(npm:*), write' --no-ask-user

Шаг 7: полезные слэш-команды

Из оболочки copilot --resume (или --continue для последней сессии) продолжает с того места, где вы остановились, а -n NAME даёт сессии имя, чтобы потом продолжить её по имени.

Шаг 8: выберите модель

/model открывает выбор модели; --model=NAME или переменная окружения COPILOT_MODEL задают её при запуске, а auto позволяет Copilot выбрать самому. --effort (или --reasoning-effort) задаёт low, medium, high, xhigh или max для моделей, которые это поддерживают. Разные модели расходуют AI Credits с разной скоростью, а длинный контекст и более высокий уровень рассуждений стоят дороже, так что иногда заглядывайте в /usage.

Можно подключить и собственного провайдера моделей. Задайте COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE (openai, azure или anthropic), COPILOT_PROVIDER_API_KEY и COPILOT_MODEL. Это работает с Ollama для локальных моделей, если модель поддерживает вызов инструментов и потоковую передачу; GitHub рекомендует контекстное окно от 128 тыс. токенов. Подробности — в copilot help providers.

Шаг 9: добавьте MCP-серверы

MCP-сервер GitHub уже настроен. Чтобы добавить другие, используйте CLI или /mcp add в сессии:

# a local server started with a command
copilot mcp add my-server -- npx -y @example/mcp-server

# a remote server over HTTP
copilot mcp add --transport http my-remote https://mcp.example.com/mcp

Серверы хранятся в ~/.copilot/mcp-config.json, а .mcp.json в репозитории добавляет серверы для этого проекта:

{
  "mcpServers": {
    "my-internal-server": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "tools": ["*"]
    }
  }
}

tools определяет, какие инструменты сервера может вызывать Copilot; ["*"] означает все. copilot mcp list показывает настроенные серверы, а --additional-mcp-config добавляет серверы на одну сессию. Впервые слышите о MCP? Начните со статьи что такое MCP-сервер.

Шаг 10: пользовательские инструкции

Copilot CLI объединяет инструкции из нескольких мест:

• AGENTS.md, CLAUDE.md и GEMINI.md в корне репозитория и в текущей папке
• .github/copilot-instructions.md
• .github/instructions/**/*.instructions.md, которые можно ограничить определёнными путями через frontmatter applyTo:
• ~/.copilot/copilot-instructions.md для личных правил во всех проектах

/init (или copilot init) создаёт стартовый .github/copilot-instructions.md на основе вашего репозитория. Держите его коротким: команды сборки и тестов, соглашения и то, чего агенту делать нельзя. Если у вас уже есть AGENTS.md для других агентов, Copilot использует его как есть. В статье CLAUDE.md и AGENTS.md есть советы, как писать правила, которым агенты действительно следуют. Чтобы начать сессию без всех этих файлов, передайте --no-custom-instructions.

Частые ошибки

• Запуск в домашней папке. Доверяйте только папке проекта; доступ Copilot к файлам определяется доверенными папками.
• Слишком широкие права в CI. --allow-all в пайплайне с секретами — прямой путь к проблемам. Разрешайте только нужные задаче инструменты и запрещайте git push, если задача не должна пушить.
• Забытое разрешение токена. Personal access token без «Copilot Requests» не пройдёт аутентификацию, а токены, принадлежащие организации, не поддерживаются.
• Одна бесконечная сессия. Длинные разговоры расходуют больше кредитов. Используйте /compact или /clear между несвязанными задачами.
• MCP-инструменты без tools. Записи сервера нужен список tools; используйте ["*"], чтобы открыть все.

Copilot CLI в AgentVera

AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает CLI-агентов рядом друг с другом в настоящих терминалах, с вашими собственными установками и аккаунтами. Copilot CLI — один из поддерживаемых агентов; подробности — на странице Copilot CLI в AgentVera:

• Ваш вход в GitHub. Copilot использует собственный вход. Если вы вышли, выполните /login в терминале агента; достаточно действующей подписки Copilot.
• Модель и уровень рассуждений для каждого агента. Модель передаётся через --model, а уровень, от minimal до max, — через --reasoning-effort.
• Сессии возвращаются. Каждый агент получает свой ID сессии, и сохранённая сессия после перезапуска открывается с --resume. /compact работает как обычно.
• MCP без правки конфига. Серверы из менеджера MCP AgentVera и её браузер добавляются через --additional-mcp-config при каждом запуске, поэтому ваш mcp-config.json остаётся нетронутым. Роль агента добавляется как дополнительная папка инструкций.
• Панели, worktree и ревью. Запускайте Copilot в сетке Workspace рядом с Claude Code или Aider, давайте каждому агенту свой worktree из панели Git и получайте автоматическое код-ревью в конце каждого хода. Агенты Copilot также работают в потоках (Pro и Team), рассылках и задачах по расписанию.

Сетка, worktree, код-ревью и менеджер MCP доступны на бесплатном плане. Скачайте AgentVera и попробуйте.

Итоги

Установите Copilot CLI, запустите copilot в проекте, отметьте папку как доверенную и войдите через /login. Планируйте крупные изменения через Shift+Tab или /plan, разрешайте только те инструменты, которым доверяете, и используйте copilot -p с явными правилами --allow-tool для скриптов и CI. Правила храните в AGENTS.md или .github/copilot-instructions.md, а MCP-серверы добавляйте, когда они нужны. Если вам нужен ещё и агент, построенный вокруг git и работающий с любой моделью, прочитайте как пользоваться Aider.