Как подключить Qwen4 к Claude Code и устранить ошибки соединения

Настройте Qwen4-Max в Claude Code: адрес QwenCloud, ключ и соответствие моделей. Разберите ошибки 401, 403 и проверку списка моделей CC Switch.

Телефонный коммутатор соединяет оранжевый штекер с подходящим гнездом.

Чтобы использовать Qwen4-Max в Claude Code, задайте совместимый с Anthropic Base URL QwenCloud, ключ для этого маршрута и явное соответствие модели qwen4-max. Изменение названия модели само по себе не меняет провайдера. Успешная проверка списка моделей не обязательна для успешного диалога.

Руководство основано на документации QwenCloud, проверенной 17 ноября 2026 года. Речь о выпущенной модели, а не qwen4-max-preview. Если версии ещё вызывают вопросы, начните с руководства по API Qwen4 и миграции. Здесь задача уже: направить клиент для программирования по нужному маршруту и определить, на каком уровне произошёл сбой.

Приведённую конфигурацию оболочки мы проверили локально с имитацией клиента, которая фиксирует имена настроек, а не вызывает модель. Платных запросов Qwen4 для статьи не было. Проверку реального диалога и списаний у провайдера предстоит выполнить вам в собственном аккаунте с разрешённым доступом.

Выберите маршрут до ввода ключа

В QwenCloud отдельно документированы Token Plan и региональные маршруты с оплатой по использованию. Сначала выберите один: не сочетайте ключ одного маршрута с Base URL другого.

Нужный маршрутBase URL для Claude CodeЧто проверить
QwenCloud Token Planhttps://token-plan.maas.qwencloudapi.com/apps/anthropicКлюч плана и доступ к выбранной модели
QwenCloud с оплатой по использованию, Сингапурhttps://ap-southeast-1.maas.qwencloudapi.com/apps/anthropicКлюч этого региона и доступ к модели
Другой регион QwenCloudДокументированный Anthropic-совместимый URL регионаРегион, доступность сервиса и область действия ключа

Это базовые URL, а не полные адреса запросов сообщений. В этой настройке не добавляйте /v1 к Base URL QwenCloud: клиент сам использует путь сообщений относительно него. Контракт подключения описан в руководстве QwenCloud для Claude Code (на английском) и документации регионов (на английском).

Ключ API Ofox не является ключом QwenCloud. Если выбираете модель, которую поддерживает Ofox, используйте документацию аутентификации Ofox и настройки соответствующей интеграции. Не вставляйте ключ Ofox ни в один из адресов QwenCloud. Эта статья не подтверждает доступность Qwen4 через Ofox: отдельно проверьте актуальный каталог моделей Ofox.

Запустите отдельный сеанс с явной настройкой Qwen4

Для первой диагностики откройте новый терминал и небольшой синтетический проект. Сохраните резервную копию обычной конфигурации. Следующий Bash-скрипт экспортирует переменные только для своего процесса и дочернего клиента. Он не переписывает глобальный файл настроек, не выводит ключ и не сохраняет его в скрипте.

Сохраните как launch-qwen4.sh:

#!/usr/bin/env bash
set -euo pipefail

# Singapore pay-as-you-go. For Token Plan, replace only this route
# and enter the matching Token Plan key when prompted.
export ANTHROPIC_BASE_URL="https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic"
unset ANTHROPIC_API_KEY
read -r -s -p "QwenCloud key for this route: " ANTHROPIC_AUTH_TOKEN
printf '\n'
if [[ -z "$ANTHROPIC_AUTH_TOKEN" ]]; then
  printf 'No key entered; no request sent.\n' >&2
  exit 1
fi
export ANTHROPIC_AUTH_TOKEN

# Deliberately use one model while diagnosing routing.
export ANTHROPIC_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen4-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen4-max"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
exec claude "$@"

Запустите bash launch-qwen4.sh из тестового проекта. Для Token Plan замените Base URL на значение из таблицы и введите соответствующий ключ. Не подставляйте произвольный ID более дешёвой модели, пока не подтвердите её доступность на выбранном маршруте.

Назначение Qwen4-Max всем псевдонимам — диагностический приём, а не рекомендация по экономии. Так вы исключаете неопределённость: фоновая задача или субагент не выберут другую настроенную модель. После проверки маршрута можно осознанно назначить лёгким задачам другую поддерживаемую модель и отдельно проверить это соответствие.

Скрипт не переопределяет все возможные управляемые настройки, обёртки или расширения IDE. Если клиент управляется организацией, соблюдайте её правила. Для теста запускайте CLI напрямую, чтобы IDE незаметно не подставила другую среду. В Windows запускайте этот Bash-пример в подходящей среде WSL или Git Bash; у PowerShell другой синтаксис переменных окружения. Не считайте, что Windows-клиент читает ту же конфигурацию, что и установка в WSL.

Проверьте маршрут и выполнение задачи по отдельности

В новом сеансе Claude Code выполните /status. Сверьте URL провайдера и выбранную модель с ожидаемыми значениями. Не публикуйте полный дамп настроек или скриншот с учётными данными. Если маршрут пуст или указывает не туда, сначала исследуйте конфигурацию, загруженную именно этим процессом, а уже затем снова меняйте модель.

Используйте небольшой запрос без приватного содержимого репозитория:

Create a Python function named normalize_code(value).
It must accept a string, trim surrounding spaces and preserve leading zeros.
Raise TypeError for non-string input.
Add tests for " 0017 ", "", and the integer 17.
Do not install dependencies or access the network.
Show which files you changed and how to run the tests.

