# Qwen

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

Language: ru

> Использование aicentos в Qwen Code — настройка OpenAI-совместимого провайдера через settings.json

Qwen Code позволяет через `modelProviders` в `settings.json` зарегистрировать любой OpenAI-совместимый эндпоинт. Направьте `baseUrl` на aicentos — и модели, подключённые к aicentos, станут доступны в Qwen Code.

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

Сначала создайте на странице «API Key» в консоли отдельный ключ для Qwen Code (рекомендуемое имя `qwen-code` — так проще отслеживать расход).

* Консоль: [https://aicentos.com](https://aicentos.com)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение кошелька: [https://aicentos.com/wallet](https://aicentos.com/wallet)
* Сайт документации: [https://docs.aicentos.com](https://docs.aicentos.com)

Qwen Code требует Node.js 20+, глобальная установка через npm:

```bash
npm install -g @qwen-code/qwen-code
qwen --version
```

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

| Поле      | Значение                                                        |
| --------- | --------------------------------------------------------------- |
| Тип auth  | `openai` (OpenAI-совместимый протокол)                          |
| baseUrl   | `https://aicentos.com/v1`                                       |
| envKey    | Имя переменной окружения, где хранится ключ (можно задать своё) |
| ID модели | имя модели из «витрины моделей» в консоли                       |

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

Отредактируйте `~/.qwen/settings.json`:

```json
{
  "env": {
    "AICENTOS_API_KEY": "sk-ваш-ключ"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "baseUrl": "https://aicentos.com/v1",
        "envKey": "AICENTOS_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "gpt-4o"
  }
}
```

* `id` — это ID модели, реально отправляемый на сервер; он должен совпадать с именем модели в консоли.
* В `modelProviders` ключ в открытом виде не пишется: `envKey` — лишь ссылка на то, «из какой переменной окружения брать ключ».
* Приоритет ключа: системная переменная окружения > файл `.env` (`~/.qwen/.env`) > блок `env` в `settings.json`.
* Если на стороне aicentos используется протокол Responses, добавьте для модели `"wireApi": "responses"`; без этого по умолчанию идёт Chat Completions.

Можно и вовсе не менять файл конфигурации, а использовать переменные окружения напрямую:

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-ваш-ключ"
export OPENAI_MODEL="gpt-4o"
```

## Проверка

Запустите `qwen`, через `/about` убедитесь, что текущие эндпоинт и модель верны, и отправьте простой промпт. Если настроено несколько записей провайдеров, переключаться можно через `/model`.

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

* Глобальная конфигурация лежит в `~/.qwen/settings.json`, конфигурация проекта — в `.qwen/settings.json` в корне проекта, и у последней приоритет выше.
* `security.auth.selectedType` должен быть `openai`, иначе кастомный эндпоинт использоваться не будет.
* Не коммитьте открытый ключ в систему контроля версий; лучше используйте `~/.qwen/.env` или системные переменные окружения.
* `wireApi` — лишь локальные метаданные маршрутизации, в теле запроса не передаются; прежде чем ставить `responses`, убедитесь, что aicentos поддерживает `/v1/responses`.
* Base URL указывайте только до `/v1`, не дописывайте полный путь к методу.