Настройки

Настройки Kodik хранятся в двух местах:

Встроенный редактор настроек Kodik — большинство параметров: профиль, агенты, автодополнение, модели, индексирование, MCP, анонимайзер и другие.
settings.json (стандартные настройки VS Code) — несколько специализированных параметров, описанных в конце этой страницы.

Открытие настроек

Нажмите кнопку с шестерёнкой «Настройки» в строке заголовка и выберите «Настройки Kodik» — в этом же меню доступны параметры редактора, действия управления (палитра команд, сочетания клавиш и другие) и вход через GitHub. Также можно выполнить команду kodik.openSettings. Когда редактор настроек активен, нажмите Ctrl+F, чтобы перевести фокус в строку поиска. Поиск охватывает параметры всех разделов, включая инструменты Harness и управление пользовательскими провайдерами; выбор результата открывает нужный раздел и фокусирует соответствующий элемент. Для названий отдельных моделей используется собственный поиск в разделе Models.

В компактной боковой панели сначала идут основные настройки, затем расширения в группе Customization и внешние сервисы в группе Integrations. Связанные параметры собраны в карточки: страница General разделена на Interface, Privacy и Danger zone, а страница Agents — на Assistant, Summarization и Tools.

Kodik запоминает активный раздел настроек при перезагрузке рабочего окна. Если снова открыть настройки Kodik без указания конкретного раздела, откроется раздел, который использовался последним.

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

Идентификаторы хранилища

Установленный Kodik использует .kodik для runtime-профиля и глобального дома. Development-сборка из исходников сохраняет брендинг Kodik, но по умолчанию использует отдельный идентификатор .kodik-dev для runtime, глобальных assets, расширений, argv, сессий, конфигурации sub-agents и CLI. При первом запуске после перехода Kodik перемещает прежний runtime code-oss-dev как единый профиль, чтобы User, Local State, настройки, сессии и контекст зашифрованных секретов оставались вместе. Если целевая папка уже содержит данные, старый профиль неполон или используется, либо прерванный перенос оставил конфликтующих владельцев, запуск останавливается и сохраняет обе папки для проверки.

Portable production хранит runtime в <portable>/user-data, глобальные assets и CLI — в <portable>/.kodik, расширения — в <portable>/extensions, а аргументы запуска — в <portable>/argv.json. Portable development использует соответствующие владельцы user-data-dev, .kodik-dev, extensions-dev и argv-dev.json. Переключения на домашнюю папку хоста нет. Системное хранилище ключей и зарегистрированные tunnel-сервисы остаются ресурсами хоста; после переноса носителя нужно войти снова или явно перенести сервис с исходного компьютера.

Глобальные assets в нижнем регистре

Kodik переносит шесть категорий глобальных assets в lowercase-папки активного глобального дома: skills, commands, rules, memories, hooks и plugins. Production обычно использует ~/.kodik, development — ~/.kodik-dev, а portable-установка — соответствующий дом на своём носителе. Новые файловые определения агентов используют lowercase-путь .kodik/agents, но старые Markdown-агенты не перемещаются и не импортируются; актуальные профили хранятся в sub-agents.json или установленном плагине.

При первом запуске с этой схемой Kodik инвентаризирует прежние uppercase-категории, не переходя по ссылкам, и завершает перенос до открытия первого рабочего окна. Перемещение внутри одного дома проходит без диалога. Если исходные имена неоднозначны по правилам регистра или Unicode целевой файловой системы, Kodik просит выбрать сохраняемый источник. Portable- или другой cross-home перенос выполняется через staging и проверку; если точное сохранение метаданных нельзя доказать, Kodik запрашивает согласие. Существующее lowercase-содержимое всегда авторитетно, точные дубликаты объединяются, а конфликты и сохранённые оригиналы остаются доступными в .kodik/.migration/global-assets-v1/.

Зафиксированный манифест навсегда отмечает завершённый переход. Kodik не показывает повторно окно гидратации, не удаляет автоматически сохранённые материалы и не читает uppercase-папки, созданные после перехода. Такое позднее содержимое нужно вручную перенести в документированную lowercase-папку.

Совместимость рабочей области с Code OSS

