كيفية تشغيل Qwen Code في الطرفية وإعداد وضع التحرير

يبدو السؤال عادةً هكذا: كيف تجعل Qwen يعمل كما ينبغي في وحدة التحكم ويكتب الشيفرة بمفرده؟ غالبًا ما يكمن وراء السؤال شعور بالإحباط: ثبّت شخص ما Qwen Code، وطرح سؤالًا، فتلقى نصًا ومقطعًا من الشيفرة اضطر إلى نسخه يدويًا، رغم أنهم وعدوه بوكيل يدخل المشروع وينجز كل شيء بنفسه.

هذا هو Qwen Code بالضبط: وكيل متكامل. يستطيع فتح الملفات وتعديلها وتشغيل الأوامر بنفسه. يتوقف سلوكه على وضع الموافقة النشط: يطلب Ask Permissions التأكيد، بينما يسمح Auto-Edit وAuto باستقلالية أكبر. افحص سطر الحالة بدل افتراض أن وضعًا اسمه Default هو خيار التثبيت الأول. فيما يلي، بالترتيب: التثبيت، وتشغيله في مشروع، وربط نموذج بعد تغييرات أبريل، والانتقال إلى وضع يعدّل فيه الوكيل الشيفرة من دون أسئلة غير ضرورية. تحقّقنا من كل شيء بالرجوع إلى وثائق Qwen الرسمية حتى 30 أغسطس 2026.

مصادر عملية حول النماذج والوكلاء: وثائق Ailoot.

ما المقصود بعبارة «Qwen Code يكتب الشيفرة بمفرده»؟#

الفرق بسيط. تجيب دردشة المتصفح عن السؤال بنص. تقرأ الإجابة، وتنسخ الشيفرة، وتلصقها في ملفك، وتشغّلها بنفسك، وتكتشف الخطأ بنفسك، ثم تعيده إلى الدردشة. أنت الوسيط بين الدردشة والمشروع.

يعمل الوكيل بطريقة مختلفة. كلّفه بمهمة بلغة عادية: «أضف نموذجًا للتعليقات» أو «أصلح هذا الخطأ». ثم يفحص بنية المشروع، ويعثر على الملفات ذات الصلة، ويجري التعديلات، ويشغّل اختبارًا. وتوضح الوثائق الأمر مباشرةً: يضع الوكيل خطة، ويكتب الشيفرة، ويتأكد من أنها تعمل.

من هنا يأتي الالتباس في السؤال. فعبارة «Qwen لا يكتب الشيفرة بمفرده» تعني غالبًا أحد أمرين: إما أن الشخص فتح دردشة في المتصفح بدلًا من وكيل الطرفية، أو أن الوكيل يعمل لكنه مضبوط على وضع يطلب الإذن عند كل تعديل. يُحلّ الأمر الأول بتثبيت Qwen Code، والثاني بتغيير الوضع. نشرح الحلين أدناه.

كيف تثبّت Qwen Code في الطرفية؟#

أسرع طريقة هي أداة التثبيت الرسمية، التي تختار تلقائيًا الإصدار المناسب لنظامك.

على macOS وLinux، افتح الطرفية والصق سطرًا واحدًا:

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، إذا كان مثبتًا لديك بالفعل. ويتطلب Node.js بإصدار 22 أو أحدث:

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

بعد التثبيت، أعد تشغيل الطرفية. تضيف أداة التثبيت الأمر qwen إلى مسارات النظام، ولن تتعرّف عليه الطرفية حتى تعيد تشغيلها؛ وهذا السبب الأكثر شيوعًا لرسالة «ثبّتُّه، لكنه لا يجد الأمر». للتحقق من اكتمال التثبيت، شغّل:

qwen --version

إذا ظهر رقم إصدار، فهذا يعني أن الوكيل ثُبّت وأصبح جاهزًا للتشغيل في مشروعك.

كيف تشغّل Qwen Code في مشروعك؟#

أولًا، انتقل إلى المجلد الذي يحتوي على شيفرتك. وهذا مهم: يعمل الوكيل في المجلد الذي شُغّل منه ولا يرى سوى محتوياته.

cd path-to-your-project
qwen

ستُفتح واجهة الوكيل مباشرةً في الطرفية. في المرة الأولى، سيعرض عليك ربط نموذج؛ وهذا ما سنتناوله في القسم التالي. بعد ربط النموذج، يمكنك تكليف الوكيل بمهمة بلغة عادية لترى ما يستطيع الوصول إليه:

