Использование GitHub Copilot CLI

Интерфейс командной строки (CLI) GitHub Copilot позволяет использовать Copilot его напрямую с терминала. Дополнительные сведения см. в разделе О GitHub Copilot CLI.

Предпосылка

Установите Copilot CLI. См . раздел AUTOTITLE.

С использованием Copilot CLI

1. В терминале перейдите в папку, содержащую код, с которым вы хотите работать.

2. Введите copilot , чтобы начать Copilot CLI.

Copilot Попросит вас подтвердить, доверяете ли вы файлам в этой папке.

1. Выберите один из вариантов:

1. Да, продолжайте:

Copilot могу работать с файлами в этом месте только для этой сессии.

2. Да, и запомните эту папку для будущих сеансов:

Вы доверяете файлам в этой папке для этих и будущих сеансов. Тебя больше не спросят, когда ты начнёшь Copilot CLI с этой папки. Выбирайте этот вариант только если уверены, что работа с файлами в этом месте всегда безопасна Copilot .

3. Нет, выход (ESC):

Закончите сессию Copilot CLI .

1. Если вы сейчас не вошли GitHubв систему, вам попросят использовать /login команду slash. Введите эту команду и следуйте инструкциям на экране для проверки подлинности.

2. Введите запрос в CLI.

   Это может быть простой вопрос в чате или просьба Copilot выполнить конкретную задачу, например, исправить ошибку, добавить функцию в существующее приложение или создать новое.

   Вместо того чтобы печатать, вы можете произнести свой запрос. См . раздел AUTOTITLE.

   Примеры запросов см. в разделе О GitHub Copilot CLI.

3. Если Copilot вы хотите использовать инструмент, способный изменять или выполнять файлы —например, , touch, chmod``nodeилиsed он попросит вас одобрить использование инструмента.

   Выберите один из вариантов:

1. Да:

Позвольте Copilot использовать этот инструмент. В следующий раз, когда Copilot вы захотите воспользоваться этим инструментом, он попросит вас одобрить его снова.

2. Да, а затем утвердите TOOL для остальной части выполняемого сеанса:

Позвольте Copilot использовать этот инструмент — с любыми опциями — без повторного спроса на протяжении всей текущей сессии. Любые ожидающие параллельные запросы разрешения того же типа будут автоматически одобрены. Вам придется снова утвердить команду в будущих сеансах.

Выбор этой опции полезен для многих инструментов — например chmod, — так как он позволяет избежать необходимости многократно одобрять похожие команды в одной и той же сессии. Однако будьте осведомлены о последствиях для безопасности этого варианта. Например, выбор этой опции для команды rm позволит Copilot удалить любой файл из текущего каталога или его подкаталогов без вашего одобрения.

3. Нет, и скажите Copilot, что делать иначе (Esc):

Copilot не запускает команду. Вместо этого она завершает текущую операцию и ожидает следующего запроса. Можно сказать Copilot , что нужно продолжать дело, но с другим подходом.

Например, если вы просите Copilot создать bash-скрипт, но не хотите использовать рекомендованный скриптом Copilot , вы можете остановить текущую операцию и ввести новый запрос, например: Continue the previous task but include usage instructions in the script.

Когда вы отклоняете запрос на разрешение инструмента, вы также можете оставить Copilot встроенную обратную связь об отклонении, чтобы система могла адаптировать свой подход, не останавливаясь полностью.

Tips

Оптимизируйте свой опыт Copilot CLI с помощью следующих советов.

Остановка выполняемой в настоящее время операции

Если вы вводите подсказку, а затем решаете, что хотите остановить Copilot выполнение задачи, пока она ещё «Думает», нажмите Esc.

Используйте режим плана

Режим планирования позволяет сотрудничать Copilot над планом реализации до того, как будет написан код. Нажмите Shift+Tab , чтобы переключаться в режим плана и входить из него.

Добавление определенного файла в запрос

