شرح محرّر Cursor: ميزاته وخططه وكيف تبدأ

تبحث عن شرح عملي لمحرّر Cursor فتجد مقالات عربية ما زالت تتحدث عن «500 طلب شهرياً» وعن رمز @Codebase، وكلاهما اختفى من توثيق الشركة. ما يلي دليل تشغيل لما يعمل فعلاً في أغسطس 2026: كيف يبني الوكيل سياقه، وأين تذهب النقود، وما يكسر التجربة.

من إكمال الكود إلى تشغيل وكلاء متوازين

تعريف الأداة نفسه تبدّل: لم يعد Cursor محرّراً يكمل السطر التالي، بل بيئة تشغّل ثمانية وكلاء بالتوازي على مطالبة واحدة عبر git worktrees، ولها منذ أبريل 2026 «واجهة وكلاء» تديرهم محلياً وفي السحابة وعبر SSH. واستيراد إعدادات VS Code بنقرة ينقل اختصاراتك وسمتك.

والأدوات الأربع ليست قائمة تختار منها بل ترتيباً داخل المهمة: تبدأ من وضع Plan عبر Shift+Tab فيبني خطة تراجعها قبل كتابة أي كود، ثم تسلّمها لوضع Agent عبر Cmd+I فيفتح الملفات وينفّذ أوامر الطرفية ويكرّر حتى ينجز. وتنزل إلى Cmd+K حين يبقى تعديل موضعي لا يستحق وكيلاً. وتحت هذا كله يعمل Tab بإكمال يتوقّع تعديلك القادم.

وحين يخرج التنفيذ عن المسار، توصية Cursor أن تتراجع وتحسّن الخطة بدل ترقيعها بمطالبات متتابعة. ونقاط الاستعادة تعينك: لقطات قبل التعديلات المهمة، ولكل تعديل زرّا Keep وUndo. لكنها ليست إدارة نسخ.

ويدعم المحرّر بروتوكول MCP لربط أدوات خارجية بالوكيل، وتفصيله في شرح بروتوكول MCP ومتى تحتاجه. وخارج المحرّر، أطلقت Cursor منصة Origin لاستضافة الشيفرة. وموقعه بين منافسيه في أفضل أدوات البرمجة بالذكاء الاصطناعي 2026.

كيف يعثر الوكيل على الملف الصحيح

يبني Cursor فهرسة دلالية بتوليد تضمينات للكود. المحتوى لا يُخزَّن بنص صريح: يبقى في الذاكرة أثناء الفهرسة ثم يُتلَف، والمسارات تُشفَّر بمفتاح تخصّصه في ملف .cursor/keys بجذر مساحة العمل. ويرافقها محرك بحث اسمه Instant Grep تصفه الشركة بأنه يتفوق على ripgrep في المستودعات الكبيرة. وحين يحتاج استكشافاً واسعاً، يطلق الوكيل وكيلاً فرعياً في نافذة سياق مستقلة يبحث بالتوازي ويعيد ملخصاً بدل الملفات الخام.

والشروحات القديمة تكرّر ما لم يعد قائماً: رموز @Codebase و@Docs و@Web و@Git لم تعد مذكورة في التوثيق، والبحث في الويب صار أداة مدمجة لا رمزاً تكتبه. الرموز الموثّقة اليوم:

الرمز	ما يُدرجه
@اسم-الملف أو @مسار-المجلد/	ملفات أو مجلدات بعينها
@Terminals	مخرجات الطرفية
@Chats	سياق من محادثة سابقة
@Commit	فروق التغييرات غير المُودَعة
@Branch	الفرق الكامل للفرع مقابل main
@Browser	سياق من المتصفح المدمج

ويُريك Cursor الفاتورة كاملة: حلقة السياق بجوار حقل الإدخال تفصّل الامتلاء بين موجّه النظام والأدوات والقواعد وMCP والوكلاء الفرعيين. افتحها بعد عشرين رسالة وسترى غالباً أن نصف نافذتك ذهب إلى أدوات لم تستدعِها.

حاجزان مختلفان: منع الوصول ومنع الفهرسة

ملف .cursorignore يمنع الوصول إلى الكود من الوكيل ومن Tab ومن Inline Edit ومن رموز @، لكنه لا يحجب الطرفية ولا أدوات خوادم MCP. أما .cursorindexingignore فيستثني من الفهرسة فقط: تبقى الملفات متاحة للوكيل لكنها لا تظهر في نتائج بحث قاعدة الكود، وهو المناسب للملفات المولَّدة والاعتماديات المنسوخة.

الصيغة مطابقة لـ.gitignore، مع قيد نفي: لا يمكن إعادة تضمين ملف إذا كان مجلده الأب مستثنى بـ*. ويحذّر التوثيق من أن الحماية الكاملة غير مضمونة، فلا تضع أسراراً حقيقية في مساحة العمل أصلاً.

