Qwen Code بعد إغلاق qwen-oauth: العمل عبر JoinGonka Gateway

الخطوة 1: تثبيت Qwen Code. الطرق الرسمية من README الخاص بالمشروع:

# Linux and macOS: standalone build with its own Node.js
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (requires Node.js 22 or newer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew
brew install qwen-code

يضع السكربت الأمر في ~/.local/bin/qwen ويضيف المسار إلى ملف إعدادات الصدفة عند الحاجة. أعد فتح الطرفية وتحقق: qwen --version.

الخطوة 2: الحصول على المفتاح. سجّل في gate.joingonka.ai/register، وأكّد بريدك الإلكتروني، ثم أنشئ مفتاحًا ببادئة jg- من قسم «مفاتيح API».

الخطوة 3: تشغيل المثبّت.

npx @joingonka/setup --tool qwen-code

سيسألك المثبّت عن المفتاح (لا يُمرَّر عبر وسائط سطر الأوامر حتى لا يبقى في سجل الصدفة) وسيعدّل ~/.qwen/settings.json — الملف الذي تقترحه وثائق Qwen Code للإعداد «في ملف واحد»:

• سيكتب المفتاح في كتلة env داخل الملف نفسه تحت الاسم JOINGONKA_API_KEY — وهو المكان ذاته الذي يحفظ فيه أمر /auth الخاص بالمشروع مفاتيحه؛ سيحصل الملف على الصلاحيات 600، ولن تتغير بيئة الصدفة؛
• سيضيف نماذج الشبكة إلى قائمة modelProviders.openai — مع عنوان البوابة ونوافذ السياق الفعلية وحدود الاستجابة الفعلية؛ وستبقى إدخالات مزوّديك الآخرين في هذه القائمة كما هي؛
• إذا لم يكن نوع التفويض محددًا أو كان لا يزال يشير إلى qwen-oauth المغلقة، فسيحوّله إلى openai ويجعل DeepSeek V4 Flash النموذج الافتراضي؛ أما إذا كنت تستخدم نوعًا آخر يعمل فعليًا — anthropic أو gemini أو vertex-ai — فلن يمسّه ما لم تمرر الراية --model؛
• سيحفظ نسخة من الملف السابق، ولن يمسّ التعليقات والإعدادات الأخرى، ثم يرسل في النهاية طلبًا حيًا إلى البوابة ليخبرك إن كان المفتاح والعنوان والنموذج قد قُبلت.

هكذا بدا المخرَج على تثبيت كان لا يزال يستخدم qwen-oauth (مختصرًا):

Configured ~/.qwen/settings.json
Base URL: https://gate.joingonka.ai/v1
Default model: deepseek-ai/DeepSeek-V4-Flash-0731 (replaces qwen-oauth — that free tier was discontinued on 2026-04-15)
Switched Qwen Code to JoinGonka (auth type "openai") — this replaced your previous auth type "qwen-oauth".
To go back: run /auth (and /model) inside Qwen Code, or restore ~/.qwen/settings.json.bak.2026-09-23T04-22-32-159Z.
…
✓ Verified: the gateway accepted the key, base URL and model.

لتحديد نموذج افتراضي مختلف، استخدم الراية --model: الاختصار glm أو minimax أو المعرّف الكامل؛ والنموذج المحدد صراحةً يُكتب دائمًا. أما الوضع دون أسئلة فيأخذ المفتاح من متغير البيئة:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool qwen-code --model glm --non-interactive

الدليل المنقول عبر المتغير QWEN_HOME يعثر عليه المثبّت بنفسه. وإعادة التشغيل ستحدّث كتالوج النماذج لكنها ستُبقي نموذج الشبكة الذي اخترته: Kept your current default model.

كل ما يفعله المثبِّت يمكن كتابته يدويًا. الملف هو ~/.qwen/settings.json (أو $QWEN_HOME/settings.json)؛ يقرأه Qwen Code كـ JSON مع تعليقات. الإعدادات العاملة لشبكة Gonka كاملةً:

{
  "env": { "JOINGONKA_API_KEY": "jg-your-key" },
  "modelProviders": {
    "openai": [
      { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash (Gonka)",
        "baseUrl": "https://gate.joingonka.ai/v1", "envKey": "JOINGONKA_API_KEY",
        "generationConfig": { "contextWindowSize": 380000, "samplingParams": { "max_tokens": 32768 } } },
      { "id": "zai-org/GLM-5.3-Flash", "name": "GLM 5.3 Flash (Gonka)",
        "baseUrl": "https://gate.joingonka.ai/v1", "envKey": "JOINGONKA_API_KEY",
        "generationConfig": { "contextWindowSize": 390000, "samplingParams": { "max_tokens": 8192 } } },
      { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7 (Gonka)",
        "baseUrl": "https://gate.joingonka.ai/v1", "envKey": "JOINGONKA_API_KEY",
        "generationConfig": { "contextWindowSize": 200000, "samplingParams": { "max_tokens": 8192 } } }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek-ai/DeepSeek-V4-Flash-0731", "baseUrl": "https://gate.joingonka.ai/v1" }
}

أين تحتفظ بالمفتاح. قيمة المتغير من envKey يبحث عنها Qwen Code بالترتيب: بيئة الصدفة، ثم أول ملف .env يُعثر عليه (.qwen/.env أو .env من المجلد الحالي صعودًا، ثم ~/.qwen/.env و~/.env)، وبعد ذلك فقط كتلة env في الملف. ومن هنا الفخ الرئيسي: المتغير JOINGONKA_API_KEY المصدَّر في الصدفة بقيمة قديمة سيتجاوز الملف — وقد اختبرنا ذلك عن قصد وحصلنا على 401 Invalid API key مع أن المفتاح في settings.json صحيح. يحذّر المثبِّت عندما يرى قيمة مختلفة في البيئة.

وملاحظة بخصوص المشاريع: ملف .qwen/settings.json الخاص بالمشروع مع modelProviders خاص به لا يُكمِّل بل يستبدل القائمة من المجلد الرئيسي — داخل مثل هذا المشروع ستختفي نماذج البوابة من /model. ولا يجدر أصلًا وضع المفتاح في ملف المشروع: فسيصل معه إلى المستودع.

التعديلات على modelProviders تلتقطها الجلسة الجارية دون إعادة تشغيل — يكفي إعادة فتح /model. وبدون محرر، يفعل المعالج /auth → Custom Provider الشيء نفسه.

يحتوي Qwen Code على خيارين مستقلين: نوع المصادقة — أي بروتوكول يجب تفعيله ومن أين يتم جلب المفاتيح — والنموذج. يتم تخزين النوع في security.auth.selectedType، ويعتمد عليه سلوك برنامج التثبيت:

داخل الجلسة، يتم تغيير النموذج بواسطة الأمر /model. في تجربتنا، أظهر الأمر جميع سجلات البوابة مع وسم البروتوكول، وأسفل القائمة - نافذة السياق، العنوان واسم المتغير الذي يحتوي على المفتاح:

Select Model

  1. [openai] MiniMax M2.7 (Gonka) (MiniMaxAI/MiniMax-M2.7)
› 2. [openai] DeepSeek V4 Flash (Gonka) (deepseek-ai/DeepSeek-V4-Flash-0731)
  3. [openai] GLM 5.3 Flash (Gonka) (zai-org/GLM-5.3-Flash)

Modality:       text-only
Context Window: 380,000 tokens
Base URL:       https://gate.joingonka.ai/v1
API Key:        JOINGONKA_API_KEY

يتم حفظ الاختيار من /model بين الجلسات. لتشغيل واحد، يحدد النموذج الراية -m مع المعرف: qwen -m zai-org/GLM-5.3-Flash. يحدد /model --fast نموذجاً خفيفاً منفصلاً للتلميحات ومصنف الأذونات؛ طالما أنه غير موجود، يقوم النموذج الرئيسي بهذه المهمة.

أي نموذج تختار. سعر جميع نماذج الشبكة واحد، لذا الاختيار يعتمد على السلوك. هكذا تصرفت النماذج في Qwen Code 0.24.4 على نفس المهمة — قراءة ملف والعثور على خطأ (تم التحقق في 23 سبتمبر 2026):

الاستدلال في GLM-5.3 Flash. يحدد برنامج التثبيت samplingParams لكل نموذج، وفي هذه الحالة لا يضيف Qwen Code مستوى الاستدلال إلى الطلب: أمر /effort لا يصل إلى نماذج الشبكة، وGLM-5.3 Flash يفكر دائماً. إذا كنت بحاجة إلى مفتاح تبديل، أعلن عن المستويات مباشرة في سجل النموذج:

{
  "id": "zai-org/GLM-5.3-Flash",
  "capabilities": {
    "reasoning": { "profile": "openai-effort", "efforts": ["low", "high"], "defaultEffort": "high" }
  },
  …
}

عندها سيبدأ Qwen Code بإرسال reasoning_effort، وبالنسبة لـ GLM-5.3 Flash، تقوم القيمة low بإيقاف الاستدلال تماماً — التفاصيل في نظرة عامة على النموذج. في تجربتنا مع "defaultEffort": "low" أرسل Qwen Code reasoning_effort: "low"، ورد النموذج بدون كتلة استدلال.

أسرع فحص هو تشغيل لمرّة واحدة. ضع في مجلد فارغ ملف calc.py بدالة جمع تقوم فعليًا بالطرح، واطلب العثور على الخطأ:

qwen -p "Read calc.py and tell me in one sentence whether it has a bug."

يجب أن يستدعي الوكيل نفسه أداة القراءة ويجيب في صميم الموضوع. هكذا أجاب GLM-5.3 Flash (تشغيل مع -m zai-org/GLM-5.3-Flash):

Yes, there is a bug: the `add` function subtracts instead of adding (`return a - b`), so `print(add(2, 3))` prints `-1` instead of `5`.

في الواجهة (qwen بلا وسائط) سيُظهر الترويسة النموذج المختار — API Key | DeepSeek V4 Flash (Gonka) — وسيجري الطلب نفسه هكذا:

> Read calc.py and tell me in one sentence whether it has a bug.
  ✓ Read calc.py, README.md

  ◆ Yes, calc.py has a bug: the add function returns the difference (a - b) instead of the sum (a + b). …

  ➜ demo · DeepSeek V4 Flash (Gonka) · 380.0k Context 5.1% used

يعرض الأمر /stats الطلبات والرموز حسب النماذج، وتُظهر لوحة البوابة الاستهلاك نفسه في قسم «الاستخدام».

وضع الموافقة في -p. بلا أعلام، يجري التشغيل لمرّة واحدة في وضع Ask Permissions: لا أحد ليؤكّد، لذا لا تُسلَّم للنماذج ببساطة الأدوات التي تحتاج إذنًا — أوامر الصدفة وتحرير وكتابة الملفات. على طلب تنفيذ ls، أجاب الوكيل في تشغيلنا أنه لا يملك هذه الأداة. للتحرير أضف --approval-mode auto-edit، وللأوامر — --yolo؛ والأخير يرفقه Qwen Code بتحذير بأن البيئة المعزولة غير مفعّلة.

إذا حدث خطب ما، فعادةً ما يُقرأ التشخيص مباشرةً من الرسالة:

يستهلك العميل (agent) التوكنز بشكل مختلف عن الدردشة: مع كل عبارة تقدمها، يضيف Qwen Code موجه نظام (system prompt) وأوصاف للأدوات، بينما تستغرق المهمة عدة خطوات. في تشغيلنا، حمل كل طلب qwen -p حوالي 13 ألف توكن إدخال قبل البدء في المهمة الفعلية، واستغرقت مهمة "اقرأ الملف، اعثر على الخطأ" خطوتين وحوالي 27 ألف توكن. في واجهة الأدوات يكون الاستهلاك أكبر، وبعد رد Qwen Code يقوم بنفس النموذج بإجراء طلبات خدمة — على سبيل المثال، اقتراح الرد التالي: أظهر /stats لنفس المهمة 4 طلبات وحوالي 79 ألف توكن إدخال.

من خلال JoinGonka Gateway، تبلغ تكلفة التوكنز $0.0069 لكل مليون عند الإدخال و $0.021 لكل مليون عند الإخراج — السعر موحد لجميع نماذج الشبكة ويتم تحديثه في هذه الصفحة من مصدر حي.

التقديرات في العمود الأيمن تعتمد على أسعار سبتمبر 2026. للمقارنة — كيف يمكنك الدفع مقابل النماذج في Qwen Code:

يتم إيقاف طلبات الخدمة حيث لا تكون مطلوبة: اقتراحات الرد التالي — "ui": { "enableFollowupSuggestions": false }، ذاكرة الخلفية التلقائية — "memory": { "enableManagedAutoMemory": false, "enableManagedAutoDream": false }. الاستهلاك الدقيق والرصيد المتبقي متاحان في لوحة التحكم، في قسمي "الاستخدام" (Usage) و "الفواتير" (Billing). تم شرح سبب اختيار DeepSeek V4 Flash افتراضياً بالتفصيل في مراجعة النموذج.

أوضاع الموافقة. في الواجهة، يبدأ Qwen Code في وضع Auto: يُسمح بالقراءة والبحث والتعديلات داخل المشروع على الفور، بينما تقوم أوامر الغلاف (shell) والإجراءات الخطرة الأخرى بتقييمها بواسطة مصنف — طلب منفصل للنموذج. يمكن التنقل بين الأوضاع الأخرى — Plan و Ask Permissions و Auto-Edit و YOLO — باستخدام Shift+Tab (في ويندوز Tab) أو عبر الأمر /approval-mode؛ يتم تحديد الوضع الافتراضي بواسطة المفتاح tools.approvalMode.

العمل في الخلفية. افتراضياً، يقوم Qwen Code بإدارة ذاكرة تلقائية: بعد المحادثات في الخلفية، يستخرج ملاحظات حول المشروع وتفضيلاتك، وينظفها مرة يومياً (Dream) — باستخدام نفس النموذج. في التشغيل الفردي يكون هذا ملحوظاً: قد لا ينتهي qwen -p لعدة دقائق بعد الرد، بينما تنتظر المهمة في الخلفية النموذج. للنصوص البرمجية (scripts) و CI، قم بإيقاف الذاكرة التلقائية (المفاتيح في القسم أعلاه) وضع حدوداً للتشغيل: --max-wall-time و --max-session-turns و --max-tool-calls.

الصور. نماذج الشبكة نصية فقط (Modality: text-only في /model). للقطات الشاشة، قم بتعيين نموذج وسيط من مزود آخر باستخدام الأمر /model --vision: سيقوم بوصف الصورة نصياً، وسيكمل النموذج الرئيسي العمل.

الإحصائيات. يرسل Qwen Code إحصائيات استخدام مجهولة الهوية افتراضياً؛ يتم إيقافها بواسطة "privacy": { "usageStatisticsEnabled": false }. لا تخزن البوابة محتوى الموجهات والردود — فقط إجمالي الاستهلاك.

جيران الشبكة. تطلق المختبرات التي تخدم الشبكة نماذجها الخاصة لعملائها: لدى DeepSeek يوجد DeepSeek Harness، ولدى MiniMax يوجد MiniMax Code، ولدى Z.ai (مؤلفو GLM) يوجد ZCode. جميعهم يتصلون بنفس البوابة بنفس المفتاح ويستهلكون رصيداً واحداً.