Qwen Code без OAuth: как настроить агент на свой ключ и OpenAI-совместимый API
После закрытия бесплатного OAuth-доступа к Qwen Code в апреле 2026 года российские разработчики столкнулись с невозможностью использовать официальные методы аутентификации. Однако инструмент можно настроить на любой OpenAI-совместимый endpoint с собственным ключом, минуя браузерный вход и иностранные платёжные системы.
Qwen Code — это открытый терминальный агент, разработанный командой QwenLM. Он представляет собой CLI-инструмент, который читает репозиторий, редактирует файлы и выполняет команды в оболочке, аналогично Claude Code и Gemini CLI (проект является форком последнего). После закрытия бесплатного OAuth-тарифа 15 апреля 2026 года и сохранения платных подписок Plus/Pro, недоступных для оплаты из России, разработчики ищут обходные пути. Настройка на произвольный OpenAI-совместимый провайдер с собственным ключом позволяет обойти эти ограничения. Важно понимать, что Qwen Code — не просто чат, а полноценный агент, интегрированный с файловой системой и командной оболочкой, что делает его мощным инструментом для автоматизации рутинных задач разработки.
Официальные способы аутентификации Qwen Code требуют либо подписки Qwen Plus/Pro с браузерным OAuth, либо доступа к Alibaba Cloud Model Studio с иностранной картой. Российские карты «Мир» и СБП не принимаются. В результате единственным рабочим вариантом остаётся использование стороннего OpenAI-совместимого шлюза, который можно оплатить локально. Для этого достаточно изменить три параметра в конфигурации: baseUrl, ключ и идентификатор модели. Установка Qwen Code не вызывает сложностей: на Linux и macOS используется curl-скрипт, на Windows — PowerShell-команда, также доступна установка через npm (требуется Node.js 22+) или Homebrew. После установки необходимо перезапустить терминал для обновления PATH. Команда qwen auth упразднена; интерактивная настройка теперь выполняется через /auth внутри сессии, а диагностика — через /doctor. Стоит отметить, что проект активно развивается, и синтаксис конфигурации может меняться, поэтому рекомендуется сверяться с официальной документацией.
Пользовательский конфигурационный файл располагается по пути ~/.qwen/settings.json (на Windows — %USERPROFILE%\.qwen\settings.json). В нём необходимо определить провайдера в секции modelProviders.openai, указав произвольный id (например, qwen3-coder-plus), name, baseUrl (адрес API, обычно заканчивающийся на /v1), description и envKey — имя переменной окружения, содержащей ключ (по умолчанию OPENAI_API_KEY). Также следует установить security.auth.selectedType в значение "openai" и model.name, совпадающее с выбранным id. Сам ключ рекомендуется хранить в файле ~/.qwen/.env, а не в settings.json, чтобы избежать его попадания в систему контроля версий. Переменные окружения загружаются в порядке приоритета: флаги CLI, экспортированные переменные оболочки, первый найденный .env (поиск идёт от текущей директории вверх до домашней), затем блок env в settings.json. Если ключ игнорируется, стоит проверить echo $OPENAI_API_KEY — возможно, старая переменная в ~/.bashrc перекрывает новый файл. Поле wireApi можно не указывать: для протокола openai по умолчанию используется chat-completions; значение responses требуется только для специфичных endpoint. Для быстрого запуска без JSON достаточно экспортировать OPENAI_API_KEY, OPENAI_BASE_URL и OPENAI_MODEL (алиас QWEN_MODEL) и запустить qwen. Также поддерживаются проектные настройки в .qwen/settings.json, которые перекрывают пользовательские, что позволяет адаптировать агент под конкретный репозиторий.
Qwen Code появился как форк Gemini CLI, что подчёркивает стремление QwenLM создать открытый и расширяемый инструмент. Однако закрытие бесплатного OAuth в апреле 2026 года стало частью общей тенденции монетизации AI-сервисов. Многие разработчики из России оказались отрезаны от официальных каналов, что стимулирует использование альтернативных провайдеров. На рынке уже присутствуют аналогичные инструменты, такие как Claude Code и Gemini CLI, но они также требуют подписки или API-ключей, недоступных для прямой оплаты из РФ. Qwen Code выгодно отличается открытостью и поддержкой OpenAI-совместимых интерфейсов, что делает его привлекательным для локальных решений. В отличие от конкурентов, Qwen Code распространяется под открытой лицензией и позволяет сообществу вносить изменения, что особенно важно в условиях санкционных ограничений.
Для российского рынка описанная конфигурация является практически значимым обходным путём. Разработчики могут использовать локальные шлюзы, например, основанные на OpenRouter или собственных прокси, оплачиваемых в рублях. Это снижает зависимость от иностранных платёжных систем и позволяет продолжать работу с агентом. В сообществе уже появляются руководства по настройке Qwen Code с российскими провайдерами, хотя официальная документация таких сценариев не описывает. Реакция отрасли в целом нейтральна: инструмент остаётся доступным, но требует дополнительных усилий по настройке. Альтернативы, такие как Continue или Cody, также поддерживают OpenAI-совместимые API, но Qwen Code ориентирован именно на терминальный workflow и глубокую интеграцию с репозиторием. Кроме того, Qwen Code поддерживает расширения через плагины, что позволяет добавлять новые возможности без изменения ядра.
По сравнению с другими агентами, Qwen Code предлагает более гибкую систему конфигурации за счёт разделения пользовательских и проектных настроек и явного управления переменными окружения. Однако отсутствие встроенной поддержки российских платёжных систем и необходимость ручной настройки могут отпугнуть часть пользователей. В то же время конкуренты, например, Gemini CLI, также не предоставляют официальных способов оплаты из России, поэтому Qwen Code не одинок в этой проблеме. Важно, что проект остаётся открытым и сообщество может предлагать патчи для упрощения интеграции с локальными провайдерами. Технические детали, такие как поддержка различных протоколов (chat-completions и responses) и настраиваемый порядок загрузки переменных, делают Qwen Code одним из самых гибких инструментов в своём классе.
В перспективе QwenLM может пересмотреть политику аутентификации, добавив больше способов оплаты или упростив настройку сторонних провайдеров. Однако пока разработчикам приходится полагаться на документацию и собственные силы. Открытым вопросом остаётся поддержка российских карт в официальных сервисах Alibaba Cloud, что решило бы многие проблемы. До тех пор настройка на OpenAI-совместимый endpoint с собственным ключом остаётся наиболее жизнеспособным вариантом для использования Qwen Code в России. Следует также отметить, что при выборе провайдера важно убедиться в его надёжности и соответствии политикам безопасности, чтобы не подвергать риску данные репозитория. В условиях растущей фрагментации AI-рынка подобные обходные пути становятся всё более востребованными, и Qwen Code демонстрирует, как открытые инструменты могут адаптироваться к локальным ограничениям.