Подключение Coding Agent

Qwen Code: настройка API Key, Base URL и ограничения чтения файлов

Настройте Qwen Code с API Key BetterToken, Base URL и протоколом Responses. Проверьте текстовый запрос и учтите ограничения при чтении файлов инструментами.

Подключите Qwen Code к BetterToken через modelProviders.openai в ~/.qwen/settings.json. В тестах на macOS с моделью GPT Qwen Code 0.26.0 выполнил текстовые запросы через Responses и Chat Completions.

Ключевые параметры

Поле	Значение
API Key	API Key BetterToken со ссылкой через `envKey`
Base URL	`https://bettertoken.ai/v1` в `baseUrl`
Model	`YOUR_MODEL_ID`
Настройка провайдера	`modelProviders.openai`
Формат API	`wireApi: "responses"`

Подготовка

Node.js 22 или новее для установки через npm ниже
API Key BetterToken: зарегистрироваться и получить
Model ID из каталога моделей

Установка

Используйте установку через npm из официальной краткой инструкции:

npm install -g @qwen-code/qwen-code@latest
qwen --version

Ручная настройка

Задайте API Key в терминале, заменив YOUR_API_KEY:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Добавьте эти настройки в ~/.qwen/settings.json. Замените оба YOUR_MODEL_ID одним и тем же точным Model ID:

{
  "modelProviders": {
    "openai": [
      {
        "id": "YOUR_MODEL_ID",
        "envKey": "BETTERTOKEN_API_KEY",
        "baseUrl": "https://bettertoken.ai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "YOUR_MODEL_ID"
  }
}

В envKey указывается имя переменной окружения, а не сам API Key. Согласно официальному справочнику провайдеров моделей, также поддерживается wireApi: "chat-completions". В этом тесте через Responses было больше успешных попыток чтения файлов, но ни один из форматов не прошёл все попытки.

Проверка подключения

Выполните эту проверку только текстового запроса в том же терминале:

qwen -p "Reply with only: OK" --output-format stream-json --max-session-turns 4

Убедитесь, что итоговый ответ — OK. Успешный текстовый запрос не подтверждает, что задача чтения файла завершится правильным итоговым ответом. При выборе рабочего процесса учитывайте ограничение выше.

Смена модели

Добавьте запись модели в modelProviders.openai, укажите её точный id в model.name и начните новую сессию.

Частые ошибки

Симптом	Что проверить
Ошибка авторизации	Экспортируйте переменную с именем из `envKey` в терминале, из которого запускаете Qwen Code.
Неверный адрес API	Укажите `https://bettertoken.ai/v1` в `baseUrl`; протокол запросов выбирает `wireApi`.
Модель не найдена	Значение `model.name` должно совпадать с одним из `id` в `modelProviders.openai`.
Пустой или неверный ответ после чтения файла	Это происходило в 0.26.0 даже при правильных результатах инструментов. Переход на Responses не устранил сбои; используйте другой протестированный клиент для задач чтения файлов.

См. также

Технические детали

wireApi: "responses" выбирает /v1/responses; wireApi: "chat-completions" выбирает /v1/chat/completions. В тестах Qwen Code 0.26.0 оба маршрута текстовых запросов прошли проверку. Результаты чтения файлов — 2/3 и 0/3 соответственно.