دليل Cline للمبتدئين

برنامج تعليمي لـ Cline للمبتدئين: التثبيت، أول مهمة، Plan/Act، القواعد وMCP

برنامج تعليمي خطوة بخطوة لـ Cline مع 15 لقطة شاشة مُتحقق منها: ثبّت إضافة VS Code، وأنجز تطبيقًا حقيقيًا بنموذج مجاني، ثم أتقن وضعَي Plan وAct والقواعد وخوادم MCP.

الخلاصة السريعة

  • Cline وكيل برمجة بالذكاء الاصطناعي مجاني ومفتوح المصدر يعمل داخل VS Code: ثبّته من متجر الإضافات، وسجّل الدخول عبر Google أو GitHub، وابدأ دون مفتاح API.
  • يعتمد خيار Absolutely Free على نماذج مستضافة مثل DeepSeek V4 Flash (سياق مليون) وGLM-5.3-Flash؛ هذا المسار يُنجز تطبيق حاسبة BMI يعمل فعليًا في 15 خطوة.
  • وضع Plan يرسم الخطة بنموذج استدلال، ووضع Act يكتب البرنامج بنموذج سريع — كل تحليل Plan في العرض التجريبي كلّف 0.0145 دولار فقط.
  • طوّر إعدادك بمفتاح Gemini الخاص بك، وقواعد Global وWorkspace، وخوادم MCP مثل GitHub وContext7 — وهي الركائز الثلاث للإعداد الأمثل لـ Cline.

I Found 2 Ways to Use Cline for FREE (Best Free AI Coding Agent)

فيديو الشرح:HMA WebCode5:26

شاهده على YouTube

Ideal Setup for Cline

مصدر الحقائق:Cline3:47

شاهده على YouTube

لقطات الشرح مأخوذة من عرض الإعداد المجاني لقناة HMA WebCode، ولقطات إعدادات Plan/Act والقواعد وسوق MCP مأخوذة من مقاطع قناة Cline الرسمية، وهي أيضًا مصدر الحقائق بشأن سلوك الأوضاع ونطاق القواعد وإعداد الركائز الثلاث.

لقطات الشاشة ملك للقنوات المعنية وتُستخدم مع نسبة المصدر وروابط عميقة للطوابع الزمنية؛ وجميع أوصاف الخطوات من كتابتنا الخاصة.

جولة Cline في 15 خطوة

ثبّت Cline وفعّل الخطة المجانية

  1. 1

    ثبّت إضافة Cline في VS Code

    افتح عرض الإضافات في VS Code، وابحث عن Cline، ثم اضغط Install على بطاقة وكيل البرمجة المستقل المنشورة من Cline Bot. بعد انتهاء التثبيت يظهر أيقونة روبوت Cline في شريط النشاط؛ اضغط عليها لفتح لوحة الوكيل بجانب المحرر.

    The VS Code Extensions Marketplace search for Cline showing the Autonomous coding agent right in your IDE listing with its blue Install button
    بطاقة Cline في متجر إضافات VS Code، جاهزة للتثبيت.شاهد عند 0:24
  2. 2

    اختر الطريقة التي تريد استخدام Cline بها

    عند فتح اللوحة لأول مرة يسألك Cline كيف تريد استخدامه ويعرض أربعة مسارات: Absolutely Free (نماذج مجانية مستضافة)، وClinePlans (اشتراك مدفوع للنماذج مفتوحة الأوزان)، وFrontier Model (دفع حسب الاستخدام عبر فوترة Cline)، وBring my own API key (مفتاحك الخاص). على المبتدئين البدء بـ Absolutely Free — دون مفتاح API أو بطاقة.

    Cline's first-run screen asking How will you use Cline with the four setup options Absolutely Free, ClinePlans, Frontier Model and Bring my own API key
    شاشة التشغيل الأولى لـ Cline بخيارات الإعداد الأربعة.شاهد عند 0:34
  3. 3

    سجّل الدخول وادخل الخطة المجانية

    اختر Absolutely Free ثم اضغط Log in to Cline وسجّل الدخول بحساب Google أو GitHub — يستغرق نحو عشر ثوانٍ ولا يطلب وسيلة دفع. ستصل إلى شاشة المزوّد مع اختيار Cline Usage-Billing، وهو ما يوفّر النماذج المجانية.

    Cline settings panel after signing in, with the API Provider set to Cline Usage-Billing and a blue Sign up with Cline button above the model list
    بعد تسجيل الدخول يعرض Cline مزوّد Usage-Billing وتبويبات النماذج.شاهد عند 1:46
  4. 4

    اختر نموذجًا مجانيًا ودرجة الاستدلال

    افتح محدد النماذج وانتقل إلى تبويب Free: نماذج DeepSeek V4 Flash (سياق مليون توكن) وGLM-5.3-Flash وLongCat 2.0 وLaguna S 2.1 كلها تحمل علامة FREE. اختر DeepSeek V4 Flash للعمل السريع عبر ملفات متعددة واترك Reasoning Effort على Medium — أسرع مع Low وأعمق تفكيرًا مع High لكنه يستهلك توكنات أكثر.

    Cline settings showing the deepseek/deepseek-v4-flash model ID chosen from the Free tab with the Reasoning Effort dropdown set to Medium
    معرّف النموذج deepseek/deepseek-v4-flash محدد وReasoning Effort على Medium.شاهد عند 2:12

