Каталог конфигурации CLI GitHub Copilot

Второй пилот CLI Хранит свою конфигурацию, историю сессий, журналы и настройки в одном каталоге на вашем компьютере. По умолчанию эта папка ( ~/.copilot то есть $HOME/.copilot).

В этой статье описывается содержимое этого каталога и то, как им можно пользоваться.

Обзор каталога

Каталог ~/.copilot содержит следующие элементы верхнего уровня.

Файлы, редактируемые пользователем

Следующие файлы предназначены для прямого редактирования вами или управления с помощью команд CLI.

settings.json

Это основной конфигурационный файл для Второй пилот CLI. В течение сессии вы можете использовать интерактивную /settings команду для изменения конкретных значений или запустить /settings KEY VALUE её для установки одного значения. См . раздел AUTOTITLE. В качестве альтернативы можно редактировать settings.json файл напрямую в текстовом редакторе. Файл поддерживает JSON с комментариями (JSONC).

По умолчанию этот файл находится в ~/.copilot каталоге, который является пользовательской конфигурационной директорией. Он содержит глобальные пользовательские настройки по умолчанию для всех репозиториев. Вы можете изменить расположение этой директории, установив COPILOT_HOME переменную окружения на другой путь.

Полный список настроек и их взаимодействие с конфигурацией на уровне репозитория см. раздел «Настройки конфигурационных файлов » позже в этой статье.

copilot-instructions.md

Личные индивидуальные инструкции, которые применимы ко всем вашим сессиям, независимо от того, над каким проектом вы работаете. Этот файл работает так же, как репозиторий copilot-instructions.md , но применяется глобально.

Дополнительные сведения см. в разделе Добавление пользовательских инструкций репозитория для GitHub Copilot.

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.

lsp-config.json

Определяет серверы Language Server Protocol (LSP), доступные на уровне пользователя. Эти серверы предоставляют агенту языковой интеллект (диагностику, завершение и т.д.). Управляйте этим файлом с помощью /lsp команды slash или редактируйте его напрямую.

Дополнительные сведения см. в разделе Добавление серверов LSP для интерфейс командной строки GitHub Copilot.

agents/

Здесь храните личные определения пользовательских агентов в виде .agent.md файлов. Агенты, размещённые в этом каталоге, доступны во всех ваших сессиях. Агенты Project уровня (в .github/agents/) имеют приоритет перед личными агентами, если у них одинаковое имя.

Дополнительные сведения см. в разделе Создание и использование пользовательских агентов для интерфейс командной строки GitHub Copilot.

skills/

Здесь храните личные индивидуальные определения навыков. Каждый навык находится в подкаталоге, содержащем SKILL.md файл — например, ~/.copilot/skills/my-skill/SKILL.md. Личные навыки доступны во всех ваших сессиях. Навыки Project Level имеют приоритет над личными, если у них одинаковое название.

Дополнительные сведения см. в разделе Добавление навыков агента для интерфейс командной строки GitHub Copilot.

hooks/

Здесь можно хранить скрипты с крючками на уровне пользователя. Эти зацепки применимы ко всем вашим сессиям. Вы также можете задать крючки в строке в пользовательском конфигурационном файле (~/.copilot/settings.json) с помощью ключа hooks . Хуки уровня репозитория (in .github/hooks/) загружаются вместе с пользовательскими хуками.

Дополнительные сведения см. в разделе Использование крючков с интерфейс командной строки GitHub Copilot.

extensions/

Храните файлы расширений пользовательского уровня здесь. Расширения в этом каталоге доступны между сессиями.

Вы можете создавать файлы в этой директории вручную или подготовить расширение, а затем редактировать сгенерированный файл.

Автоматически управляемые файлы

Следующие пункты управляются CLI. Обычно не стоит редактировать их вручную.

config.json

Хранит внутреннее состояние приложения, которое автоматически управляется CLI, включая данные аутентификации, метаданные установленного плагина и другую информацию во время выполнения. Обычно редактировать этот файл не понадобится.

permissions-config.json