Kodik сохраняет .vscode под внешним владельцем и читает оттуда только закрытый набор ресурсов рабочей области Code OSS: settings.json, tasks.json, launch.json, extensions.json, каталог extensions/ и mcp.json. Соответствующий JSON-ресурс в .kodik является каноническим. Читаемый канонический файл выбирается целиком; .vscode допускается только при его отсутствии. Если канонический файл повреждён или недоступен для чтения, Kodik сообщает об ошибке и не переключается на .vscode молча.

Нативные действия редактора могут по-прежнему изменять активные файлы настроек, задач, запуска, рекомендаций расширений и snippets в .vscode. Новая конфигурация, принадлежащая Kodik, по умолчанию создаётся в .kodik, а настройки Kodik никогда не перезаписывают compatibility-файл. Остальные элементы .vscode остаются под владельцем Code OSS или расширений и не становятся хранилищем Kodik.

Разделы настроек

Account

Профиль вошедшего в систему пользователя, текущий тарифный план и его статус, баланс кредитов, история использования по моделям и сессиям, информация о пробном периоде и реферальная программа. Подробнее — на странице Аккаунт и использование.

General

Общие параметры поведения Kodik:

Язык интерфейса — язык UI (вызывает стандартную команду VS Code для смены локали). Русский язык встроен в приложение и используется по умолчанию; после перезапуска выбранный язык применяется к сообщениям чата, карточкам инструментов и статусов, навигации по сессиям, настройкам моделей и остальному интерфейсу Kodik.
Язык ответов AI — на каком языке AI-ассистент отвечает по умолчанию.
Уведомления — включение и настройка системных уведомлений.
Сбросить состояние — кнопка сброса всех настроек Kodik к значениям по умолчанию.

Harness

Единая пользовательская настройка того, что Kodik отправляет модели. Выберите Plan, Code, Ask, Debug, Educator или Orchestrator: единственный переключатель в строке инструмента изменяет только выбранный режим. Harness показывает только структурно поддерживаемые инструменты, а остальные кратко перечисляет как недоступные. Списки действий доступны только для просмотра и описывают эффективную схему; отдельных переключателей действий нет. Orchestrator предоставляет только фиксированные инструменты координации; доступ субагентов настраивается отдельно в Sub Agents и затем пересекается с остальными политиками среды выполнения.

Список Sub-agents in this mode определяет, какие настроенные профили выбранный родительский режим может запускать. Это не меняет сам профиль: у каждого субагента остаются собственные инструкции, модель, reasoning effort и инструменты. Глобально отключённый в Sub Agents профиль виден в Harness, но недоступен до повторного включения.

Общий бюджет объединяет токены активных схем инструментов и системного промпта и показывает экономию относительно стандартного состояния выбранного режима. Предпросмотр в Настройках не привязан к открытому чату: на вкладке Orchestrator он учитывает пустую сводку Team Workspace, а реальные ходы Orchestrator используют записи текущего чата. Можно отключить все инструменты, Generate plans в режиме Plan или подсказки Protected content — изменение применяется сразу, а Harness показывает предупреждение.

Строки системного промпта раскрываются в точный текст следующего запроса. Необязательные разделы настраиваются отдельно для каждого режима. Для правил Agents, пользовательских правил, памяти, навыков, профилей субагентов, MCP-серверов и необязательных значений Environment доступны отдельные флажки источников; они убирают только текст промпта, не отключая и не удаляя сам источник. Working directory и Shell всегда обязательны.

Подключённые MCP-инструменты находятся в том же списке после встроенных во всех режимах и имеют один переключатель режима, метку сервера, оценку токенов и ссылку Manage MCP. Настройки MCP по-прежнему отвечают за подключение, авторизацию, состояние сервера и собственные настройки инструментов.

Agents

Инструменты и поведение агента:

Инструменты — ссылка на раздел Harness, где находится единая политика доступности инструментов и подсказок промпта. Agents сохраняет настройки поведения ассистента, отображения изменений и суммаризации.
Подсказки ассистента — предлагать ли следующий шаг после ответа.
Отображение изменений файлов — открывать ли отредактированные файлы, включая ноутбуки, в редакторе и разворачивать ли изменения по умолчанию.
Отображение рассуждений — разворачивать ли сообщения с рассуждениями автоматически во время стриминга. После завершения стрима они сворачиваются; панели, открытые вручную, остаются открытыми. По умолчанию параметр выключен.
Триггеры суммаризации — когда агент должен сжимать длинные диалоги.
Session memory — может ли инструмент memory сохранять временные заметки задачи внутри текущей chat-сессии и добавлять их после сжатия.