ماذا يفعل هذا المشروع؟

سيقرأ الوكيل الملفات، ويفهم البنية، ويقدّم لك إجابة مفيدة. ثم يمكنك أن تطلب منه كتابة الشيفرة وتعديلها: «أضف زر تسجيل الخروج»، أو «قسّم هذا الملف إلى ملفين»، أو «اكتشف سبب فشل الاختبار». سيعثر على المواضع المناسبة ويجري التغييرات بنفسه.

وهناك طريقة ثانية لتشغيله بأمر واحد، من دون الواجهة. وهي مفيدة للنصوص البرمجية والمهام المؤتمتة:

qwen -p "أعِد قراءة README وحدّث قائمة الأوامر"

ينفّذ المهمة ثم ينتهي من دون محادثة. لست بحاجة إليه في الخطوات الأولى، لكن من المفيد معرفته لاحقًا.

لماذا يعمل الوكيل لكنه لا يفعل شيئًا بمفرده؟#

العقبة الأولى هي الوصول إلى النموذج. كان Qwen Code يوفّر وصولًا مجانيًا في السابق: تسجّل الدخول بحساب qwen.ai ويعمل الوكيل من دون بطاقة. كان ذلك الوصول يُسمّى Qwen OAuth، وقد أُوقف. وتذكر وثائق التفويض ذلك صراحةً: أُوقف المستوى المجاني من Qwen OAuth في 15 أبريل 2026؛ وقد تستمر عمليات تسجيل الدخول المحفوظة سابقًا لفترة وجيزة، لكن الخادم يرفض الطلبات الجديدة. كما أُزيل خيار «تسجيل الدخول باستخدام qwen.ai» من القائمة.

لذلك، كي يبدأ الوكيل بالتفكير في أي مهمة، عليك ربط نموذج. يتناول القسم التالي خيارات الربط، المدفوعة منها والمحلية المجانية.

أما السبب الثاني فأقل وضوحًا وأكثر إحباطًا. النموذج مرتبط، والوكيل يرد، لكنه لا يعدّل أي ملفات؛ بل يعرض ما يخطط لفعله وينتظر. هذا سلوك متوقع في Ask Permissions الذي يطلب التأكيد قبل التعديلات والأوامر؛ وليس دليلًا على وضع بدء عام لكل تثبيت. لكي يعمل الوكيل بمفرده، عليك تغيير الوضع. سنشرح ذلك بعد قسمين، حيث ستجد إجابة السؤال الأصلي.

كيف تربط نموذجًا الآن بعد إيقاف الوصول المجاني؟#

في الوكيل، اكتب الأمر:

/auth

ستُفتح قائمة تضم ثلاثة خيارات رئيسية. إليك وظيفة كل منها.

Alibaba ModelStudio هو الخيار الرسمي من مطوّري Qwen. يقدم Coding Plan بسعر ثابت وحصة أسبوعية للمطوّر الفردي، وToken Plan بتسعير حسب الاستخدام للفرق، وخيار ربط مفتاح ModelStudio موجود. وهذا وصول مدفوع إلى نموذج Qwen «الأصلي».

تتيح موفرو الخدمات الخارجيون اختيار موفر مدمج والاتصال به باستخدام مفتاح. تشمل القائمة الرسمية DeepSeek وGrok وMiniMax وZ.AI وKimi وModelScope وغيرها. احصل على مفتاح من الموفر وأدخله، وسيستخدم الوكيل نموذج ذلك الموفر.

يربط Custom Provider خادمك أو وكيلك الوسيط أو محركك المحلي. ومن هنا يمكنك ربط نموذج يعمل على حاسوبك عبر Ollama. يدعم هذا الخيار تنسيقات OpenAI وAnthropic وGemini، لذا فهو يعمل مع أي طريقة وصول تقريبًا.

يمكنك أيضًا إدخال المفتاح والإعدادات يدويًا في الملف ~/.qwen/settings.json. يتضمن الملف الحقل modelProviders (النماذج المتاحة)، وenv (المفاتيح نفسها)، وsecurity.auth.selectedType (البروتوكول الذي سيُفعّل عند بدء التشغيل)، وmodel.name (النموذج الافتراضي). بعد ذلك سيبدأ qwen بهذه الإعدادات من دون أن يسألك شيئًا. ولأول مرة، من الأسهل استخدام /auth؛ ويمكنك العودة إلى الملف عندما تريد حفظ جميع الإعدادات.

