Qwen Code API: настройка ключа и OpenAI-совместимого провайдера
Qwen Code API можно подключить к Relay через OpenAI-совместимого провайдера: нужны ключ, https://relay-llm.ru/v1 и ID модели, например qwen3.8-max. Настройки задаются в конфигурации Qwen Code, а ключ передаётся процессу через окружение. Ниже пример конфигурации, отдельная проверка API и первый запуск на небольшой задаче. Название клиента Qwen Code не означает, что любая модель Qwen автоматически подходит для работы агента.
Как настроить Qwen Code API
Установите клиент по руководству своего релиза и убедитесь, что запускается команда qwen. Здесь рассматривается настройка уже установленного клиента. Поддержку собственных провайдеров и переменные окружения описывает официальное руководство Qwen Code.
Создайте отдельный ключ в Relay. Он использует баланс вашего аккаунта, а не подписку или бесплатную квоту стороннего клиента. Для теста задайте список разрешённых моделей и лимит расходов. Доступные способы пополнения проверяйте на странице цен и в кабинете.
В Bash или Zsh подготовьте переменные. Значение ключа вымышленное, его нужно заменить своим через безопасный способ передачи секрета:
export RELAY_API_KEY="sk-demo-not-a-real-key"
export OPENAI_API_KEY="$RELAY_API_KEY"
export OPENAI_BASE_URL="https://relay-llm.ru/v1"
export OPENAI_MODEL="qwen3.8-max"Qwen Code читает свои имена переменных, поэтому одной RELAY_API_KEY без настройки недостаточно. Не печатайте OPENAI_API_KEY для проверки. Запускайте клиент из этого терминала либо передайте те же переменные его рабочему процессу.
Откройте ~/.qwen/settings.json и добавьте конфигурацию. Если там уже есть настройки, объедините объекты: полная замена файла может удалить другие профили.
{
"modelProviders": {
"openai": [
{
"id": "qwen3.8-max",
"name": "Relay Qwen",
"envKey": "OPENAI_API_KEY",
"baseUrl": "https://relay-llm.ru/v1"
}
]
},
"security": { "auth": { "selectedType": "openai" } },
"model": { "name": "qwen3.8-max" }
}Пример выбирает OpenAI-совместимый режим. Схему сверяйте с руководством установленной версии. Не переносите сюда флаги авторизации из старого видео: интерфейс клиента меняется. Значение envKey обозначает имя переменной, а не сам секрет.
Как проверить Qwen API отдельно от агента
Сначала выполните запрос из того же терминала. Он проверяет ключ, маршрут и модель без чтения файлов проекта:
curl --fail-with-body --show-error https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"qwen3.8-max",
"messages":[{"role":"user","content":"Объясни результат Python-выражения len(\"\") одним предложением."}]
}'Текст ответа находится в choices[0].message.content. Если API вернул ошибку, сначала исправьте её по документации Chat Completions, затем возвращайтесь к клиенту. Не включайте повторы на неверном ключе: они не изменят результат авторизации.
После успеха запустите qwen в отдельной тестовой папке и попросите объяснить то же выражение. Не начинайте с правки большого репозитория. Если простой запрос проходит, а клиент нет, сравните протокол, модель и источник ключа в активном профиле. Сохранённая настройка может отличаться от переменных нового терминала.
Какой Qwen выбрать для кода
В каталоге есть qwen3.8-max и qwen3.8-flash. Они имеют тип chat. Это подтверждает возможность текстового обращения, но не качество рефакторинга, длину контекста или поддержку каждого инструмента Qwen Code. Ограничения и протокол выбранной модели проверяйте в карточке.
Для объяснения кода дайте короткую функцию и проверьте ответ по её реальному поведению. Для изменения задайте воспроизводимый результат: например, тест на пустую строку должен проходить после правки. Для поиска ошибки выберите небольшой diff, где вы знаете причину сбоя. Так станет видно, помогает ли конкретная модель в вашей работе.
Проверьте инструменты отдельным следующим шагом: чтение тестового файла, затем предложение правки, затем изменение с просмотром diff. Успешный текстовый ответ не доказывает, что клиент правильно разбирает tool_calls и исполняет их в нужной папке.
Как разбирать ошибки ключа, пути и модели
При 401 проверьте, видит ли процесс переменную, указанную в envKey. При 404 сравните итоговый URL: повторный /v1 или путь /chat/completions внутри baseUrl могут испортить запрос. При model_not_found скопируйте ID заново из каталога. Не заменяйте его словами «Qwen Coder».
При 400 прочитайте сообщение об ошибке и проверьте дополнительные поля клиента. Если короткий curl работает, сначала сравните его тело с телом запроса Qwen Code, удалив секреты и содержимое проекта. Смена модели без этого сравнения скроет исходную причину.
После первого запуска проверьте журнал Relay: модель, токены и стоимость. Разделяйте расход на объяснение и многократную агентскую правку. Если агент ходит по кругу, остановите его, прочитайте diff и уточните задачу. Денежные лимиты ключа и ограничения на локальные инструменты решают разные проблемы; настройки описаны на странице ключей.
Где получить Qwen Code API key для Relay?
Создайте ключ в кабинете Relay. В показанной конфигурации передайте его процессу как OPENAI_API_KEY. Ключ другого сервиса не авторизует запрос к Relay.
Qwen Coder API и Qwen Code означают одно и то же?
Нет. Qwen Code обозначает клиент, а Qwen Coder может обозначать семейство моделей. Для запроса нужен точный публичный ID из каталога выбранного сервиса.
Нужен ли отдельный Qwen Coder API key для каждой модели?
В Relay один ключ подходит для разрешённых ему моделей. При смене модели обновите ID и проверьте протокол, ограничения и работу инструментов клиента.