Настройки агента живут на отдельном экране — **Настройки WorkAI**. Он открывается по `Cmd/Ctrl+Shift+,`, из меню **Preferences → WorkAI Settings** или из палитры команд по запросу «WorkAI Settings». Это не то же самое, что настройки редактора (`Cmd/Ctrl+,`): там остаются шрифты, темы, отступы и всё привычное по VS Code, а на экране WorkAI — аккаунт, модели, индексирование, правила, коннекторы и разрешения агента.

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

## Что в каком разделе

Меню слева разбито на три смысловые группы: чем пользуются все, что агент знает и к чему подключён, и отдельно разработческое. Сверху есть поиск — он ищет по названиям разделов, а не по параметрам внутри них.

| Раздел | Что внутри |
|---|---|
| **Основные** | статус входа в аккаунт, кнопки «Войти» и «Выйти» |
| **Модели** | выбор модели и подключение собственных ключей провайдеров |
| **Индексирование** | состояние индекса проекта, запуск и остановка индексации, удаление индекса, автоиндексация новых папок — см. [.workaignore](/docs/configuration/ignore-files) и [приватность](/docs/privacy) |
| **Правила** | личные правила и найденные файлы правил с областью действия — подробно в [Правила](/docs/rules) |
| **Коннекторы (MCP)** | список MCP-серверов, их состояние и добавление новых — подробно в [MCP](/docs/mcp) |
| **Терминал и защита** | что агенту разрешено выполнять без подтверждения и где это действует |
| **Хуки** | пункт-ссылка: открывает встроенный диалог настройки хуков |

«Хуки» — единственный пункт, который не открывает свой раздел, а вызывает встроенный мастер настройки хуков: он спрашивает тип хука и файл конфигурации и правит этот файл. Подсветка на пункте не остаётся — своего раздела с таким содержимым внутри настроек WorkAI нет.

Внизу меню есть ещё одна ссылка наружу — **VS Code Settings**: она открывает обычные настройки редактора.

Раньше всё подключаемое лежало одним пунктом «Инструменты и MCP». Старые ссылки и сохранённые вкладки после переименования не ломаются: идентификатор раздела `mcp` при открытии тихо переводится в `connectors`.

## Разрешения агента

Раздел «Терминал и защита» показывает единый список того, что выполняется без вопроса: команды терминала, инструменты и коннекторы. У каждой записи подписана область — **везде**, **в этом проекте** или **в этом чате**. Список фильтруется по области, отдельную запись можно отозвать крестиком, а кнопка очистки убирает либо весь список, либо только то, что показано под текущим фильтром. Разрешение «в этом чате» отозвать нельзя — оно само истекает в конце диалога.

Что именно агент спрашивает и почему, разобрано в [Безопасности агента](/docs/agent/security).

## Настройки в окне агентов

У [окна агентов](/docs/agent/agents-window) свой, урезанный экран настроек — он открывается шестерёнкой рядом с блоком аккаунта или выбором модели. Там пять разделов: Основные, Модели, Индексация, Правила, Терминал и безопасность. Коннекторов и хуков в нём нет, наверху есть кнопка «Назад», которая закрывает вкладку и возвращает к работе.

## Что переезжает на другую машину само

Часть настроек привязана к аккаунту WorkAI, а не к компьютеру. Достаточно войти на новой машине, и они окажутся на месте:

- выбранная модель по умолчанию;
- подключённые аккаунты провайдеров с вашими ключами — ключи хранятся на стороне сервиса в зашифрованном виде, повторно вводить их не нужно.

Всё остальное не копируется вместе с `settings.json`: индекс смыслового поиска нужно запустить для проекта на новой машине снова, а разрешения на инструменты и коннекторы лежат не в файле настроек, а в профиле и конкретном проекте.

## Где лежат файлы настроек

Параметры WorkAI пишутся в тот же `settings.json`, что и настройки редактора, — с префиксами `aiSolver.` и `workai.` (например, `workai.terminal.allowedCommands` или личные правила `aiSolver.userRules`). Файл лежит в папке приложения:

| Система | Путь |
|---|---|
| macOS | `~/Library/Application Support/WorkAI/User/settings.json` |
| Windows | `%APPDATA%\WorkAI\User\settings.json` |
| Linux | `~/.config/WorkAI/User/settings.json` |

Рядом, в той же папке `User`, лежит `keybindings.json` с вашими горячими клавишами. Расширения ставятся в `~/.workai/extensions`.

Список разрешённых команд терминала — исключение из абзаца выше: он лежит именно в `settings.json` (`workai.terminal.allowedCommands`), в пользовательском файле или в `.vscode/settings.json` проекта, и вместе с файлом переезжает.

Правила и MCP-серверы файлами не лежат в этой папке — у них свои места: `~/.workai/rules` и `~/.workai/mcp.json` для личных, `.workai/rules` и `.workai/mcp.json` внутри проекта. Проектные кладут в git, и тогда они приезжают на новую машину вместе с репозиторием.

Перенести настройки руками — значит скопировать `settings.json`, `keybindings.json` и каталог `~/.workai` на новую машину. Отдельного облачного механизма синхронизации настроек редактора в WorkAI нет.

## Темы и горячие клавиши

Тему, шрифт, раскладку панелей и сочетания клавиш меняют штатными средствами редактора: `Cmd/Ctrl+,` для настроек, палитра команд → **Color Theme** для темы, **Keyboard Shortcuts** для клавиш. Собственных тем WorkAI не добавляет — доступен стандартный набор, включая тёмную и светлую «2026». Из своих сочетаний в WorkAI назначены `Cmd/Ctrl+Shift+,` (этот экран настроек) и `Cmd/Ctrl+Shift+A` (окно агентов); оба переназначаются как любые другие.