للتعرّف على ما بقي مجانيًا بعد أبريل، راجع المقال عن Qwen Code المجاني.

ما الوضع الذي ينبغي تفعيله ليعدّل الوكيل الشيفرة بمفرده؟#

الفكرة الأساسية هي أن وضع الوصول يحدد مدى استقلالية الوكيل في التصرف. وهناك خمسة أوضاع، من الأكثر حذرًا إلى الأكثر سماحًا.

إذا كان الوكيل يعرض عليك التعديلات وينتظر، فالأرجح أنه في وضع Ask Permissions (الذي كان يُسمّى Default في الإصدارات القديمة). عندها ستضطر إلى تأكيد كل تعديل وأمر يدويًا، ما يعطيك انطباعًا بأنه لا يفعل شيئًا بمفرده.

لجعله يعدّل الملفات من دون طلب إذن، انتقل إلى Auto-Edit. ستُجرى التعديلات تلقائيًا، لكن الوكيل سيظل يطلب تأكيدك قبل تشغيل الأوامر؛ وهذا إجراء وقائي معقول لتجنب تشغيل rm في المكان الخطأ مثلًا.

يستخدم Auto مقيّمًا داخليًا للإجراءات المحتاجة إلى تقييم. اختره عمدًا بعد فحص الإصدار المثبت والحالة النشطة؛ فكلمة default الباقية في إعداد Ask Permissions اسم توافق، وليست دليلًا على أنه وضع بدء التشغيل.

YOLO هو الوضع الأكثر سماحًا. يعدّل الوكيل الملفات ويشغّل الأوامر بمفرده، من دون أن يسأل عن أي شيء. وتقول الوثائق إنه مخصص للمشروعات الشخصية الموثوقة وسير العمل المؤتمت. وقد يؤدي تفعيله في مشروع عمل إلى نتيجة غير مرغوبة، لذا لا تفعّله إلا عندما تكون متيقظًا، ويُفضّل أن تستخدمه على نسخة.

كيف تغيّر الوضع أثناء الجلسة؟#

يمكنك تغيير الأوضاع أثناء العمل، حتى في منتصف المهمة. اضغط على Shift+Tab للانتقال إلى الوضع التالي. وفي Windows، يؤدي مفتاح Tab العادي الوظيفة نفسها. تسلسل الأوضاع هو: Plan، ثم التأكيدات، ثم التعديلات التلقائية، ثم Auto، ثم YOLO، ثم العودة إلى Plan.

يظهر الوضع الحالي دائمًا في سطر الحالة أسفل الواجهة. اعتد على التحقق منه قبل تكليف الوكيل بمهمة كبيرة، كي لا تشغّل YOLO بينما كنت تريد الاطلاع على خطة فحسب.

يتألف سير العمل المناسب للمبتدئين من ثلاث خطوات:

1. شغّل الوكيل في وضع Plan واطلب منه تحليل المهمة واقتراح خطة. لن يلمس أي شيء؛ سيقرأ الشيفرة ويصف ما ينوي فعله فحسب.
2. اقرأ الخطة، وإذا وافقت عليها، فانتقل إلى Auto-Edit أو Auto بالضغط على Shift+Tab.
3. اطلب منه المتابعة. سيعدّل الوكيل الآن الملفات بمفرده بينما تراقب النتائج.

يخفف هذا النهج من أكبر مخاوف المبتدئين، أي أن يفسد الوكيل كل شيء فورًا. تراجع الخطة أولًا في وضع آمن، وبعدها فقط تسمح له بالمتابعة.

يعتمد النهج الكامل للبرمجة بأسلوب vibe coding على المنهج؛ أما الأداة فثانوية. سواء استخدمت Qwen أو Claude أو غيرهما، يمكنك تغيير النموذج الذي يعمل في الخلفية. وهناك ثلاثة أسس تساعدك في الحفاظ على النتائج عند تغيير النماذج: نسخة ذكاء اصطناعي عنك، وSecond Brain، وهندسة السياق. وتنتج هذه الأسس مجتمعةً نتائج متوقعة؛ ولا علاقة للحظ العابر بذلك.

نموذج محلي من دون بطاقة#

ثبّت نموذجًا مفتوحًا على حاسوبك عبر Ollama أو vLLM، ثم اربطه بوصفه Custom Provider من قائمة /auth. بعد ذلك، سيستخدم الوكيل نموذجًا على جهازك بدلًا من سحابة Alibaba. لا تحتاج إلى بطاقة أو مفاتيح، ولا يوجد حد للطلبات. ولمعرفة النماذج المفتوحة القادرة على البرمجة، راجع مراجعة نماذج البرمجة المجانية.

