# Junie

Источник: https://docs.aicentos.com/ru/clients/junie

Language: ru

> Подключение aicentos в Junie CLI через кастомный профиль модели

Junie — агент для программирования от JetBrains, выпускается в двух формах: плагин для IDE и Junie CLI. **Направить на кастомный эндпоинт умеет только Junie CLI**: он подключается к любому OpenAI-совместимому сервису через JSON-профили в `$JUNIE_HOME/models/`. Плагин для IDE пока не поддерживает кастомные эндпоинты.

## Подготовка

Сначала создайте на странице «API Key» в консоли отдельный ключ для Junie (рекомендуемое имя `junie-cli`).

* Консоль: [https://aicentos.com](https://aicentos.com)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение при нехватке баланса: [https://aicentos.com/wallet](https://aicentos.com/wallet)

## Конфигурация для заполнения

| Поле                           | Значение                                                     |
| ------------------------------ | ------------------------------------------------------------ |
| `baseUrl`                      | `https://aicentos.com/v1/chat/completions`                   |
| `apiType`                      | `OpenAICompletion`                                           |
| `apiKey`                       | ключ, созданный в консоли (поддерживает ссылку `${ENV_VAR}`) |
| `id`                           | имя модели из «витрины моделей» в консоли                    |
| `displayName` / `providerName` | на ваш выбор, например `aicentos`                            |

Обратите внимание: профиль Junie, в отличие от большинства клиентов, требует в `baseUrl` указывать **полный эндпоинт** — он обязательно должен заканчиваться на `/chat/completions`, путь Junie сам не дописывает.

## Шаги настройки

* Создайте файл профиля (имя файла без `.json` — идентификатор профиля):
  * Пользовательский уровень: `~/.junie/models/aicentos.json` (`$JUNIE_HOME` по умолчанию — `~/.junie`)
  * Уровень проекта: `<корень проекта>/.junie/models/aicentos.json` (проект должен быть отмечен как доверенный)
* Запишите в него следующее:

```json
{
  "id": "gpt-5",
  "baseUrl": "https://aicentos.com/v1/chat/completions",
  "apiType": "OpenAICompletion",
  "apiKey": "${AICENTOS_API_KEY}",
  "displayName": "aicentos GPT",
  "providerName": "aicentos",
  "fasterModel": { "id": "gpt-5-mini" }
}
```

* Экспортируйте переменную окружения:

```bash
export AICENTOS_API_KEY="sk-ваш-ключ-aicentos"
```

* Укажите профиль при запуске или выберите его командой `/model` в интерактивном интерфейсе:

```bash
junie --model custom:aicentos
```

## Проверка

Сразу после запуска сделайте лёгкий тест с простым промптом и переходите к полноценным agentic-сценариям, только когда результат возвращается нормально.

## Примечания

* **Плагин JetBrains IDE не поддерживает кастомные эндпоинты**; этот профиль работает только в Junie CLI.
* `baseUrl` должен быть полным эндпоинтом (с `/v1/chat/completions`), в отличие от многих клиентов, где достаточно Base URL.
* Ссылки `${VAR}` в `apiKey` и `extraHeaders` разрешаются при загрузке профиля; если переменная окружения не задана, профиль загрузится с ошибкой.
* Профили уровня проекта ограничены доверием к проекту: в недоверенном проекте будет ошибка `Unknown custom model profile`.
* Слабым моделям трудно справляться с многошаговыми вызовами инструментов и длинным контекстом Junie — выбирайте модель с более сильными возможностями.
* Подробнее см. на сайте документации: [https://docs.aicentos.com](https://docs.aicentos.com)