قاعدة واحدة بامتداد mdc تغني عن تكرار التعليمات

قواعد المشروع تعيش في .cursor/rules بامتداد .mdc، ولها أربعة أنواع: تُطبَّق دائماً، أو يقرّرها الوكيل بناءً على description، أو حين يطابق الملف نمط globs، أو تُستدعى يدوياً بـ@اسم-القاعدة:

---
description: "Standards for service layer implementation"
alwaysApply: false
globs: src/services/**/*.ts
---

- Define each service in its own file under `src/services/`
- Always validate inputs at the service boundary
- Return structured error objects with `code` and `message` fields

وضبط alwaysApply: true يُضمِّن القاعدة في كل جلسة ويُلغي globs وdescription معاً، وهو يستنزف نافذة السياق، فلا تجعله الافتراضي. والتوصية الرسمية إبقاؤها تحت 500 سطر. وإلى جانبها يعمل AGENTS.md، ماركداون بلا frontmatter يُلتقط تلقائياً وتتقدّم تعليمات ملفه الأعمق على الأب، والأولوية عند التعارض لقواعد الفريق ثم المشروع ثم المستخدم. أما .cursorrules فقديم وسيُهمَل رسمياً.

ومطبّ صامت يستهلك ساعات: ملف .md عادي داخل .cursor/rules يُتجاهَل تماماً لأنه بلا frontmatter، فلا يعمل ولا يظهر لك خطأ.

ما لا تصله القواعد أبداً

القواعد تنطبق على الوكيل وحده: لا تصل إلى إكمال Tab، ولا إلى Inline Edit، ولا إلى مراجعات Bugbot. فمن يشكو أن «Tab يتجاهل قواعدي» يصف سلوكاً موثّقاً لا عطلاً.

الاشتراك أرضية لا سقف: كيف تُحسب الفاتورة

في 16 يونيو 2025 استُبدلت حصة «500 طلب سريع» بحصة استهلاك مقوَّمة بالدولار بأسعار API، وأثار التغيير اعتراضاً انتهى باعتذار علني من الرئيس التنفيذي.

الخطة	السعر بالدولار شهرياً	ما يميّزها
Hobby	0	طلبات وكيل محدودة
Pro	20	حدود موسّعة، MCP والمهارات، وكلاء سحابيون
Pro+	60	حدود وكيل أوسع، لمن تنفد حصته قبل اليوم العشرين
Ultra	200	أعلى الحدود، لتشغيل وكلاء متوازين يومياً
Teams	40 للمقعد	فوترة مركزية وSSO وفرض وضع الخصوصية

كل خطة تشمل قدراً من الاستهلاك يُحسب بأسعار API، دون رقم منشور. والاستهلاك مقسوم إلى حوضين شهريين: نماذج Cursor بحصة أكبر، ونماذج الأطراف الثالثة بسعر مزوّدها، ويُصفَّران مع دورة الفوترة.

ووفق صفحة التسعير الحالية، وضع Auto ليس معفى من الخصم. أوضاعه الثلاثة تُفوتر بسعر القائمة للنموذج الذي وُجّه إليه الطلب؛ فهو وسيلة توجيه لا خصم. وعلى خطط Teams وEnterprise تحمل نماذج الأطراف الثالثة رسماً إضافياً قدره 0.25 دولار لكل مليون رمز فوق سعر API.

والرقم الحاسم يأتي من Cursor نفسه: المستخدم اليومي للوكيل ينفق عادةً 60-100 دولار شهرياً، والمكثّف يتجاوز 200 دولار. أي أن الـ20 دولاراً أرضية لا سقف؛ ومقابلته بسعر دخول Copilot في GitHub Copilot مقابل Cursor.

وضع الخصوصية يمنع التدريب لا يمنع الرفع

أكثر ما يُساء فهمه أن وضع الخصوصية يعني أن الكود لا يغادر جهازك. ما يعِد به هو منع التدريب عليه، من Cursor ومن مزوّدي النماذج تحت اتفاقيات عدم الاحتفاظ بالبيانات، لا منع رفعه. فالفهرسة ترفع مقاطع لحساب التضمينات، والنص الصريح ينتهي بانتهاء الطلب، غير أن التضمينات والبيانات الوصفية قد تبقى في قاعدة البيانات.

كل الطلبات تمرّ عبر خادم Cursor الخلفي، حتى ما يستخدم مفتاح API الخاص بك، لأن بناء المطالبة النهائي يتم هناك. ومع تعطيله يتّسع ما قد يُخزَّن ليشمل المطالبات وإجراءات المحرّر ومقتطفات الكود. والاستثناء الوحيد الذي يتطلب تخزين الكود هو الوكلاء السحابيون، على نسخ مشفّرة تُحذف بعد انتهائهم.

