Второй пилот 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.
config.json
Это основной конфигурационный файл для Второй пилот 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)