{"meta":{"title":"Использование GitHub Copilot CLI","intro":"Учитесь использовать GitHub Copilot через командную строку.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/how-tos","title":"Инструкции"},{"href":"/ru/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/ru/copilot/how-tos/copilot-cli/use-copilot-cli","title":"Использование Copilot CLI"},{"href":"/ru/copilot/how-tos/copilot-cli/use-copilot-cli/overview","title":"Обзор"}],"documentType":"article"},"body":"# Использование GitHub Copilot CLI\n\nУчитесь использовать GitHub Copilot через командную строку.\n\nИнтерфейс командной строки (CLI) GitHub Copilot позволяет использовать Copilot его напрямую с терминала. Дополнительные сведения см. в разделе [О GitHub Copilot CLI](/ru/copilot/concepts/agents/copilot-cli/about-copilot-cli).\n\n## Предпосылка\n\nУстановите Copilot CLI. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli).\n\n## С использованием Copilot CLI\n\n1. В терминале перейдите в папку, содержащую код, с которым вы хотите работать.\n\n2. Введите `copilot` , чтобы начать Copilot CLI.\n\nCopilot Попросит вас подтвердить, доверяете ли вы файлам в этой папке.\n\n> \\[!IMPORTANT]\n> Во время этой GitHub Copilot CLI сессии Copilot можно пытаться читать, изменять и выполнять файлы в этой папке и ниже. Вы должны продолжать работу только в том случае, если вы доверяете файлам в этом расположении. Дополнительные сведения о доверенных каталогах см. в разделе [О GitHub Copilot CLI](/ru/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories).\n\n1. Выберите один из вариантов:\n\n**1. Да, продолжайте**:\n\nCopilot могу работать с файлами в этом месте только для этой сессии.\n\n**2. Да, и запомните эту папку для будущих сеансов**:\n\nВы доверяете файлам в этой папке для этих и будущих сеансов. Тебя больше не спросят, когда ты начнёшь Copilot CLI с этой папки. Выбирайте этот вариант только если уверены, что работа с файлами в этом месте всегда безопасна Copilot .\n\n**3. Нет, выход (ESC)**:\n\nЗакончите сессию Copilot CLI .\n\n1. Если вы сейчас не вошли GitHubв систему, вам попросят использовать `/login` команду slash. Введите эту команду и следуйте инструкциям на экране для проверки подлинности.\n\n2. Введите запрос в CLI.\n\n   Это может быть простой вопрос в чате или просьба Copilot выполнить конкретную задачу, например, исправить ошибку, добавить функцию в существующее приложение или создать новое.\n\n   Вместо того чтобы печатать, вы можете произнести свой запрос. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input).\n\n   Примеры запросов см. в разделе [О GitHub Copilot CLI](/ru/copilot/concepts/agents/copilot-cli/about-copilot-cli).\n\n3. Если Copilot вы хотите использовать инструмент, способный изменять или выполнять файлы —например, , `touch`, `chmod``node`или`sed` он попросит вас одобрить использование инструмента.\n\n   Выберите один из вариантов:\n\n**1. Да**:\n\nПозвольте Copilot использовать этот инструмент. В следующий раз, когда Copilot вы захотите воспользоваться этим инструментом, он попросит вас одобрить его снова.\n\n**2. Да, а затем утвердите TOOL для остальной части выполняемого сеанса**:\n\nПозвольте Copilot использовать этот инструмент — с любыми опциями — без повторного спроса на протяжении всей текущей сессии. Любые ожидающие параллельные запросы разрешения того же типа будут автоматически одобрены. Вам придется снова утвердить команду в будущих сеансах.\n\nВыбор этой опции полезен для многих инструментов — например `chmod`, — так как он позволяет избежать необходимости многократно одобрять похожие команды в одной и той же сессии. Однако будьте осведомлены о последствиях для безопасности этого варианта. Например, выбор этой опции для команды `rm` позволит Copilot удалить любой файл из текущего каталога или его подкаталогов без вашего одобрения.\n\n**3. Нет, и скажите Copilot, что делать иначе (Esc)**:\n\nCopilot не запускает команду. Вместо этого она завершает текущую операцию и ожидает следующего запроса. Можно сказать Copilot , что нужно продолжать дело, но с другим подходом.\n\nНапример, если вы просите Copilot создать bash-скрипт, но не хотите использовать рекомендованный скриптом Copilot , вы можете остановить текущую операцию и ввести новый запрос, например: `Continue the previous task but include usage instructions in the script`.\n\nКогда вы отклоняете запрос на разрешение инструмента, вы также можете оставить Copilot встроенную обратную связь об отклонении, чтобы система могла адаптировать свой подход, не останавливаясь полностью.\n\n## Tips\n\nОптимизируйте свой опыт Copilot CLI с помощью следующих советов.\n\n### Остановка выполняемой в настоящее время операции\n\nЕсли вы вводите подсказку, а затем решаете, что хотите остановить Copilot выполнение задачи, пока она ещё «Думает», нажмите <kbd>Esc</kbd>.\n\n### Используйте режим плана\n\nРежим планирования позволяет сотрудничать Copilot над планом реализации до того, как будет написан код. Нажмите <kbd>Shift</kbd>+<kbd>Tab</kbd> , чтобы переключаться в режим плана и входить из него.\n\n### Добавление определенного файла в запрос\n\nЧтобы добавить определенный файл в запрос, используйте `@` относительный путь к файлу. Пример: `Explain @config/ci/ci-required-checks.yml` или `Fix the bug in @src/app.js`. Это добавляет содержимое файла в ваш запрос в виде контекста для Copilot.\n\nПри вводе пути к файлу соответствующие пути отображаются под полем запроса. Используйте клавиши со стрелками, чтобы выбрать путь и нажать <kbd>клавишу TAB</kbd> , чтобы завершить путь в запросе.\n\n### Прикреплять изображения и PDF-файлы\n\nВы можете прикреплять изображения и PDF-файлы к вашим подсказкам, используя модель, поддерживающую ввод изображений.\n\nCopilot Поддерживает следующие типы файлов:\n\n* JPEG (`.jpg`, `.jpeg`)\n* Папуа (`.png`Новая Гвинея)\n* GIF (`.gif`)\n* WEBP (`.webp`)\n* PDF (`.pdf`)\n* HEIC (`.heic`)\n* HEIF (`.heif`)\n\nВложения с изображениями и PDF доступны на всех Copilot тарифах и включены по умолчанию, без необходимости включать или выключать эту функцию.\n\nВы можете прикрепить файл следующим образом во время интерактивной сессии:\n\n* Ссылайтесь на файл в вашем запросе с `@` помощью пути к файлу.\n* Перетащите файл в интерактивную сессию.\n* Скопируйте изображение в буфер обмена, затем вставьте его как вложение.\n\n### Работа с файлами в другом расположении\n\nЧтобы выполнить задачу, Copilot возможно, потребуется работать с файлами, находящимися вне текущей рабочей папки. Если запрос, введённый вами в интерактивной сессии, требует Copilot изменить файл вне текущего местоположения, он попросит вас одобрить доступ к каталогу файла.\n\nВы также можете добавить доверенный каталог вручную с помощью команды косой черты:\n\n```shell\n/add-dir /path/to/directory\n```\n\nЕсли все файлы, с которыми вы хотите работать, находятся в разных местах, вы можете переключить текущую рабочую папку без запуска Copilot CLI новой сессии, используя команды `/cwd` или `/cd` slash:\n\n```shell\n/cwd /path/to/directory\n```\n\n### Выполнение команд оболочки\n\nВы можете добавить в начало ввода `!` команду оболочки для непосредственного выполнения команд оболочки без вызова модели.\n\n```shell\n!git clone https://github.com/github/copilot-cli\n```\n\n### Запросы расписания будут запущены позже\n\nВы можете запланировать запуск подсказок в будущем с помощью `/every` команд и `/after` slash. Команда `/every` планирует повторный запуск prompt с определённым интервалом, а `/after` one-shot prompt запускается один раз после определённой задержки. Рассмотрим пример.\n\n```shell\n/every 1h Run frontend tests and report any failures\n```\n\nДополнительные сведения см. в разделе [Запросы по расписанию GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/automate-copilot-cli/schedule-prompts).\n\n### Возобновление интерактивного сеанса\n\nВы можете использовать `--resume` командную строку или `/resume` команду «слэш», чтобы выбрать и продолжить интерактивную сессию CLI, что позволит продолжить с того места, где остановились, с сохраненным контекстом. Можно начать Copilot cloud agent сессию на GitHub, а затем GitHub Copilot CLI перенести её в локальную среду.\n\n> \\[!TIP]\n> Чтобы быстро возобновить недавно закрытую локальную сессию, введите это в терминал:\n>\n> ```shell\n> copilot --continue\n> ```\n\n### Использование пользовательских инструкций\n\nВы можете повысить Copilotпроизводительность , добавив пользовательские инструкции в репозиторий, в котором работаете. Пользовательские инструкции — это описания естественного языка, сохраненные в файлах Markdown в репозитории. Они автоматически включаются в запросы, которые вы вводите во время работы в этом репозитории. Это помогает Copilot лучше понять контекст вашего проекта и понять, как реагировать на ваши запросы.\n\nCopilot CLI поддерживает:\n\n* Инструкции по всему репозиторию `.github/copilot-instructions.md` в файле.\n* Файлы инструкций для конкретного пути: `.github/instructions/**/*.instructions.md`\n* Файлы агента, такие как `AGENTS.md`.\n\nДополнительные сведения см. в разделе [Добавление пользовательских инструкций для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions).\n\n### Использование custom agents\n\nA custom agent — специализированная версия .Copilot\nCustom agents Помогайте Copilot управлять уникальными рабочими процессами, определёнными нормами кодирования и специализированными сценариями использования.\n\nCopilot CLI Включает стандартную группу custom agents для общих задач:\n\n<table>\n  <thead>\n    <tr>\n      <th style=\"width:20%\">Агент</th>\n      <th>Description</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Обзор</td>\n      <td>Выполняет быстрый анализ кодовой базы, позволяя задавать вопросы о вашем коде, не добавляя к основному контексту.</td>\n    </tr>\n    <tr>\n      <td>задачи</td>\n      <td>Выполняет команды, такие как тесты и сборки, предоставляя краткие обзоры успеха и полный результат при неудаче.</td>\n    </tr>\n    <tr>\n      <td>Общее назначение</td>\n      <td>Выполняет сложные, многоступенчатые задачи, требующие полного набора инструментов и качественного рассуждения, выполняя его в отдельном контексте, чтобы основной разговор был чётко сфокусирован.</td>\n    </tr>\n    <tr>\n      <td>проверка кода;</td>\n      <td>Обзоры меняются, делая акцент только на выявление реальных проблем, минимизируя шум.</td>\n    </tr>\n    <tr>\n      <td>Исследование</td>\n      <td>Проводит глубокое исследование по вашей кодовой базе, релевантным репозиториям и интернету, создавая подробный отчет с цитатами.</td>\n    </tr>\n    <tr>\n      <td>Резиновая утка</td>\n      <td>Выступает конструктивным критиком, давая обратную связь по некоторым нетривиальным задачам. Используется автоматически .Copilot CLI</td>\n    </tr>\n  </tbody>\n</table>\n\nМодель ИИ, используемая CLI, может делегировать задачу вспомогательному субагенту, который работает с custom agent определённой экспертизой, если он считает, что это приведёт к более эффективному выполнению работы. Модель может также выбрать работу непосредственно в основном агенте.\n\nНекоторые встроенные custom agents, например агент резиновой утки, консультируются автоматически Copilot от вашего имени, а не вызываются вами напрямую. Вы не увидите их как отдельные опции при запуске `/agent`, но можете увидеть Copilot упоминание по мере выполнения задачи.\n\nВы можете определить свои custom agents собственные с помощью файлов Markdown, называемых agent profiles, которые указывают, какую экспертизу должен обладать агент, какие инструменты он может использовать и какие конкретные инструкции по реагированию.\n\nВы можете определить custom agents на уровне пользователя, репозитория или организации/предприятия:\n\n| Тип                                                                             | Location                                                       | Объем       |\n| ------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------- |\n| Пользовательский уровень custom agent                                           | Локальный `~/.copilot/agents` каталог                          | Все проекты |\n| Уровень репозитория custom agent                                                |                                                                |             |\n| `.github/agents` в локальных и удаленных репозиториях                           | Текущий проект                                                 |             |\n| Организация и корпоративный уровень custom agent                                |                                                                |             |\n| `/agents` Каталог в `.github-private` репозитории в организации или предприятии | Все проекты в вашей организации и корпоративной учетной записи |             |\n\nВ случае конфликтов имен агент системного уровня переопределяет агент уровня репозитория, а агент уровня репозитория будет переопределять агент уровня организации.\n\nCustom agents Можно использовать тремя способами:\n\n* Используя команду slash в интерактивном интерфейсе CLI, чтобы выбрать из списка доступных custom agents:\n\n  ```shell\n  /agent\n  ```\n\n* Обращаясь custom agent напрямую в подсказке:\n\n  ```shell\n  Use the refactoring agent to refactor this code block\n  ```\n\nCopilot Автоматически определит, какой агент вы хотите использовать.\n\n* Указать нужный custom agent вариант в командной строке. Рассмотрим пример.\n\n  ```shell\n  copilot --agent=refactor-agent --prompt \"Refactor this code block\"\n  ```\n\nДополнительные сведения см. в разделе [Создание кастомных агентов для Copilot cloud agent](/ru/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n\n### Использование навыков\n\nВы можете развивать навыки для выполнения Copilot специализированных задач с помощью инструкций, скриптов и ресурсов.\n\nДополнительные сведения см. в разделе [Добавление навыков агента для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-skills).\n\n### Используйте крючки\n\nВы можете использовать крючки для расширения и настройки поведения Copilot CLI. Крючки позволяют автоматически запускать пользовательские команды shell в ключевых точках сессии CLI.\n\nДополнительные сведения см. в разделе [Использование крючков с GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/use-hooks).\n\n### Добавление сервера MCP\n\nCopilot CLI В комплекте уже настроенный GitHub MCP-сервер. Этот MCP-сервер позволяет взаимодействовать с ресурсами на GitHub.com— например, объединяя pull requests из CLI.\n\nЧтобы расширить функциональные возможности, доступные для вас Copilot CLI, можно добавить дополнительные серверы MCP.\n\nЧтобы добавить удаленный HTTP-сервер непосредственно из терминала без запуска интерактивного сеанса, используйте:\n\n```shell copy\ncopilot mcp add --transport http SERVER-NAME URL\n```\n\nРассмотрим пример.\n\n```shell copy\ncopilot mcp add --transport http sentry https://mcp.sentry.dev/mcp\n```\n\nСведения о локальных серверах и дополнительных параметрах см. в разделе [Добавление MCP-серверов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#using-the-copilot-mcp-add-subcommand).\n\nКроме того, добавьте сервер из интерактивного сеанса:\n\n1. Используйте следующую команду косой черты:\n\n   ```shell\n   /mcp add\n   ```\n\n2. Введите сведения о сервере MCP, который вы хотите добавить, с помощью <kbd>клавиши TAB</kbd> для перемещения между полями.\n\n3. Нажмите клавиши <kbd>CTRL<kbd></kbd>+S</kbd>, чтобы сохранить сведения.\n\nСведения о настроенных серверах MCP хранятся в `mcp-config.json` файле, расположенном по умолчанию в каталоге `~/.copilot` . Это расположение можно изменить, задав `COPILOT_HOME` переменную среды. Сведения о структуре JSON определения сервера см. в разделе [Настройте MCP-серверы для вашего репозитория](/ru/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).\n\n### Управление контекстом\n\nCopilot CLI предоставляет несколько команд с косой чертой кожей, которые помогают вам отслеживать и управлять окном контекста:\n\n* `/usage`: Позволяет просмотреть статистику вашей сессии, включая:\n  * Количество используемых GitHub AI Credits в текущей сессии\n  * Продолжительность сессии\n  * Общее количество редактированных строк кода\n  * Разбивка использования токенов по моделям\n\n* `/context`: Предоставляет визуальный обзор текущего использования токена\n\n* `/compact`: Ручное сжимает историю переписки, чтобы освободить контекстное пространство\n\nGitHub Copilot CLI Автоматически сжимает вашу историю в фоне, когда разговор приближается к 95% лимита токенов, не прерывая ваш рабочий процесс.\n\n### Включить все права\n\nВ ситуациях, когда вы доверяете Copilot свободному запуску, можно использовать `--allow-all` флаги OR `--yolo` , чтобы одновременно включить все права доступа.\n\n### Использование песочницы\n\nВы можете использовать песочницу, чтобы ограничить доступ к доступу Copilot . Локальная песочница не запускает сам интерфейс командной строки в песочнице; Вместо этого команды и средства, Copilot CLI которые выполняются от вашего имени, ограничены, ограничивая доступ к файловой системе, сети и системным возможностям. Чтобы включить локальную песочницу, войдите `/sandbox enable` в сессию.\n\nКроме того, при использовании облачной песочницы весь Copilot CLI сеанс выполняется удаленно в изолированной среде. Чтобы запустить Copilot CLI сеанс в облаке, выполните команду `copilot ‑‑cloud`. Дополнительные сведения см. в разделе [Сведения об облачных и локальных песочницах для GitHub Copilot](/ru/copilot/concepts/about-cloud-and-local-sandboxes).\n\n### Видимость с переключением рассуждения\n\nНажмите <kbd>Ctrl</kbd>+<kbd>T</kbd> , чтобы показать или скрыть процесс рассуждений модели во время генерации ответа. Эта настройка сохраняется на протяжении всех сессий, позволяя наблюдать, как Copilot работает сложные задачи.\n\n### Настройка параметров\n\nВы можете просматривать и менять личные Copilot CLI настройки с помощью `/settings` команды слэш.\n\n* Запустите `/settings` , чтобы открыть интерактивный редактор настроек, где можно найти параметр по названию и отредактировать его. Чтобы восстановить значение настройки по умолчанию, выделите его в списке настроек и нажмите <kbd>Ctrl</kbd>+<kbd>R</kbd>.\n* Запустите `/settings KEY VALUE` , чтобы изменить параметр напрямую в окне подсказок CLI. KEY — это название настройки, а VALUE — это то значение, которое вы хотите установить. Это также работает в скриптах и в программных сессиях, начинаемых с `-p`.\n* Запустите `/settings show KEY` , чтобы отображать текущее значение настройки в виде текста, не открывая редактор.\n\nБольшинство изменений настроек вступают в силу сразу, без необходимости перезапуска Copilot CLI.\n\nДополнительные сведения см. в разделе [Изменение настроек с помощью команды \\`/settings\\`](/ru/copilot/how-tos/copilot-cli/customize-copilot/change-settings). Полный список доступных настроек см. [АВТОТИТРЫ](/ru/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings).\n\n## Подробнее\n\nДля полного списка опций командной строки и команд слэш, с которыми можно Copilot CLIиспользовать , выполните одну из следующих задач:\n\n* Введите `?` поле запроса в интерактивном сеансе.\n* Введите `copilot help` в терминале.\n\nДля получения дополнительной информации используйте одну из следующих `copilot help` подкоманд в вашем терминале:\n\n* **Параметры конфигурации**:\n\n  `copilot help config`\n\n* **Переменные окружающей** среды, влияющие Copilot CLIна :\n\n  `copilot help environment`\n\n* **Доступные уровни** ведения журнала:\n\n  `copilot help logging`\n\n* \\*\\*\\*\\* Разрешения для разрешения или запрета использования средства:\n\n  `copilot help permissions`\n\n## Обратная связь\n\nЕсли у вас есть отзывы о GitHub Copilot CLI, сообщите нам, используя `/feedback` команду косой черты в интерактивном сеансе и выбрав один из вариантов. Вы можете выполнить частный опрос отзывов, отправить отчет об ошибке или предложить новую функцию.\n\n## Дальнейшие действия\n\nCopilot CLI Может работать как ассистент в разговоре, отвечая на вопросы и помогая писать код интерактивно. Помимо чата, Copilot CLI поддерживается ряд агентских режимов, позволяющих делегировать задачи с большей автономией.\n\nВы можете работать с агентами Copilot CLI для поддержки полного жизненного цикла задачи — от делегирования работы до проверки результатов:\n\n* **Делегировать задачи автономно**: Запускайте Copilot CLI в режиме автопилота, чтобы выполнять многошаговые задачи без необходимости одобрения на каждом этапе. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/delegate-tasks-to-cca).\n* **Вызов пользовательских агентов**: Вызов специализированных агентов, адаптированных для конкретных задач, таких как проверка кода, документация или аудит безопасности. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/invoke-custom-agents).\n* **Направляйте агентов**: направляйте и совершенствуйте поведение агентов во время выполнения задач, чтобы работа оставалась на правильном плане. См. [Направляющие агенты GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents).\n* **Запросите проверку кода**: используйте Copilot CLI для получения AI-проверки изменений в коде. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review).\n\n## Дополнительные материалы\n\n* [Лучшие практики для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/cli-best-practices)\n* [Справочник команды GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [Каталог конфигурации CLI GitHub Copilot](/ru/copilot/reference/copilot-cli-reference/cli-config-dir-reference)\n* [Copilot CLI ACP сервер](/ru/copilot/reference/copilot-cli-reference/acp-server)"}