{"meta":{"title":"Каталог конфигурации CLI GitHub Copilot","intro":"Найдите информацию о ~/.copilot каталоге, где Второй пилот CLI хранятся конфигурации, данные сессий и настройки.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/reference","title":"Справочные материалы"},{"href":"/ru/copilot/reference/copilot-cli-reference","title":"Ссылка Второй пилот CLI"},{"href":"/ru/copilot/reference/copilot-cli-reference/cli-config-dir-reference","title":"Каталог конфигурации CLI"}],"documentType":"article"},"body":"# Каталог конфигурации CLI GitHub Copilot\n\nНайдите информацию о ~/.copilot каталоге, где Второй пилот CLI хранятся конфигурации, данные сессий и настройки.\n\n```\n          Второй пилот CLI Хранит свою конфигурацию, историю сессий, журналы и настройки в одном каталоге на вашем компьютере. По умолчанию эта папка ( `~/.copilot` то есть `$HOME/.copilot`).\n```\n\nВ этой статье описывается содержимое этого каталога и то, как им можно пользоваться.\n\n## Обзор каталога\n\nКаталог `~/.copilot` содержит следующие элементы верхнего уровня.\n\n| Путь                      | Тип       | Описание                                                        |\n| ------------------------- | --------- | --------------------------------------------------------------- |\n| `config.json`             | Файл      | Ваши личные настройки конфигурации                              |\n| `mcp-config.json`         | Файл      | Определения серверов MCP на уровне пользователя                 |\n| `permissions-config.json` | Файл      | Сохранённые права на инструменты и каталоги для каждого проекта |\n| `agents/`                 | Directory | Определения персональных кастомных агентов                      |\n| `skills/`                 | Directory | Определения личных индивидуальных навыков                       |\n| `hooks/`                  | Directory | Скрипты с крючками на уровне пользователя                       |\n| `logs/`                   | Directory | Файлы журнала сессии                                            |\n| `session-state/`          | Directory | История сессий и данные рабочего пространства                   |\n| `session-store.db`        | Файл      | База данных SQLite для данных между сессиями                    |\n| `installed-plugins/`      | Directory | Установленные файлы плагинов                                    |\n| `ide/`                    | Directory | Состояние интеграции IDE                                        |\n\n> \\[!NOTE]\n> Не все эти предметы появляются сразу. Некоторые создаются по запросу при первом использовании конкретной функции — например, `installed-plugins/` появляются только после установки первого плагина.\n\n## Файлы, редактируемые пользователем\n\nСледующие файлы предназначены для прямого редактирования вами или управления с помощью команд CLI.\n\n### `config.json`\n\nЭто основной конфигурационный файл для Второй пилот CLI. Вы можете редактировать его напрямую в текстовом редакторе или использовать интерактивные команды, такие как `/model` и `/theme` для изменения конкретных значений внутри сессии. Файл поддерживает JSON с комментариями (JSONC).\n\nК общим параметрам относятся:\n\n| Ключ                  | Тип       | Описание                                                                                                                                                        |\n| --------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `model`               | струна    | Модель ИИ для использования (например, `\"gpt-5.2\"`, `\"claude-sonnet-4.6\"`). Настройте `Auto` так, чтобы автоматически Copilot выбирать лучшую доступную модель. |\n| `effortLevel`         | струна    | Уровень рассуждения для моделей, поддерживающих её                                                                                                              |\n| `theme`               | струна    | Цветовая тема: `\"auto\"`, `\"dark\"`, или `\"light\"`                                                                                                                |\n| `mouse`               | булевый   | Включите поддержку мыши в альтернативном режиме экрана (по умолчанию: `true`)                                                                                   |\n| `banner`              | струна    | Частота анимированного баннера: `\"always\"`, , или `\"once\"` (по умолчанию: `\"never\"``\"once\"`)                                                                    |\n| `renderMarkdown`      | булевый   | Render Markdown в ответах (по умолчанию: `true`)                                                                                                                |\n| `screenReader`        | булевый   | Включить оптимизацию экранных читателей (по умолчанию: `false`)                                                                                                 |\n| `autoUpdate`          | булевый   | Автоматическая загрузка обновлений CLI (по умолчанию: `true`)                                                                                                   |\n| `stream`              | булевый   | Потоковые ответы токены по токену (по умолчанию: `true`)                                                                                                        |\n| `includeCoAuthoredBy` | булевый   | Добавить соавторство в коммиты, созданные агентами (по умолчанию: `true`)                                                                                       |\n| `respectGitignore`    | булевый   | Исключить gitignored файлы из `@` выбора файлов (по умолчанию: `true`)                                                                                          |\n| `allowedUrls`         | строка\\[] | URL или домены разрешены без подсказки                                                                                                                          |\n| `deniedUrls`          | строка\\[] | URL или домены, которые всегда отклоняются                                                                                                                      |\n| `logLevel`            | струна    | Логарифмическая многословность: `\"none\"`, `\"error\"`, `\"warning\"``\"info\"``\"debug\"``\"all\"`или `\"default\"` (по умолчанию: ) `\"default\"`                            |\n| `disableAllHooks`     | булевый   | Отключите все крючки (по умолчанию: `false`)                                                                                                                    |\n| `hooks`               | объект    | Встроенные определения хуков на уровне пользователя                                                                                                             |\n\nДля полного списка настроек настроек введите `copilot help config` в терминале.\n\n> \\[!TIP]\n> Некоторые настройки также можно настроить с помощью флагов командной строки. Например, `/model` команда slash записывает выбор модели в этот файл, чтобы он сохранялся в разных сессиях.\n\n### `mcp-config.json`\n\nОпределяет серверы MCP (Model Context Protocol), доступные на уровне пользователя. Эти серверы доступны во всех ваших сессиях, независимо от того, в каком вы каталоге проектов. Project-уровневые конфигурации MCP (в `.mcp.json` или `.github/mcp.json`) имеют приоритет над определениями на уровне пользователя при конфликте имён серверов.\n\nДополнительные сведения см. в разделе [Добавление MCP-серверов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).\n\n### `agents/`\n\nЗдесь храните личные определения пользовательских агентов в виде `.agent.md` файлов. Агенты, размещённые в этом каталоге, доступны во всех ваших сессиях. Агенты Project уровня (в `.github/agents/`) имеют приоритет перед личными агентами, если у них одинаковое имя.\n\nДополнительные сведения см. в разделе [Создание и использование пользовательских агентов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli).\n\n### `skills/`\n\nЗдесь храните личные индивидуальные определения навыков. Каждый навык находится в подкаталоге, содержащем `SKILL.md` файл — например, `~/.copilot/skills/my-skill/SKILL.md`. Личные навыки доступны во всех ваших сессиях. Навыки Project Level имеют приоритет над личными, если у них одинаковое название.\n\nДополнительные сведения см. в разделе [Добавление навыков агента для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-skills).\n\n### `hooks/`\n\nЗдесь можно хранить скрипты с крючками на уровне пользователя. Эти зацепки применимы ко всем вашим сессиям. Вы также можете определить крючки в линии `config.json` с помощью ключа `hooks` . Хуки уровня репозитория (in `.github/hooks/`) загружаются вместе с пользовательскими хуками.\n\nДополнительные сведения см. в разделе [Использование крючков с GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/use-hooks).\n\n## Автоматически управляемые файлы\n\nСледующие пункты управляются CLI. Обычно не стоит редактировать их вручную.\n\n### `permissions-config.json`\n\nСохраняет сохранённые решения по инструменту и разрешению каталога, организованные по расположению проекта. Когда вы одобряете инструмент или предоставляете доступ к каталогу, CLI фиксирует решение здесь, чтобы вас больше не запросили в том же проекте.\n\n> \\[!NOTE]\n> Если вы хотите сбросить разрешения для проекта, вы можете удалить соответствующую запись из этого файла. Однако редактирование файла во время сессии может вызвать неожиданное поведение.\n\n### `session-state/`\n\nСодержит данные истории сессий, организованные по идентификатору сессии в подкаталогах. Каждый каталог сессии хранит журнал событий (`events.jsonl`) и артефакты рабочего пространства (планы, контрольные точки, отслеживаемые файлы). Эти данные позволяют возобновить сессию (`--resume` или `--continue`).\n\n### `session-store.db`\n\nБаза данных SQLite, используемая CLI для межсессионных данных, таких как индексация контрольных точек и поиск. Этот файл управляется автоматически и не должен редактироваться.\n\n### `logs/`\n\nСодержит лог-файлы для сессий CLI. Каждая сессия создаёт лог-файл с названием `process-{timestamp}-{pid}.log`. Эти файлы полезны для отладки.\n\n> \\[!TIP]\n> Чтобы найти файл журнала вашей текущей сессии, зарегистрируйте `/session` интерактивную сессию. Вывод включает полный путь к файлу журнала, а также другие детали сессии, такие как идентификатор сессии, длительность и рабочий каталог.\n\n### `installed-plugins/`\n\nСодержит файлы для установленных вами плагинов. Плагины, установленные на маркетплейсе, хранятся в .`installed-plugins/{marketplace-name}/{plugin-name}/` Напрямую установленные плагины хранятся в .`installed-plugins/_direct/` Управляйте плагинами с `copilot plugin` помощью команд, а не редактировать эту папку напрямую.\n\nДополнительные сведения см. в разделе [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference).\n\n### `ide/`\n\nСодержит файлы блокировки и состояние для интеграций с IDE (например, при Второй пилот CLI подключении к Visual Studio Code). Этот каталог управляется автоматически.\n\n## Изменение расположения каталога конфигурации\n\nВы можете переопределить стандартное `~/.copilot` местоположение двумя способами:\n\n* ```\n          **Переменная окружения**: установите `COPILOT_HOME` путь к нужной директории.\n  ```\n\n  ```bash copy\n  export COPILOT_HOME=/path/to/my/copilot-config\n  ```\n\n* ```\n          **Опция командной строки**: Используйте `--config-dir` при запуске CLI.\n  ```\n\n  ```bash copy\n  copilot --config-dir /path/to/my/copilot-config\n  ```\n\nОпция `--config-dir` имеет приоритет над `COPILOT_HOME`, которая, в свою очередь, имеет приоритет перед стандартным `~/.copilot` местоположением.\n\n### Вещи, которые следует учитывать\n\n* ```\n          `COPILOT_HOME` заменяет весь `~/.copilot` путь. Значение должно быть полным путём к нужной директории, которую вы хотите использовать для конфигурационных файлов и подкаталогов.\n  ```\n* Изменение каталога означает, что ваша существующая конфигурация, история сессий, установленные плагины и сохранённые права не будут найдены в новом месте. Скопируйте или переместите содержимое `~/.copilot` в новый адрес, если хотите сохранить его.\n* ```\n          **Каталог кэша** (используемый для маркетплейс-кэшей, автоматического обновления пакетов и других временных данных) следует платформным конвенциям и не подвергается `COPILOT_HOME`влиянию . Он расположен по адресу:\n  ```\n\n  \\-\n  **macOS:**`~/Library/Caches/copilot`\n  ------------------------------------\n\n  ```\n          **Linux**: `$XDG_CACHE_HOME/copilot` или `~/.cache/copilot`\n  ```\n\n  \\-\n  **Windows**: `%LOCALAPPDATA%/copilot`\n\n  Чтобы отдельно переопределить каталог кэша, установите `COPILOT_CACHE_HOME`.\n\n## Что можно безопасно удалить\n\n| Элемент                        | Безопасно ли удалить? | Эффект                                                                                                                    |\n| ------------------------------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| `logs/`                        | Да                    | Файлы журналов создаются заново каждую сессию. Удаление их не имеет функционального эффекта.                              |\n| `session-state/`               | С осторожностью       | Удаление удаляет историю сессий. Вы больше не сможете возобновить прошлые занятия.                                        |\n| `session-store.db`             | С осторожностью       | Удаление удаляет данные между сессиями. Файл воссоздаётся автоматически.                                                  |\n| `config.json`                  | С осторожностью       | Сбрасывает все настройки по умолчанию. Вам нужно будет перенастроить свои настройки.                                      |\n| `permissions-config.json`      | С осторожностью       | Сбрасывает все сохранённые права. CLI снова подскаже вам одобрение инструментов и каталогов.                              |\n| `installed-plugins/`           | Не рекомендуется      | Используйте `copilot plugin uninstall` вместо этого, чтобы метаданные `config.json` плагина оставались последовательными. |\n| `mcp-config.json`              | Не рекомендуется      | Вы потеряете определения сервера MCP на уровне пользователя. Сначала отойди.                                              |\n| `agents/`, , `skills/``hooks/` | Не рекомендуется      | Вы потеряете свои личные настройки. Сначала отойди.                                                                       |\n\n## Дополнительные материалы\n\n* [GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli)\n* [Справочник команды GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [GitHub Copilot CLI программный справочник](/ru/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}