بدأ Qwen Code مشروعًا مبنيًا على Gemini CLI من Google، واليوم يملك وحده أكثر من 30,000 نجمة على GitHub. يقول ملف README إن المشروع كان مبنيًا في الأصل على Gemini CLI v0.8.2، ثم توقف عن المزامنة مع المشروع الأصلي بدءًا من v0.1، وتحوّل إلى وكيل برمجة مستقل يدعم عدة بروتوكولات.
أهم النقاط
- Qwen Code وكيل برمجة مفتوح المصدر للطرفية بترخيص Apache-2.0، بدأ نسخةً متفرعة من Gemini CLI.
- ثبّته بالسكربت المستقل، أو عبر npm مع Node.js 22 أو أحدث، أو عبر Homebrew، ثم شغّل /auth لربط نموذج.
- لا يوصف أي خيار لتسجيل الدخول بأنه مجاني، لذا استخدم خادمًا محليًا من Ollama أو vLLM أو LM Studio إن أردت تكلفة صفرية.
- ابدأ مع قواعد الكود الجديدة في Plan Mode للقراءة فقط، وراجع التغييرات بـ /diff وتراجع عنها بـ /restore.
يشرح هذا الدليل كيف تثبّت Qwen Code، وتسجّل الدخول (أو توجّهه إلى نموذج محلي مجاني)، وتستخدمه بأمان في مشروع حقيقي. كل ما يلي مأخوذ من ملف README وتوثيق المشروع على GitHub، وقد راجعناهما في 15 نوفمبر 2026. لم نشغّل أيًّا من الأوامر لكتابة هذا المقال، فجرّبها أولًا في مجلد تجريبي.
ما تحتاج إليه
- طرفية على macOS أو Linux أو Windows
- Node.js 22 أو أحدث، إذا اخترت طريقة npm
- مشروع برمجي توجّهه إليه (والأفضل مستودع احتياطي)
- وسيلة للدفع مقابل نموذج أو استضافته: اشتراك Qwen، أو مفتاح API، أو خادم نماذج محلي