Сохраняет сохранённые решения по инструменту и разрешению каталога, организованные по расположению проекта. Когда вы одобряете инструмент или предоставляете доступ к каталогу текущего местоположения, CLI фиксирует решение здесь, чтобы вас больше не запросили в том же репозитории или каталоге.

Расположение файла

Второй пилот CLI Разрешает файл из каталога конфигурации.

Интерфейс командной строки использует только первый применимый каталог конфигурации в этом порядке. Он также не загружается permissions-config.json из расположений с более низким приоритетом.

Этот --config-dir вариант — наследие. Предпочитаю COPILOT_HOME , когда нужно менять каталог конфигурации.

В Windows стандартный файл обычно выглядит:

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, используйте нормализованный текущий рабочий каталог.

Ключ должен совпадать с местом, где Второй пилот CLI он работает. Если ключ не совпадает, сохраненные одобрения не будут применяться.

CLI загружает одобрения соответствующего места при начале сессии и изменении активного рабочего каталога.

Схема

Файл должен содержать объект JSON.

permissions-config.json не поддерживает правила отказа, правила «спросить», режимы по умолчанию, правила URL, фильтрацию инструментов или совместную политику репозитория. Для таких действий используйте командные опции, такие --deny-toolкак , --available-tools, --excluded-tools``--allow-url, и --deny-url. Правила сохранения URL хранятся в settings.json, а не в permissions-config.json.

Неизвестные поля не входят в схему. CLI может их игнорировать, а последующие записи могут их удалять.

Виды одобрения

Каждый элемент должен tool_approvals быть одним из следующих объектов.

Для одобрения MCP serverName должно точно совпадать с настроенным именем сервера MCP. Используйте сырое имя сервера из вашей конфигурации MCP, а не очищенный префикс имени инструмента.

Сопоставление команд оболочки

permissions-config.json не поддерживает регулярные выражения или общие шаблоны глобов. Строковые значения совпадают буквально, за исключением того, что :* значение оболочки commandIdentifiers соответствует тексту до :*того, как само по себе или за ним следует пробел и больше текста. Равнина * не имеет особого смысла, поэтому git* не соответствует git status.

Сопоставление каталогов

allowed_directories Записи позволяют Второй пилот CLI получать доступ к путям внутри этих каталогов без отдельного запроса на путь. Они не одобряют саму работу инструмента. Например, редактирование файла в разрешённой папке всё равно может требовать write одобрения.

Каждая allowed_directories запись должна быть абсолютной, непустой и доступной папкой. CLI разрешает симлинки перед сравнением путей, блокирует сетевые пути UNC, если они не являются локальными путями расширенной длины, сравнивает пути без падежа в Windows и сравнивает пути с учетом регистра на других платформах. Если запись не может быть применена, CLI фиксирует предупреждение и пропускает эту запись.

Примеры

Разрешите все подкоманды Git и получите доступ к дополнительной локальной директории:

{
  "locations": {
    "C:\\src\\my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": ["git:*"]
        }
      ],
      "allowed_directories": ["C:\\src\\shared-docs"]
    }
  }
}

{
  "locations": {
    "C:\\src\\my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": ["git:*"]
        }
      ],
      "allowed_directories": ["C:\\src\\shared-docs"]
    }
  }
}

Разрешите выбранные команды, всё ещё спрашивая перед записью файла:

{
  "locations": {
    "/Users/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": [
            "git status",
            "git diff",
            "git log",
            "npm test",
            "npm run build"
          ]
        }
      ]
    }
  }
}

{
  "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-сервер для репозитория:

{
  "locations": {
    "/home/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "write"
        },
        {
          "kind": "mcp",
          "serverName": "github-mcp-server",
          "toolName": null
        }
      ]
    }
  }
}

{
  "locations": {
    "/home/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "write"
        },
        {
          "kind": "mcp",
          "serverName": "github-mcp-server",
          "toolName": null
        }
      ]
    }
  }
}

Одобрить один MCP-инструмент, запись в памяти и доступ к разрешениям расширения:

{
  "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"
        }
      ]
    }
  }
}