Полезная запись проверки состоит из трёх частей:

  1. Маршрут: сеанс показывает ожидаемого провайдера и соответствие модели; журнал провайдера, если он доступен, указывает нужную модель. Самоописание модели не подтверждает маршрут.
  2. Результат: файл существует, " 0017 " преобразуется в "0017", пустая строка остаётся пустой, целое число вызывает TypeError. Запустите созданные тесты и изучите diff.
  3. Учёт расходов: вызов появился в разделе использования нужного аккаунта или плана. Название модели в инструменте не доказывает источник оплаты.

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

Определите уровень сбоя по симптому

Официальный раздел диагностики (на английском) разделяет несколько проблем, которые легко принять за одну: «Qwen не работает».

СимптомЧто проверить сначалаСледующее действие
401 invalid_api_keyМаршрут и регион ключа, фактический URL провайдераИспользуйте подходящий ключ QwenCloud и перезапустите клиент; не выводите ключ в журналы
Claude Code всё ещё подключается к Anthropic/status и загруженная процессом конфигурацияИсправьте окружение/настройки провайдера; проверьте обёртки и конфликтующую аутентификацию
CC Switch не нашёл эндпоинт списка моделейПроверяет ли запрос обнаружение моделей, а не сообщенияЗадайте соответствие модели вручную и проверьте реальное сообщение на документированном маршруте
403 AccessDenied после смены моделиПрава на модель и статус её жизненного цикла в галерее QwenCloudЗамените недоступные/устаревшие назначения на доступную актуальную модель; сохраните ID ошибки/запроса
На старом маршруте смена модели ничего не меняетЕсть ли claude-code-proxy в Base URLПерейдите на документированный интерфейс /apps/anthropic
Длинный ответ обрываетсяЛимит вывода клиента и причина завершения ответаПроверьте лимит конкретной модели; сократите задачу или осознанно измените ограничение клиента

Если нужный сторонний провайдер настроен, но при запуске всё ещё появляется официальный вход Anthropic, FAQ QwenCloud предлагает проверить hasCompletedOnboarding: true в ~/.claude.json — это другой файл, не ~/.claude/settings.json. Сначала сохраните копию JSON и добавьте только нужное поле; не заменяйте файл и не меняйте настройки, управляемые организацией. Перезапустите в новом терминале. Если документированная настройка всё ещё не работает, обновите клиент официальным способом установки и повторно проверьте загруженную конфигурацию.

Случай списка моделей особенно важен. QwenCloud документирует /v1/messages для Anthropic-совместимого маршрута, но не эндпоинт списка моделей. Поэтому CC Switch может сообщать об ошибке обнаружения, хотя сам диалог работает. Это не означает, что любую 404 можно игнорировать: неверный URL сообщения, лишний сегмент пути или неподдерживаемую модель всё равно надо исправить. Установите, какой именно запрос завершился ошибкой.

Если прямой запрос работает, а клиент для программирования нет, обратитесь к диагностике подключения Claude Code. Если недоступен точный идентификатор, используйте описанный в руководстве model-not-found OpenAI (на английском) способ проверки провайдера и эндпоинта. Ошибка сертификата относится к диагностике TLS и сертификатов (на английском), а не к соответствию моделей; не отключайте проверку сертификата ради быстрого обхода.

Осознанно задайте лимиты контекста и вывода

Актуальное руководство QwenCloud предписывает CLAUDE_CODE_MAX_CONTEXT_TOKENS=983616 для Qwen4-Max. Эта настройка клиента не равна рекламируемому контексту модели в миллион токенов; сама по себе она не доказывает успешное завершение длинной задачи.

Версия руководства от 17 ноября рекомендует CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072 при обрыве вывода Qwen4-Max. Примечание о предварительной версии на той же странице использует 64000. Не переносите рекомендацию для preview в конфигурацию выпущенной модели. Для первого пробного вызова максимум не обязателен: большой разрешённый вывод может увеличить время и расход. Изучите причину остановки и выберите подходящий задаче лимит.

Если агент повторно использует большой справочный документ, продолжите с руководством по явному кешированию Qwen4. Размер контекста определяет вместимость; кеширование — отдельный контракт запроса. Ни то ни другое не подтверждает попадание в кеш без соответствующих полей использования.

Сохраните конфигурацию, к которой можно вернуться

После успешной проверки запишите версию клиента, Base URL провайдера, соответствие моделей, тип и регион ключа, результат теста и время. Сам ключ храните в обычном хранилище секретов. При постоянном изменении настроек добавляйте нужные поля в существующий файл, не заменяя посторонние разрешения и настройки.

При будущих сбоях меняйте одну переменную за раз, сохраняя очищенный от секретов ID запроса, HTTP-статус, код ошибки и ID модели. Чтобы отменить действие скрипта, выйдите из запущенного сеанса и откройте обычный клиент из родительского терминала: окружение родителя и файл настроек не менялись. Если вы отдельно редактировали постоянные настройки, восстановите их сохранённую версию.

Настройка завершена, когда нужный маршрут, переданные файлы и запись использования согласуются. Это устойчивая отправная точка для сравнения моделей на реальных задачах программирования, а не отладки нового маршрута при каждой попытке.

Часто задаваемые вопросы

Нужен ли Claude Code список моделей от Qwen?
Нет. По документации QwenCloud совместимый с Anthropic интерфейс поддерживает сообщения, но не обнаружение моделей. Ошибка проверки списка в CC Switch не равнозначна ошибке отправки сообщения.
Если выбран Opus, запрос выполняет модель Anthropic?
Не обязательно. У стороннего провайдера псевдоним Opus может указывать на Qwen4-Max. Проверьте провайдера, точное соответствие моделей и журнал его запросов.