Модели¶

Koda Desktop позволяет выбирать модель для каждого чата и подключать собственные OpenAI-совместимые модели.

Выбор модели¶

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

Когда список ещё не получен, приложение использует:

• автоматический выбор (модель по умолчанию)
• или модель, сохранённую в настройках

Стоимость моделей¶

Рядом с названием модели может отображаться множитель стоимости — коэффициент, показывающий, сколько от лимита потребляет один запрос к этой модели.

Чем выше множитель, тем больше токенов расходуется на запрос. Для экономии лимитов выбирайте модели с меньшим множителем для простых задач.

Размышления модели¶

Некоторые модели умеют обдумывать запрос перед ответом.

Чем глубже размышления, тем больше времени и токенов модель тратит на анализ и тем выше качество ответа на сложных задачах. Низкие уровни отвечают быстрее и экономнее.

Где переключается уровень¶

Рядом с чипом модели в композере находится переключатель размышлений. Он появляется только для моделей, которые поддерживают размышления.

Список уровней:

Каждая модель поддерживает свой набор уровней — в списке видны только доступные для выбранной модели.

Как переключить с клавиатуры¶

Уровень размышлений можно менять горячими клавишами, не открывая список:

• ⌘⌥↑ / Ctrl + Alt + ↑ — на шаг сильнее;
• ⌘⌥↓ / Ctrl + Alt + ↓ — на шаг слабее.

На границе доступного списка переключение останавливается.

Как сохраняется выбор¶

Выбор уровня запоминается для каждой модели.

Если агент запущен, новый уровень передаётся в живую сессию. Если агент не запущен, выбор сохраняется в общие настройки — тот же ключ, который использует команда /reasoning в CLI. Поэтому уровень, заданный в Desktop, учитывается и в CLI, и наоборот.

Если модель не поддерживает сохранённый уровень, автоматически используется уровень по умолчанию для этой модели.

Пользовательские модели¶

Во вкладке Модели в настройках можно подключить собственную OpenAI-совместимую модель. После подключения модель появится в списке выбора моделей в композере.

Добавление модели¶

1. Откройте Настройки → вкладка Модели

2. Заполните поля:

   • Base URL — адрес API-сервера (например, https://api.example.com/v1)
   • API-ключ — ключ доступа к API (например, sk-…)
   • Идентификатор модели — идентификатор модели (например, openai/gpt-4.1 или provider/model)

3. Нажмите **Добавить модель»

Подсказки по идентификатору¶

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

Безопасность API-ключа¶

Редактирование и удаление¶

• Нажмите иконку карандаша, чтобы отредактировать модель
• При редактировании можно оставить поле API-ключа пустым, чтобы сохранить текущий
• Нажмите иконку корзины, чтобы удалить модель

Модели и изображения¶

Не все модели поддерживают изображения. Если вы приложили скриншот или изображение, а выбранная модель не поддерживает картинки, композер покажет предупреждение. В этом случае выберите другую модель из списка.