GitHub Copilot CLI: от установки до первого PR

Как установить GitHub Copilot CLI и войти в аккаунт

Для установки через npm используйте стабильный пакет GitHub @github/copilot. Он требует Node.js 22 или новее. На Windows также нужен PowerShell v6 или выше. Если доступ к Copilot предоставляет ваша организация, администратор должен разрешить Copilot CLI в настройках политики. Требования к установке.

Выполните в терминале:

npm install -g @github/copilot

Если в файле ~/.npmrc задано ignore-scripts=true, GitHub предлагает такой вариант: npm_config_ignore_scripts=false npm install -g @github/copilot. В документации есть и другие способы установки: winget install GitHub.Copilot на Windows, brew install --cask copilot-cli на macOS или Linux и curl -fsSL https://gh.io/copilot-install | bash на macOS или Linux. Требование к Node относится к установке через npm. Команды установки GitHub.

Перейдите в нужный репозиторий и введите copilot. Подтвердите доверие к папке — на текущий сеанс или на будущие сеансы. Если вы ещё не вошли в аккаунт, по запросу введите /login внутри Copilot. Первый запуск.

Выберите GitHub.com или адрес вашего GitHub Enterprise Cloud с региональным размещением данных. На локальном компьютере удобнее авторизация через браузер; в удалённой среде или среде без графического интерфейса обычно первым предлагается вход по коду устройства. Завершите авторизацию в браузере, разрешите доступ к нужным организациям, если они используют SAML SSO, и подтвердите доступ приложения GitHub Copilot CLI. Затем вернитесь в терминал. Авторизацию также можно начать из командной оболочки командой copilot login. Инструкция по авторизации.

Если CLI использует не тот аккаунт, проверьте переменные COPILOT_GITHUB_TOKEN, GH_TOKEN и GITHUB_TOKEN: явно экспортированные токены имеют приоритет над сохранёнными данными авторизации. Для автоматизации GitHub поддерживает токен личного аккаунта с детальными разрешениями и правом Copilot Requests на уровне аккаунта. Классические персональные токены доступа не поддерживаются. Авторизация и приоритет токенов.

Первые задачи: разобраться в коде, исправить тест и открыть PR

Начните с вопроса, затем внесите изменение, которое можно проверить, и откройте пул-реквест. Представьте CLI как разработчика, который работает рядом с вами: он изучает проект и пользуется инструментами, а вы определяете, какие действия ему разрешены.

В таблице отдельно указаны команды оболочки и ввод внутри интерактивного сеанса copilot. Все приведённые команды и запросы взяты из документации GitHub. Каждое обращение к модели расходует ИИ-кредиты; фиксированной стоимости этих задач в кредитах GitHub не указывает. Как учитывается использование CLI.

Сначала разберитесь в репозитории

Разработчик, который подключается к незнакомому проекту, может начать с команды из таблицы. В примере GitHub выбрана Claude Haiku 4.5: параметр -p отправляет один запрос и завершает работу, -s убирает дополнительный вывод, а --model задаёт модель. Если она недоступна в вашем тарифе или запрещена политикой, откройте интерактивный сеанс и выберите доступную модель через /model. Аккаунты Free и Student используют выбор Auto. Пример программного запуска, доступ к моделям.

По объяснению найдите точки входа и настройки тестов, а затем сами проверьте соответствующие файлы. Так у вас появится конкретная карта проекта, которую можно уточнять, вместо бессистемного обхода каталогов.

Исправьте падающий тест и проверьте результат

Если тест сломан, мейнтейнер проекта может запустить принятую в репозитории команду тестирования, передать Copilot вывод с ошибкой и воспользоваться интерактивным запросом из таблицы. Именно такую формулировку GitHub приводит в сценарии разработки через тестирование — после создания и проверки падающих тестов. При исправлении уже существующего сбоя дайте тот же необходимый контекст: какой тест падает и какое поведение должно сохраниться. Перед принятием изменения просмотрите diff и повторно запустите соответствующий тест. Сценарий работы с тестами GitHub.

