# Настройки

> Обзор встроенного редактора настроек Kodik и справочник по параметрам settings.json.

Источник: https://docs.kodik.ru/configuration/settings

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

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

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

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

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

### Account

Профиль вошедшего в систему пользователя, текущий тарифный план и его статус, баланс кредитов, история использования по моделям и сессиям, информация о пробном периоде, ежедневный бонус кредитов и реферальная программа. Подробнее — на странице [Аккаунт и использование](https://docs.kodik.ru/account/overview).

### General

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

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

### Harness

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

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

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

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

### Agents

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

- **Инструменты** — ссылка на раздел [Harness](#harness), где находится единая политика доступности инструментов и подсказок промпта. Agents сохраняет настройки поведения ассистента, отображения изменений, суммаризации и скрытой модели субагентов.
- **Подсказки ассистента** — предлагать ли следующий шаг после ответа.
- **Отображение изменений файлов** — открывать ли отредактированные файлы, включая ноутбуки, в редакторе и разворачивать ли изменения по умолчанию.
- **Триггеры суммаризации** — когда агент должен сжимать длинные диалоги.
- **Session memory** — может ли инструмент `memory` сохранять временные заметки задачи внутри текущей chat-сессии и добавлять их после сжатия.
- **Модель вспомогательного агента (Sub-agent)** — выбор модели, которую использует внутренний субагент.

### Auto Approve

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

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

### Autocomplete

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

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

Параметры `kodik.autocompleteDisableLineRegex` и `kodik.autocompleteDisableFileRegex` (см. раздел `settings.json` ниже) дают более точный контроль через регулярные выражения. Подробнее — на странице [Автодополнение](https://docs.kodik.ru/features/autocomplete).

### Models

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

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

### Indexing

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

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

Индекс хранится локально как SQLite в пользовательских данных Kodik для рабочего пространства, вне папки проекта. Подробнее — на странице [Индексирование](https://docs.kodik.ru/context/indexing).

### Ollama

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

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

Подробнее — на странице [Локальные модели](https://docs.kodik.ru/models/local-models).

### 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-сообщения коммитов](https://docs.kodik.ru/features/commit-messages).

### Anonymizer

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

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

Подробнее — на странице [Анонимайзер](https://docs.kodik.ru/features/anonymizer).

### Skills

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

### Commands

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

### Rules

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

### Sub Agents

Список специализированных агентов, которым основной ассистент может делегировать задачи через инструмент `sub_agent`. Встроенные агенты доступны всегда; включённые проектные профили из `.kodik/agents/`, личные профили из `~/.kodik/Agents/` и профили плагинов передаются модели из этого реестра.

### Hooks

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

### Memory

Просмотр и управление долгосрочными воспоминаниями, которые Kodik сохранил для текущего рабочего пространства и глобально. Перед сохранением секреты автоматически удаляются из содержимого воспоминаний. Подробнее — на странице [Память](https://docs.kodik.ru/context/memory).

### MCP Servers

Список установленных MCP-серверов, управление их включением и удалением. Подробнее — на страницах раздела [MCP](https://docs.kodik.ru/mcp/overview).

---

## Справочник settings.json

### Браузерный предпросмотр

| Параметр                | Тип       | По умолчанию | Описание                                                                                                               |
| ----------------------- | --------- | ------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `kodik.preview.enabled` | `boolean` | `true`       | Разрешает агенту управлять Integrated Browser. Если выключено, инструмент `browser` недоступен в сессиях Code и Debug. |
