Qwen Code CLI с моделями Claude, GPT и GLM через Zukko

Qwen Code — терминальный агент для программирования от команды Qwen, но работать он может не только с моделями Qwen. Он поддерживает OpenAI-совместимые API, а значит, через Zukko в нём доступны Claude, GPT и GLM по одному ключу fetch_.... Ниже — быстрое подключение через переменные окружения, постоянная настройка через settings.json и разбор ошибок.

Что такое Qwen Code

Qwen Code↗ — открытый coding-агент: читает и правит код в проекте, запускает команды, есть интеграции с VS Code, Zed и JetBrains. По README проекта, он поддерживает несколько протоколов — OpenAI, Anthropic, Gemini — и любых сторонних провайдеров. Для Zukko проще всего OpenAI-совместимый вариант.

Установка (нужен Node.js 22+):

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

На macOS и Linux можно поставить и через Homebrew: brew install qwen-code. Запускается агент командой qwen в папке проекта.

Переменные окружения для подключения

По документации Qwen Code, для OpenAI-совместимого протокола используются три переменные:

export OPENAI_API_KEY="fetch_..."
export OPENAI_BASE_URL="https://api.zukko.pro/v1"
export OPENAI_MODEL="claude-sonnet-5"

• OPENAI_API_KEY — ваш ключ fetch_... со страницы API-ключей↗. Именно эта переменная включает OpenAI-совместимую авторизацию без интерактивной настройки.
• OPENAI_BASE_URL — адрес Zukko с суффиксом /v1.
• OPENAI_MODEL — id модели из каталога Zukko.

Быстрый запуск

macOS / Linux:

export OPENAI_API_KEY="fetch_..."
export OPENAI_BASE_URL="https://api.zukko.pro/v1"
export OPENAI_MODEL="claude-sonnet-5"
cd /path/to/your-project
qwen

Windows (PowerShell):

$env:OPENAI_API_KEY = "fetch_..."
$env:OPENAI_BASE_URL = "https://api.zukko.pro/v1"
$env:OPENAI_MODEL = "claude-sonnet-5"
qwen

Задайте любой вопрос, затем откройте раздел «Использование» в кабинете — запрос должен появиться там.

Модели и цены

Актуальный список — GET https://api.zukko.pro/v1/models или страница «Модели»↗ в кабинете. Какая модель лучше справится с вашим кодом, заранее сказать нельзя: дайте одну и ту же задачу двум-трём моделям и сравните результат и расход.

Модель можно задать и при запуске, не меняя переменные: qwen --model "gpt-5.6-sol".

Постоянная настройка через settings.json

Вводить переменные каждый раз неудобно. Документация Qwen Code рекомендует описать провайдера в ~/.qwen/settings.json:

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Zukko)",
        "baseUrl": "https://api.zukko.pro/v1",
        "envKey": "ZUKKO_API_KEY"
      },
      {
        "id": "gpt-5.6-sol",
        "name": "GPT-5.6 Sol (Zukko)",
        "baseUrl": "https://api.zukko.pro/v1",
        "envKey": "ZUKKO_API_KEY"

Что здесь происходит:

• modelProviders.openai — список моделей для OpenAI-совместимого протокола; id уходит в API, name показывается в меню.
• envKey — имя переменной, в которой лежит ключ. Здесь своё имя ZUKKO_API_KEY, чтобы не путать с другими провайдерами.
• env — запасной способ хранить ключ прямо в файле (самый низкий приоритет). Ключ в нём лежит открытым текстом, поэтому документация Qwen Code советует для секретов файл .qwen/.env или export в профиле оболочки.
• security.auth.selectedType — какой протокол использовать при старте, чтобы не проходить /auth вручную.
• model.name — модель по умолчанию, должна совпадать с одним из id.

После этого достаточно запустить qwen, а модели переключаются командой /model прямо в сессии.

Модели Qwen и Zukko

Модели семейства Qwen в каталоге Zukko сейчас нет. Если нужен именно Qwen, подключайте Qwen Code к провайдеру Alibaba Cloud по его инструкции. Через Zukko в Qwen Code работают Claude, GPT и GLM из таблицы выше.

Если не работает

401 unauthorized

Ключ опечатан, отозван или скопирован с пробелами. Проверьте его на странице API-ключей↗.

402

Закончился баланс. Пополните↗ и повторите.

Модель не найдена (404)

Опечатка в id модели или её нет в каталоге. Проверьте список:

curl https://api.zukko.pro/v1/models \
  -H "Authorization: Bearer fetch_..."

Запросы уходят не туда или возвращают 404 на любой модели

Проверьте, что base URL — ровно https://api.zukko.pro/v1, с /v1. Для OpenAI-совместимого формата суффикс обязателен.

Qwen Code не видит переменные

1. export выполнен в том же терминале, где запускаете qwen? Переменные не переходят между окнами.
2. Для постоянной работы добавьте их в ~/.bashrc / ~/.zshrc или используйте settings.json.
3. Проверьте текущую авторизацию командой /doctor внутри Qwen Code.

Частые вопросы

Можно ли менять модель во время работы?

Да. Команда /model показывает все модели из modelProviders и переключает между ними; выбор сохраняется между сессиями. Без settings.json можно перезапустить qwen с другим OPENAI_MODEL или флагом --model.

Какая модель лучше для кода?

Готового ответа нет, всё зависит от задач. Сравнивайте сами: одна и та же задача на claude-sonnet-5, gpt-5.6-sol и glm-5.3-flash, затем оцените результат и посмотрите расход в кабинете. Учтите, что у GLM контекст 128K, а у Claude и GPT — 1M.

Есть ли экономия на кэше?

У вендоров чтение из кэша промптов стоит около 10% входной цены, а в Zukko кэшированные токены оплачиваются по обычной входной цене. Агент отправляет большой повторяющийся контекст, поэтому для длинных сессий реальная разница с официальным прайсом меньше, чем при прямом сравнении цен. Поставьте на ключ дневной лимит.

Почему у разных моделей одинаковая цена?

Так устроен прайс Zukko: Claude Sonnet 5, Claude Opus 5.5 и GPT-5.6 Sol стоят по $0,30 за 1M входных и выходных токенов, GPT-5.6 Luna и GLM 5.3 — по $0,10, GLM 5.3 Flash — по $0,04. Выбирайте по результату на своих задачах, а не только по цене.

Подробнее о форматах API — в разделе Anthropic или OpenAI↗ документации Zukko.