{"meta":{"title":"GitHub Copilot CLI программный справочник","intro":"Найдите варианты программного запуска Второй пилот CLI .","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/reference","title":"Справочные материалы"},{"href":"/ru/copilot/reference/copilot-cli-reference","title":"Ссылка Второй пилот CLI"},{"href":"/ru/copilot/reference/copilot-cli-reference/cli-programmatic-reference","title":"Программный справочник CLI"}],"documentType":"article"},"body":"# GitHub Copilot CLI программный справочник\n\nНайдите варианты программного запуска Второй пилот CLI .\n\nПомимо интерактивного запуска Второй пилот CLI , вы также можете передавать запрос напрямую в CLI одной командой, не входя в интерактивную сессию. Это позволяет программно использовать Copilot скрипты, CI/CD конвейеры и автоматизацию. Дополнительные сведения см. в разделе [Программный запуск GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically).\n\nВ этой статье описываются командные строки и переменные среды, которые особенно актуальны при программном запуске Второй пилот CLI .\n\nЧтобы увидеть полный список доступных опций, смотрите [Справочник команды GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#command-line-options) или введите следующую команду в вашем терминале:\n\n```shell copy\ncopilot help\n```\n\n## Параметры командной строки\n\nСуществует ряд опций командной строки, которые особенно полезны при программном запуске Второй пилот CLI .\n\n| Опция                        | Описание                                                                                                                                                                                                                                                                                                      |\n| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `-p PROMPT`                  | Выполните запрос в неинтерактивном режиме. CLI запускает подсказку и уходит после завершения.                                                                                                                                                                                                                 |\n| `-s`                         | Подавлять характеристики и декорации, выдавая только реакцию агента. Идеально подходит для прокладки вывода в скриптах.                                                                                                                                                                                       |\n| `--add-dir=DIRECTORY`        | Добавьте каталог в список разрешённых путей. Это можно использовать несколько раз для добавления нескольких каталогов. Полезно, когда агенту нужно читать/записывать вне текущей рабочей директории.                                                                                                          |\n| `--agent=AGENT`              | Укажите a Пользовательский агент для использования.                                                                                                                                                                                                                                                           |\n| `--allow-all` (или `--yolo`) | Разрешите CLI все права. Эквивалентно `--allow-all-tools --allow-all-paths --allow-all-urls`.                                                                                                                                                                                                                 |\n| `--allow-all-paths`          | Полностью отключите проверку пути по файлу. Это более простая альтернатива, чем `--add-dir` когда ограничения по пути не нужны.                                                                                                                                                                               |\n| `--allow-all-tools`          | Разрешить каждому инструменту работать без явного разрешения для каждого инструмента.                                                                                                                                                                                                                         |\n| `--allow-all-urls`           | Разрешить доступ ко всем URL без явного разрешения для каждого URL.                                                                                                                                                                                                                                           |\n| `--allow-tool=TOOL ...`      | Избирательно предоставляйте разрешение на конкретный инструмент. Для множества инструментов используйте список с кавычками, разделёнными запятыми.                                                                                                                                                            |\n| `--allow-url=URL ...`        | Позвольте агенту получить определённый URL или домен. Полезно, когда рабочий процесс требует веб-доступа к известным конечным точкам. Для нескольких URL используйте список с кавычками, разделёнными запятыми.                                                                                               |\n| `--deny-tool=TOOL ...`       | Откажитесь от конкретного инструмента. Полезно для ограничения возможностей агента в закрытом рабочем процессе. Для множества инструментов используйте список с кавычками, разделёнными запятыми.                                                                                                             |\n| `--model=MODEL`              | Выберите модель ИИ (например `gpt-5.2` , или `claude-sonnet-4.6`). Полезно для закрепления модели в воспроизводимых рабочих процессах. См. [раздел «Выбор модели](#choosing-a-model) » ниже.                                                                                                                  |\n| `--no-ask-user`              | Предотвратите паузу агента для получения дополнительного пользовательского ввода.                                                                                                                                                                                                                             |\n| `--secret-env-vars=VAR ...`  | Переменная среды, значение которой вы хотите скрыть в выводе. Для множества переменных используйте список с кавычками, разделёнными запятыми. Это необходимо для предотвращения раскрытия секретов в логах. Значения в `GITHUB_TOKEN` переменных и `COPILOT_GITHUB_TOKEN` среды по умолчанию заредактированы. |\n| `--share=PATH`               | Экспортируйте транскрипт сессии в файл markdown после неинтерактивного завершения (по умолчанию ).`./copilot-session-<ID>.md` Полезно для аудита или архивирования того, что сделал агент. Обратите внимание, что расшифровки сессий могут содержать конфиденциальную информацию.                             |\n| `--share-gist`               | Опубликуйте расшифровку сессии в виде секретного GitHub gist после её завершения. Удобно для обмена результатами CI. Обратите внимание, что расшифровки сессий могут содержать конфиденциальную информацию.                                                                                                   |\n\n## Инструменты для этой `--allow-tool` опции\n\nС помощью этой `--allow-tool` опции можно задать различные типы инструментов.\n\n| Такой инструмент | Что он контролирует                                                                                                                                                                                                           |\n| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| оболочка         | Выполнение команд shell.                                                                                                                                                                                                      |\n| писать           | Создание или изменение файлов.                                                                                                                                                                                                |\n| read             | Чтение файлов или каталогов.                                                                                                                                                                                                  |\n| URL-адрес        | Загрузка контента по URL.                                                                                                                                                                                                     |\n| memory           | Хранение новых фактов в постоянной памяти агента. Это не влияет на использование существующих воспоминаний. См [. раздел AUTOTITLE](/ru/copilot/concepts/agents/copilot-memory).                                              |\n| MCP-SERVER       | Вызов инструментов с конкретного MCP-сервера. Используйте настроенное имя сервера в качестве идентификатора — например, `github`. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers). |\n\n### Инструментальные фильтры\n\nТипы `shell`инструментов , `write`, `url`и MCP позволяют задавать фильтр в скобках, чтобы контролировать, какие именно инструменты разрешены.\n\n<!-- markdownlint-disable -->\n\n| Такой инструмент | Пример                                   | Объяснение примера                                                                           |\n| ---------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------- |\n| **раковина**     | `shell(git:*)`                           | Разрешить все подкоманды Git (`git push`, `git status`, и т.д.).                             |\n|                  | `shell(npm test)`                        | Разрешите точную команду `npm test`.                                                         |\n| **писать**       | `write(.github/copilot-instructions.md)` | Позвольте CLI записывать по этому конкретному пути.                                          |\n|                  | `write(README.md)`                       | Позвольте CLI записывать в любой файл, путь которого заканчивается на `/README.md`.          |\n| **url**          | `url(github.com)`                        | Разрешите CLI получать доступ к HTTPS-URL на github.com.                                     |\n|                  | `url(http://localhost:3000)`             | Разрешите CLI получить доступ к локальному серверу разработчика с явным протоколом и портом. |\n|                  | `url(https://*.github.com)`              | Разрешите CLI получать доступ к любому GitHub поддомену (например, `api.github.com`).        |\n|                  | `url(https://docs.github.com/copilot/*)` | Разрешите доступ к Copilot документации на этом сайте.                                       |\n| **MCP-SERVER**   | `github(create_issue)`                   | Разрешите только инструмент `create_issue` с `github` сервера MCP.                           |\n\n<!-- markdownlint-enable -->\n\n> \\[!NOTE]\n> Дикие карты поддерживаются только для `shell` совпадения всех подкоманд определённого инструмента, а `url` в начале имени хоста — для совпадения с любым поддоменом, или в конце пути для совпадения с любым суффиксом пути — как показано в предыдущей таблице.\n\n## Переменные среды\n\nВы можете использовать переменные среды для настройки различных аспектов поведения CLI при программном запуске. Это особенно полезно для настройки конфигурации в рабочих процессах CI/CD или других автоматизированных средах, где не стоит указывать определённые опции напрямую в командной строке.\n\n| Variable               | Описание                                                                  |\n| ---------------------- | ------------------------------------------------------------------------- |\n| `COPILOT_ALLOW_ALL`    | Настройте на `true` полные разрешения                                     |\n| `COPILOT_MODEL`        | Задайте модель (например, `gpt-5.2`, `claude-sonnet-4.5`)                 |\n| `COPILOT_HOME`         | Задайте папку для конфигурационного файла CLI (`~/.copilot` по умолчанию) |\n| `COPILOT_GITHUB_TOKEN` | Токен аутентификации (высший приоритет)                                   |\n| `GH_TOKEN`             | Токен аутентификации (второй приоритет)                                   |\n| `GITHUB_TOKEN`         | Токен аутентификации (третий прецедент)                                   |\n\nДля получения полной информации о переменных окружения Второй пилот CLIиспользуйте команду `copilot help environment` в вашем терминале.\n\n## Выбор модели\n\nКогда вы отправляете запрос в Второй пилот CLI неинтерактивном режиме, модель, которую CLI использует для генерации ответа, отображается в выходе ответа (если `-s`опция , или `--silent`, не используется).\n\nВы можете использовать `--model` опцию, чтобы указать, какую модель ИИ должен использовать CLI. Это позволяет выбрать модель, которая лучше всего соответствует вашему запросу, учитывая такие факторы, как скорость, стоимость и возможности.\n\nНапример, для простых задач, таких как объяснение кода или создание резюме, вы можете выбрать быструю, более дешевую модель, например, модель Клода Хайку:\n\n```bash copy\ncopilot -p \"What does this project do?\" -s --model claude-haiku-4.5\n```\n\nДля более сложных задач, требующих более глубокого мышления — например, отладки или рефакторинга кода — вы можете выбрать более мощную модель, например, модель GPT Codex:\n\n```bash copy\ncopilot -p \"Fix the race condition in the worker pool\" \\\n  --model gpt-5.3-codex \\\n  --allow-tool='write, shell'\n```\n\n> \\[!NOTE]\n> Вы можете найти строки моделей для всех доступных моделей в описании `--model` опции при входе `copilot help` в терминал.\n\nВ качестве альтернативы можно установить `COPILOT_MODEL` переменную среды так, чтобы она указывала модель на время сессии оболочки.\n\nЧтобы сохранить выбор модели между сессиями оболочки, можно установить `model` ключ в конфигурационном файле CLI. Этот файл находится по адресу `~/.copilot/config.json` (или `$COPILOT_HOME/.copilot/config.json` если вы установили переменную `COPILOT_HOME` среды). Некоторые модели также позволяют установить уровень усилия для рассуждения, который контролирует, сколько времени модель тратит на размышления перед ответом.\n\n```json copy\n{\n  \"model\": \"gpt-5.3-codex\",\n  \"reasoning_effort\": \"low\"\n}\n```\n\n> \\[!TIP]\n> Самый простой способ установить модель в конфигурационном файле — использовать `/model` команду slash в интерактивной сессии. Выбор, который вы делаете с помощью этой команды, записывается в конфигурационный файл.\n\n### Приоритет модели\n\nПри определении модели, которую использовать для заданного запроса, CLI проверяет спецификации модели в следующем порядке приоритета (от самого высокого к наименьшему):\n\n* Где используется пользовательский агент: модель, указанная в определении пользовательского агента (если таковая есть).\n* Опция командной `--model` строки.\n* Переменная среды `COPILOT_MODEL`.\n* Ключ `model` в конфигурационном файле (`~/.copilot/config.json` или `$COPILOT_HOME/.copilot/config.json`).\n* Стандартная модель CLI.\n\n## Использование кастомных агентов\n\nВы можете делегировать работу специализированному агенту, используя эту `--agent` опцию. Дополнительные сведения см. в разделе [Создание и использование пользовательских агентов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli).\n\nВ этом примере `code-review` используется агент. Для этого требуется, чтобы с этим именем был создан пользовательский агент.\n\n```bash\ncopilot -p \"Review the latest commit\" \\\n  --allow-tool='shell' \\\n  --agent code-review\n```\n\n## Дополнительные материалы\n\n* [GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli)\n* [Справочник команды GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}