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

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

Предпосылка

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

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

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

2. Введите для copilot запуска Copilot CLI.

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

   Внимание

   Во время этого сеанса GitHub Copilot CLI Copilot может попытаться считывать, изменять и выполнять файлы под этой папкой. Вы должны продолжать работу только в том случае, если вы доверяете файлам в этом расположении. Дополнительные сведения о доверенных каталогах см. в разделе О GitHub Copilot CLI.

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

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

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

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

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

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

   Завершите сеанс Copilot CLI.

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

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

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

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

6. Если 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 встроенную обратную связь об отклонении, чтобы он мог адаптировать свой подход, не останавливаясь полностью.

Советы

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

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

Если вы введете запрос, а затем решите, что вы хотите остановить Copilot от завершения задачи в то время как она по-прежнему называется "Мышление", нажмите клавишу ESC.

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

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

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

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

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

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

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

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

/add-dir /path/to/directory

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

/cwd /path/to/directory

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

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

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

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

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

copilot --continue

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

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

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

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

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

Use Пользовательские агенты

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

Copilot CLI включает по умолчанию группу Пользовательские агенты для обычных задач:

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

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

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

          `.github/agents` в локальных и удаленных репозиториях | Текущий проект |

| Организация и уровень предприятия Пользовательский агент | /agents Каталог в .github-private репозитории в организации или предприятии | Все проекты в вашей организации и корпоративной учетной записи |

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

Пользовательские агенты можно использовать тремя способами:

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

  /agent
  

• Вызов Пользовательский агент непосредственно в командной строке:

  Use the refactoring agent to refactor this code block
  

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

• Указание Пользовательский агент, которые вы хотите использовать, с помощью опции командной строки. Рассмотрим пример.

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

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

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

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

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

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

Copilot CLI поставляется с уже настроенным сервером MCP GitHub MCP. Этот сервер MCP позволяет взаимодействовать с ресурсами на GitHub.com, например, что позволяет объединять запросы на вытягивание из ИНТЕРФЕЙСА командной строки.

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

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

   /mcp add
   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подробнее

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

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

Дополнительные сведения используют одну из следующих команд в терминале:

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

  copilot help config

  Параметры конфигурации можно настроить, изменив config.json файл, расположенный по умолчанию в каталоге ~/.copilot . Это расположение можно изменить, задав COPILOT_HOME переменную среды.

•         **Переменные среды, влияющие** на Copilot CLI:
  

  copilot help environment

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

  copilot help logging

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

  copilot help permissions

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

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

Дальнейшие шаги

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

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

•         **Делегирование задач автономно**: запускать Copilot CLI в режиме автопилота для выполнения многошаговых задач без необходимости одобрения на каждом этапе. См [. раздел AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca).
  

•         **Вызов пользовательских агентов**: Вызов специализированных агентов, адаптированных для конкретных задач, таких как проверка кода, документация или аудит безопасности. См [. раздел AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/invoke-custom-agents).
  

•         **Направляйте агентов**: направляйте и совершенствуйте поведение агентов во время выполнения задач, чтобы работа оставалась на правильном плане. См. [АВТОЗАГОЛОВОК](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/steer-agents).
  

•         **Запросите проверку кода**: используйте Copilot CLI для получения AI-проверки изменений в коде. См [. раздел AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review).
  

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

•         [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server)