Если тест падает в CI — автоматических проверках существующего пул-реквеста, — GitHub предлагает /pr fix ci focus on test failures. Команда изучает логи, вносит исправления и может отправить изменения в удалённый репозиторий. Это отдельный сценарий, который отличается от исправления локального теста. Для текущей ветки уже должен быть открыт PR. Исправление сбоев CI.

Откройте пул-реквест после проверки изменений

Основатель проекта, который выпускает небольшое исправление, может вызвать /pr create из рабочей ветки, предварительно проверив изменение и создав коммит. Команда работает в Git-репозитории, размещённом на GitHub. Copilot отправляет локальные коммиты и создаёт PR, используя шаблон пул-реквестов репозитория для заголовка и описания. Если у ветки уже есть PR, команда обновит его. Создание пул-реквеста.

Так результат попадёт на проверку в привычный команде процесс GitHub. Ответственность за содержимое ветки остаётся на вас.

Какие разрешения Copilot запрашивает перед запуском команд

Доверие к папке и разрешение на использование инструмента — разные решения. Когда действие требует подтверждения, его можно разрешить один раз, разрешить инструмент на весь текущий сеанс или отклонить запрос и объяснить причину. Разрешение на сеанс распространяется на инструмент вместе с его параметрами. Запросы разрешений.

Операции только для чтения могут выполняться автоматически. Потенциально разрушительные действия, запись и обращение к URL требуют разрешения, если оно ещё не выдано. В некоторых запросах можно сохранить разрешение для репозитория или каталога. Постоянные разрешения для доменов URL действуют и в последующих сеансах. Сохранённые разрешения.

GitHub приводит такой пример заранее настроенных разрешений:

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

Он разрешает команды Git, но запрещает отправку изменений. Правила запрета имеют приоритет над правилами разрешения и сохранёнными подтверждениями. Команда /reset-allowed-tools сбрасывает разрешения сеанса и сохранённые разрешения инструментов для текущего расположения, возвращая настройки, заданные при запуске. Правила разрешения и запрета.

Параметр --allow-all-tools разрешает все доступные инструменты. С --allow-all или --yolo также разрешается доступ ко всем путям и URL. GitHub рекомендует использовать столь широкие разрешения в изолированной среде. Для первых задач оставьте обычный порядок подтверждений. Параметры широкого доступа.

В какие тарифы входит CLI и за что списываются кредиты?

CLI входит во все тарифы Copilot: Free, Student, Pro, Pro+, Max, Business и Enterprise. Отдельная подписка на CLI к уже имеющемуся доступу Copilot не нужна. Ниже — текущие месячные цены и квоты со страницы тарифов GitHub. Тарифы Copilot.

Дополнительная квота flex может меняться, поэтому нынешние итоговые значения не гарантируют такой объём навсегда. Один ИИ-кредит равен $0.01 USD. Расход зависит от цен выбранной модели и количества входных, выходных и кешированных токенов. Чат и CLI используют одну квоту. На платных тарифах автодополнение кода и подсказки следующего изменения остаются безлимитными и не расходуют ИИ-кредиты. Оплата индивидуальных тарифов.

Для пользователя Pro, у которого уже есть подписка, её цена остаётся $10 в месяц. Работа модели в терминале расходует ту же текущую квоту в 1,500 кредитов. Практический расчёт прост: сначала попробуйте доступ, за который уже платите, и оцените, хватает ли общей квоты для вашей работы. Пользователи индивидуальных платных тарифов могут заложить бюджет на дополнительное использование, перейти на другой тариф или дождаться месячного обновления квоты. В публичной таблице цен покупка дополнительных кредитов для Free не предусмотрена. Индивидуальные квоты, ограничения на покупки в Free.

