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

URL: https://agentvera.dev/ru/blog/how-to-use-copilot-cli/ · Опубликовано: 2026-10-27

Как пользоваться GitHub Copilot CLI: установка, вход, выбор плана, интерактивный режим и -p, права на инструменты, модели, MCP-серверы и инструкции проекта.

**Коротко:**

- Установите Copilot CLI через npm, Homebrew, WinGet или скрипт установки, запустите copilot в папке проекта, отметьте папку как доверенную и войдите командой /login.
- Copilot спрашивает разрешение перед запуском инструментов; шаблоны --allow-tool и --deny-tool вроде shell(git:*) задают права, а copilot -p выполняет один промпт для скриптов и CI.
- /model переключает модели, copilot mcp add подключает MCP-серверы, а AGENTS.md или .github/copilot-instructions.md хранят правила проекта.

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

Это основной цикл. В руководстве — всё, что понадобится после первой сессии: какой план нужен, интерактивная и программная работа, права на инструменты, полезные слэш-команды, модели, MCP-серверы и пользовательские инструкции. Всё описанное соответствует официальной документации GitHub на docs.github.com по состоянию на октябрь 2026 года. Если вы ещё выбираете агента, в статье [Copilot CLI или Claude Code](/ru/blog/copilot-cli-vs-claude-code/ "Copilot CLI или Claude Code") они сравниваются бок о бок; здесь — практическое руководство.

## Что такое Copilot CLI

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

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

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

| План | Цена | Примечание |
| --- | --- | --- |
| Copilot Free | Бесплатно | Ограниченный объём AI Credits |
| Copilot Student | Бесплатно | Для подтверждённых студентов |
| Copilot Pro | $10 в месяц | Больше кредитов |
| Copilot Pro+ | $39 в месяц | Больше кредитов |
| Copilot Max | $100 в месяц | Самый большой личный объём |
| Business / Enterprise | $19 / $39 за место | Управляется организацией |

Если Copilot выдан организацией, администратор может отключить CLI, так что проверьте это первым делом, если он не запускается. В [статье-сравнении](/ru/blog/copilot-cli-vs-claude-code/ "Copilot CLI или Claude Code") кредиты и цены разобраны подробнее.

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

| Способ | Команда |
| --- | --- |
| npm (Node.js 22 или новее) | `npm install -g @github/copilot` |
| Homebrew (macOS, Linux) | `brew install --cask copilot-cli` |
| WinGet (Windows) | `winget install GitHub.Copilot` |
| Скрипт установки (macOS, Linux) | `curl -fsSL https://gh.io/copilot-install \| bash` |

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

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

```bash
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: интерактивная работа

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

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

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

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

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

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

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

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

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

| Шаблон | Что разрешает |
| --- | --- |
| `shell(git:*)` | Любую команду `git` (`git status`, `git log`…) |
| `shell(git push)` | Только `git push` |
| `write` или `write(src/*.ts)` | Запись файлов, при желании только по пути |
| `read(.env)` | Чтение конкретного файла |
| `url(github.com)` | Загрузку с домена |
| `MyMCP(create_issue)` | Один инструмент MCP-сервера |

```bash
# 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-агентов для программирования](/ru/blog/ai-coding-agent-security/ "Безопасность AI-агентов для программирования").

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

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

```bash
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`:

```yaml
- 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: полезные слэш-команды

| Команда | Что делает |
| --- | --- |
| `/model` | Выбор модели или `auto` |
| `/plan`, `/autopilot` | Сначала план или работа до завершения |
| `/review` | Ревью текущих изменений |
| `/diff` | Показать, что изменилось |
| `/undo` (`/rewind`) | Откат к более ранней точке |
| `/compact` | Сжать разговор, чтобы освободить контекст |
| `/context`, `/usage` | Использование контекста и кредитов |
| `/clear` (`/new`) | Начать новый разговор |
| `/resume` | Продолжить прошлую сессию |
| `/pr` | Посмотреть, создать или исправить pull request |
| `/delegate` | Передать задачу Copilot на GitHub, который откроет pull request |
| `/mcp` | Просмотр, добавление и управление MCP-серверами |
| `/init` | Создать файл пользовательских инструкций |
| `/permissions` | Изменить правила подтверждений |

Из оболочки `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` в сессии:

```bash
# 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` в репозитории добавляет серверы для этого проекта:

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

`tools` определяет, какие инструменты сервера может вызывать Copilot; `["*"]` означает все. `copilot mcp list` показывает настроенные серверы, а `--additional-mcp-config` добавляет серверы на одну сессию. Впервые слышите о MCP? Начните со статьи [что такое MCP-сервер](/ru/blog/what-is-mcp-server/ "Что такое 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](/ru/blog/claude-md-agents-md/ "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](/ru/agents/copilot-cli/ "Copilot CLI в AgentVera"):

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

Сетка, worktree, код-ревью и менеджер MCP доступны на бесплатном плане. [Скачайте AgentVera](/ru/download/ "Скачать AgentVera") и попробуйте.

## Итоги

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

## Частые вопросы

**Нужен ли платный план для Copilot CLI?** Нет. По состоянию на октябрь 2026 года GitHub указывает, что Copilot CLI входит во все планы Copilot, включая Copilot Free и Copilot Student. В Free входит ограниченный объём GitHub AI Credits; в Pro, Pro+, Max, Business и Enterprise — больше. Если Copilot выдан организацией, администратор может отключить CLI.

**Как войти в Copilot CLI?** Запустите copilot и введите /login или выполните copilot login из оболочки. Откроется вход через браузер с вашим аккаунтом GitHub. Для скриптов и CI можно указать в COPILOT_GITHUB_TOKEN fine-grained personal access token с разрешением Copilot Requests.

**Как сделать, чтобы Copilot CLI не спрашивал подтверждение каждый раз?** Когда он спросит, выберите вариант «да и одобрять до конца сессии» или заранее разрешите нужные инструменты через --allow-tool, например --allow-tool='shell(git:*)'. --allow-all убирает все запросы, что рискованно вне песочницы или контейнера. Правило --deny-tool всегда сильнее разрешающего.

**Может ли Copilot CLI работать с моделями не от GitHub?** Да. Помимо моделей в /model, Copilot CLI поддерживает собственных провайдеров со своим ключом. Задайте COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY и COPILOT_MODEL, чтобы использовать OpenAI-совместимый эндпоинт, Azure или Anthropic, в том числе локальную модель через Ollama.

**Куда писать инструкции проекта для Copilot CLI?** В .github/copilot-instructions.md или AGENTS.md в корне репозитория. Copilot CLI также читает CLAUDE.md, GEMINI.md и файлы в .github/instructions/. Личные правила хранятся в ~/.copilot/copilot-instructions.md. Команда /init создаёт стартовый файл.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/