ما هو Qwen Code
إنه وكيل برمجة مفتوح المصدر يعمل في الطرفية، ويقرأ مستودعك، ويعدّل الملفات، وينفّذ الأوامر. يذكر GitHub أن ترخيصه Apache-2.0، ويقول README إنه يعمل مع واجهات OpenAI وAnthropic وGemini وQwen البرمجية، إضافةً إلى أي مزوّد خارجي أو نموذج محلي مثل Ollama أو vLLM. وحتى 15 نوفمبر 2026، أحدث وسم إصدار هو v0.27.4.
ينشر المشروع أيضًا نتائج اختبار أداء خاص به: على SWE-bench Verified، حققت سبعة إصدارات من Qwen Code متوسطًا بين 76.40% و77.80% مع النموذج نفسه Qwen 3.7 Max. هذا تقييم القائمين على المشروع، وليس اختبارًا مستقلًا.
بالأرقام
30,000نجمة على GitHub، أكثر من
77.80%أعلى متوسط SWE-bench معلن ذاتيًا
v0.27.4أحدث وسم إصدار
خطوة بخطوة
1. ثبّته
يعرض README ثلاث طرق. الأولى مثبّت من سطر واحد على Linux وmacOS:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
تمرير سكربت مباشرةً إلى الصدفة قرار يتعلق بالثقة. المثبّت مستضاف على عنوان تخزين تابع لـ Alibaba Cloud، لذا يمكنك إن شئت استخدام npm أو Homebrew بدلًا منه:
npm install -g @qwen-code/qwen-code@latest
أو على macOS وLinux باستخدام Homebrew:
brew install qwen-code
يوفّر README لمستخدمي Windows مثبّتًا عبر PowerShell. وبعد التثبيت المستقل، أعد تشغيل الطرفية حتى تسري متغيرات البيئة.
2. شغّله داخل مشروع
cd ~/projects/my-app
qwen
يُفترض أن ترى جلسة تفاعلية في الطرفية. يذكر README أيضًا فرعًا باسم “1.0 Preview”، لكن التعليمات هنا خاصة بالإصدار الرئيسي.
3. سجّل الدخول أو اربط نموذجًا
اكتب /auth. يسرد التوثيق خمسة خيارات رئيسية:
- Qwen Account with Subscription: تسجيل الدخول عبر المتصفح باشتراك Plus أو Pro.
- QwenCloud: خطة Token Plan أو مفتاح Standard API Key بالدفع حسب الاستخدام.
- Alibaba ModelStudio: خطة Coding Plan أو Token Plan أو مفتاح Standard API Key.
- Third-party Providers: قائمة مدمجة تضم DeepSeek وKimi وOpenRouter وغيرها، باستخدام مفتاح API.
- Custom Provider: خادم محلي، أو وكيل، أو مزوّد غير مدعوم.
لا يصف التوثيق الحالي أيًّا من هذه الخيارات بأنه مجاني. وللإبقاء على التكلفة صفرًا، استخدم نموذجًا محليًا. يبيّن التوثيق أن Ollama وvLLM وLM Studio تعمل عبر عنوان متوافق مع OpenAI. ويغطي دليلنا إلى تشغيل نموذج ذكاء اصطناعي باستخدام Ollama جانب الخادم. ثم احفظ ملف إعدادات في ~/.qwen/settings.json، مقتبسًا من مثال التوثيق نفسه:
{
"env": { "OLLAMA_API_KEY": "ollama" },
"modelProviders": {
"openai": [
{
"id": "your-model-name",
"name": "My local model",
"envKey": "OLLAMA_API_KEY",
"baseUrl": "http://localhost:11434/v1"
}
]
},
"security": { "auth": { "selectedType": "openai" } },
"model": { "name": "your-model-name" }
}
استبدل your-model-name باسم النموذج الدقيق الذي يعرضه خادمك. يقول التوثيق إن model.name يجب أن يطابق إحدى قيم id. وبعد الحفظ، شغّل qwen.
4. اطرح سؤالك الأول
يقترح README البدء بطلب آمن للقراءة فقط:
Explain this repository and show me where to start.
ثم شغّل /init، الذي يصفه التوثيق بأنه يحلّل المجلد الحالي وينشئ ملف سياق أوليًا. يحمّل Qwen Code ملفي التعليمات QWEN.md وAGENTS.md تلقائيًا. وإذا كنت تستخدم ملفات المهارات بالفعل، فإن دليلنا إلى مهارات الوكيل في Claude Code يشرح الفكرة، ويذكر Qwen Code في توثيقه لوحة /skills خاصة به.
5. حدّد مقدار الحرية التي تمنحه إياها
لدى Qwen Code خمسة أوضاع للأذونات: Plan وAsk Permissions وAuto-Edit وAuto وYOLO. اضغط Shift+Tab (أو Tab على Windows) للتنقل بينها. يصف التوثيق وضع Auto، حيث يوافق مصنِّف على الإجراءات الآمنة ويحظر الخطرة، بأنه الوضع الافتراضي، لكن الصفحة نفسها تذكر Ask Permissions بوصفه الوضع الأولي، لذا تحقّق من شريط الحالة. ومع قاعدة كود جديدة، ابدأ في Plan Mode:
/plan refactor the settings page
Plan Mode للقراءة فقط، فلا يُعدَّل شيء ولا يُنفَّذ شيء. اكتب /plan exit للعودة إلى وضعك السابق. واحتفظ بوضع YOLO للمشاريع الموثوقة، كما ينصح التوثيق.
6. راجع وتراجع
استخدم /diff لفتح عارض تفاعلي للتغييرات غير المحفوظة في Git. وإذا ساءت خطوة ما، فإن /restore يعرض نقاط الاستعادة ويعيد ملفات المشروع إلى حالتها قبل تشغيل أداة ما.
7. استخدمه في السكربتات
يقول README إن الوضع غير التفاعلي (headless) يعمل من السكربتات وأنظمة CI:
qwen -p "Summarize the repository layout."