Чтобы добавить определенный файл в запрос, используйте @ относительный путь к файлу. Пример: Explain @config/ci/ci-required-checks.yml или Fix the bug in @src/app.js. Это добавляет содержимое файла в ваш запрос в виде контекста для Copilot.

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

Прикреплять изображения и PDF-файлы

Вы можете прикреплять изображения и PDF-файлы к вашим подсказкам, используя модель, поддерживающую ввод изображений.

Copilot Поддерживает следующие типы файлов:

• JPEG (.jpg, .jpeg)
• Папуа (.pngНовая Гвинея)
• GIF (.gif)
• WEBP (.webp)
• PDF (.pdf)
• HEIC (.heic)
• HEIF (.heif)

Вложения с изображениями и PDF доступны на всех Copilot тарифах и включены по умолчанию, без необходимости включать или выключать эту функцию.

Вы можете прикрепить файл следующим образом во время интерактивной сессии:

• Ссылайтесь на файл в вашем запросе с @ помощью пути к файлу.
• Перетащите файл в интерактивную сессию.
• Скопируйте изображение в буфер обмена, затем вставьте его как вложение.

Работа с файлами в другом расположении

Чтобы выполнить задачу, Copilot возможно, потребуется работать с файлами, находящимися вне текущей рабочей папки. Если запрос, введённый вами в интерактивной сессии, требует Copilot изменить файл вне текущего местоположения, он попросит вас одобрить доступ к каталогу файла.

Вы также можете добавить доверенный каталог вручную с помощью команды косой черты:

/add-dir /path/to/directory

Если все файлы, с которыми вы хотите работать, находятся в разных местах, вы можете переключить текущую рабочую папку без запуска Copilot CLI новой сессии, используя команды /cwd или /cd slash:

/cwd /path/to/directory

Выполнение команд оболочки

Вы можете добавить в начало ввода ! команду оболочки для непосредственного выполнения команд оболочки без вызова модели.

!git clone https://github.com/github/copilot-cli

Запросы расписания будут запущены позже

Вы можете запланировать запуск подсказок в будущем с помощью /every команд и /after slash. Команда /every планирует повторный запуск prompt с определённым интервалом, а /after one-shot prompt запускается один раз после определённой задержки. Рассмотрим пример.

/every 1h Run frontend tests and report any failures

Дополнительные сведения см. в разделе Запросы по расписанию GitHub Copilot CLI.

Возобновление интерактивного сеанса

Вы можете использовать --resume командную строку или /resume команду «слэш», чтобы выбрать и продолжить интерактивную сессию CLI, что позволит продолжить с того места, где остановились, с сохраненным контекстом. Можно начать Copilot cloud agent сессию на GitHub, а затем GitHub Copilot CLI перенести её в локальную среду.

copilot --continue

Использование пользовательских инструкций

Вы можете повысить Copilotпроизводительность , добавив пользовательские инструкции в репозиторий, в котором работаете. Пользовательские инструкции — это описания естественного языка, сохраненные в файлах Markdown в репозитории. Они автоматически включаются в запросы, которые вы вводите во время работы в этом репозитории. Это помогает Copilot лучше понять контекст вашего проекта и понять, как реагировать на ваши запросы.

Copilot CLI поддерживает:

• Инструкции по всему репозиторию .github/copilot-instructions.md в файле.
• Файлы инструкций для конкретного пути: .github/instructions/**/*.instructions.md
• Файлы агента, такие как AGENTS.md.

Дополнительные сведения см. в разделе Добавление пользовательских инструкций для GitHub Copilot CLI.

Использование custom agents

A custom agent — специализированная версия .Copilot Custom agents Помогайте Copilot управлять уникальными рабочими процессами, определёнными нормами кодирования и специализированными сценариями использования.

Copilot CLI Включает стандартную группу custom agents для общих задач:

Модель ИИ, используемая CLI, может делегировать задачу вспомогательному субагенту, который работает с custom agent определённой экспертизой, если он считает, что это приведёт к более эффективному выполнению работы. Модель может также выбрать работу непосредственно в основном агенте.