Auto Approve

Когда агент может действовать без запроса:

Авто-подтверждение — главный переключатель и разрешения по инструментам: какие действия агент выполняет без явного разрешения пользователя (чтение файлов, редактирование и т. д.). Переключатели автоодобрения недоступного инструмента неактивны. Подробнее — на странице Авто-подтверждение.
Autopilot — режим полной автономности агента.
Заблокированные команды — список шаблонов команд, которые агент никогда не выполнит (например, rm *, sudo rm *, git clean*).
Паттерны команд — настраиваемые шаблоны для авто-разрешения конкретных команд.

Autocomplete

Параметры встроенного автодополнения:

Включить автодополнение — глобальное включение и отключение.
Задержка (debounce) — время ожидания после остановки ввода перед отправкой запроса.
Источник модели — какая модель используется для автодополнения: модель Kodik по умолчанию, локальная модель Ollama или один из ваших пользовательских провайдеров (со своим ключом). Варианты Ollama загружаются с текущего эндпоинта, поэтому сам выпадающий список служит индикатором доступности без отдельного сообщения о статусе под ним. Смена выбранной модели не удаляет другие модели, возвращённые работающим эндпоинтом.
Игнорируемые файлы — glob-паттерны файлов, в которых автодополнение отключается.
Дополнения в импортах и строках — включение подсказок в операторах импорта и строковых литералах.

Параметры kodik.autocompleteDisableLineRegex и kodik.autocompleteDisableFileRegex (см. раздел settings.json ниже) дают более точный контроль через регулярные выражения. Подробнее — на странице Автодополнение.

Models

Управление доступными моделями:

Включение и отключение моделей — управление тем, какие облачные модели Kodik отображаются при выборе.
Значки поставщиков и возможностей — помогают с первого взгляда определить семейство известной модели в этом списке и в меню выбора модели в чате. Значки изображений и мышления появляются только тогда, когда эти возможности указаны в актуальном каталоге моделей; для неизвестных или частных семейств поставщик не подставляется наугад.
Порог суммаризации — при какой длине контекста запускается автоматическое сжатие диалога. По умолчанию это 90% окна модели; порог снижается, только если провайдер сообщает максимальный размер ответа, для которого нужно оставить больше места. Для пользовательской модели, которая сообщает лишь окно контекста, Kodik не придумывает резерв ответа. В интерфейсе показывается точное эффективное значение, а заданный для модели порог сохраняется после перезапуска.

Indexing

Настройки семантического индексирования кодовой базы:

Синхронизация — запуск индексирования. Если активная индексация была приостановлена, работа продолжается с сохранённого прогресса по файлам с учётом изменений, сделанных во время паузы.
Удалить индекс — полная очистка локального индекса.
Пауза — остановка текущей индексации с сохранением прогресса по обработанным файлам и временная приостановка автоматической синхронизации.
Игнорировать .gitignore — не исключать пути, указанные в .gitignore.
Игнорировать .kodikignore — не исключать пути, указанные в .kodikignore.

Индекс хранится локально как SQLite в пользовательских данных Kodik для рабочего пространства, вне папки проекта. Подробнее — на странице Индексирование.

Ollama

Управление локальным эндпоинтом Ollama:

Статус установки и запуска Ollama.
Проверка доступности локального сервера.
Выбор модели Ollama для использования в агенте.
Скачивание рекомендованных моделей (Gemma 4 E4B, Qwen3 8B, Devstral 24B, Qwen3 Coder 30B и других).

Подробнее — на странице Локальные модели.

Git

Настройки генерации сообщений коммитов и поведения при работе с Git:

