دليل تثبيت Qwen Code CLI: إعداد سريع على Windows وmacOS وLinux (2026)

المتطلبات المسبقة

قبل تثبيت Qwen Code CLI (وكيل البرمجة الذكي المعتمد على الطرفية والذي يعمل بنماذج Qwen)، تأكد من توافر ما يلي:

إصدار Node.js 20 أو أحدث (يُوصى بأحدث إصدار LTS). حمله من nodejs.org.
طرفية أو موجه أوامر بصلاحيات إدارية على Windows.
اتصال بالإنترنت لتحميل الحزم والنماذج.
اختياري لكن موصى به: Git (للتثبيت اليدوي من المصدر) وHomebrew على macOS/Linux.

تحقق من تثبيت Node.js:

node --version
npm --version

من المتوقع أن يظهر الناتج إصدارات مثل v20.x.x أو أحدث.

الخطوة 1: اختر طريقة التثبيت المناسبة

يوفر Qwen Code CLI مسارات تثبيت متعددة. يُوصى بـسكريبت التثبيت السريع لمعظم المستخدمين لأنه يتعامل مع التبعيات تلقائياً.

التثبيت السريع (موصى به)

Linux / macOS:

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Windows (شغّل Command Prompt كمسؤول):

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

بعد التنفيذ، أعد تشغيل الطرفية لتحديث PATH.

الخطوة 2: التثبيت اليدوي عبر npm

إذا كنت تفضل التحكم اليدوي:

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

هذا الأمر يثبت أمر qwen عالمياً.

على macOS/Linux باستخدام sudo (إذا واجهت مشاكل في الصلاحيات):

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

الخطوة 3: التثبيت عبر Homebrew (macOS وLinux)

brew install qwen-code

الخطوة 4: التحقق من التثبيت

شغّل الأمر التالي لتأكيد نجاح التثبيت:

qwen --version

يجب أن ترى ناتجاً مشابهاً لـ:

Qwen Code CLI v0.x.x

الخطوة 5: الإطلاق الأول والمصادقة

أطلق واجهة سطر الأوامر التفاعلية:

qwen

في أول تشغيل، ستطلب الواجهة منك المصادقة بحساب Qwen الخاص بك (يفتح المتصفح لتسجيل دخول بنقرة واحدة). بعد تسجيل الدخول، يطبق الإعدادات الافتراضية ويدخل واجهة الطرفية التفاعلية.

انتقل أولاً إلى دليل مشروعك للحصول على أفضل النتائج:

cd /path/to/your/project
qwen

داخل الجلسة، استخدم أوامر مثل /help، /model لتبديل النماذج، أو أشر إلى الملفات باستخدام @filename.

الخطوة 6: التثبيت اليدوي من المصدر (متقدم)

للمطورين الراغبين في الحصول على أحدث التغييرات غير المنشورة:

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

ثم تحقق باستخدام qwen --version.

مشاكل شائعة واستكشاف الأخطاء وإصلاحها

الرسالة "Command 'qwen' not found": أعد تشغيل الطرفية أو نفذ الأمر hash -r (Linux/macOS). على Windows، أغلق وأعد فتح موجه الأوامر. تأكد من أن مجلد bin العام الخاص بـ Node.js مضاف إلى متغير PATH.
- أخطاء الصلاحيات أثناء npm install: استخدم sudo على Linux/macOS أو شغّل موجه الأوامر كمسؤول على Windows.
- إصدار Node.js قديم جداً: قم بالترقية إلى Node 20+ باستخدام nvm أو برنامج التثبيت الرسمي.
- مشاكل في الشبكة مع أصول Aliyun: جرب طريقة npm كحل احتياطي.
- فشل التثبيت على Termux أو توزيعات Linux معينة: استخدم علم --ignore-scripts: npm install -g @qwen-code/qwen-code@latest --ignore-scripts.
- المصادقة لا تعمل: تأكد من أن متصفحك يسمح بالنوافذ المنبثقة وأن لديك حساب Qwen صالح.

في حال استمرار المشاكل، تحقق من مستودع GitHub الرسمي: https://github.com/QwenLM/qwen-code.

الخطوات التالية

استكشف واجهة المستخدم التفاعلية: اكتب /help لمعرفة أوامر الشرطة المائلة المتاحة.
- جرّب البرمجة الوكيلية (agentic coding): اطلب من سطر الأوامر إعادة هيكلة الكود، أو شرح الملفات، أو أتمتة المهام باستخدام لغة طبيعية.
- ضبط النماذج (models): استخدم /model لاختيار Qwen3-Coder أو خلفيات أخرى مدعومة (بما في ذلك Ollama المحلي).
- التكامل مع VS Code: ثبّت ملحق Qwen Code Companion للتكامل السلس مع المحرر.
- تخصيص الإعدادات: عدّل ملف ~/.qwen/settings.json للسمات والنماذج الافتراضية والخيارات المتقدمة.

الآن أنت جاهز لاستخدام Qwen Code CLI كزميل برمجة ذكي قوي مباشرة في طرفيتك. ابدأ بتعليمات بسيطة مثل "Explain this codebase" أو "Refactor this function for better performance" داخل مجلد مشروعك.

برمجة سعيدة!