شغّل أول مهمة من البداية للنهاية

  1. 5

    افتح صندوق مهمة فارغًا

    أنشئ مجلد مشروع في VS Code أو افتحه، ثم اضغط أيقونة Cline. تستقبلك اللوحة بسؤال بسيط، وهذا الحقل هو نقطة انطلاق كل مهمة. يقع صف Auto-approve ومبدّل Plan/Act في أسفل اللوحة.

    An empty Cline task panel in VS Code with the Type your task here input and the Plan and Act mode toggle in the bottom corner
    لوحة مهام Cline جاهزة لأول أمر، مع Plan/Act في الزاوية.شاهد عند 2:36
  2. 6

    أرسل أول مهمة لك

    اكتب هدفًا محددًا في صندوق المهمة، مثلًا: أنشئ تطبيق ويب عصريًا لحاسبة BMI بلغة HTML وCSS وJavaScript، يدخل المستخدم فيه الطول بالسنتيمتر والوزن بالكيلوغرام ويعرض التطبيق مؤشر كتلة الجسم مع تصنيف. المتطلبات المحددة للمدخلات والمخرجات والتصميم تعطي نتائج أفضل بكثير من سطر عام واحد.

    A first Cline task asking for a modern BMI calculator web app using HTML, CSS and JavaScript typed into the chat input
    أمر حاسبة BMI مكتوبًا في صندوق مهام Cline.شاهد عند 2:58
  3. 7

    وافق على كل إجراء — أو فعّل الموافقة التلقائية

    يعمل Cline خطوة بخطوة: يريد تنفيذ أمر أو إنشاء ملف أو تعديل آخر، ويعرض فرقًا (diff) لكل تغيير قبل تطبيقه. وافق على إجراء واحد، أو فعّل Auto-approve للقراءة والتحرير والأوامر ليمضي في قائمته وحده — والنقاط checkpoints تجعل كل خطوة قابلة للتراجع على أي حال.

    Cline asking for approval to create index.html for the BMI calculator while the generated CSS appears as a green diff in the editor
    Cline يطلب الموافقة على إنشاء index.html مع إظهار فرق CSS.شاهد عند 3:06
  4. 8

    افتح التطبيق المكتمل

    خلال دقائق تكتمل المهمة مع ملخص وسجل BMI Calculation Checkpoint. افتح ملف index.html الناتج عبر Live Server أو أي خادم ثابت وجرّبه: 175 سنتيمترًا و70 كيلوغرامًا يعطيان مؤشر كتلة 22.9 — طبيعي. تطبيق كامل يعمل دون أن تكتب سطرًا واحدًا بنفسك.

    The finished BMI Calculator web app running in a browser next to VS Code with Cline's completion summary and BMI Calculation Checkpoint in the panel
    حاسبة BMI الجاهزة في المتصفح بجانب ملخص Cline في VS Code.شاهد عند 3:17