Некоторые встроенные custom agents, например агент резиновой утки, консультируются автоматически Copilot от вашего имени, а не вызываются вами напрямую. Вы не увидите их как отдельные опции при запуске /agent, но можете увидеть Copilot упоминание по мере выполнения задачи.

Вы можете определить свои custom agents собственные с помощью файлов Markdown, называемых agent profiles, которые указывают, какую экспертизу должен обладать агент, какие инструменты он может использовать и какие конкретные инструкции по реагированию.

Вы можете определить custom agents на уровне пользователя, репозитория или организации/предприятия:

В случае конфликтов имен агент системного уровня переопределяет агент уровня репозитория, а агент уровня репозитория будет переопределять агент уровня организации.

Custom agents Можно использовать тремя способами:

• Используя команду slash в интерактивном интерфейсе CLI, чтобы выбрать из списка доступных custom agents:

  /agent
  

• Обращаясь custom agent напрямую в подсказке:

  Use the refactoring agent to refactor this code block
  

Copilot Автоматически определит, какой агент вы хотите использовать.

• Указать нужный custom agent вариант в командной строке. Рассмотрим пример.

  copilot --agent=refactor-agent --prompt "Refactor this code block"
  

Дополнительные сведения см. в разделе Создание кастомных агентов для Copilot cloud agent.

Использование навыков

Вы можете развивать навыки для выполнения Copilot специализированных задач с помощью инструкций, скриптов и ресурсов.

Дополнительные сведения см. в разделе Добавление навыков агента для GitHub Copilot CLI.

Используйте крючки

Вы можете использовать крючки для расширения и настройки поведения Copilot CLI. Крючки позволяют автоматически запускать пользовательские команды shell в ключевых точках сессии CLI.

Дополнительные сведения см. в разделе Использование крючков с GitHub Copilot CLI.

Добавление сервера MCP

Copilot CLI В комплекте уже настроенный GitHub MCP-сервер. Этот MCP-сервер позволяет взаимодействовать с ресурсами на GitHub.com— например, объединяя pull requests из CLI.

Чтобы расширить функциональные возможности, доступные для вас Copilot CLI, можно добавить дополнительные серверы MCP.

Чтобы добавить удаленный HTTP-сервер непосредственно из терминала без запуска интерактивного сеанса, используйте:

copilot mcp add --transport http SERVER-NAME URL

copilot mcp add --transport http SERVER-NAME URL

Рассмотрим пример.

copilot mcp add --transport http sentry https://mcp.sentry.dev/mcp

copilot mcp add --transport http sentry https://mcp.sentry.dev/mcp

Сведения о локальных серверах и дополнительных параметрах см. в разделе Добавление MCP-серверов для GitHub Copilot CLI.

Кроме того, добавьте сервер из интерактивного сеанса:

1. Используйте следующую команду косой черты:

   /mcp add
   

2. Введите сведения о сервере MCP, который вы хотите добавить, с помощью клавиши TAB для перемещения между полями.

3. Нажмите клавиши CTRL+S, чтобы сохранить сведения.

Сведения о настроенных серверах MCP хранятся в mcp-config.json файле, расположенном по умолчанию в каталоге ~/.copilot . Это расположение можно изменить, задав COPILOT_HOME переменную среды. Сведения о структуре JSON определения сервера см. в разделе Настройте MCP-серверы для вашего репозитория.

Управление контекстом

Copilot CLI предоставляет несколько команд с косой чертой кожей, которые помогают вам отслеживать и управлять окном контекста:

• /usage: Позволяет просмотреть статистику вашей сессии, включая:

  • Количество используемых GitHub AI Credits в текущей сессии
  • Продолжительность сессии
  • Общее количество редактированных строк кода
  • Разбивка использования токенов по моделям

• /context: Предоставляет визуальный обзор текущего использования токена