В Business и Enterprise кредиты объединяются на уровне плательщика. Дополнительное платное использование включено по умолчанию; администраторы могут его отключить. Бюджет пользователя или корпоративный лимит расходов может остановить доступ, даже если по другой квоте ещё остались кредиты. Для корректного отображения расходов и использования GitHub рекомендует CLI 1.0.48 или новее. Оплата для организаций.

После задачи вызовите /usage, чтобы увидеть расход кредитов за сеанс и использование токенов модели. В интерактивном сеансе можно задать /limits set max-ai-credits NUMBER, заменив NUMBER выбранной квотой. Минимум — 30 кредитов. Функция находится в стадии публичного предварительного доступа и задаёт мягкий лимит: уже начатый ответ завершится и может немного превысить порог. Отображение использования, лимиты сеанса.

Какие модели доступны в Copilot CLI?

Вызовите /model внутри Copilot, чтобы увидеть доступные варианты, или используйте --model при запуске из оболочки. В текущей таблице клиентов GitHub перечисленные ниже модели отмечены как поддерживаемые CLI. Ваш тариф и политики администратора могут ограничивать доступ. Поддерживаемые модели.

В отдельной таблице GitHub для режима Auto в CLI также есть GPT-6.1 Sol. Тарифы Free и Student работают только с Auto. Доступность меняется, поэтому актуальный набор для своего аккаунта смотрите в меню выбора модели. Auto и доступность по тарифам.

Как добавить инструкции проекта и инструменты MCP

Опишите правила работы с репозиторием до того, как начнёте регулярно поручать изменения. Пользовательские инструкции — это Markdown-файлы, которые Copilot добавляет в контекст. Общие команды сборки, запуска тестов и соглашения проекта поместите в .github/copilot-instructions.md. Для правил, относящихся к отдельным путям, используйте .github/instructions/**/*.instructions.md с шаблонами applyTo. Пользовательские инструкции.

CLI также находит AGENTS.md, CLAUDE.md, .claude/CLAUDE.md и GEMINI.md. Общие настройки пользователя можно хранить в ~/.copilot/copilot-instructions.md или ~/.copilot/instructions/**/*.instructions.md. Применимые инструкции объединяются; GitHub не задаёт для них общего порядка приоритетов. Следите, чтобы они не противоречили друг другу, и используйте /instructions для просмотра или отключения найденных файлов. Поиск и совместное применение инструкций.

MCP, Model Context Protocol, подключает агента к внешним инструментам и данным. Это похоже на подключение дополнительного сервиса к вашей рабочей среде. Сервер GitHub MCP уже встроен. Чтобы добавить другой сервер, используйте /mcp add, переходите между полями клавишей Tab и сохраняйте через Ctrl+S. Локальные серверы и серверы stdio запускают процесс; HTTP-серверы подключаются к удалённой конечной точке. Устаревший транспорт SSE тоже поддерживается. Добавление серверов MCP.

Пример GitHub для терминала: copilot mcp add --transport http sentry https://mcp.sentry.dev/mcp. Конфигурация пользователя хранится в ~/.copilot/mcp-config.json; для конфигурации проекта можно использовать .mcp.json или .github/mcp.json. В отдельном руководстве MCP указано, что настроенные политики реестра организации и списка разрешённых серверов распространяются и на CLI. Пример для терминала, конфигурация и политики.

Когда выбрать CLI, расширение для IDE или другого агента

Моя рекомендация: начните с Copilot CLI, если задача уже решается в терминале и у вас есть доступ к Copilot. Расширение для IDE удобнее, когда вы хотите работать рядом с редактируемым файлом, просматривать изменения визуально и оставаться в редакторе. В выборе поможет наше сравнение Cursor и GitHub Copilot.

После первых задач стоит рассмотреть и такие сценарии:

