Устранение неисправностей

В этом руководстве приведены решения распространенных проблем и советы по отладке, включая:

• Ошибки аутентификации или входа в систему
• Часто задаваемые вопросы (FAQ)
• Советы по отладке
• Существующие Issues на GitHub, похожие на вашу проблему, или создание новых Issues

Ошибки аутентификации или входа в систему

• Ошибка: Qwen OAuth free tier was discontinued on 2026-04-15

  • Причина: Qwen OAuth больше не доступен с 15 апреля 2026 года.
  • Решение: Переключитесь на другой способ аутентификации. Запустите qwen → /auth и выберите один из:
    • API Key: Используйте API-ключ из Alibaba Cloud Model Studio (Beijing  / intl ). См. руководство по настройке API (Beijing  / intl ).
    • Alibaba Cloud Coding Plan: Оформите подписку с фиксированной ежемесячной платой и повышенными квотами. См. руководство по Coding Plan (Beijing  / intl ).

• Ошибка: UNABLE_TO_GET_ISSUER_CERT_LOCALLY, UNABLE_TO_VERIFY_LEAF_SIGNATURE или unable to get local issuer certificate

  • Причина: Возможно, вы находитесь в корпоративной сети с файрволом, который перехватывает и проверяет SSL/TLS-трафик. Это часто требует доверия к пользовательскому корневому CA-сертификату со стороны Node.js.
  • Решение: Установите переменную окружения NODE_EXTRA_CA_CERTS в абсолютный путь к файлу корневого CA-сертификата вашей корпоративной сети.
    • Пример: export NODE_EXTRA_CA_CERTS=/path/to/your/corporate-ca.crt

• Ошибка: Device authorization flow failed: fetch failed

  • Причина: Node.js не смог связаться с конечными точками Qwen OAuth (часто проблема с прокси или доверием SSL/TLS). Если это возможно, Qwen Code также выводит основную причину ошибки (например: UNABLE_TO_VERIFY_LEAF_SIGNATURE). Примечание: эта ошибка характерна для устаревшего потока Qwen OAuth.
  • Решение:
    • Если вы всё ещё используете Qwen OAuth, переключитесь на API Key или Coding Plan через /auth.
    • Если вы находитесь за прокси, укажите его через qwen --proxy <url> (или настройку proxy в settings.json).
    • Если ваша сеть использует корпоративный CA для проверки TLS, установите NODE_EXTRA_CA_CERTS, как описано выше.

• Проблема: Не удается отобразить интерфейс после сбоя аутентификации

  • Причина: Если аутентификация не удалась после выбора типа аутентификации, настройка security.auth.selectedType может сохраниться в settings.json. При перезапуске CLI может застрять в попытке аутентификации с неудачным типом и не отобразить интерфейс.
  • Решение: Очистите элемент конфигурации security.auth.selectedType в вашем файле settings.json:
    • Откройте ~/.qwen/settings.json (или ./.qwen/settings.json для настроек, специфичных для проекта)
    • Удалите поле security.auth.selectedType
    • Перезапустите CLI, чтобы он снова предложил аутентификацию

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

• В: Как обновить Qwen Code до последней версии?

  • О: Если вы установили Qwen Code с помощью standalone-установщика, повторно запустите команду standalone-установки. Если вы установили его глобально через npm, обновите его с помощью команды npm install -g @qwen-code/qwen-code@latest. Если вы скомпилировали его из исходного кода, получите последние изменения из репозитория, а затем пересоберите с помощью команды npm run build.

• В: Где хранятся файлы конфигурации или настроек Qwen Code?

  • О: Конфигурация Qwen Code хранится в двух файлах settings.json:

    1. В вашей домашней директории: ~/.qwen/settings.json.
    2. В корневой директории вашего проекта: ./.qwen/settings.json.

    Обратитесь к разделу Конфигурация Qwen Code для получения дополнительной информации.

• В: Почему я не вижу информацию о кэшированных токенах в выводе статистики?

  • О: Информация о кэшированных токенах отображается только тогда, когда они используются. Эта функция доступна пользователям API-ключей (например, API-ключ Alibaba Cloud Model Studio или Google Cloud Vertex AI). Вы по-прежнему можете просматривать общее использование токенов с помощью команды /stats.

Распространенные сообщения об ошибках и их решения

• Ошибка: EADDRINUSE (Адрес уже используется) при запуске MCP-сервера.

  • Причина: Другой процесс уже использует порт, который пытается занять MCP-сервер.
  • Решение: Остановите другой процесс, использующий этот порт, или настройте MCP-сервер на использование другого порта.

• Ошибка: Команда не найдена (при попытке запустить Qwen Code с помощью qwen).

  • Причина: CLI не установлен корректно или не находится в PATH вашей системы.
  • Решение: Обновление зависит от способа установки Qwen Code:
    • Если вы установили qwen с помощью standalone-установщика, повторно запустите команду standalone-установки, а затем откройте новый терминал.
    • Если вы установили qwen глобально, проверьте, что глобальная директория бинарных файлов npm находится в вашем PATH. Вы можете обновить с помощью команды npm install -g @qwen-code/qwen-code@latest.
    • Если вы запускаете qwen из исходного кода, убедитесь, что используете правильную команду для его вызова (например, node packages/cli/dist/index.js ...). Для обновления получите последние изменения из репозитория, а затем пересоберите с помощью команды npm run build.

