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

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

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

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

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

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

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

settings.json

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

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

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 Разрешает файл из каталога конфигурации.

Этот --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, а не очищенный префикс имени инструмента.

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

commandIdentifiers совпадение с идентификаторами команд, извлечёнными из запроса оболочки. Совпадение точное, за исключением :* суффикса.

Суффикс :* — это не типичный шар. Он совпадает с точной основой, или с тем, за которым следует пробел и ещё текст.

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

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)

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

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

Локальные настройки (.github/copilot/settings.local.json)

Создайте .github/copilot/settings.local.json в репозитории личные перемены, которые не должны быть коммитированы. Добавить этот файл в .gitignore.

Локальный конфигурационный файл использует ту же схему, что и файл конфигурации репозитория (.github/copilot/settings.json), и имеет приоритет над ней.

Управляемые настройки MDM

ИТ-администраторы могут запускать базовую политику с помощью управляемых настроек Mobile Управление устройствами (MDM) вместо необходимости конфигурации для каждого пользователя. Эти настройки применяют устройства по умолчанию для поддерживаемых клавиш и загружаются до пользовательских настроек.

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

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

Формат файла

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

{
    "permissions": {
        "disableBypassPermissionsMode": "disable"
    }
}

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

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

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

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