> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка кастомной модели Kodacode через LLMEasy

> Настройте кастомную OpenAI-compatible модель в расширении Kodacode / Koda для VS Code.

Расширение Kodacode для VS Code может использовать модели в chat, agent и edit workflows. Для подключения LLMEasy добавьте модель **Any OpenAI-compatible API** и используйте API Key из группы GPT.

<Info>
  В этом руководстве показан пример для расширения VS Code. В документации Kodacode указано, что нужна версия VS Code `1.75` или новее, а ID расширения — `Koda.koda`.
</Info>

## Требования

* Установлен VS Code
* Установлено расширение Kodacode / Koda
* API Key LLMEasy (<a href={"https://www.llmeasy.ru/register"}>зарегистрироваться</a>)
* API Key относится к группе **GPT**
* ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>, например `gpt-5.5`

## Настройка

<Steps>
  <Step title="Откройте панель Koda и добавьте модель">
    Откройте панель **KODA** в боковой панели VS Code, нажмите на selector модели под полем ввода и выберите **Добавить модель: Agent** / **Add model: Agent**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/JsSNwp3BGwYpLlK1/images/kodacode/select-model-menu.png?fit=max&auto=format&n=JsSNwp3BGwYpLlK1&q=85&s=867c818ce56ad909161f7fd3dcab2e47" alt="Выбор Add model: Agent в selector модели на панели Koda." style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/kodacode/select-model-menu.png" />
    </Frame>
  </Step>

  <Step title="Заполните настройки OpenAI-compatible модели">
    В окне добавления модели заполните поля так:

    | Поле     | Рекомендуемое значение                                                                                 |
    | -------- | ------------------------------------------------------------------------------------------------------ |
    | Provider | `Any OpenAI-compatible API`                                                                            |
    | API Base | `https://www.llmeasy.ru/v1/`                                                                           |
    | Model ID | ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>, например `gpt-5.5` |
    | API Key  | Ваш API Key LLMEasy                                                                                    |

    После заполнения нажмите **Подключить** / **Connect**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/JsSNwp3BGwYpLlK1/images/kodacode/add-openai-compatible-model.png?fit=max&auto=format&n=JsSNwp3BGwYpLlK1&q=85&s=f3da14509732195af35771da421ecb47" alt="В окне добавления модели Kodacode выбран Any OpenAI-compatible API и заполнены API Base, Model ID и API Key." style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/kodacode/add-openai-compatible-model.png" />
    </Frame>
  </Step>

  <Step title="Проверьте, что модель активна">
    После успешного подключения выберите новую модель, например `gpt-5.5`, в selector модели под полем ввода Koda. Отправьте короткое сообщение и проверьте, что ответ приходит.
  </Step>

  <Step title="Проверьте config.yaml">
    Kodacode записывает конфигурацию в `~/.koda/config.yaml`. Откройте этот файл и проверьте, что модель добавлена.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/JsSNwp3BGwYpLlK1/images/kodacode/config-yaml-result.png?fit=max&auto=format&n=JsSNwp3BGwYpLlK1&q=85&s=749b52ab5ef35f22fb278825b08f8d09" alt="Файл config.yaml Kodacode с добавленной OpenAI-compatible моделью." style={{ borderRadius: '0.5rem' }} width="1570" height="1600" data-path="images/kodacode/config-yaml-result.png" />
    </Frame>
  </Step>
</Steps>

## Пример config.yaml

Ниже полная структура для проверки. Замените `YOUR_API_KEY` на ваш API Key LLMEasy и не коммитьте реальный API Key в репозиторий.

```yaml theme={null}
name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: gpt-5.5
    provider: openai
    model: gpt-5.5
    apiKey: YOUR_API_KEY
    apiBase: https://www.llmeasy.ru/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase
```

<Note>
  Если вы используете не `gpt-5.5`, измените и `name`, и `model`, чтобы они совпадали с ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>.
</Note>

## Troubleshooting

* Если подключение не работает, проверьте, что **API Base** равен `https://www.llmeasy.ru/v1/`, включая завершающий `/`.
* Если модель недоступна, проверьте, что **Model ID** относится к группе GPT.
* Если возникает ошибка авторизации, скопируйте API Key заново и проверьте, что нет лишних пробелов или переносов строки.
* Если изменения в `config.yaml` не применились, перезапустите VS Code или выполните **Developer: Reload Window**.
* LLMEasy обычно не требует дополнительного `User-Agent` или custom headers.

## Ссылки

* [Обзор расширения Kodacode](https://docs.kodacode.ru/plugin/overview.html)
* [Установка расширения Kodacode](https://docs.kodacode.ru/plugin/install.html)