# Использование GitHub Copilot CLI Учитесь использовать GitHub Copilot через командную строку. Интерфейс командной строки (CLI) GitHub Copilot позволяет использовать Copilot его напрямую с терминала. Дополнительные сведения см. в разделе [О GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-copilot-cli). ## Предпосылка Установите Copilot CLI. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli). ## С использованием Copilot CLI 1. В терминале перейдите в папку, содержащую код, с которым вы хотите работать. 2. Введите `copilot` , чтобы начать Copilot CLI. Copilot Попросит вас подтвердить, доверяете ли вы файлам в этой папке. > \[!IMPORTANT] > Во время этой GitHub Copilot CLI сессии Copilot можно пытаться читать, изменять и выполнять файлы в этой папке и ниже. Вы должны продолжать работу только в том случае, если вы доверяете файлам в этом расположении. Дополнительные сведения о доверенных каталогах см. в разделе [О GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories). 1. Выберите один из вариантов: **1. Да, продолжайте**: Copilot могу работать с файлами в этом месте только для этой сессии. **2. Да, и запомните эту папку для будущих сеансов**: Вы доверяете файлам в этой папке для этих и будущих сеансов. Тебя больше не спросят, когда ты начнёшь Copilot CLI с этой папки. Выбирайте этот вариант только если уверены, что работа с файлами в этом месте всегда безопасна Copilot . **3. Нет, выход (ESC)**: Закончите сессию Copilot CLI . 1. Если вы сейчас не вошли GitHubв систему, вам попросят использовать `/login` команду slash. Введите эту команду и следуйте инструкциям на экране для проверки подлинности. 2. Введите запрос в CLI. Это может быть простой вопрос в чате или просьба Copilot выполнить конкретную задачу, например, исправить ошибку, добавить функцию в существующее приложение или создать новое. Вместо того чтобы печатать, вы можете произнести свой запрос. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input). Примеры запросов см. в разделе [О GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-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 изменить файл вне текущего местоположения, он попросит вас одобрить доступ к каталогу файла. Вы также можете добавить доверенный каталог вручную с помощью команды косой черты: ```shell /add-dir /path/to/directory ``` Если все файлы, с которыми вы хотите работать, находятся в разных местах, вы можете переключить текущую рабочую папку без запуска Copilot CLI новой сессии, используя команды `/cwd` или `/cd` slash: ```shell /cwd /path/to/directory ``` ### Выполнение команд оболочки Вы можете добавить в начало ввода `!` команду оболочки для непосредственного выполнения команд оболочки без вызова модели. ```shell !git clone https://github.com/github/copilot-cli ``` ### Запросы расписания будут запущены позже Вы можете запланировать запуск подсказок в будущем с помощью `/every` команд и `/after` slash. Команда `/every` планирует повторный запуск prompt с определённым интервалом, а `/after` one-shot prompt запускается один раз после определённой задержки. Рассмотрим пример. ```shell /every 1h Run frontend tests and report any failures ``` Дополнительные сведения см. в разделе [Запросы по расписанию GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/automate-copilot-cli/schedule-prompts). ### Возобновление интерактивного сеанса Вы можете использовать `--resume` командную строку или `/resume` команду «слэш», чтобы выбрать и продолжить интерактивную сессию CLI, что позволит продолжить с того места, где остановились, с сохраненным контекстом. Можно начать Copilot cloud agent сессию на GitHub, а затем GitHub Copilot CLI перенести её в локальную среду. > \[!TIP] > Чтобы быстро возобновить недавно закрытую локальную сессию, введите это в терминал: > > ```shell > copilot --continue > ``` ### Использование пользовательских инструкций Вы можете повысить Copilotпроизводительность , добавив пользовательские инструкции в репозиторий, в котором работаете. Пользовательские инструкции — это описания естественного языка, сохраненные в файлах Markdown в репозитории. Они автоматически включаются в запросы, которые вы вводите во время работы в этом репозитории. Это помогает Copilot лучше понять контекст вашего проекта и понять, как реагировать на ваши запросы. Copilot CLI поддерживает: * Инструкции по всему репозиторию `.github/copilot-instructions.md` в файле. * Файлы инструкций для конкретного пути: `.github/instructions/**/*.instructions.md` * Файлы агента, такие как `AGENTS.md`. Дополнительные сведения см. в разделе [Добавление пользовательских инструкций для GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions). ### Использование custom agents A custom agent — специализированная версия .Copilot Custom agents Помогайте Copilot управлять уникальными рабочими процессами, определёнными нормами кодирования и специализированными сценариями использования. Copilot CLI Включает стандартную группу custom agents для общих задач:
Агент Description
Обзор Выполняет быстрый анализ кодовой базы, позволяя задавать вопросы о вашем коде, не добавляя к основному контексту.
задачи Выполняет команды, такие как тесты и сборки, предоставляя краткие обзоры успеха и полный результат при неудаче.
Общее назначение Выполняет сложные, многоступенчатые задачи, требующие полного набора инструментов и качественного рассуждения, выполняя его в отдельном контексте, чтобы основной разговор был чётко сфокусирован.
проверка кода; Обзоры меняются, делая акцент только на выявление реальных проблем, минимизируя шум.
Исследование Проводит глубокое исследование по вашей кодовой базе, релевантным репозиториям и интернету, создавая подробный отчет с цитатами.
Резиновая утка Выступает конструктивным критиком, давая обратную связь по некоторым нетривиальным задачам. Используется автоматически .Copilot CLI
Модель ИИ, используемая CLI, может делегировать задачу вспомогательному субагенту, который работает с custom agent определённой экспертизой, если он считает, что это приведёт к более эффективному выполнению работы. Модель может также выбрать работу непосредственно в основном агенте. Некоторые встроенные custom agents, например агент резиновой утки, консультируются автоматически Copilot от вашего имени, а не вызываются вами напрямую. Вы не увидите их как отдельные опции при запуске `/agent`, но можете увидеть Copilot упоминание по мере выполнения задачи. Вы можете определить свои custom agents собственные с помощью файлов Markdown, называемых agent profiles, которые указывают, какую экспертизу должен обладать агент, какие инструменты он может использовать и какие конкретные инструкции по реагированию. Вы можете определить custom agents на уровне пользователя, репозитория или организации/предприятия: | Тип | Location | Объем | | ------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------- | | Пользовательский уровень custom agent | Локальный `~/.copilot/agents` каталог | Все проекты | | Уровень репозитория custom agent | | | | `.github/agents` в локальных и удаленных репозиториях | Текущий проект | | | Организация и корпоративный уровень custom agent | | | | `/agents` Каталог в `.github-private` репозитории в организации или предприятии | Все проекты в вашей организации и корпоративной учетной записи | | В случае конфликтов имен агент системного уровня переопределяет агент уровня репозитория, а агент уровня репозитория будет переопределять агент уровня организации. Custom agents Можно использовать тремя способами: * Используя команду slash в интерактивном интерфейсе CLI, чтобы выбрать из списка доступных custom agents: ```shell /agent ``` * Обращаясь custom agent напрямую в подсказке: ```shell Use the refactoring agent to refactor this code block ``` Copilot Автоматически определит, какой агент вы хотите использовать. * Указать нужный custom agent вариант в командной строке. Рассмотрим пример. ```shell copilot --agent=refactor-agent --prompt "Refactor this code block" ``` Дополнительные сведения см. в разделе [Создание кастомных агентов для Copilot cloud agent](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents). ### Использование навыков Вы можете развивать навыки для выполнения Copilot специализированных задач с помощью инструкций, скриптов и ресурсов. Дополнительные сведения см. в разделе [Добавление навыков агента для GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-skills). ### Используйте крючки Вы можете использовать крючки для расширения и настройки поведения Copilot CLI. Крючки позволяют автоматически запускать пользовательские команды shell в ключевых точках сессии CLI. Дополнительные сведения см. в разделе [Использование крючков с GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). ### Добавление сервера MCP Copilot CLI В комплекте уже настроенный GitHub MCP-сервер. Этот MCP-сервер позволяет взаимодействовать с ресурсами на GitHub.com— например, объединяя pull requests из CLI. Чтобы расширить функциональные возможности, доступные для вас Copilot CLI, можно добавить дополнительные серверы MCP. Чтобы добавить удаленный HTTP-сервер непосредственно из терминала без запуска интерактивного сеанса, используйте: ```shell copy copilot mcp add --transport http SERVER-NAME URL ``` Рассмотрим пример. ```shell copy copilot mcp add --transport http sentry https://mcp.sentry.dev/mcp ``` Сведения о локальных серверах и дополнительных параметрах см. в разделе [Добавление MCP-серверов для GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#using-the-copilot-mcp-add-subcommand). Кроме того, добавьте сервер из интерактивного сеанса: 1. Используйте следующую команду косой черты: ```shell /mcp add ``` 2. Введите сведения о сервере MCP, который вы хотите добавить, с помощью клавиши TAB для перемещения между полями. 3. Нажмите клавиши CTRL+S, чтобы сохранить сведения. Сведения о настроенных серверах MCP хранятся в `mcp-config.json` файле, расположенном по умолчанию в каталоге `~/.copilot` . Это расположение можно изменить, задав `COPILOT_HOME` переменную среды. Сведения о структуре JSON определения сервера см. в разделе [Настройте MCP-серверы для вашего репозитория](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers). ### Управление контекстом 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](/ru/enterprise-cloud@latest/copilot/concepts/about-cloud-and-local-sandboxes). ### Видимость с переключением рассуждения Нажмите Ctrl+T , чтобы показать или скрыть процесс рассуждений модели во время генерации ответа. Эта настройка сохраняется на протяжении всех сессий, позволяя наблюдать, как Copilot работает сложные задачи. ### Настройка параметров Вы можете просматривать и менять личные Copilot CLI настройки с помощью `/settings` команды слэш. * Запустите `/settings` , чтобы открыть интерактивный редактор настроек, где можно найти параметр по названию и отредактировать его. Чтобы восстановить значение настройки по умолчанию, выделите его в списке настроек и нажмите Ctrl+R. * Запустите `/settings KEY VALUE` , чтобы изменить параметр напрямую в окне подсказок CLI. KEY — это название настройки, а VALUE — это то значение, которое вы хотите установить. Это также работает в скриптах и в программных сессиях, начинаемых с `-p`. * Запустите `/settings show KEY` , чтобы отображать текущее значение настройки в виде текста, не открывая редактор. Большинство изменений настроек вступают в силу сразу, без необходимости перезапуска Copilot CLI. Дополнительные сведения см. в разделе [Изменение настроек с помощью команды \`/settings\`](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/change-settings). Полный список доступных настроек см. [АВТОТИТРЫ](/ru/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-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](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/delegate-tasks-to-cca). * **Вызов пользовательских агентов**: Вызов специализированных агентов, адаптированных для конкретных задач, таких как проверка кода, документация или аудит безопасности. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/invoke-custom-agents). * **Направляйте агентов**: направляйте и совершенствуйте поведение агентов во время выполнения задач, чтобы работа оставалась на правильном плане. См. [Направляющие агенты GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents). * **Запросите проверку кода**: используйте Copilot CLI для получения AI-проверки изменений в коде. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review). ## Дополнительные материалы * [Лучшие практики для GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/cli-best-practices) * [Справочник команды GitHub Copilot CLI](/ru/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference) * [Каталог конфигурации CLI GitHub Copilot](/ru/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference) * [Copilot CLI ACP сервер](/ru/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/acp-server)