الأخطاء الشائعة وحلولها
qwen: command not found. أعد تشغيل الطرفية بعد التثبيت كما يوصي README. وإذا استخدمت npm، فتأكد من أن إصدار Node.js هو 22 أو أحدث.- تسجيل الدخول عبر المتصفح لا يعمل. في أنظمة CI أو الحاويات التي تعمل دون إشراف، يوصي توثيق المصادقة باستخدام طريقة مفتاح API مع متغيرات البيئة بدلًا من ذلك.
- الأمر
qwen authلا يفيد بشيء. لقد أُزيل هذا الأمر. شغّلqwenثم/auth. وشغّل/doctorللتحقق من المصادقة الحالية. - انتهاء مهلة النموذج المحلي. تأكد من أن
baseUrlينتهي بـ/v1وأن الخادم يعمل. وللخوادم البطيئة، يصف التوثيق إعدادstreamIdleTimeoutMs. - غير متأكد من أمان الخدمة الخلفية. إذا كنت تستخدم
qwen serveأوqwen daemon start، فانتبه إلى أن README يقول إنها تستمع افتراضيًا على واجهة loopback دون مصادقة bearer، فيستطيع أي عملية محلية تصل إليها استخدام الـ API كاملة، بما في ذلك تنفيذ الكود. وعلى الأجهزة المشتركة، اضبطQWEN_SERVER_TOKENواستخدم--require-auth.
هل تعلم؟
تستمع الخدمة الخلفية qwen serve افتراضيًا على واجهة loopback دون مصادقة bearer، فيستطيع أي عملية محلية تصل إليها استخدام الـ API كاملة، بما في ذلك تنفيذ الكود. اضبط QWEN_SERVER_TOKEN واستخدم –require-auth على الأجهزة المشتركة.
هل يستحق التجربة؟
إذا كنت تحب أسلوب عمل Claude Code أو Gemini CLI وتريد أداة يمكنك توجيهها إلى نموذجك الخاص، فإن Qwen Code على بُعد تثبيت قصير. ابدأ في Plan Mode، واحتفظ بـ commit في Git في متناول يدك، وتعامل مع أرقام اختبار الأداء على أنها أرقام القائمين على المشروع إلى أن تجرّبه بنفسك.
الأسئلة الشائعة
هل Qwen Code مجاني؟
الأداة نفسها مفتوحة المصدر بترخيص Apache-2.0، لكن التوثيق الحالي لا يصف أيًّا من خيارات تسجيل الدخول في /auth بأنه مجاني. وللإبقاء على التكلفة صفرًا، اربطه بنموذج محلي عبر Ollama أو vLLM أو LM Studio.
كيف أثبّت Qwen Code؟
يعرض README ثلاث طرق: مثبّت مستقل من سطر واحد على Linux وmacOS، أو npm install –g @qwen-code/qwen-code@latest مع Node.js 22 أو أحدث، أو brew install qwen-code. ولمستخدمي Windows مثبّت عبر PowerShell. أعد تشغيل الطرفية بعد ذلك.
هل يمكن لـ Qwen Code استخدام نموذج محلي عبر Ollama؟
نعم. احفظ ملف ~/.qwen/settings.json يوجّه مزوّدًا متوافقًا مع OpenAI إلى http://localhost:11434/v1، وتأكد من أن model.name يطابق إحدى قيم id لدى المزوّد. ثم شغّل qwen.
ما هو Plan Mode في Qwen Code؟
Plan Mode واحد من خمسة أوضاع للأذونات، وهو للقراءة فقط، فلا يُعدَّل شيء ولا يُنفَّذ شيء. شغّله بكتابة /plan متبوعًا بمهمتك، واكتب /plan exit للعودة إلى وضعك السابق.
اختبار سريع
على أي مشروع بُني Qwen Code في الأصل؟
- Claude Code
- Gemini CLI
- Ollama
يقول README إنه بُني في الأصل على Gemini CLI v0.8.2.
أي وضع مخصّص للقراءة فقط؟
- Plan
- YOLO
- Auto-Edit
يقول التوثيق إن Plan Mode لا يعدّل ولا ينفّذ أي شيء.
أي أمر يعيد ملفات المشروع إلى نقطة استعادة؟
- /diff
- /init
- /restore
يعرض /restore نقاط الاستعادة ويعيد الملفات إلى حالتها قبل تشغيل أداة ما.
المصادر
آخر تحقق من الروابط في 15 نوفمبر 2026.





اكتب ردًّا