GitHub Copilot CLI configuration directory - Документация по GitHub

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

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

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

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

Путь	Тип	Описание
`config.json`	Файл	Ваши личные настройки конфигурации
`mcp-config.json`	Файл	Определения серверов MCP на уровне пользователя
`permissions-config.json`	Файл	Сохранённые права на инструменты и каталоги для каждого проекта
`agents/`	Directory	Определения персональных кастомных агентов
`skills/`	Directory	Определения личных индивидуальных навыков
`hooks/`	Directory	Скрипты с крючками на уровне пользователя
`logs/`	Directory	Файлы журнала сессии
`session-state/`	Directory	История сессий и данные рабочего пространства
`session-store.db`	Файл	База данных SQLite для данных между сессиями
`installed-plugins/`	Directory	Установленные файлы плагинов
`ide/`	Directory	Состояние интеграции IDE

Примечание.

Не все эти предметы появляются сразу. Некоторые создаются по запросу при первом использовании конкретной функции — например, installed-plugins/ появляются только после установки первого плагина.

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

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

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

К общим параметрам относятся:

Ключ	Тип	Описание
`model`	струна	Модель ИИ для использования (например, `"gpt-5.2"`, `"claude-sonnet-4.6"`)
`effortLevel`	струна	Уровень рассуждения для моделей, поддерживающих её
`theme`	струна	Цветовая тема: `"auto"`, `"dark"`, или `"light"`
`alt_screen`	булевый	Используйте альтернативный буфер экрана (по умолчанию: `true`)
`mouse`	булевый	Включите поддержку мыши в альтернативном режиме экрана (по умолчанию: `true`)
`banner`	струна	Частота анимированного баннера: `"always"`, , или `"never"` (по умолчанию: "once"``"once")
`render_markdown`	булевый	Render markdown в ответах (по умолчанию: `true`)
`screen_reader`	булевый	Включить оптимизацию экранных читателей (по умолчанию: `false`)
`auto_update`	булевый	Автоматическая загрузка обновлений CLI (по умолчанию: `true`)
`stream`	булевый	Потоковые ответы токены по токену (по умолчанию: `true`)
`includeCoAuthoredBy`	булевый	Добавить соавторство в коммиты, созданные агентами (по умолчанию: `true`)
`respectGitignore`	булевый	Исключить gitignored файлы из `@` выбора файлов (по умолчанию: `true`)
`trusted_folders`	строка[]	Папки, для которых предоставлено разрешение на чтение/выполнение
`allowed_urls`	строка[]	URL или домены разрешены без подсказки
`denied_urls`	строка[]	URL или домены, которые всегда отклоняются
`log_level`	струна	Логарифмическая многословность: `"none"`, `"error"`, "warning"``"info"``"all"``"debug"или `"default"` (по умолчанию: ) `"default"`
`disableAllHooks`	булевый	Отключите все крючки (по умолчанию: `false`)
`hooks`	объект	Встроенные определения хуков на уровне пользователя

Для полного списка настроек настроек введите copilot help config в терминале.

Совет

Некоторые настройки также можно настроить с помощью флагов командной строки. Например, установите --alt-screen``--no-alt-screen``alt_screen значение и сохраняете его в .config.json /model Команда slash записывает ваш выбор модели в этот файл, чтобы он сохранялся на протяжении всех сессий.

`mcp-config.json`

Определяет серверы MCP (Model Context Protocol), доступные на уровне пользователя. Эти серверы доступны во всех ваших сессиях, независимо от того, в каком вы каталоге проектов. Конфигурации MCP на уровне проекта (в .mcp.json, .github/mcp.json, или .vscode/mcp.json) имеют приоритет над определениями на уровне пользователя, когда имена серверов конфликтуют.

Дополнительные сведения см. в разделе Добавление MCP-серверов для GitHub Copilot CLI.

`agents/`

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

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

`skills/`

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

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

`hooks/`

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

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

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

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

`permissions-config.json`

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

Примечание.

Если вы хотите сбросить разрешения для проекта, вы можете удалить соответствующую запись из этого файла. Однако редактирование файла во время сессии может вызвать неожиданное поведение.

`session-state/`

Содержит данные истории сессий, организованные по идентификатору сессии в подкаталогах. Каждый каталог сессии хранит журнал событий (events.jsonl) и артефакты рабочего пространства (планы, контрольные точки, отслеживаемые файлы). Эти данные позволяют возобновить сессию (--resume или --continue).

`session-store.db`

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

`logs/`

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

Совет

Чтобы найти файл журнала вашей текущей сессии, зарегистрируйте /session интерактивную сессию. Вывод включает полный путь к файлу журнала, а также другие детали сессии, такие как идентификатор сессии, длительность и рабочий каталог.

`installed-plugins/`

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

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

`ide/`

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

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

Вы можете переопределить стандартное ~/.copilot местоположение двумя способами:

        **Переменная окружения**: установите `COPILOT_HOME` путь к нужной директории.

Bash

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

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

        **Опция командной строки**: Используйте `--config-dir` при запуске CLI.

Bash

copilot --config-dir /path/to/my/copilot-config

copilot --config-dir /path/to/my/copilot-config

Опция --config-dir имеет приоритет над COPILOT_HOME, которая, в свою очередь, имеет приоритет перед стандартным ~/.copilot местоположением.

Вещи, которые следует учитывать

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

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

        **Каталог кэша** (используемый для маркетплейс-кэшей, автоматического обновления пакетов и других временных данных) следует платформным конвенциям и не подвергается `COPILOT_HOME`влиянию . Он расположен по адресу:

- macOS:`~/Library/Caches/copilot`

        **Linux**: `$XDG_CACHE_HOME/copilot` или `~/.cache/copilot`

- Windows: %LOCALAPPDATA%/copilot

Чтобы отдельно переопределить каталог кэша, установите COPILOT_CACHE_HOME.

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

Элемент	Безопасно ли удалить?	Эффект
`logs/`	Да	Файлы журналов создаются заново каждую сессию. Удаление их не имеет функционального эффекта.
`session-state/`	С осторожностью	Удаление удаляет историю сессий. Вы больше не сможете возобновить прошлые занятия.
`session-store.db`	С осторожностью	Удаление удаляет данные между сессиями. Файл воссоздаётся автоматически.
`config.json`	С осторожностью	Сбрасывает все настройки по умолчанию. Вам нужно будет перенастроить свои настройки.
`permissions-config.json`	С осторожностью	Сбрасывает все сохранённые права. CLI снова подскаже вам одобрение инструментов и каталогов.
`installed-plugins/`	Не рекомендуется	Используйте `copilot plugin uninstall` вместо этого, чтобы метаданные `config.json` плагина оставались последовательными.
`mcp-config.json`	Не рекомендуется	Вы потеряете определения сервера MCP на уровне пользователя. Сначала отойди.

          `agents/`, , `skills/``hooks/` | Не рекомендуется | Вы потеряете свои личные настройки. Сначала отойди. |

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

        [AUTOTITLE](/copilot/how-tos/copilot-cli)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-programmatic-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-plugin-reference)