• Мейнтейнер, который готовит код к ревью, может запросить проверку рабочей ветки, разобраться в замечаниях и передать diff человеку на ревью. Результат — конкретный список пунктов для проверки, если замечания подтвердятся. GitHub описывает сценарии локального ревью. Рекомендации по ревью.
• Разработчик, который отвечает на замечания в PR, может вызвать /pr fix feedback, проверить предложенные изменения и разрешить их отправку. Это помогает держать правки и обсуждение вместе. Команда умеет отвечать в обсуждениях ревью и закрывать ветки обсуждений, по которым замечания устранены, поэтому перед подтверждением проверьте объём действий. Работа с замечаниями ревью.

Другой терминальный агент имеет смысл, если вам нужна иная квота подписки, другой вариант подключения провайдера или больше контроля над самим агентом. Для выбора подписки обратитесь к нашему сравнению альтернатив Claude Code и расходов на работу в терминале. Сначала проверьте, подходят ли вам модели самого Copilot: GitHub также описывает подключение собственного провайдера, включая совместимые локальные модели. Такой вариант требует отдельной настройки провайдера, а также поддержки вызова инструментов и потоковой передачи. Это отдельная конфигурация, отличающаяся от использования квоты Copilot. Подключение собственной модели.

Что небольшая команда может построить на этой основе

Самая сильная идея для старта — комплект материалов для знакомства с репозиторием. Разработчики ищут «how to understand a new codebase» и «ai tool to understand codebase»: как разобраться в незнакомой кодовой базе и какой ИИ-инструмент в этом поможет. Команда могла бы продавать руководителям разработки поддерживаемый комплект архитектурных заметок, проверенных инструкций по сборке и вводных задач с чёткими границами. Минимально полезная версия должна охватывать репозиторий заказчика и демонстрировать последовательность: объяснение кода, тест и PR. Сложность в том, что универсальные промпты легко скопировать; покупатель будет платить за актуальные знания о своём проекте.

Другой вариант — процесс подготовки к ревью. Запросы «ai code review tools» и «ai powered code review platform» указывают на эту потребность. Команда могла бы объединить инструкции проекта и подключённый контекст задач, чтобы формировать пакет для ревью: изменения, подтверждения тестирования и нерешённые вопросы. Покупателем стал бы руководитель команды, который хочет привести передачу работы к единому стандарту. Сложность: сгенерированные замечания нужно проверять, а польза такого процесса должна оправдывать его использование рядом с существующими возможностями ревью GitHub. Это возможные направления продукта, а не подтверждённые результаты.

Какие ограничения нужно учитывать

CLI может предложить правдоподобное, но ошибочное изменение. В рекомендациях по ответственному использованию GitHub предупреждает, что сгенерированный результат бывает неточным или неполным, и требует проверять код и команды CLI. Успешный запуск соответствующих тестов и просмотр diff остаются частью работы. Ответственное использование.

Доверие к папке не гарантирует изоляцию. GitHub описывает ограничение разрешений каталогами как эвристическое и не гарантирует защиту каждого файла за пределами доверенных каталогов. Запускайте CLI в том репозитории, с которым собираетесь работать. Для более строгих ограничений команда /sandbox enable включает локальную песочницу для инструментов. Локальные и облачные песочницы GitHub находятся в стадии публичного предварительного доступа. Доверие к каталогам и песочницы.

Ограничения доступа и расходов продолжают действовать. Модель из документации может быть недоступна в вашем тарифе или отключена политикой. CLI делит кредиты с остальной работой в Copilot, а предварительная версия лимита сеанса допускает небольшое превышение. Бюджет организации может остановить использование без автоматического переключения на более дешёвую модель. Доступ к моделям, лимиты сеанса, поведение при достижении бюджета.

Для следующего рабочего сеанса выберите реальный падающий тест в ветке, которую сможете проверить. Попросите объяснить связанный код, подтвердите запросы инструментов для исправления, снова запустите тест, посмотрите /usage и откройте PR. Так вы сможете предметно оценить, подходит ли вам этот процесс и сколько он расходует.

Если вы хотите выстроить работу с репозиторием вокруг проверок вашей команды и подключённых инструментов, мы разрабатываем автоматизацию с ИИ.