# كيفية تثبيت Qwen Code CLI: دليل خطوة بخطوة لوكيل الترميز بالذكاء الاصطناعي في الطرفية

تعلم كيفية تثبيت Qwen Code CLI، وكيل الترميز بالذكاء الاصطناعي مفتوح المصدر لطرفيتك. تعليمات خطوة بخطوة باستخدام npm، سكريبت التثبيت السريع، Homebrew، واستكشاف الأخطاء وإصلاحها على Windows وmacOS وLinux.

Canonical URL: https://a2a-mcp.org/blog/qwen-cli-install-ar

Language: ar

Published: 2026-04-07

Updated: 2026-04-07

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

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

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

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

```bash
node --version
npm --version
```

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

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

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

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

**Linux / macOS**:

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

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

```cmd
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

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

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

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

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

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

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

```bash
brew install qwen-code
```

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

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

```bash
qwen --version
```

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

```
Qwen Code CLI v0.x.x
```

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

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

```bash
qwen
```

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

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

```bash
cd /path/to/your/project
qwen
```

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

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

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

```bash
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" داخل مجلد مشروعك.

.

برمجة سعيدة!