GonkaGate Настройка Qwen Code

Подключите Qwen Code к GonkaGate через официальный установщик qwen-code-setup.

Подключите уже установленный Qwen Code к GonkaGate через официальный установщик. Этот гайд использует поддерживаемый сценарий @gonkagate/qwen-code-setup, чтобы вам не пришлось вручную править Qwen settings, экспортировать ключи через shell profiles или хранить секреты в репозитории.

Быстрая настройка через официальный установщик

Запустите официальный установщик:

Быстрая настройка через официальный установщик

npx @gonkagate/qwen-code-setup

Этот инструмент настраивает уже установленный локально qwen. Сам Qwen Code он не устанавливает.

Выбирайте этот путь, если хотите получить безопасную настройку без ручной правки Qwen Code config:

не кладет секрет в локальные файлы репозитория
сохраняет несвязанные Qwen-настройки вместо полной перезаписи файлов
проверяет GonkaGate /v1/models до записи конфига
записывает поддерживаемые модели GonkaGate в OpenAI-compatible provider catalog Qwen Code
проверяет постоянную локальную настройку и оставляет вас в обычном qwen

Перед началом

Qwen Code уже установлен локально и доступен как qwen в PATH.
Аудированный baseline Qwen Code: @qwen-code/qwen-code 0.18.0.
Для npx установщика доступен Node >=22.14.0.
У вас уже есть API-ключ GonkaGate в формате gp-....
Установщик сейчас стартует с моделью qwen/qwen3-235b-a22b-instruct-2507-fp8.

Как выбрать правильный scope

У установщика есть два scope:

user: сделать GonkaGate доступным на этой машине в целом.
project: сделать GonkaGate настройкой по умолчанию для текущего репозитория.

Project scope не кладет секреты в файлы репозитория. Установщик пишет provider catalog GonkaGate и GONKAGATE_API_KEY в активные user Qwen settings, а в project Qwen settings записывает только activation settings.

Здесь есть одно важное ограничение: project modelProviders может скрыть user-managed providers в аудированном baseline Qwen Code. Если trusted project уже определяет modelProviders, установщик блокируется вместо того, чтобы записать настройку, которая выглядит корректной, но не сработает в runtime.

Настройка без интерактива

Используйте это для скриптов, автоматизации или повторяемой локальной настройки:

Настройка без интерактива

npx @gonkagate/qwen-code-setup --scope user --yes

С ключом из переменной окружения:

С ключом из переменной окружения

GONKAGATE_API_KEY="$GONKAGATE_API_KEY" npx @gonkagate/qwen-code-setup --scope project --yes

С ключом через stdin и JSON-выводом:

С ключом через stdin и JSON-выводом

printf '%s' "$GONKAGATE_API_KEY" | npx @gonkagate/qwen-code-setup --api-key-stdin --scope project --yes --json

Используйте dry run, если хотите сначала посмотреть планируемые записи:

Команда

npx @gonkagate/qwen-code-setup --scope user --dry-run

Передавайте ключ только так:

скрытый интерактивный prompt
GONKAGATE_API_KEY
--api-key-stdin

Установщик намеренно не принимает обычный --api-key, чтобы секрет не попадал в историю shell или список процессов.

Как проверить настройку

Если Qwen Code уже открыт, сначала закройте его. Затем начните новую сессию:

Как проверить настройку

qwen

Дальше:

убедитесь, что активная модель относится к GonkaGate
при необходимости переключите модель в Qwen Code
отправьте такой промпт:

Reply with exactly: Qwen Code connected to GonkaGate

Так вы проверите провайдера, выбор модели и путь запроса до длинной coding-сессии.

По умолчанию установщик проверяет постоянные локальные настройки. Если вам нужен live model call прямо во время setup, используйте --verify-live. Это может потратить quota и зависит от текущей доступности провайдера или сети, поэтому не входит в default success check.

Куда пишет qwen-code-setup

Установщик не хранит секреты в репозитории. Он управляет такими Qwen Code surfaces:

user settings: ~/.qwen/settings.json
QWEN_HOME user settings: <QWEN_HOME>/settings.json
project activation settings: .qwen/settings.json
backups: ~/.gonkagate/qwen-code/backups/
install state: ~/.gonkagate/qwen-code/install-state.json

Managed Qwen settings используют:

modelProviders.openai[] для моделей GonkaGate
security.auth.selectedType = "openai"
model.name для выбранной модели GonkaGate
settings.env.GONKAGATE_API_KEY для постоянного ключа

Provider catalog включает все модели GonkaGate, которые сейчас поддерживаются в этом setup flow:

qwen/qwen3-235b-a22b-instruct-2507-fp8
moonshotai/Kimi-K2.6
minimaxai/minimax-m2.7

Частые первые ошибки

Если видите	Обычно это значит	Что делать
`qwen_not_found`	Qwen Code отсутствует или не доступен в `PATH`	Установите `@qwen-code/qwen-code`, затем повторно запустите установщик
`qwen_version_unsupported`	Локальная версия Qwen Code не совпадает с аудированным setup contract	Используйте поддерживаемый baseline или повторите compatibility audit до изменения setup-допущений
`secret_missing`	Не передан безопасный источник ключа GonkaGate	Используйте скрытый prompt, `GONKAGATE_API_KEY` или `--api-key-stdin`
`required_models_unavailable`	GonkaGate `/v1/models` не вернул все обязательные модели для этого ключа	Проверьте ключ и доступ к моделям, затем повторите setup
`project_modelproviders_override`	Trusted project settings определяют `modelProviders` и скрывают user provider set	Уберите project override или используйте user scope
`secret_shadowed_by_process_env`	В текущем shell задан другой `GONKAGATE_API_KEY`	Уберите или выровняйте текущее env-значение перед запуском `qwen`
`secret_shadowed_by_project_env`	Trusted project `.qwen/.env` или `.env` перекрывает managed user key	Уберите или выровняйте project env-значение
`live_verify_failed` после `--verify-live`	Local config может быть корректным, но live request падает из-за quota, модели или сети	Проверьте balance, quota, выбранную модель и доступность provider перед повторной live-проверкой

Текущие ограничения

Этот гайд настраивает уже установленный Qwen Code. Сам Qwen Code он не устанавливает.
Аудированный baseline Qwen Code: @qwen-code/qwen-code 0.18.0.
Текущий transport target: OpenAI-compatible chat/completions через https://api.gonkagate.com/v1.
Установщик записывает все три поддерживаемые модели в modelProviders.openai[], а затем выбирает одну через model.name.
Установщик не принимает произвольные custom base URLs.
Установщик не принимает произвольные raw model IDs.
Установщик не принимает обычный --api-key.
Установщик не меняет shell profiles и не хранит секреты в локальных файлах репозитория.
Default setup success основан на локальной проверке, а не на live model call.

Официальные источники

См. также

Claude Code для поддерживаемого Anthropic-compatible пути
Настройка Cursor для OpenAI-настроек Cursor
Kilo Code для пути через официальный установщик Kilo Code
MiMoCode для пути через официальный установщик MiMoCode
Настройка OpenCode для пути через официальный установщик OpenCode
Настройка OpenClaw для custom-provider сценария
Hermes Agent для пути через установщик Hermes
Аутентификация и API-ключи для создания, хранения и ротации ключей
GET /v1/models для актуальных machine-readable model ID

Qwen Code

На этой странице