وعلى مستوى الفريق يمكن فرضه بحيث لا يستطيع الأعضاء تعطيله؛ فافعل ذلك قبل أول فهرسة لا بعدها.

ما يكسر التجربة بعد أسبوع

أول ما يصطدم به المنتقلون سجل الإضافات، فهي لا تنتقل كلها: Cursor يستخدم Open VSX لا سوق مايكروسوفت، وإضافات مايكروسوفت المملوكة مثل Pylance وRemote-SSH لم تعد تعمل في المشتقات لأن شروط الترخيص تحصرها بمنتجاتها، فردّت Anysphere ببدائل باسمها مثل Cursor Pyright. فإن كان عملك C# أو ‎.NET أو Remote-SSH، فهذه أول نقطة تقييم.

والثانية أخطر لأنها صامتة: بلاغات مستخدمين متكررة على المنتدى الرسمي تفيد بأن الوكيل يطبّق التعديل في مخزن المحرّر دون كتابته على القرص، فتختلف حالة الملف عمّا يُبنى. والوقاية مباشرة: أودِع في Git قبل التشغيلات الكبيرة، وتحقّق بـgit diff لا بما يعرضه المحرّر.

أما الاعتماد المفرط فأوضح دليل عليه يخصّ Cursor نفسه: في تجربة METR المعشّاة (يوليو 2025) كانت الأداة الأساسية Cursor Pro، وقاست تباطؤاً 19% عبر العينة كلها بينما قدّر المشاركون أنهم تسارعوا، وكان صاحب الخبرة الأطول بـCursor وحده من تسارع فعلاً. لكن METR عدّلت التصميم في فبراير 2026 لتحيّز انتقاء ووصفت جولتها الثانية بأنها دليل ضعيف جداً، فالرقم ليس نهائياً؛ تفصيله في دليل البرمجة بوكلاء الذكاء الاصطناعي. ويبقى أن منحنى تعلّم Cursor يُقاس بعشرات الساعات.

العربية داخل المحرّر: ما ينكسر وكيف تلتف حوله

لا واجهة عربية في Cursor ولا دعم أصيل للكتابة من اليمين إلى اليسار. طلبات الميزة مفتوحة على المنتدى الرسمي منذ يونيو 2026: النموذج يولّد نصاً عربياً جيداً جداً، بينما تُعرض المحادثات والخطط من اليسار إلى اليمين، وتنكسر الواجهة مع النص المختلط. ثمة إضافة مجتمعية تضيف دعم RTL للمحادثة، لكن الأثر الأهم أن خطط وضع Plan تُحفَظ في ملفات ماركداون: فمن يكتب خططه بالعربية سيعاني قراءتها. اكتب القواعد وملفات AGENTS.md بالإنجليزية.

ولا تسعير إقليمي للمنطقة العربية. السابقة الوحيدة هي الهند: خطة Start بـ649 روبية شهرياً شاملة الضريبة أُعلنت في يوليو 2026، وتستثني Bugbot وAuto. فالقارئ العربي يدفع 20 دولاراً بالسعر العالمي ببطاقة دولية عبر Stripe.

ترتيب أول ساعة قبل أن تسلّم الوكيل مشروعك

1. نزّل Cursor واستورد إعدادات VS Code بنقرة.
2. إن كنت تعتمد على إضافة مملوكة لمايكروسوفت، توقّف هنا وابقَ على VS Code.
3. فعّل وضع الخصوصية قبل أول فهرسة، وافرضه على الفريق إن كان كود شركة.
4. اكتب .cursorignore للأسرار و.cursorindexingignore للملفات المولَّدة.
5. أنشئ قاعدة .mdc واحدة محدودة بـglobs، لا قاعدة عملاقة تُطبَّق دائماً.
6. أودِع في Git قبل أول تشغيل للوكيل.
7. خطّط بـPlan ثم نفّذ بـAgent، وابدأ محادثة جديدة لكل مهمة.

ثم راقب لوحة الاستهلاك أسبوعياً في شهرك الأول. الرقم يحسم قرارك:

حالتك بعد الشهر الأول	الإجراء
نفدت الحصة بعد اليوم العشرين	ابقَ على Pro وفعّل الاستهلاك عند الطلب
نفدت قبل نهاية الأسبوع الثاني	لا ترقِّ بعد؛ راجع طول محادثاتك وعدد خوادم MCP
نفدت مبكراً وأنت تشغّل وكلاء متوازين فعلاً	Pro+ هي الترقية الصحيحة
كود شركة ولا تملك فرض وضع الخصوصية	Teams لا Pro، مهما قلّ عدد المقاعد

وإن بقيت المقارنة مع كلود كود معلّقة، فالأرقام في المقارنة التفصيلية بين كلود كود وCursor. وحكمنا: Cursor يستحق العشرين دولاراً لمن يشغّل وكلاء فعلاً، لا لمن يريد إكمالاً أذكى.