أما المقابل فهو متطلبات الأجهزة. فالنموذج الذي يكتب الشيفرة بجودة معقولة يحتاج إلى قدر كبير من ذاكرة الفيديو. ويمكن تشغيله على حاسوب ألعاب مزود ببطاقة رسومات قوية، لكن قد لا يتسع له حاسوب محمول عادي. أو قد يستغرق وقتًا طويلًا في التفكير في كل إجابة، حتى يصبح البحث عن خيار آخر أسهل.

ومن مزايا التشغيل المحلي أيضًا خصوصية البيانات. تبقى شيفرتك كلها على حاسوبك، ولا يُرسل شيء إلى خادم جهة أخرى. وهذا أهم من توفير رسوم الاشتراك في مشروع حساس.

كيف تمنع الوكيل من إفساد المشروع؟#

يكون الوكيل المستقل مريحًا ما دام يفعل ما تريده. ولتفادي أن تكلفك زلّة ما، اتبع ثلاث عادات.

أولًا، استخدم git. إذا كان المشروع تحت إدارة الإصدارات، يمكنك رؤية كل تعديل يجريه الوكيل والتراجع عن أي منها. الوكيل المستقل محفوف بالمخاطر فعلًا من دون git: يغيّر شيئًا ولا توجد طريقة لاستعادة الإصدار السابق. ومع git، لا يتطلب التراجع سوى أمر قصير.

ثانيًا، ابدأ بوضع Plan. قبل تكليف الوكيل بمهمة كبيرة، اطلب منه وضع خطة في وضع لا يلمس فيه أي شيء. اقرأ الخطة وافهم ما ينوي الوكيل فعله، ثم انتقل إلى التعديلات.

ثالثًا، توخَّ الحذر مع YOLO. في هذا الوضع، يشغّل الوكيل الأوامر بنفسه، بما فيها الأوامر التي تحذف الملفات. وهذا أكثر مما ينبغي لمشروع عمل. خصّص YOLO للنسخ التجريبية والمهام الصغيرة التي لا يهم فيها إن حدث خطأ.

تعالج هذه العادات الثلاث الخوف الأساسي: «استخدمت vibe coding وأفسدت المشروع». ولمعرفة المزيد عن التراجع عن التغييرات في vibe coding، راجع هذه المراجعة المنفصلة. تتناول المقالة Claude Code، لكن مبدأ استخدام git هو نفسه تمامًا.

من أين تبدأ في مهمتك؟#

إليك العملية كاملةً في قائمة مختصرة. اتبعها من الأعلى إلى الأسفل:

1. ثبّت Qwen Code بأمر واحد وأعد تشغيل الطرفية.
2. انتقل إلى مجلد المشروع باستخدام cd وشغّل qwen.
3. اربط نموذجًا عبر /auth: خطة مدفوعة، أو نموذجًا محليًا عبر Ollama إذا لم يكن الدفع بالبطاقة خيارًا متاحًا.
4. كلّف الوكيل بمهمة في وضع Plan واقرأ خطته.
5. انتقل إلى Auto-Edit أو Auto باستخدام Shift+Tab واتركه يعمل.
6. أدر المشروع باستخدام git كي تتمكن من التراجع عن أي تعديل.

باختصار، تعني عبارة «Qwen لا يكتب الشيفرة بمفرده» غالبًا إما أن نموذجًا غير مرتبط، أو أن الوكيل في وضع التأكيد. عالج المشكلة الأولى من قائمة /auth، والثانية بالضغط على Shift+Tab حتى تصل إلى Auto-Edit. بعد ذلك سيعمل الوكيل حقًا بمفرده في الطرفية.

إذا أردت مقارنة Qwen بوكلاء آخرين لمهمتك، فراجع هذه المراجعة لبدائل Claude Code. يظهر Qwen ضمن الخيارات، لتتمكن من معرفة الأنسب لكل استخدام.

يعتمد النهج الكامل للبرمجة بأسلوب vibe coding على المنهج، وتأتي الأداة المحددة في المرتبة الثانية: نسخة ذكاء اصطناعي عنك، وSecond Brain، وهندسة السياق. يمكنك تغيير الأداة التي تعمل في الخلفية؛ أما المنهج فيبقى كما هو. مصادر عملية: وثائق Ailoot.

المزيد من المصادر والأدوات: Ailoot.