{
  "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 данных сессии.

command-history-state/

Содержит данные истории команд, используемые для обратного поиска (Ctrl R+) и навигации по истории в интерактивном интерфейсе. Этот каталог управляется автоматически и не подлежит редактированию.

session-store.db

База данных SQLite, используемая CLI для межсессионных данных, таких как индексация контрольных точек и поиск. Этот файл управляется автоматически и не должен редактироваться.

Если вы удалите этот файл, его можно восстановить с помощью команды /chronicle reindex . Реиндексация также синхронизирует данные сессии с аккаунтом.

logs/

Содержит лог-файлы для сессий CLI. Каждая сессия создаёт лог-файл с названием process-{timestamp}-{pid}.log. Эти файлы полезны для отладки.

CLI также может создавать логи, специфичные для расширения, в разделе logs/extensions/.

Это отдельно от ~/.copilot/extensions/, где хранится код расширений, созданный пользователем.

installed-plugins/

Содержит файлы для установленных вами плагинов. Плагины, установленные на маркетплейсе, хранятся в .installed-plugins/{marketplace-name}/{plugin-name}/ Напрямую установленные плагины хранятся в .installed-plugins/_direct/ Управляйте плагинами с copilot plugin помощью команд, а не редактировать эту папку напрямую.

Дополнительные сведения см. в разделе Ссылка на плагин GitHub Copilot CLI.

plugin-data/

Содержит постоянные данные для установленных плагинов, организованные по маркетплейсу и имени плагина. Эти данные управляются самими плагинами и не должны редактироваться вручную.

ide/

Содержит файлы блокировки и состояние для интеграций с IDE (например, при Второй пилот CLI подключении к Visual Studio Code). Этот каталог управляется автоматически.

mcp-oauth-config/

Содержит резервные файлы MCP OAuth, регистрационные и резервные файлы PKCE при недоступном хранилище, поддерживаемом брелоком. Этот каталог управляется автоматически.

mcp-secrets/

Содержит резервное хранилище файлов и индекс секретных заполняющих MCP, когда хранилище с защитой связки ключей недоступно. Этот каталог управляется автоматически.

Изменение расположения каталога конфигурации

Чтобы переопределить местоположение по умолчанию ~/.copilot , установите COPILOT_HOME переменную среды на путь к нужной вам директории.

export COPILOT_HOME=/path/to/my/copilot-config

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.

Что можно безопасно удалить

Настройки конфигурационных файлов

Настройки применяются в следующем порядке (позже переопределяются раньше):

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.

CLI также читает и для общего кросс-инструментального подмножества настроек репозитория (таких .claude/settings.jsonкак , .claude/settings.local.json, companyAnnouncements, disableAllHooks, и enabledPlugins).extraKnownMarketplaces``hooks

Пользовательские настройки (~/.copilot/settings.json)

Эти настройки применимы ко всем вашим сессиям и репозиториям. Вы можете использовать /settings команду slash для запуска интерактивного диалога, или специальные команды для обновления отдельных значений, либо редактировать этот файл напрямую.

Настройки репозитория (.github/copilot/settings.json)

Настройки репозитория применимы ко всем, кто работает в репозитории. Они привержены хранилищу и делятся ими с сотрудниками.

На уровне репозитория поддерживаются только ключи, перечисленные в следующей таблице. Любые другие ключи — включая те, что действительны в пользовательском конфигурационном файле — молча игнорируются. Каждый поддерживаемый ключ имеет политику направления слияния, которая сохраняет переопределение сбоем и безопасно.

model, effortLevelи contextTier переопределения применяются только в том случае, если рабочий каталог является доверенным.

Подключаемый модуль, включенный только через репозиторий enabledPlugins , ограничен этим репозиторием: он автоматически устанавливает и активирует в декларируемом репозитории, но остается отключенным глобально, поэтому он никогда не активируется в не связанных проектах. Выход из репозитория или репозиторий, отключающий подключаемый модуль, удаляет сервер MCP и деактивирует агенты и навыки сеанса.

Список разрешений моделей уровня репозитория (.github/allowed_models.txt)

Ограничение того, какие встроенные модели репозитория могут использовать с списком .github/allowed_models.txtразрешений обычного текста, разрешенным из корневого каталога текущего рабочего каталога (или рабочего каталога за пределами репозитория).

Каждая строка — это шаблон глоба, соответствующий идентификаторам модели, или fallback: директива, именующая модель, используемую, если настроенная или запрошенная модель не разрешена:

# .github/allowed_models.txt
fallback: gpt-5.2
gpt-5.2
gpt-5.4
claude-sonnet-*

Негабаритные шаблоны () не поддерживаются, резервная модель должна быть точным идентификатором (!patternа не глобом), а резервная модель должна соответствовать одной из настроенных глобов. Второй пилот CLI Повторно оценивает политику /cd и отклоняет недопустимый файл с ошибкой перед выполнением.

Список разрешений управляет только Copilotвстроенными моделями. Не удается отфильтровать пользовательские модели, добавленные с помощью метода "Ключи API" (BYOK). Модели BYOK остаются в списке и выбираются независимо от настроенных шаблонов, и fallback: директива никогда не применяется к ним. Дополнительные сведения см. в разделе [AUTOTITLE и Включение пользовательских моделей для GitHub Copilot в организации](/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) вместо необходимости конфигурации для каждого пользователя. Эти настройки применяют устройства по умолчанию для поддерживаемых клавиш и загружаются до пользовательских настроек.

Второй пилот CLI также загружает параметры, управляемые сервером при запуске, в дополнение к MDM. Параметры, управляемые устройством (MDM) и управляемые сервером, разрешаются на один ключ: значение MDM выигрывает для всех заданных ключей, а значение сервера заполняется ключами MDM не задано. Это позволяет организации задать определенную политику с помощью MDM (например, permissions), получая другие управляемые значения по умолчанию (например, model) с сервера.

Длительные сеансы повторно извлекает и повторно применяет управляемые параметры почасово, поэтому изменения политики, например, организация, включающая permissions.disableBypassPermissionsMode, вступают в силу без перезапуска сеанса.

Источники управляемых настроек MDM

Второй пилот CLI читает управляемые настройки из специализированных для платформы MDM или файловых локаций.

Формат файла

Пишите управляемые настройки на основе файлов в формате JSON.

{
    "model": "auto",
    "permissions": {
        "disableBypassPermissionsMode": "disable"
    }
}

Поддерживаемые ключи

В управляемых настройках MDM поддерживаются только следующие ключи.

Список разрешений и запретов управляемого сервера MCP

Администраторы могут управлять серверами MCP непосредственно с помощью управляемых параметров MDM, независимо от списка разрешений MCP предприятия.

Задайте allowedMcpServers и(или) deniedMcpServers в источнике управляемых параметров:

{
    "allowedMcpServers": [
        { "serverUrl": "https://mcp.example.com/*" },
        { "serverCommand": ["npx", "-y", "@example/mcp-server"] }
    ],
    "deniedMcpServers": [
        { "serverName": "untrusted-server" }
    ]
}

Каждая запись идентифицирует сервер точно одним из следующих совпадений.

Правила:

• Доверенные сторонние серверы (например, встроенный GitHub сервер MCP) всегда освобождаются от обоих списков.
• Unset allowedMcpServers разрешает все серверы, отличные от по умолчанию; Пустой массив блокирует все из них (запретить все).
• Отмена набора или пустого deniedMcpServers ничего не блокирует.
• Запрет всегда выигрывает— сопоставление deniedMcpServers сервера блокируется, даже если он также соответствует allowedMcpServers.
• Для удаленных серверов совпадение должно поступать из serverUrl записи; serverName только при отсутствии serverUrl записей. Для серверов stdio совпадение должно поступать из serverCommand записи; serverName только при отсутствии serverCommand записей.

Дополнительные материалы

• интерфейс командной строки GitHub Copilot
• Справочник команды GitHub Copilot CLI
• GitHub Copilot CLI программный справочник
• Ссылка на плагин GitHub Copilot CLI
• Ссылка на крючки GitHub Copilot