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

Учитесь использовать GitHub Copilot через командную строку.

Кто может использовать эту функцию?

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

В этой статье

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

Предпосылка

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

С использованием Второй пилот CLI

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

  2. Введите copilot , чтобы начать Второй пилот CLI.

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

    Внимание

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

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

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


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


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

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

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

    Закончите сессию Второй пилот CLI .

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

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

Советы

Оптимизируйте свой опыт Второй пилот 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

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

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

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

Используйте Пользовательские агенты

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

          Второй пилот CLI Включает стандартную группу Пользовательские агенты для общих задач:
Агент Описание
Исследовать Выполняет быстрый анализ кодовой базы, позволяя задавать вопросы о вашем коде, не добавляя к основному контексту.
Задача Выполняет команды, такие как тесты и сборки, предоставляя краткие обзоры успеха и полный результат при неудаче.
Универсальное применение Выполняет сложные, многоступенчатые задачи, требующие полного набора инструментов и качественного рассуждения, выполняя его в отдельном контексте, чтобы основной разговор был чётко сфокусирован.
Обзор кода Обзоры меняются, делая акцент только на выявление реальных проблем, минимизируя шум.

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

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

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

ТипМестоположениеОбласть действия
Пользовательский уровень Пользовательский агентЛокальный ~/.copilot/agents каталогВсе проекты
Уровень репозитория Пользовательский агент
          `.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

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

Чтобы расширить доступную функциональность в Второй пилот CLI, вы можете добавить больше MCP-серверов:

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

    /mcp add

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

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

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

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

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

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

  • Количество премиум-запросов, использованных в текущей сессии

  • Продолжительность сессии

  • Общее количество редактированных строк кода

  • Разбивка использования токенов по моделям

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

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

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

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

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

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

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

Подробнее

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

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

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

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

    copilot help config

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

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

    copilot help environment

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

    copilot help logging

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

    copilot help permissions

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

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

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

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

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

  •         **Делегировать задачи автономно**: Запускайте Второй пилот 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).

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

  •         **Запросите проверку кода**: используйте Второй пилот 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/cli-config-dir-reference)

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