Промпт для сообщений коммитов — дополнительные инструкции к встроенному промпту (kodik.commitMessage.instructions).
Инструкции для pull request — дополнения к промпту генерации заголовка и описания PR (kodik.pullRequest.instructions).
Атрибуция коммитов — добавлять ли трейлер Kodik Co-authored-by в коммиты агента, а также в каждый коммит из панели контроля версий (kodik.git.commitAttribution).
Атрибуция PR — помечать ли pull request’ы агента как созданные с Kodik (kodik.git.prAttribution).
Префикс веток — префикс для новых веток агента; при пустом значении используется kodik/. Kodik принимает префиксы в формате Git ref и возвращается к kodik/, если значение не поддерживается (kodik.git.branchPrefix).
Автоудаление worktree — автоматически удалять старые рабочие деревья агента (kodik.git.autoDeleteWorktrees, по умолчанию: true).
Лимит хранения worktree — сколько рабочих деревьев сохранять перед очисткой (kodik.git.worktreeKeepLimit, по умолчанию: 15).
Статус контроля версий — показывать сводку контроля версий (ветка, опережение/отставание, незакоммиченные изменения, открытый pull request, CI, конфликты) в футере чата. Она обновляется при изменениях репозитория, при возвращении фокуса окна и через действие Refresh в футере; переключение веток отклоняет неподдерживаемые имена до запуска git (kodik.git.statusAutoRefresh, по умолчанию: true).
Интервал обновления статуса — как часто (в миллисекундах) обновлять часть из GitHub (pull request и CI), пока открыт pull request (kodik.git.statusRefreshIntervalMs, по умолчанию: 300000).

Подробнее — на странице AI-сообщения коммитов.

Anonymizer

Настройки защиты конфиденциальных данных:

Включить анонимайзер — активировать маскировку чувствительного контента перед отправкой в модель.
Список файлов с чувствительными регионами — просмотр и удаление вручную помеченных областей.

Подробнее — на странице Анонимайзер.

Skills

Список установленных навыков (skills), обнаруженных в глобальной директории и директории рабочего пространства. Можно включать и отключать отдельные навыки.

Commands

Список установленных пользовательских slash-команд из поддерживаемых директорий рабочего пространства.

Rules

Список установленных файлов правил (rules), обнаруженных в глобальной и рабочей директориях. Можно включать и отключать отдельные файлы правил.

Sub Agents

Максимум одновременно работающих субагентов — задаёт лимит субагентов на один чат от 1 до 16 (по умолчанию 4). Родительская модель видит настроенный лимит, число активных субагентов и свободных мест; когда все места заняты, Chat показывает Достигнут лимит, а результат отклонённого вызова сообщает модели, что перед новым делегированием нужно дождаться завершения одного из субагентов.
Профили — специализированные субагенты, которым любой родительский режим может делегировать задачи через sub_agent; карточки сгруппированы как Default, Workspace, Global и Plugins. Профили Default, Workspace и Global позволяют менять identity, инструкции, точную модель с провайдером, необязательный reasoning effort, инструменты, поиск навыков и состояние. Определения плагинов доступны только для чтения и не выполняют автоматический поиск навыков, но их можно включать и отключать; Open configuration открывает исходное определение внутри плагина.
Доступность по режимам — отключение профиля здесь убирает его из всех родительских режимов. Чтобы скрыть включённый профиль только от Code, Plan, Ask, Debug, Educator или Orchestrator, используйте список Sub-agents in this mode соответствующей вкладки Harness.
Доступность — строки профилей проверяются по текущему каталогу Kodik, endpoint Ollama, Custom Provider, возможностям reasoning и поддержке инструментов. Все модели, возвращённые работающим endpoint Ollama, остаются доступными при смене модели профиля. Маркер ошибки показывает профили, которые нельзя запустить.
Область — первое пользовательское изменение создаёт ~/.kodik/sub-agents.json. Необязательный .kodik/sub-agents.json полностью заменяет пользовательский слой для рабочей области. Settings позволяет создать, сбросить, удалить или открыть выбранную конфигурацию, не удаляя исходные значения.
Без legacy-импорта — отдельные Markdown-профили не переносятся и не импортируются. Создавайте актуальные профили здесь, чтобы Kodik сохранял их в sub-agents.json.

Подробнее: Профили и модели субагентов и Субагенты.

Hooks

Хуки — это shell-команды, которые запускаются в ключевые моменты рабочего процесса AI: при вызове инструментов, отправке промптов, старте и завершении сессии и т. д. Хуки могут блокировать, изменять или просто наблюдать за происходящим.

Memory

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

MCP Servers

Список установленных MCP-серверов, управление их включением и удалением. Подробнее — на страницах раздела MCP.