{"meta":{"title":"Каталог конфигурации CLI GitHub Copilot","intro":"Найдите информацию о ~/.copilot каталоге, где Copilot CLI хранятся конфигурации, данные сессий и настройки.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/reference","title":"Справочные материалы"},{"href":"/ru/copilot/reference/copilot-cli-reference","title":"Ссылка Copilot CLI"},{"href":"/ru/copilot/reference/copilot-cli-reference/cli-config-dir-reference","title":"Каталог конфигурации CLI"}],"documentType":"article"},"body":"# Каталог конфигурации CLI GitHub Copilot\n\nНайдите информацию о ~/.copilot каталоге, где Copilot CLI хранятся конфигурации, данные сессий и настройки.\n\nCopilot CLI Хранит свою конфигурацию, историю сессий, журналы и настройки в одном каталоге на вашем компьютере. По умолчанию эта папка ( `~/.copilot` то есть `$HOME/.copilot`).\n\nВ этой статье описывается содержимое этого каталога и то, как им можно пользоваться.\n\n## Обзор каталога\n\nКаталог `~/.copilot` содержит следующие элементы верхнего уровня.\n\n| Путь | Тип | Описание |\n| ------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------- |\n| `agents/` | Directory | Определения персональных кастомных агентов |\n| `config.json` | Файл | Автоматически управляемое состояние приложения (аутентификация, установленные плагины и другие внутренние данные) |\n| `copilot-instructions.md` | Файл | Личные индивидуальные инструкции (применяются ко всем сессиям) |\n| `extensions/` | Directory | Персональные расширения, загруженные CLI |\n| `hooks/` | Directory | Скрипты с крючками на уровне пользователя |\n| `ide/` | Directory | Состояние интеграции IDE |\n| `installed-plugins/` | Directory | Установленные файлы плагинов |\n| `instructions/` | Directory | Дополнительные личные `*.instructions.md` дела |\n| `logs/` | Directory | Файлы журнала сессии |\n| `lsp-config.json` | Файл | Определения серверов LSP на уровне пользователя |\n| `mcp-config.json` | Файл | Определения серверов MCP на уровне пользователя |\n| `mcp-oauth-config/` | Directory | Резервное хранилище токена MCP OAuth и регистрационного резерва |\n| `mcp-secrets/` | Directory | Локальное резервное хранилище и индекс секретных заполнятелей MCP |\n| `permissions-config.json` | Файл | Сохранённые права на инструменты и каталоги для каждого проекта |\n| `plugin-data/` | Directory | Постоянные данные для установленных плагинов |\n| `session-state/` | Directory | История сессий и данные рабочего пространства |\n| `command-history-state/` | Directory | Данные истории командования |\n| `session-store.db` | Файл | База данных SQLite для данных между сессиями |\n| `settings.json` | Файл | Ваши личные настройки конфигурации |\n| `skills/` | Directory | Определения личных индивидуальных навыков |\n\n> \\[!NOTE]\n> Не все эти предметы появляются сразу. Некоторые создаются по запросу при первом использовании конкретной функции — например, `installed-plugins/` появляются только после установки первого плагина.\n\n## Файлы, редактируемые пользователем\n\nСледующие файлы предназначены для прямого редактирования вами или управления с помощью команд CLI.\n\n### `settings.json`\n\nЭто основной конфигурационный файл для Copilot CLI. В течение сессии вы можете использовать интерактивную `/settings` команду для изменения конкретных значений или запустить `/settings KEY VALUE` её для установки одного значения. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/customize-copilot/change-settings). В качестве альтернативы можно редактировать `settings.json` файл напрямую в текстовом редакторе. Файл поддерживает JSON с комментариями (JSONC).\n\nПо умолчанию этот файл находится в `~/.copilot` каталоге, который является пользовательской конфигурационной директорией. Он содержит глобальные пользовательские настройки по умолчанию для всех репозиториев. Вы можете изменить расположение этой директории, установив `COPILOT_HOME` переменную окружения на другой путь.\n\n> \\[!NOTE]\n> Настройки, редактируемые пользователем, изначально хранились в `config.json`. Они были перенесены на `settings.json`. Любые пользовательские настройки, появляющиеся при `config.json` запуске, автоматически мигрируются в `settings.json`.\n\nЕсли `settings.json` не удается прочитать, проанализировать или проверить, Copilot CLI игнорирует недопустимые значения (распознанные `config.json` значения по-прежнему объединяются) и отображает предупреждение о запуске на временной шкале, направляющие вас на вкладку `/settings`**\"Проблемы**\" команды. Откройте эту вкладку, чтобы увидеть конкретную ошибку, а затем исправьте сообщаемую проблему для восстановления затронутых параметров.\n\nЕсли `settings.json` содержит ключ верхнего уровня, который не является распознаваемым параметром (например, опечаткой), он отображается на вкладке `/settings`**\"Проблемы**\" Copilot CLI команды вместо временной шкалы или в stderr. Метка вкладки показывает количество (например, `Problems (2)`) при возникновении проблем с любой областью конфигурации.\n`$schema` допускается и никогда не сообщается.\n\nЕсли `~/.copilot/settings.json` это асимметричная ссылка, например для синхронизации параметров с помощью репозитория dotfiles, записи из `/settings` команды следуют симлинку и обновляют целевой объект вместо замены симлинка обычным файлом.\n\nПолный список настроек и их взаимодействие с конфигурацией на уровне репозитория см. [раздел «Настройки конфигурационных файлов](#configuration-file-settings) » позже в этой статье.\n\n> \\[!TIP]\n> Запусти `copilot help config` в терминале для быстрой справки.\n\n### `copilot-instructions.md`\n\nЛичные индивидуальные инструкции, которые применимы ко всем вашим сессиям, независимо от того, над каким проектом вы работаете. Этот файл работает так же, как репозиторий `copilot-instructions.md` , но применяется глобально.\n\nДополнительные сведения см. в разделе [Добавление пользовательских инструкций репозитория для GitHub Copilot](/ru/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).\n\n### `instructions/`\n\nЗдесь храните дополнительные личные инструкции в виде `*.instructions.md` файлов. Они загружаются вместе `copilot-instructions.md` и применяются ко всем вашим сессиям. Вы можете организовать инструкции по темам — например, `~/.copilot/instructions/code-style.instructions.md`.\n\n### `mcp-config.json`\n\nОпределяет серверы MCP (Model Context Protocol), доступные на уровне пользователя. Эти серверы доступны во всех ваших сессиях, независимо от того, в каком вы каталоге проектов. Project-уровневые конфигурации MCP (в `.mcp.json` или `.github/mcp.json`) имеют приоритет над определениями на уровне пользователя при конфликте имён серверов.\n\nДополнительные сведения см. в разделе [Добавление MCP-серверов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).\n\n### `lsp-config.json`\n\nОпределяет серверы Language Server Protocol (LSP), доступные на уровне пользователя. Эти серверы предоставляют агенту языковой интеллект (диагностику, завершение и т.д.). Управляйте этим файлом с помощью `/lsp` команды slash или редактируйте его напрямую.\n\nДополнительные сведения см. в разделе [Добавление серверов LSP для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/set-up-copilot-cli/add-lsp-servers).\n\n### `agents/`\n\nЗдесь храните личные определения пользовательских агентов в виде `.agent.md` файлов. Агенты, размещённые в этом каталоге, доступны во всех ваших сессиях. Агенты Project уровня (в `.github/agents/`) имеют приоритет перед личными агентами, если у них одинаковое имя.\n\nДополнительные сведения см. в разделе [Создание и использование пользовательских агентов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli).\n\n### `skills/`\n\nЗдесь храните личные индивидуальные определения навыков. Каждый навык находится в подкаталоге, содержащем `SKILL.md` файл — например, `~/.copilot/skills/my-skill/SKILL.md`. Личные навыки доступны во всех ваших сессиях. Навыки Project Level имеют приоритет над личными, если у них одинаковое название.\n\nДополнительные сведения см. в разделе [Добавление навыков агента для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-skills).\n\n### `hooks/`\n\nЗдесь можно хранить скрипты с крючками на уровне пользователя. Эти зацепки применимы ко всем вашим сессиям. Вы также можете задать крючки в строке в пользовательском конфигурационном файле (`~/.copilot/settings.json`) с помощью ключа `hooks` . Хуки уровня репозитория (in `.github/hooks/`) загружаются вместе с пользовательскими хуками.\n\nДополнительные сведения см. в разделе [Использование крючков с GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/use-hooks).\n\n### `extensions/`\n\nХраните файлы расширений пользовательского уровня здесь. Расширения в этом каталоге доступны между сессиями.\n\nВы можете создавать файлы в этой директории вручную или подготовить расширение, а затем редактировать сгенерированный файл.\n\n## Автоматически управляемые файлы\n\nСледующие пункты управляются CLI. Обычно не стоит редактировать их вручную.\n\n### `config.json`\n\nХранит внутреннее состояние приложения, которое автоматически управляется CLI, включая данные аутентификации, метаданные установленного плагина и другую информацию во время выполнения. Обычно редактировать этот файл не понадобится.\n\n> \\[!NOTE]\n> Ранние версии Copilot CLI хранили как пользовательские настройки, так и состояние приложения в `config.json`. Настройки, редактируемые пользователем, теперь расположены в `settings.json`. Любые пользовательские настройки `config.json` при запуске автоматически переносятся в `settings.json`. Поля прикладного состояния — такие `loggedInUsers`как , `installedPlugins`, `firstLaunchAt`, и `staff`— остаются в `config.json` и не мигрированы.\n\n### `permissions-config.json`\n\nСохраняет сохранённые решения по инструменту и разрешению каталога, организованные по расположению проекта. Когда вы одобряете инструмент или предоставляете доступ к каталогу текущего местоположения, CLI фиксирует решение здесь, чтобы вас больше не запросили в том же репозитории или каталоге.\n\n> \\[!NOTE]\n> Если вы хотите сбросить разрешения для проекта, вы можете удалить соответствующую запись из этого файла. Однако редактирование файла во время сессии может вызвать неожиданное поведение. CLI автоматически удаляет записи, путь к расположению которых больше не существует на диске.\n\n#### Расположение файла\n\nCopilot CLI Разрешает файл из каталога конфигурации.\n\n| Priority | Source | Используемый файл |\n| -------- | ------------------------ | --------------------------------------- |\n| 1 | `--config-dir=DIRECTORY` | `DIRECTORY/permissions-config.json` |\n| 2 | `COPILOT_HOME` | `$COPILOT_HOME/permissions-config.json` |\n| 3 | Default | `~/.copilot/permissions-config.json` |\n\nИнтерфейс командной строки использует только первый применимый каталог конфигурации в этом порядке. Он также не загружается `permissions-config.json` из расположений с более низким приоритетом.\n\nЭтот `--config-dir` вариант — наследие. Предпочитаю `COPILOT_HOME` , когда нужно менять каталог конфигурации.\n\nВ Windows стандартный файл обычно выглядит:\n\n```text\nC:\\Users\\YOUR-USER\\.copilot\\permissions-config.json\n```\n\nСтарые сборки использовали файл без расширения под названием `permissions-config`. Если `permissions-config.json` его нет, а файл без расширения есть, CLI всё равно учитывает наследственный файл. Используйте `permissions-config.json` для новых правок.\n\nПредыдущие локации конфигурации на базе XDG мигрируются `~/.copilot` при запуске, когда `COPILOT_HOME` она не настроена.\n\n#### Ключи местоположения\n\nОбъект верхнего уровня `locations` определяется абсолютным путём.\n\n* Для репозитория Git используйте корень Git, используемый для определения разрешений.\n* Связанные рабочие деревья разрешаются на основной корень репозитория, поэтому они разделяют права с основным деревом работы.\n* Подмодули используют собственную рабочую директорию.\n* Для каталога, который не входит в репозиторий Git, используйте нормализованный текущий рабочий каталог.\n\nКлюч должен совпадать с местом, где Copilot CLI он работает. Если ключ не совпадает, сохраненные одобрения не будут применяться.\n\nCLI загружает одобрения соответствующего места при начале сессии и изменении активного рабочего каталога.\n\n#### Схема\n\nФайл должен содержать объект JSON.\n\n| Поле | Тип | Обязательный | Default | Допустимые значения | Описание |\n| -------------------------------------------------------------------------------------------------------------------- | ----------------------- | ------------------------------------- | --------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `locations` | Object | Нет | `{}` | Ключи абсолютных путей | Карта ключей местоположения для сохраненных одобрений. |\n| `locations.` | Object | Нет | `{}` | Любой абсолютный ключ местоположения | Сохранены одобрения для одного репозитория или каталога. |\n| `locations..tool_approvals` | Массив | Нет | `[]` | Объекты утверждения | Инструменты одобрены для этого места. |\n| `locations..allowed_directories` | Массив строк | Нет | `[]` | Пути абсолютных каталогов | Дополнительные каталоги, к которым может получить доступ путевой врата для этого места. Каждый каталог должен существовать, когда CLI применяет конфигурацию. |\n| `locations..tool_approvals[].kind` | String | Да | None | | |\n| `commands`, `read``write``mcp``mcp-sampling``memory``custom-tool``extension-management``extension-permission-access` | Выбирает тип одобрения. | | | | |\n| `commandIdentifiers` | Массив строк | Да, для `commands` | None | Идентификаторы команд | Оболоченные идентификаторы команд для одобрения. |\n| `serverName` | String | Да, для `mcp` и `mcp-sampling` | None | Имя сервера MCP | MCP-сервер для одобрения. |\n| `toolName` | Строка или `null` | Да, для `mcp` | None | Название инструмента MCP, или `null` | Инструмент MCP для одобрения. Используйте `null` для одобрения всех инструментов на сервере. |\n| `toolName` | String | Да, для `custom-tool` | None | Пользовательское имя инструмента | Пользовательский инструмент для одобрения по точному названию. |\n| `operation` | String | Нет, для `extension-management` | Упущенный | Название операции расширения | Операция по управлению расширением для утверждения. Исключить это поле для утверждения всех операций по управлению расширением. |\n| `extensionName` | String | Да, для `extension-permission-access` | None | Имя расширения | Расширение, доступ к возможностям с ограничением разрешений одобрен. |\n\n`permissions-config.json` не поддерживает правила отказа, правила «спросить», режимы по умолчанию, правила URL, фильтрацию инструментов или совместную политику репозитория. Для таких действий используйте командные опции, такие `--deny-tool`как , `--available-tools`, `--excluded-tools``--allow-url`, и `--deny-url`. Правила сохранения URL хранятся в `settings.json`, а не в `permissions-config.json`.\n\nНеизвестные поля не входят в схему. CLI может их игнорировать, а последующие записи могут их удалять.\n\n#### Виды одобрения\n\nКаждый элемент должен `tool_approvals` быть одним из следующих объектов.\n\n| `kind` | Обязательные поля | Необязательные поля | Meaning |\n| ----------------------------- | -------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `commands` | `commandIdentifiers` | None | Одобряет совпадающие идентификаторы команд shell. |\n| `read` | None | None | Одобряет запросы на инструменты чтения. Интерактивные сессии CLI уже автоматически одобряют чтение, поэтому обычно это не обязательно. |\n| `write` | None | None | Одобряет запросы на создание и инструменты для модификации файлов. Запрос на путь всё равно может применяться для путей вне разрешённых каталогов. |\n| `mcp` | | | |\n| `serverName`, `toolName` | None | Одобряет один инструмент MCP или все инструменты на сервере, когда `toolName` это `null`. | |\n| `mcp-sampling` | `serverName` | None | Одобряет запросы на выборку MCP для одного сервера. |\n| `memory` | None | None | Одобряет запросы на запись и голосование по памяти. |\n| `custom-tool` | `toolName` | None | Одобряет кастомный инструмент под точным названием. |\n| `extension-management` | None | `operation` | Утверждает управление расширением. Если `operation` опущено, все операции управления расширением совпадают. |\n| `extension-permission-access` | `extensionName` | None | Одобряет доступ расширения к возможностям с ограничением разрешений. |\n\nДля одобрения MCP `serverName` должно точно совпадать с настроенным именем сервера MCP. Используйте сырое имя сервера из вашей конфигурации MCP, а не очищенный префикс имени инструмента.\n\n#### Сопоставление команд оболочки\n\n`permissions-config.json` не поддерживает регулярные выражения или общие шаблоны глобов. Строковые значения совпадают буквально, за исключением того, что `:*` значение оболочки `commandIdentifiers` соответствует тексту до `:*`того, как само по себе или за ним следует пробел и больше текста. Равнина `*` не имеет особого смысла, поэтому `git*` не соответствует `git status`.\n\n| Рисунок | Совпадения | Не соответствует |\n| ------------------------------------- | -------------- | -------------------- |\n| `git status` | `git status` | `git status --short` |\n| `git:*` | | |\n| `git`, , `git status``git push` | `gitea` | |\n| `gh pr:*` | | |\n| `gh pr`, , `gh pr view``gh pr create` | `gh repo view` | |\n\n#### Сопоставление каталогов\n\n`allowed_directories` Записи позволяют Copilot CLI получать доступ к путям внутри этих каталогов без отдельного запроса на путь. Они не одобряют саму работу инструмента. Например, редактирование файла в разрешённой папке всё равно может требовать `write` одобрения.\n\nКаждая `allowed_directories` запись должна быть абсолютной, непустой и доступной папкой. CLI разрешает симлинки перед сравнением путей, блокирует сетевые пути UNC, если они не являются локальными путями расширенной длины, сравнивает пути без падежа в Windows и сравнивает пути с учетом регистра на других платформах. Если запись не может быть применена, CLI фиксирует предупреждение и пропускает эту запись.\n\n#### Примеры\n\nРазрешите все подкоманды Git и получите доступ к дополнительной локальной директории:\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\"git:*\"]\n }\n ],\n \"allowed_directories\": [\"C:\\\\src\\\\shared-docs\"]\n }\n }\n}\n```\n\nРазрешите выбранные команды, всё ещё спрашивая перед записью файла:\n\n```json copy\n{\n \"locations\": {\n \"/Users/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\n \"git status\",\n \"git diff\",\n \"git log\",\n \"npm test\",\n \"npm run build\"\n ]\n }\n ]\n }\n }\n}\n```\n\nApprove file writes и один MCP-сервер для репозитория:\n\n```json copy\n{\n \"locations\": {\n \"/home/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"write\"\n },\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": null\n }\n ]\n }\n }\n}\n```\n\nОдобрить один MCP-инструмент, запись в памяти и доступ к разрешениям расширения:\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": \"search_code\"\n },\n {\n \"kind\": \"memory\"\n },\n {\n \"kind\": \"extension-permission-access\",\n \"extensionName\": \"my-extension\"\n }\n ]\n }\n }\n}\n```\n\n### `session-state/`\n\nСодержит данные истории сессий, организованные по идентификатору сессии в подкаталогах. Каждый каталог сессии хранит журнал событий (`events.jsonl`) и артефакты рабочего пространства (планы, контрольные точки, отслеживаемые файлы). Эти данные позволяют возобновить сессию (`--resume` или `--continue`).\n\nУдаление файлов из этой папки удаляет только локальные копии. Если у вас синхронизированы сессии с аккаунтом GitHub , синхронизированные данные хранятся отдельно и не зависят от локального удаления файлов. Вы можете удалить или скрыть синхронизированные сессии из GitHub.com. Дополнительные сведения см. в разделе [О GitHub Copilot CLI данных сессии](/ru/copilot/concepts/agents/copilot-cli/chronicle#managing-your-session-data).\n\n### `command-history-state/`\n\nСодержит данные истории команд, используемые для обратного поиска (Ctrl R+) и навигации по истории в интерактивном интерфейсе. Этот каталог управляется автоматически и не подлежит редактированию.\n\n### `session-store.db`\n\nБаза данных SQLite, используемая CLI для межсессионных данных, таких как индексация контрольных точек и поиск. Этот файл управляется автоматически и не должен редактироваться.\n\nЕсли вы удалите этот файл, его можно восстановить с помощью команды `/chronicle reindex` . Реиндексация также синхронизирует данные сессии с аккаунтом.\n\n### `logs/`\n\nСодержит лог-файлы для сессий CLI. Каждая сессия создаёт лог-файл с названием `process-{timestamp}-{pid}.log`. Эти файлы полезны для отладки.\n\nCLI также может создавать логи, специфичные для расширения, в разделе `logs/extensions/`.\n\nЭто отдельно от `~/.copilot/extensions/`, где хранится код расширений, созданный пользователем.\n\n> \\[!TIP]\n> Чтобы найти файл журнала вашей текущей сессии, зарегистрируйте `/session` интерактивную сессию. Вывод включает полный путь к файлу журнала, а также другие детали сессии, такие как идентификатор сессии, длительность и рабочий каталог.\n\n### `installed-plugins/`\n\nСодержит файлы для установленных вами плагинов. Плагины, установленные на маркетплейсе, хранятся в .`installed-plugins/{marketplace-name}/{plugin-name}/` Напрямую установленные плагины хранятся в .`installed-plugins/_direct/` Управляйте плагинами с `copilot plugin` помощью команд, а не редактировать эту папку напрямую.\n\nДополнительные сведения см. в разделе [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference).\n\n### `plugin-data/`\n\nСодержит постоянные данные для установленных плагинов, организованные по маркетплейсу и имени плагина. Эти данные управляются самими плагинами и не должны редактироваться вручную.\n\n### `ide/`\n\nСодержит файлы блокировки и состояние для интеграций с IDE (например, при Copilot CLI подключении к Visual Studio Code). Этот каталог управляется автоматически.\n\n### `mcp-oauth-config/`\n\nСодержит резервные файлы MCP OAuth, регистрационные и резервные файлы PKCE при недоступном хранилище, поддерживаемом брелоком. Этот каталог управляется автоматически.\n\n### `mcp-secrets/`\n\nСодержит резервное хранилище файлов и индекс секретных заполняющих MCP, когда хранилище с защитой связки ключей недоступно. Этот каталог управляется автоматически.\n\n## Изменение расположения каталога конфигурации\n\nЧтобы переопределить местоположение по умолчанию `~/.copilot` , установите `COPILOT_HOME` переменную среды на путь к нужной вам директории.\n\n```bash copy\nexport COPILOT_HOME=/path/to/my/copilot-config\n```\n\n### Вещи, которые следует учитывать\n\n* `COPILOT_HOME` заменяет весь `~/.copilot` путь. Значение должно быть полным путём к нужной директории, которую вы хотите использовать для конфигурационных файлов и подкаталогов.\n* Изменение каталога означает, что ваша существующая конфигурация, история сессий, установленные плагины и сохранённые права не будут найдены в новом месте. Скопируйте или переместите содержимое `~/.copilot` в новый адрес, если хотите сохранить его.\n* **Каталог кэша** (используемый для маркетплейс-кэшей, автоматического обновления пакетов и других временных данных) следует платформным конвенциям и не подвергается `COPILOT_HOME`влиянию . Он расположен по адресу:\n\n * **macOS:**`~/Library/Caches/copilot`\n * **Linux**: `$XDG_CACHE_HOME/copilot` или `~/.cache/copilot`\n * **Windows**:`%LOCALAPPDATA%/copilot`\n\n Чтобы отдельно переопределить каталог кэша, установите `COPILOT_CACHE_HOME`.\n\n## Что можно безопасно удалить\n\n| Элемент | Безопасно ли удалить? | Эффект |\n| ------------------------------------------ | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `agents/`, , `skills/``hooks/` | Не рекомендуется | Вы потеряете свои личные настройки. Сначала отойди. |\n| `config.json` | С осторожностью | Сбрасывает состояние приложения, включая аутентификацию. Вам потребуется повторная аутентификацию, и CLI повторно обнаружит внутреннее состояние при следующем запуске. |\n| `copilot-instructions.md`, `instructions/` | Не рекомендуется | Вы потеряете свои индивидуальные инструкции. Сначала отойди. |\n| `extensions/` | Не рекомендуется | Вы потеряете свои личные продления. Сначала отойди. |\n| `installed-plugins/` | Не рекомендуется | Используйте `copilot plugin uninstall` вместо этого, чтобы метаданные плагина `config.json` оставались точными. |\n| `logs/` | Да | Файлы журналов создаются заново каждую сессию. Удаление их не имеет функционального эффекта. |\n| `lsp-config.json` | Не рекомендуется | Вы потеряете определения сервера LSP на уровне пользователя. Сначала отойди. |\n| `mcp-config.json` | Не рекомендуется | Вы потеряете определения сервера MCP на уровне пользователя. Сначала отойди. |\n| `mcp-oauth-config/` | С осторожностью | Проходит через резервный штат MCP OAuu. Возможно, потребуется повторная аутентификация MCP-серверов. |\n| `mcp-secrets/` | С осторожностью | Очищает местное секретное резервное состояние MCP и карты. Серверы MCP с секретной поддержкой могут потребовать перенастройки. |\n| `permissions-config.json` | С осторожностью | Сбрасывает все сохранённые права. CLI снова подскаже вам одобрение инструментов и каталогов. |\n| `plugin-data/` | Да | Постоянные данные плагина создаются по мере необходимости. |\n| `session-state/` | С осторожностью | Удаление удаляет историю сессий. Вы больше не сможете возобновить прошлые занятия. |\n| `command-history-state/` | С осторожностью | Удаление удаляет историю команд. Вы больше не сможете искать предыдущие команды с помощью Ctrl+R. |\n| `session-store.db` | С осторожностью | Удаление удаляет данные между сессиями. Файл воссоздаётся автоматически. |\n| `settings.json` | С осторожностью | Все пользовательские настройки сбрасываются до стандартных настроек. Вам нужно будет перенастроить настройки. |\n\n## Настройки конфигурационных файлов\n\nНастройки применяются в следующем порядке (позже переопределяются раньше):\n\n\n\n1. Встроенные значения по умолчанию\n2. Управляемые настройки Mobile Управление устройствами (MDM)\n3. Пользовательские настройки (`~/.copilot/settings.json`)\n4. Настройки репозитория (`.github/copilot/settings.json`)\n5. Локальные настройки (`.github/copilot/settings.local.json`)\n6. Переменные среды\n7. Флаги командной строки\n\n\n\nУправляемые настройки MDM загружаются при запуске и объединяются с пользовательскими настройками как базовая база политики. Для большинства клавиш пользовательские настройки могут переопределить эту базовую линию. Для `permissions.disableBypassPermissionsMode`, MDM-значение `\"disable\"` всегда выигрывает. Для получения дополнительной информации см. [управляемые настройки MDM](#mdm-managed-settings).\n\n| Область действия | Location | Purpose |\n| ---------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| User | `~/.copilot/settings.json` | Глобальные стандарты для всех репозиториев. Используйте `COPILOT_HOME` переменную среды для указания альтернативного пути. |\n| Репозиторий | `.github/copilot/settings.json` | Конфигурация общего репозитория (фиксирована в репозитории). |\n| Local | `.github/copilot/settings.local.json` | Личные перемены (добавьте это к `.gitignore`). |\n\nCLI также читает и для общего кросс-инструментального подмножества настроек репозитория (таких `.claude/settings.json`как , `.claude/settings.local.json`, `companyAnnouncements`, `disableAllHooks`, и `enabledPlugins`).`extraKnownMarketplaces``hooks`\n\n### Пользовательские настройки (`~/.copilot/settings.json`)\n\nЭти настройки применимы ко всем вашим сессиям и репозиториям. Вы можете использовать `/settings` команду slash для запуска интерактивного диалога, или специальные команды для обновления отдельных значений, либо редактировать этот файл напрямую.\n\n| Ключ | Тип | Default | Описание |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedUrls` | `string[]` | `[]` | URL или домены разрешены без подсказки. Поддерживает точные URL-адреса, шаблоны доменов и поддомены с уайлдкардом (например, `\"*.github.com\"`). |\n| `askUser` | `boolean` | `true` | Позвольте агенту задавать уточняющие вопросы. Настроен `false` на полностью автономную работу. Также можно установить с `--no-ask-user`. |\n| `autoUpdate` | `boolean` | `true` | Автоматическое скачивание обновлений CLI и обновление сторонних подключаемых модулей в начале каждого сеанса. |\n| `autoUpdatesChannel` | | | |\n| `\"stable\"` | | | |\n| \\| | | | |\n| `\"prerelease\"` | | | |\n| `\"stable\"` | Канал обновлений. Настроен на `\"prerelease\"` получение обновлений до релиза. | | |\n| `banner` | | | |\n| `\"always\"` | | | |\n| \\| | | | |\n| `\"once\"` | | | |\n| \\| | | | |\n| `\"never\"` | | | |\n| `\"once\"` | Частота анимированного отображения баннеров. | | |\n| `bashEnv` | `boolean` | `false` | Включите `BASH_ENV` поддержку bash-shells. Также можно задать с `--bash-env` помощью или `--no-bash-env`. |\n| `beep` | `boolean` | `true` | Воспроизведите звуковой сигнал, когда требуется внимание. |\n| `beepOnSchedule` | `boolean` | `true` | Воспроизведите звуковой сигнал, когда запланированный `/every` или `/after` забег заканчивается. |\n| `builtInAgents.rubberDuck` | `boolean` | `true` | Включить субагент «резиновая утка», который даёт противоположную обратную связь по планам агента. |\n| `builtInAgents.rubberDuckAutoInvoke` | `boolean` | `false` | Включите проактивное подсказывание для автоматического вызова резиновой утки. Настроен на `true` дополнительные подталкивания в виде резиновой утки во время поворотов агента. |\n| `colorMode` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Устаревший псевдоним для `theme`. Предпочитать `theme`. | | |\n| `commandHistoryMaxSize` | `number` | `50` | Максимальное количество последних команд, сохраненных для журнала ввода и обратного поиска. Должно быть целым числом между `1` и `1000`. |\n| `compactPaste` | `boolean` | `true` | Свернуть большие пасты (более 10 строк) в компактные токены. |\n| `companyAnnouncements` | `string[]` | `[]` | Пользовательские сообщения отображаются случайным образом при запуске. Одно сообщение выбирается случайным образом каждый раз при запуске CLI. Полезно для командных объявлений или напоминаний. |\n| `continueOnAutoMode` | `boolean` | `false` | Автоматически переключается в автоматический режим при ограничении скорости. Когда `true`ошибки допустимого лимита скорости вызывают автоматическое переключение в авторежим и повторную попытку. Это не относится к глобальным тарифным лимитам или провайдерам BYOK. |\n| `copyOnSelect` | `boolean` | | |\n| `true` (macOS), `false` (другое) | Автоматически скопируйте выбранный мышью текст в системный буфер обмена. | | |\n| `customAgents.defaultLocalOnly` | `boolean` | `false` | Используйте только локальные кастомные агенты (без удалённых агентов организации или корпоративных агентов). |\n| `deniedUrls` | `string[]` | `[]` | URL или домены, которые всегда отклоняются. Правила отказа имеют приоритет над правилами допуска. |\n| `disableAllHooks` | `boolean` | `false` | Отключите все хуки (как на уровне репозитория, так и на уровне пользователя). |\n| `disabledMcpServers` | `string[]` | `[]` | Имена серверов MCP нужно отключить. Указанные серверы настроены, но не запущены. |\n| `disabledSkills` | `string[]` | `[]` | Имена навыков нужно отключить. Перечисленные навыки открываются, но не загружаются. |\n| `dynamicRetrieval` | `{ skills?: boolean }` | сбросить | Управление по категориям динамического поиска инструкций на основе вложения. Настройте `skills` на `false` отключение поиска навыков. |\n| `effortLevel` | `string` | `\"medium\"` | Уровень усилий для рассуждения для расширенного мышления: `\"low\"`, `\"medium\"`, `\"high\"`, или `\"xhigh\"`. Более высокие уровни требуют больше вычислений. |\n| `enabledMcpServers` | `string[]` | `[]` | Включите встроенные серверы MCP, отключенные по умолчанию. |\n| `enabledPlugins` | `Record` | `{}` | Автоматическая установка декларативного плагина. Клавиши — это спецификации плагинов; значения — `true` (включено) или `false` (отключено). |\n| `experimental` | `boolean` | `false` | Включить экспериментальные функции. Также можно включить с `--experimental` помощью командной строки или `/experimental` команды слэш. |\n| `extraKnownMarketplaces` | `Record` | `{}` | Дополнительные маркетплейсы плагинов. Каждый ключ — это имя Marketplace; значение указывает обязательный `source` (`\"directory\"`, `\"git\"`или `\"github\"`). Установите `autoUpdate: true` для записи, чтобы выбрать установленные подключаемые модули Marketplace в автоматическое обновление сеанса, то же самое, что и сторонние подключаемые модули. Эта возможность применяется только к интерактивным сеансам, `-p` а сеансы SDK и сервера не обновляются автоматически. Согласие учитывается при установке в собственных параметрах пользователя или в управляемых параметрах (MDM/server). При столкновении с тем же именем встроенная первая сторона Marketplace выигрывает, а затем управляемую запись (которая заменяет всю ту же именованную запись пользователя, поэтому управляемая запись без `\"autoUpdate\": true` удаления согласия пользователя), а затем собственная запись пользователя. |\n| `footer` | `object` | — | Управляет, какие предметы появляются в строке статуса. Подключения включают `showModelEffort`, `showDirectory`, `showBranch`, `showContextWindow`, `showQuota`, `showAgent`, `showAiUsed``showCodeChanges``showUsername``showSandbox``showYolo`, и `showCustom` (все ).`boolean` Управляется командой `/statusline` слэша. |\n| `hooks` | `object` | — | Встроенные определения хуков на уровне пользователя, с ключом по названию события. Использует ту же схему, что и `.github/hooks/*.json` файлы. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). |\n| `ide.autoConnect` | `boolean` | `true` | Автоматически подключайтесь к рабочему пространству IDE при запуске. Когда `false`, вы всё ещё можете подключиться вручную с помощью команды `/ide` . |\n| `ide.openDiffOnEdit` | `boolean` | `true` | Открывайте дифференциации редактирования файлов в подключённом IDE для утверждения. Когда `false`, одобрения редактирования файлов отображаются только в терминале. |\n| `includeCoAuthoredBy` | `boolean` | `true` | Добавьте `Co-authored-by` трейлер к git-коммитам, сделанным агентом. |\n| `keepAlive` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| \\| | | | |\n| `\"busy\"` | | | |\n| `\"off\"` | Режим keep-alive применяется при запуске CLI. | | |\n| `\"on\"` Всегда препятствует системе спящей, `\"busy\"` не даёт спящему только во время работы агента и `\"off\"` отключает поддержание жизни. Также можно настраивать с `/keep-alive` помощью команды слэша. | | | |\n| `logLevel` | | | |\n| `\"none\"` | | | |\n| \\| | | | |\n| `\"error\"` | | | |\n| \\| | | | |\n| `\"warning\"` | | | |\n| \\| | | | |\n| `\"info\"` | | | |\n| \\| | | | |\n| `\"debug\"` | | | |\n| \\| | | | |\n| `\"all\"` | | | |\n| \\| | | | |\n| `\"default\"` | | | |\n| `\"default\"` | Веду многословность. | | |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| — | Стратегия разрешения конфликтов для `/pr fix conflicts`. При установке в `\"rebase\"`, конфликты разрешаются путем перебазировки на базовую ветвь. При установке в `\"merge\"`, базовая ветвь объединяется с ветвью признаков. Если не настроено, отображается диалог picker. | | |\n| `model` | `string` | изменяется | Модель искусственного интеллекта для использования. Настройте `\"auto\"` так, чтобы автоматически Copilot выбирать лучшую доступную модель. Управляется командой `/model` слэша. |\n| `mouse` | `boolean` | `true` | Включите поддержку мыши. Также можно задать с `--mouse` помощью или `--no-mouse`. |\n| `permissions.disableBypassPermissionsMode` | `string` | — | Установите для `\"disable\"` подавления всех флагов allow-all (`--allow-all-tools`, `--allow-all-paths`, `--allow-all-urls`, `--allow-all`) при запуске, `--yolo`чтобы их нельзя было использовать для предоставления повышенных разрешений. Установите для `\"allow-auto-only\"` блокировки полного разрешения во время разрешения `/allow-all auto` (автоматическое утверждение с поддержкой LLM). См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options). |\n| `pinnedPrompts` | `boolean` | `true` | Закрепите запрос пользователя текущего раздела непосредственно под верхней панелью при прокрутке временной шкалы, поэтому он остается ясным, к каким запросам относится видимый результат. Только пользовательский интерфейс CLI не влияет на запросы, отправленные в модель. |\n| `powershellFlags` | `string[]` | `[\"-NoProfile\", \"-NoLogo\"]` | Флаги передавались в PowerShell при запуске. В Windows CLI предпочитает PowerShell 7+ (`pwsh`) и возвращается к Windows PowerShell (`powershell.exe`), когда `pwsh` недоступен. Только для Windows. |\n| `proxyKerberosServicePrincipal` | `string` | сбросить | Имя принципа сервиса (SPN) для аутентификации прокси Kerberos/Negotiate, переопределяя производное `HTTP/`. |\n| `proxyUrl` | `string` | сбросить | Прокси-URL для HTTP(S)-запросов (например, `http://proxy.corp.example:3128`). Переопределяется `HTTP_PROXY` переменными окружающей среды или `HTTPS_PROXY` (любой корпус). |\n| `remote` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| `\"on\"` | Контролирует синхронизацию сессий и удалённый доступ. Настройте так, `\"off\"` чтобы данные сессии оставались локальными и отключили удалённое управление. Также можно задать с `--remote` помощью или `--no-remote`. | | |\n| `renderHexColors` | `boolean` | `true` | Отображение шестизначных шестнадцатеричных цветовых кодов, написанных как встроенный код (например, `` `#FF0000` ``) в виде цветовых образцов. |\n| `renderMarkdown` | `boolean` | `true` | Render Markdown на выходе терминала. |\n| `remoteExport` | `boolean` | `true` | Экспортируйте сессии удалённо, когда доступна синхронизация сессий. По `false` умолчанию установлен отказ от удалённого экспорта. Настройка `remoteSessions` , установленная на `true`, или флаг `--remote` , всё равно включает экспорт и управление вне зависимости от этой настройки. |\n| `respectGitignore` | `boolean` | `true` | Исключите gitignored файлы из выбора `@` упоминаний файлов. Когда `false`, picker включает файлы, обычно исключаемые .`.gitignore` |\n| `sandbox.allowBypass` | `boolean` | `true` | Разрешите изолированным командам запрашивать обход для определенных операций (создает запрос на разрешение), чтобы такие инструменты, как `grep` и `glob` работа, когда песочница в противном случае блокировала их. Установите для `false` отказа. |\n| `sandbox.enabled` | `boolean` | `false` | Ограничить команды оболочки, серверы MCP/LSP и встроенные файлы или веб-инструменты в изолированной среде с ограниченным доступом к файловой системе и сети. Включите его из диалогового `/sandbox` окна или с помощью `/sandbox enable`. |\n| `sandbox.auth.git` | `boolean` | `true` | Вставьте учетные данные Git в песочницу, чтобы команды, выполняемые внутри него, могли пройти проверку подлинности с помощью Git. Установите для `false` отказа. Переименован из `sandbox.gitAuth`; старый ключ не имеет миграции и игнорируется везде, где он по-прежнему отображается. |\n| `sandbox.auth.gh` | `boolean` | `true` | Вставьте GitHub CLI () учетные данные в песочницу, чтобы команды, выполняемые внутри него, могли пройти проверку подлинности с помощью `gh`.GitHub CLI Установите для `false` отказа. Переименован из `sandbox.ghAuth`; старый ключ не имеет миграции и игнорируется везде, где он по-прежнему отображается. |\n| `sandbox.userPolicy.network.allowLocalNetwork` | `boolean` | `true` | Разрешить изолированным командам доступ к адресам локальной сети (например, локальным серверам разработки). Установите для `false` отказа. |\n| `sandbox.userPolicy.network.proxy` | `object` | сбросить | Маршрутизация изолированного сетевого трафика через прокси-сервер HTTP. Поля: `url` (обязательно), `username` (необязательно), `password` (необязательно). Настройте его на вкладке `/sandbox`**\"Сеть** \" диалогового окна, которая маскирует поле пароля. Сам пароль хранится в цепочке ключей ОС, а не в `settings.json`, поэтому он не редактируется с помощью `/settings`. В Linux и macOS прокси-сервер работает совместно (не строго применяется); Windows применяет его. |\n| `sandbox.userPolicy.deniedPaths` | `string[]` | `[]` | Пути, к которым запрещен доступ изолированные команды. В Windows серверная часть песочницы ProcessContainer не может применять правила запрета на путь, поэтому записи не `deniedPaths` влияют на защиту конфиденциального каталога на Windows. |\n| `sandbox.userPolicy.seatbelt.keychainAccess` | `boolean` | `false` | только macOS. Предоставьте изолированным командам доступ к цепочке ключей системы. Можно также переключать из диалогового `/sandbox` окна. |\n| `screenReader` | `boolean` | `false` | Включите оптимизацию экранных читателей. |\n| `scrollbar` | `boolean` | `true` | Покажите полосу прокрутки в режиме прокрутки. Настройте на `false` скрытие и используйте всю ширину клеммы. |\n| `shellShortcut` | `boolean` | `true` | Пусть одинокий `$` в запросе, за которым следует ВВОД, откройте интерактивную оболочку, корневую в рабочем каталоге сеанса (активирует только для локального, доверенного, простоя сеанса в реальном TTY). Только для пользователей или управляемых областей— не переопределяемый репозиторий. |\n| `showTimestamps` | `boolean` | `true` | Отображение меток `HH:mm` времени рядом с пользовательскими сообщениями на временной шкале. |\n| `showTipsOnStartup` | `boolean` | `true` | Показывайте случайную подсказку команд при запуске CLI. |\n| `skillDirectories` | `string[]` | `[]` | Дополнительные каталоги для поиска определений пользовательских навыков (в дополнение к `~/.copilot/skills/`). |\n| `statusLine` | `object` | — | Пользовательский отбор строки статуса. |\n| `type`: должно быть `\"command\"`. | | | |\n| `command`: путь к исполняемому скрипту, который принимает session JSON на stdin и печатает статус-контент в stdout. | | | |\n| `padding`: необязательное количество пробелов с левым заполнением. | | | |\n| `refreshInterval`: необязательное целое число секунд (`1`–`2147483`) для повторного выполнения команды таймера вместо событий; опустите его, чтобы обновить только при изменении состояния сеанса. Если команда не сможет разрежена, завершает работу без нуля или не получает состояние JSON в stdin, интерфейс командной строки записывает предупреждение один раз на каждый эпизод непрерывного сбоя и оставляет строку состояния пустой, а не автоматически. Выполните команду, `--log-level all` чтобы просмотреть основные сведения об ошибке. | | | |\n| `stayInAutopilot` | `boolean` | `true` | Оставаться в режиме автопилота после завершения каждой задачи. При включении следующего запроса после завершения задачи также обрабатывается в режиме autopilot. Дополнительные сведения см. в разделе [Позволяя GitHub Copilot CLI работать автономно](/ru/copilot/concepts/agents/copilot-cli/autopilot#staying-in-autopilot-mode-between-tasks). |\n| `storeTokenPlaintext` | `boolean` | `false` | Разрешить хранить токены аутентификации в открытом тексте, `config.json` когда системный ключ недоступен. |\n| `stream` | `boolean` | `true` | Включите потоковые ответы. |\n| `streamerMode` | `boolean` | `false` | Скрытие имен моделей предварительного просмотра, сведений о квоте, меток времени запроса и уведомления об обновлении. Полезно при демонстрации Copilot CLI или совместном использовании экрана. |\n| `subagents.agents` | `object` | `{}` | Конфигурация модели для каждого агента, с ключом по имени агента. Каждое значение является объектом с необязательными `model` полями (строка), `effortLevel` (строка) и `contextTier` (`\"default\"`, `\"long_context\"`, или `\"inherit\"`) поля. Установите любое поле так, `\"inherit\"` чтобы использовать значение родительской сессии во время отправки. Используйте `/subagents` команду slash для интерактивной настройки этих настроек. |\n| `subagents.disabledSubagents` | `string[]` | `[]` | Имена агентов, чтобы не быть отправленными. Только `rubber-duck` агент нельзя отключить через эту настановку. Все остальные встроенные агенты — включая `explore`, `task`, `code-review`, `general-purpose``research`, , и `security-review`— могут быть отключены. |\n| `subagents.maxConcurrency` | `number` | на основе плана | Максимальное число параллельных подагентов для этого сеанса. Учитывается только для пользователей выставления счетов на основе использования; игнорируется для всех остальных планов. Обрезанный в `32`. См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits). |\n| `subagents.maxDepth` | `number` | `6` | Максимальная глубина вложения субагентов. Учитывается только для пользователей выставления счетов на основе использования; игнорируется для всех остальных планов. Обрезанный в `256`. См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits). |\n| `tabs.enabled` | `boolean` | `true` | Покажите панель вкладок главной комнаты. Настроил `false` на то, чтобы полностью это скрыть. |\n| `tabs.hide` | `string[]` | `[]` | Идентификаторы вкладок для скрытия. Принятые значения: `\"copilot\"`, `\"agents\"`, `\"issues\"`, `\"pull-requests\"``\"gists\"` , (совпадение без падежа). |\n| `tabs.sort` | `string[]` | `[]` | Порядок отображения вкладок. Вкладки, не указанные, сохраняют свой относительный порядок по умолчанию после перечисленных вкладок. Неизвестные идентификаторы игнорируются. |\n| `terminalProgress` | `boolean` | `true` | Emit OSC 9; 4 индикатора прогресса терминала, пока агент работает. Поддерживаемые терминалы включают Терминал Windows, iTerm2, Ghostty и ConEmu. |\n| `theme` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Цветовая палитра для выходных данных терминала. Управляется командами `/settings` и `/theme` слэш. | | |\n| `colorMode` является устаревшим псевдонимом для этого параметра. | | | |\n| `toolSearch` | `boolean` | Зависящие от модели и признаков | Поиск инструментов управления (отложенная загрузка инструментов). Настройте `toolSearch: false` на отказ от поиска по инструментам. |\n| `updateTerminalTitle` | `boolean` | `true` | Покажите текущее намерение во вкладке терминала или в заголовке окна. |\n| `worktreeBaseRef` | | | |\n| `\"head\"` | | | |\n| \\| | | | |\n| `\"defaultBranch\"` | | | |\n| `\"head\"` | Отправная точка для новых рабочих полос, созданных `/worktree`, `/worktree new`и `--worktree`. | | |\n| `\"defaultBranch\"` начинается с удаленной ветви по умолчанию вместо текущего выхода. | | | |\n\n> \\[!TIP]\n> Выполните `copilot help sandbox` полный справочник по песочнице, включая поддерживаемые узлы и все `sandbox` ключи параметров.\n\nГруппы `/sandbox` диалогов `git``gh`и доступ к цепочке ключей на выделенной вкладке **проверки подлинности** и `settings.json` путь, по которому хранится текущая конфигурация песочницы. Нажмите клавиши CTRL+E в `/sandbox` диалоговом окне, чтобы сохранить ожидающие изменения и открыть `settings.json` его в редакторе (`COPILOT_EDITOR`или`VISUAL``EDITOR`) с одинаковым ярлыком`/settings`. Диалоговое окно перезагрузит его состояние с диска после изменения и сохранения файла.\n\nПесочница поддерживается [Microsoft контейнер eXecution (MXC),](https://github.com/microsoft/mxc) который предоставляет серверные серверы, зависящие от платформы.\nCopilot CLIиспользуется Seatbelt в macOS, Bubblewrap в Linux и ProcessContainer на Windows.\n\n### Настройки репозитория (`.github/copilot/settings.json`)\n\nНастройки репозитория применимы ко всем, кто работает в репозитории. Они привержены хранилищу и делятся ими с сотрудниками.\n\n> \\[!NOTE]\n> Ключи, связанные с плагинами, в конфигурационном файле репозитория (`enabledPlugins` и ) также считываются не только `extraKnownMarketplaces`Copilot cloud agent.Copilot CLI Это позволяет активировать одни и те же плагины для обоих клиентов из одного файла. Для получения дополнительной информации о плагинах см. [О GitHub Copilot плагинах](/ru/copilot/concepts/agents/about-plugins).\n\nНа уровне репозитория поддерживаются только ключи, перечисленные в следующей таблице. Любые другие ключи — включая те, что действительны в пользовательском конфигурационном файле — молча игнорируются. Каждый поддерживаемый ключ имеет политику направления слияния, которая сохраняет переопределение сбоем и безопасно.\n\n| Ключ | Тип | Поведение слияния | Описание |\n| ----------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `companyAnnouncements` | `string[]` | Замена — репозиторий имеет приоритет | Сообщения появляются случайно при запуске. |\n| `contextTier` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"long_context\"` | | | |\n| Замена — репозиторий имеет приоритет | Закрепление уровня контекста по умолчанию. | | |\n| `deniedUrls` | `string[]` | Объединение— репозиторий может добавлять записи, никогда не удалять | URL-адреса или домены заблокированы. |\n| `disableAllHooks` | `boolean` | Репозиторий имеет приоритет | Отключите все крючки. |\n| `disabledMcpServers` | `string[]` | Объединение— репозиторий может добавлять записи, никогда не удалять | Серверы MCP настроены, но не запущены. |\n| `disabledSkills` | `string[]` | Объединение— репозиторий может добавлять записи, никогда не удалять | Навыки обнаружены, но не загружены. |\n| `effortLevel` | `string` | Замена — репозиторий имеет приоритет | Закрепление усилий по умолчанию по поводу причин. |\n| `enabledPlugins` | `Record` | Merged — репозиторий переопределяет пользователя для того же ключа | Автоматическая установка декларативного плагина. |\n| `extraKnownMarketplaces` | `Record` | Merged — репозиторий переопределяет пользователя для того же ключа | Маркетплейсы плагинов, доступные в этом репозитории. Требуется каждая запись `source` . Запись `autoUpdate: true` принимается на уровне репозитория, но в настоящее время игнорируется— автоматическое обновление учитывается только при установке параметров пользователя или в параметрах управляемого (MDM/server). |\n| `hooks` | `object` | Merged — репозиторий переопределяет пользователя для того же ключа | Определения крючков, ограниченные этим репозиторием. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). |\n| `includeCoAuthoredBy` | `boolean` | Замена — репозиторий имеет приоритет | |\n| `Co-authored-by` Добавьте трейлер для фиксаций. | | | |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| Замена — репозиторий имеет приоритет | Стратегия разрешения конфликтов для `/pr fix conflicts`. | | |\n| `model` | `string` | Замена — репозиторий имеет приоритет | Закрепление модели по умолчанию для этого репозитория. |\n| `respectGitignore` | `boolean` | Только для ужесточения— репозиторий может включать, никогда не отключать | Исключите gitignored файлы из выбора `@` упоминаний файлов. |\n\n`model`, `effortLevel`и `contextTier` переопределения применяются только в том случае, если рабочий каталог [является доверенным](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools).\n\nПодключаемый модуль, включенный только через репозиторий `enabledPlugins` , ограничен этим репозиторием: он автоматически устанавливает и активирует в декларируемом репозитории, но остается отключенным глобально, поэтому он никогда не активируется в не связанных проектах. Выход из репозитория или репозиторий, отключающий подключаемый модуль, удаляет сервер MCP и деактивирует агенты и навыки сеанса.\n\n### Список разрешений моделей уровня репозитория (`.github/allowed_models.txt`)\n\nОграничение того, какие встроенные модели репозитория могут использовать с списком `.github/allowed_models.txt`разрешений обычного текста, разрешенным из корневого каталога текущего рабочего каталога (или рабочего каталога за пределами репозитория).\n\nКаждая строка — это шаблон глоба, соответствующий идентификаторам модели, или `fallback:` директива, именующая модель, используемую, если настроенная или запрошенная модель не разрешена:\n\n```text\n# .github/allowed_models.txt\nfallback: gpt-5.2\ngpt-5.2\ngpt-5.4\nclaude-sonnet-*\n```\n\n| Правило | Описание |\n| -------------------- | ----------------------------------------------------------------------------------------- |\n| `*` | Разрешить все модели (по умолчанию, если файл отсутствует). |\n| `MODEL-ID` | Разрешить точный идентификатор модели. |\n| `GLOB-PATTERN` | Разрешить идентификаторы модели, соответствующие глобу (например, `claude-sonnet-*`). |\n| `fallback: MODEL-ID` | Требуется ровно один раз. Модель используется, если активная модель Copilot не разрешена. |\n| `#` | Строка комментариев. |\n\nНегабаритные шаблоны () не поддерживаются, резервная модель должна быть точным идентификатором (`!pattern`а не глобом), а резервная модель должна соответствовать одной из настроенных глобов.\nCopilot CLI Повторно оценивает политику `/cd` и отклоняет недопустимый файл с ошибкой перед выполнением.\n\nСписок разрешений управляет только Copilotвстроенными моделями. Не удается отфильтровать пользовательские модели, добавленные с помощью метода \"Ключи API\" (BYOK). Модели BYOK остаются в списке и выбираются независимо от настроенных шаблонов, и `fallback:` директива никогда не применяется к ним. Дополнительные сведения см. в разделе \\[AUTOTITLE и [Включение пользовательских моделей для GitHub Copilot в организации](/ru/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models)]\\(/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models).\n\n### Локальные настройки (`.github/copilot/settings.local.json`)\n\nСоздайте `.github/copilot/settings.local.json` в репозитории личные перемены, которые не должны быть коммитированы. Добавить этот файл в `.gitignore`.\n\nЛокальный конфигурационный файл использует ту же схему, что и файл конфигурации репозитория (`.github/copilot/settings.json`), и имеет приоритет над ней.\n\n## Управляемые настройки MDM\n\nИТ-администраторы могут запускать базовую политику с помощью управляемых настроек Mobile Управление устройствами (MDM) вместо необходимости конфигурации для каждого пользователя. Эти настройки применяют устройства по умолчанию для поддерживаемых клавиш и загружаются до пользовательских настроек.\n\nCopilot CLI также загружает параметры, управляемые сервером при запуске, в дополнение к MDM. Параметры, управляемые устройством (MDM) и управляемые сервером, разрешаются **на один ключ**: значение MDM выигрывает для всех заданных ключей, а значение сервера заполняется ключами MDM не задано. Это позволяет организации задать определенную политику с помощью MDM (например, `permissions`), получая другие управляемые значения по умолчанию (например, `model`) с сервера.\n\nДлительные сеансы повторно извлекает и повторно применяет управляемые параметры почасово, поэтому изменения политики, например, организация, включающая `permissions.disableBypassPermissionsMode`, вступают в силу без перезапуска сеанса.\n\n### Источники управляемых настроек MDM\n\nCopilot CLI читает управляемые настройки из специализированных для платформы MDM или файловых локаций.\n\n| Platform | Тип источника | Location |\n| -------- | ------------- | ------------------------------------------------------------------ |\n| macOS | Plist MDM | `com.github.copilot` |\n| macOS | Файл | `/Library/Application Support/GitHubCopilot/managed-settings.json` |\n| Windows | Реестр MDM | `HKLM\\SOFTWARE\\Policies\\GitHubCopilot` |\n| Windows | Файл | `%ProgramFiles%\\GitHubCopilot\\managed-settings.json` |\n| Linux | Файл | `/etc/github-copilot/managed-settings.json` |\n\n> \\[!NOTE]\n> В системах Copilot CLI POSIX отклоняет управляемые настройки на основе файлов, которые являются символическими ссылками, не принадлежащими root, или записываемыми по всему миру.\n\n### Формат файла\n\nПишите управляемые настройки на основе файлов в формате JSON.\n\n```json\n{\n \"model\": \"auto\",\n \"permissions\": {\n \"disableBypassPermissionsMode\": \"disable\"\n }\n}\n```\n\n> \\[!NOTE]\n> `model` — это ключ верхнего уровня. Старые конфигурации, вложенные в нее по-прежнему `permissions.model` работают, — среда выполнения возвращается в это расположение, когда ключ верхнего уровня `model` отсутствует, но записывает новые конфигурации на `model` верхнем уровне.\n\n### Поддерживаемые ключи\n\nВ управляемых настройках MDM поддерживаются только следующие ключи.\n\n| Ключ | Описание |\n| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedMcpServers` | Список разрешенных пользователей серверов MCP может загружаться, сопоставляется `serverUrl``serverCommand``serverName`или . Доверенные сторонние серверы (например, встроенный GitHub сервер MCP) всегда освобождаются. Если этот ключ не задан, все серверы, не используемые по умолчанию; Пустой массив отрицает все из них. См. [список разрешений и запретов управляемого сервера MCP](#managed-mcp-server-allowdeny-list). |\n| `deniedMcpServers` | Список запретов серверов MCP, которые никогда не должны загружаться, совпадают с тем же способом, что `allowedMcpServers`и серверы MCP. Соответствующий сервер, не используемый по умолчанию, блокируется независимо от списка разрешений. Запрет всегда выигрывает. См. [список разрешений и запретов управляемого сервера MCP](#managed-mcp-server-allowdeny-list). |\n| `enabledPlugins` | Включите или отключите определённые плагины |\n| `extraKnownMarketplaces` | Добавьте доверенные маркетплейсы плагинов |\n| `forceRemoteSettingsRefresh` | Требуется получение новых параметров, управляемых сервером, при запуске, даже если существует новая кэшированная политика. Кэшированные записи по-прежнему сохраняются в качестве резервной версии, если получение завершается ошибкой. Значение устройства (MDM) имеет приоритет над кэшируемым значением сервера. |\n| `model` | Установите модель по умолчанию для всех пользователей (переопределенную флагом `--model` или моделью возобновления сессии) |\n| `permissions` | Задайте управляемые разрешения, включая `disableBypassPermissionsMode` и `deny` / `ask` / `allow` массивы правил. См. [правила управляемого разрешения](#managed-permission-rules). |\n| `policyHelper` | Зарегистрируйте исполняемый файл, предоставляющий уровень управляемых параметров с наименьшим приоритетом. Поля: `path` (обязательно), а также необязательные `args`, `timeoutMs`и `refreshIntervalMs`. Если устройство (MDM) и политика сервера регистрируются `policyHelper`, регистрация устройства выигрывает. |\n| `remoteControl` | Управление тем, можно ли управлять сеансами на этом устройстве с других устройств. |\n| `mode` is `\"enabled\"`, `\"disabled\"`or `\"requireSSO\"` (требуется `githubDotComOrganizations` , если задано). | |\n| `shellShortcut` | Принудительное включение или принудительное отключение ярлыка интерактивной `$` оболочки для всех пользователей. Управляемое значение всегда переопределяет собственный `shellShortcut` параметр пользователя. |\n| `strictKnownMarketplaces` | Ограничьте плагины известными маркетплейсами |\n| `telemetry` | Отправка базовой конфигурации экспорта OpenTelemetry: `enabled`, `endpoint`, `protocol`, `headers`, `resourceAttributes`, `captureContent``lockCaptureContent`и `serviceName`. См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring). |\n\n> \\[!NOTE]\n> `policyHelper.path` принимает абсолютный путь, относительный путь`~/...` () или имя программы, разрешенное `PATH`без доступа. Другие относительные формы отклоняются. Регистрация принимается и проверяется, но среда выполнения пока не вызывает вспомогательный сервер — вспомогательный процесс выполнения в будущем выпуске.\n\n> \\[!NOTE]\n> Если `remoteControl.mode` есть `\"requireSSO\"`, перечислить разрешенные организации в `remoteControl.githubDotComOrganizations`. Клиент должен быть авторизованным единым входом по крайней мере для одной из перечисленных GitHub.com организаций— он больше не должен быть авторизован для всех из них.\n\n> \\[!NOTE]\n> `\"disable\"` Установите значение `permissions.disableBypassPermissionsMode` в управляемых параметрах MDM, чтобы применить ограничение на уровне устройства. Параметры учетной записи не могут переопределить эту политику. Присвойте ему значение, чтобы `\"allow-auto-only\"` заблокировать полную эскалацию разрешений во время `/permissions assisted` разрешения (утверждение разрешений с поддержкой LLM). Если задано нераспознанное значение, интерфейс командной строки регистрирует проблему и применяется `\"disable\"` в качестве неисправного по умолчанию, поэтому неправильно сформированная управляемая политика по-прежнему ограничивает параметры разрешения всех, а не автоматически разрешать их. См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options).\n\n> \\[!NOTE]\n> Большинство управляемых ключей блокируют всю строку: локальное изменение автоматически переопределяется управляемым значением при следующей загрузке.\n> `enabledPlugins` и `extraKnownMarketplaces` это исключение— управляемый слой объединяет эти карты с собственными записями по полю вместо того, чтобы заменить их прямо. Это означает, что блокировка применяется **для каждой записи**, а не ко всему ключу: подключаемый модуль или Marketplace, закрепленный управляемой политикой, не может быть повторно включен, отключен или перенаправлен локально, но другие записи на той же карте остаются полностью управляемыми пользователем.\n\n### Правила управляемого разрешения\n\nPush `deny`, `ask`и `allow` списки правил под управляемым `permissions` ключом для принудительного применения политики разрешений для всех пользователей, независимо от `permissions.disableBypassPermissionsMode`.\n\n```json\n{\n \"permissions\": {\n \"deny\": [\"Shell(rm -rf *)\", \"Domain(*.evil.example)\"],\n \"ask\": [\"Shell(git push *)\"],\n \"allow\": [\"Read(**)\"]\n }\n}\n```\n\n| Семейство правил | Совпадения |\n| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `Bash(...)`, `Shell(...)` | Команды оболочки. Используйте ` *` (например, `git push *`) для сопоставления префикса команды; в противном случае правило соответствует точному тексту. |\n| `PowerShell(...)` | Команды PowerShell совпадают с тем же способом, что `Shell(...)`и команды PowerShell. |\n| `Read(...)` | Пути чтения и просмотра файлов. Поддерживает шаблоны глобов: `/` для корневого каталога рабочей области, `~/` для домашнего каталога и `./` текущего рабочего каталога. |\n| `Edit(...)`, `Write(...)` | Пути записи и редактирования файлов совпадают с способом `Read(...)`. |\n| `Domain(...)` | Имена узлов URL-адресов, соответствующие [правилам URL-адреса](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#tool-permission-patterns). |\n\nПравила объединяются между управляемыми источниками с фиксированным приоритетом: всегда отклонять победы, а затем запрашивать, а затем разрешать— сопоставление `deny` правила блокирует запрос, даже если правило также соответствует правилу `allow` .\n`deny` и `ask` объединяются между каждым управляемым источником (сервером, MDM).\n`allow` требует каждого источника, объявляющего `allow` список, чтобы признать операцию — пересечение, а не объединение. Если любой из `deny`наборов или `ask``allow` установлен, операция, которая не соответствует ни одному из них по умолчанию`ask`, а не падает безмолвно.\n\n## Список разрешений и запретов управляемого сервера MCP\n\nАдминистраторы могут управлять серверами MCP непосредственно с помощью управляемых параметров MDM, независимо от [списка разрешений MCP предприятия](/ru/copilot/reference/copilot-cli-reference/cli-command-reference#enterprise-mcp-allowlist).\n\nЗадайте `allowedMcpServers` и(или) `deniedMcpServers` в источнике управляемых параметров:\n\n```json\n{\n \"allowedMcpServers\": [\n { \"serverUrl\": \"https://mcp.example.com/*\" },\n { \"serverCommand\": [\"npx\", \"-y\", \"@example/mcp-server\"] }\n ],\n \"deniedMcpServers\": [\n { \"serverName\": \"untrusted-server\" }\n ]\n}\n```\n\nКаждая запись идентифицирует сервер точно одним из следующих совпадений.\n\n| Совпадений | Совпадения | Notes |\n| ---------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| `serverUrl` | Удаленный сервер (HTTP/SSE) по URL-адресу | Поддерживает `*` подстановочные знаки; схему и сопоставление узла без учета регистра, регистр пути с учетом регистра. |\n| `${VAR}` ссылки развертываются перед сопоставлением. | | |\n| `serverCommand` | Сервер stdio по точной команде и аргументам в порядке | |\n| `${VAR}` ссылки развертываются перед сопоставлением. | | |\n| `serverName` | Сервер по назначенной метки | Записи списка разрешений ограничены `[A-Za-z0-9_-]+` (без подстановочных знаков); записи списка запретов принимают любую непустую строку. |\n\nПравила:\n\n* **Доверенные сторонние серверы** (например, встроенный GitHub сервер MCP) всегда освобождаются от обоих списков.\n* **Unset `allowedMcpServers`** разрешает все серверы, отличные от по умолчанию; **Пустой массив** блокирует все из них (запретить все).\n* **Отмена набора или пустого `deniedMcpServers`** ничего не блокирует.\n* **Запрет всегда выигрывает**— сопоставление `deniedMcpServers` сервера блокируется, даже если он также соответствует `allowedMcpServers`.\n* Для удаленных серверов совпадение должно поступать из `serverUrl` записи; `serverName` только при отсутствии `serverUrl` записей. Для серверов stdio совпадение должно поступать из `serverCommand` записи; `serverName` только при отсутствии `serverCommand` записей.\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-programmatic-reference)\n* [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [Ссылка на крючки GitHub Copilot](/ru/copilot/reference/hooks-reference)"}