وضعا Plan وAct دون إهدار التوكنات

  1. 9

    تعرّف على وضعَي Plan وAct

    المبدّل في أسفل اللوحة يتنقل بين Plan وAct. في وضع Plan لا يفعل Cline سوى الاستقصاء: يقرأ الملفات ويطرح الأسئلة ويقترح خطة تنفيذ. وفي الإعدادات تبويبان بالاسمين نفسهما لتعيين نموذج مختلف لكل وضع — نموذج استدلال قوي لـ Plan ونموذج برمجة سريع لـ Act.

    Cline's settings dialog showing the Plan Mode and Act Mode tabs above the API Provider and Model dropdowns used to split reasoning and coding models
    إعدادات Cline بتبويبَي Plan Mode وAct Mode لتعيين نموذج لكل وضع.شاهد عند 0:48
  2. 10

    دع وضع Plan يفكر قبل أن يكتب

    نماذج الاستدلال تلمع في وضع Plan لأن تفكيك المهمة تحليل لا كتابة. ولأنه لم يُكتب شيء بعد، فإن التحقيق الكامل رخيص — تحليل مخالفات DRY في العرض التجريبي كلّف 0.0145 دولارًا فقط. أجب عن أسئلة Cline أثناء التخطيط؛ كل تصحيح هنا يوفر إعادة كتابة لاحقًا.

    A Cline Plan mode analysis listing DRY violations with the task's token count, context window and 0.0145 dollars API cost shown on the task card
    بطاقة مهمة في وضع Plan مع التحليل وعدّادات التوكنات وتكلفة API بقيمة 0.0145 دولار.شاهد عند 1:10
  3. 11

    بدّل إلى وضع Act لكتابة الكود

    حين تعجبك الخطة بدّل إلى Act — تُثبَّت الخطة ويبدأ Cline بتحرير الملفات. نماذج البرمجة أرخص وأسرع في هذه المرحلة، ومن هنا يأتي توفير التوكنات بفصل الوضعين. وفي شاشة استئناف المهمة يظهر الاختصار: Win+Shift+A يبدّل بين الوضعين.

    Cline settings with the Act Mode tab selected and the claude-3-7-sonnet model chosen for code generation, with extended thinking available below
    الإعدادات وتبويب Act Mode محدد ونموذج برمجة جاهز للتنفيذ.شاهد عند 1:28

مفتاحك الخاص والقواعد وسوق MCP

  1. 12

    أو استخدم مفتاحك المجاني

    تفضّل حصتك الخاصة على المجمّع المجاني المشترك؟ اختر Bring my own API key ثم Google Gemini، واضغط Get API key في Google AI Studio — الخطة المجانية تحتاج حساب Google فقط. الصق المفتاح في حقل API key في Cline، واختر نموذج Gemini، واحفظ، وستعمل على حصتك الخاصة.

    Google AI Studio's Create API key dialog where a free Gemini key is generated for Cline's Google Gemini provider field
    نافذة Create API key في Google AI Studio التي تُنشئ مفتاح Gemini المجاني.شاهد عند 3:54
  2. 13

    علّم Cline معاييرك عبر القواعد

    القواعد تعليمات دائمة يقرأها Cline في كل مهمة. افتح تبويب Rules في إعدادات اللوحة: قواعد Global تنطبق على كل مشاريع جهازك، بينما تعيش قواعد Workspace في المستودع الحالي كملفات ‎.clinerules يمكنك إلحاقها ومشاركتها. وهي مناسبة لمبادئ البرمجة وممارسات الأمن وإرشادات التوثيق والأسلوب.

    The Rules tab in the Cline panel settings with the Global Rules and Workspace Rules sections for adding persistent guidance files
    تبويب Rules في إعدادات Cline بقسمَي Global Rules وWorkspace Rules.شاهد عند 1:06
  3. 14

    اكتب قواعد يستطيع النموذج اتباعها فعلًا

    القواعد الغامضة تأتي بنتائج عكسية — «حسّن الكود عند الإمكان» تمنح Cline مساحة لتجاهلك. اكتب محفزات قابلة للقياس بدلًا منها: حسّن الكود إذا استغرقت اختبارات الوحدة أكثر من 100 مللي ثانية، والتزم بمبادئ SOLID عند استخدام الأصناف، وأضف تعليقات داخلية عندما يضع الكود افتراضات. عامل القواعد كوثيقة حية وأزل التعارضات.

    A Cline rule file open in VS Code with three measurable rules such as optimizing code when unit tests take longer than 100 milliseconds
    ملف قواعد فيه ثلاث قواعد ملموسة قابلة للقياس يطبقها Cline في كل مهمة.شاهد عند 1:45
  4. 15

    وسّع Cline بخوادم MCP

    أيقونة MCP Marketplace في اللوحة تفتح خوادم بنقرة واحدة تضيف قدرات جديدة إلى Cline: GitHub لعمليات المستودعات، وContext7 لوثائق المكتبات المحدّثة، وPerplexity وSequential Thinking للبحث والتخطيط. ثبّت خادمًا ووافق على أدواته، وسيتمكن Cline من استدعائه في منتصف المهمة — الركيزة الثالثة للإعداد الأمثل.

    Cline's MCP Servers marketplace with the Marketplace, Remote Servers and Installed tabs and the GitHub MCP server card ready to install
    سوق MCP Servers في Cline مع بطاقة خادم GitHub وزر Install.شاهد عند 2:44

أسئلة Cline الشائعة للمبتدئين

تابع الاستكشاف