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