• /compact: Ручное сжимает историю переписки, чтобы освободить контекстное пространство

GitHub Copilot CLI Автоматически сжимает вашу историю в фоне, когда разговор приближается к 95% лимита токенов, не прерывая ваш рабочий процесс.

Включить все права

В ситуациях, когда вы доверяете Copilot свободному запуску, можно использовать --allow-all флаги OR --yolo , чтобы одновременно включить все права доступа.

Использование песочницы

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

Кроме того, при использовании облачной песочницы весь Copilot CLI сеанс выполняется удаленно в изолированной среде. Чтобы запустить Copilot CLI сеанс в облаке, выполните команду copilot ‑‑cloud. Дополнительные сведения см. в разделе Сведения об облачных и локальных песочницах для GitHub Copilot.

Видимость с переключением рассуждения

Нажмите Ctrl+T , чтобы показать или скрыть процесс рассуждений модели во время генерации ответа. Эта настройка сохраняется на протяжении всех сессий, позволяя наблюдать, как Copilot работает сложные задачи.

Настройка параметров

Вы можете просматривать и менять личные Copilot CLI настройки с помощью /settings команды слэш.

• Запустите /settings , чтобы открыть интерактивный редактор настроек, где можно найти параметр по названию и отредактировать его. Чтобы восстановить значение настройки по умолчанию, выделите его в списке настроек и нажмите Ctrl+R.
• Запустите /settings KEY VALUE , чтобы изменить параметр напрямую в окне подсказок CLI. KEY — это название настройки, а VALUE — это то значение, которое вы хотите установить. Это также работает в скриптах и в программных сессиях, начинаемых с -p.
• Запустите /settings show KEY , чтобы отображать текущее значение настройки в виде текста, не открывая редактор.

Большинство изменений настроек вступают в силу сразу, без необходимости перезапуска Copilot CLI.

Дополнительные сведения см. в разделе Изменение настроек с помощью команды /settings. Полный список доступных настроек см. АВТОТИТРЫ.

Подробнее

Для полного списка опций командной строки и команд слэш, с которыми можно Copilot CLIиспользовать , выполните одну из следующих задач:

• Введите ? поле запроса в интерактивном сеансе.
• Введите copilot help в терминале.

Для получения дополнительной информации используйте одну из следующих copilot help подкоманд в вашем терминале:

• Параметры конфигурации:

  copilot help config

• Переменные окружающей среды, влияющие Copilot CLIна :

  copilot help environment

• Доступные уровни ведения журнала:

  copilot help logging

• **** Разрешения для разрешения или запрета использования средства:

  copilot help permissions

Обратная связь

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

Дальнейшие действия

Copilot CLI Может работать как ассистент в разговоре, отвечая на вопросы и помогая писать код интерактивно. Помимо чата, Copilot CLI поддерживается ряд агентских режимов, позволяющих делегировать задачи с большей автономией.

Вы можете работать с агентами Copilot CLI для поддержки полного жизненного цикла задачи — от делегирования работы до проверки результатов:

• Делегировать задачи автономно: Запускайте Copilot CLI в режиме автопилота, чтобы выполнять многошаговые задачи без необходимости одобрения на каждом этапе. См . раздел AUTOTITLE.
• Вызов пользовательских агентов: Вызов специализированных агентов, адаптированных для конкретных задач, таких как проверка кода, документация или аудит безопасности. См . раздел AUTOTITLE.
• Направляйте агентов: направляйте и совершенствуйте поведение агентов во время выполнения задач, чтобы работа оставалась на правильном плане. См. Направляющие агенты GitHub Copilot CLI.
• Запросите проверку кода: используйте Copilot CLI для получения AI-проверки изменений в коде. См . раздел AUTOTITLE.

Дополнительные материалы

• Лучшие практики для GitHub Copilot CLI
• Справочник команды GitHub Copilot CLI
• Каталог конфигурации CLI GitHub Copilot
• Copilot CLI ACP сервер