• Ошибка: MODULE_NOT_FOUND или ошибки импорта.

  • Причина: Зависимости установлены некорректно или проект не был собран.
  • Решение:
    1. Выполните npm install, чтобы убедиться, что все зависимости присутствуют.
    2. Выполните npm run build, чтобы скомпилировать проект.
    3. Проверьте, что сборка прошла успешно, с помощью npm run start.

• Ошибка: «Операция не разрешена», «Отказано в доступе» или подобные.

  • Причина: Когда песочница включена, Qwen Code может пытаться выполнять операции, ограниченные вашей конфигурацией песочницы, например, запись за пределами каталога проекта или системного временного каталога.
  • Решение: Обратитесь к документации Конфигурация: Песочница для получения дополнительной информации, включая настройку вашей конфигурации песочницы.

• Qwen Code не запускается в интерактивном режиме в средах «CI»

  • Проблема: Qwen Code не переходит в интерактивный режим (приглашение не появляется), если установлена переменная окружения, начинающаяся с CI_ (например, CI_TOKEN). Это связано с тем, что пакет is-in-ci, используемый базовым UI-фреймворком, обнаруживает эти переменные и предполагает неинтерактивную среду CI.
  • Причина: Пакет is-in-ci проверяет наличие CI, CONTINUOUS_INTEGRATION или любой переменной окружения с префиксом CI_. Если любая из них найдена, он сигнализирует, что среда неинтерактивна, что предотвращает запуск CLI в интерактивном режиме.
  • Решение: Если переменная с префиксом CI_ не нужна для работы CLI, вы можете временно удалить её для команды, например: env -u CI_TOKEN qwen

• Режим отладки не работает из файла .env проекта

  • Проблема: Установка DEBUG=true в файле .env проекта не включает режим отладки для CLI.
  • Причина: Переменные DEBUG и DEBUG_MODE автоматически исключаются из файлов .env проекта, чтобы предотвратить вмешательство в поведение CLI.
  • Решение: Используйте файл .qwen/.env вместо этого или настройте параметр advanced.excludedEnvVars в вашем settings.json, чтобы исключать меньше переменных.

• Прокрутка тачпадом в tmux изменяет историю команд вместо прокрутки диалога

  • Проблема: В сессии tmux прокрутка тачпадом или колесом мыши может переключать предыдущие команды, аналогично нажатию Стрелка вверх или Стрелка вниз.
  • Причина: tmux может преобразовывать жесты колеса в простые последовательности клавиш-стрелок. Эти последовательности неотличимы от реальных нажатий клавиш-стрелок к моменту их получения Qwen Code.
  • Решение: Включите ui.useTerminalBuffer; затем используйте Shift+Стрелка вверх / Shift+Стрелка вниз или колесо мыши, когда tmux передаёт события колеса приложению. Если вы предпочитаете собственную прокрутку хоста, настройте привязки мыши tmux для событий колеса.

IDE Companion не подключается

• Убедитесь, что в VS Code открыта только одна рабочая область.
• Перезапустите встроенный терминал после установки расширения, чтобы он унаследовал:
  • QWEN_CODE_IDE_WORKSPACE_PATH
  • QWEN_CODE_IDE_SERVER_PORT
• Если работа ведётся в контейнере, проверьте, что host.docker.internal разрешается. В противном случае соответствующим образом настройте хост.
• Переустановите декомпаньон с помощью /ide install и используйте «Qwen Code: Run» в палитре команд, чтобы убедиться, что он запускается.

Коды завершения

Qwen Code использует определённые коды завершения для указания причины завершения работы. Это особенно полезно для скриптов и автоматизации.

Советы по отладке

• Отладка CLI:

  • Используйте флаг --verbose (если доступен) с командами CLI для более подробного вывода.
  • Проверьте журналы CLI, которые обычно находятся в каталоге конфигурации или кэша, специфичном для пользователя.

• Отладка ядра:

  • Проверьте вывод консоли сервера на наличие сообщений об ошибках или стеков вызовов.
  • Увеличьте уровень детализации журналов, если это возможно настроить.
  • Используйте инструменты отладки Node.js (например, node --inspect), если необходимо пошагово выполнить серверный код.

• Проблемы с инструментами:

  • Если конкретный инструмент не работает, попробуйте изолировать проблему, выполнив самую простую возможную версию команды или операции, которую выполняет инструмент.
  • Для run_shell_command сначала проверьте, что команда работает напрямую в вашей оболочке.
  • Для инструментов файловой системы убедитесь, что пути верны, и проверьте права доступа.

• Предварительные проверки:

  • Всегда запускайте npm run preflight перед отправкой кода. Это может выявить многие распространённые проблемы, связанные с форматированием, линтингом и ошибками типов.

Существующие проблемы на GitHub, похожие на вашу, или создание новых проблем

Если вы столкнулись с проблемой, которая не описана в этом Руководстве по устранению неполадок, попробуйте поискать в трекере проблем  Qwen Code на GitHub. Если вы не нашли похожей проблемы, создайте новый вопрос (Issue) на GitHub с подробным описанием. Пулл-реквесты также приветствуются!