Deepseek ArtifactsDeepseek Artifacts
Cline CLI · 12 خطوة

دليل Cline CLI: التثبيت وcline auth ووضعا plan/act والوكلاء الفرعيون

تضع أداة Cline CLI المستقلة الجديدة الوكيل نفسه بوضعي plan/act في طرفيتك. يغطي هذا الدليل التثبيت وإعداد المزوّد عبر cline auth وأعلام المهام وتشغيل وكلاء VS Code الفرعيين — مع إطار من الفيديو عند كل خطوة.

ابدأ الجولةإلى الأسئلة الشائعة

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

  • ثبّتها مرة واحدة بـ npm install -g cline، ثم اكتب cline في أي مجلد مشروع لبدء جلسة تفاعلية.
  • تبدأ الجلسات التفاعلية في plan mode؛ اكتب /act حين تريد السماح بالتعديلات و/plan للعودة، أو مرّر --mode في المهام المفردة.
  • cline auth هو لوحة التحكم بالحسابات والنماذج: حساب Cline أو Cline أو مزوّد بمفتاحك الخاص مثل OpenRouter — أعد تشغيله متى شئت.
  • الوكلاء الفرعيون في إضافة VS Code: ثبّت CLI ثم اضغط Enable Subagents في لوحة Cline، فتنطلق نسخ headless في الطرفية للبحث المتوازي.

Cline CLI & Sub Agents: Cline is back with a new CLI Agent, but is it good?

القناة: AICodeKing8:03

مشاهدة على YouTube

Introducing Cline CLI 2.0

القناة: Cline1:42

مشاهدة على YouTube

Cline CLI — official documentation

التوثيق: docs.cline.bot

مشاهدة على YouTube

اللقطات مأخوذة من عرض الطرفية وVS Code النظيف في مراجعة AICodeKing — لا يظهر أي وجه في الفيديو، ولم يُستثنَ إلا شاشة الختام. تمت مطابقة الأوامر والأعلام مع التوثيق الرسمي لـ Cline وإعلان الإطلاق.

الإطارات ملك لأصحابها، ونُسبت هنا بروابط تؤدي إلى اللحظة المحددة؛ أما النص فهو من كتابتنا.

إعداد Cline CLI خطوة بخطوة

التعرّف على CLI وتثبيتها وربط مزوّد

  1. 1

    اعرف ما هي CLI وما ليست عليه

    تضع توثيق Cline الأداة بوصفها رفيقة لبيئة التطوير لا بديلًا عنها: نواة الوكيل نفسها، مصممة لإدارة وكلاء متعددين يعملون بالتوازي، مع قابلية برمجة كاملة وواجهة محادثة مريحة. وضعا plan وact ونقاط الحفظ وتنفيذ الأوامر في الطرفية والتشغيل اللامتفاعلي كلها متاحة — فكل ما تعرفه من إضافة VS Code ينتقل مباشرة.

    Cline docs page titled What's Special About Cline CLI describing a companion to your IDE that manages many agents in parallel with plan and act modes, checkpoints and headless use
    صفحة What's Special About Cline CLI في التوثيق الرسمي.المشاهدة عند 1:18
  2. 2

    انظر لأي غرض بُنيت

    يجمع منشور الإطلاق أفكارًا من مجتمعهم على Discord: شخصيات ألعاب تكتب ذكرياتها في ملفات، وتطبيق جوّال للتحكم عن بُعد، وبوت Discord مدفوع بـ Cline، وCline داخل نصوص shell، وCline في GitHub issues يفرز تقارير الأخطاء تلقائيًا. لن تحتاج كل هذا للبداية — لكنه يفسّر لماذا وُلدت الأداة لامتفاعلية وقابلة للبرمجة.

    Cline blog list of things to build with the CLI, including a Discord bot that answers common questions and GitHub issues automatically triaging bug reports
    أفكار لاستخدام CLI مأخوذة مباشرة من منشور الإطلاق.المشاهدة عند 1:48
  3. 3

    ثبّت الأداة

    نفّذ npm install -g cline في أي طرفية (يلزم Node.js). يظهر الأمر نفسه في لافتة Cline for CLI is here داخل VS Code مع زر نسخ. وبعد انتهاء npm يصبح أمر cline متاحًا في كل مكان.

    Cline blog post announcing the open-source CLI Preview with the npm install -g cline command shown in a dark code block
    أمر التثبيت الرسمي في إعلان CLI Preview.المشاهدة عند 4:30
  4. 4

    شغّلها في مجلد مشروع

    انتقل بمجلد المشروع ثم اكتب cline. تعرض صندوقة الترحيب إصدار المعاينة والمزوّد والنموذج النشطين وشارة plan mode؛ وتنتظر Start a new Cline task في الأسفل أول تعليمة منك. وشريط الأسفل خريطة اختصاراتك: alt+enter أو ctrl+j لسطر جديد، وctrl+e يفتح المحرر للعبارات الطويلة، وenter للإرسال.

    Cline CLI preview v1.0.1 welcome box in a terminal showing the active model, a plan mode badge and the Start a new Cline task prompt
    أول تشغيل: صندوقة الترحيب وحقل المهمة الجديدة.المشاهدة عند 3:36
  5. 5

    اربط مزوّدًا عبر cline auth

    التثبيت الجديد لا يعرف شيئًا عن الحسابات أو النماذج. نفّذ cline auth فيظهر معالج التفويض: المصادقة بحساب Cline، أو اختيار المزوّد النشط (Cline أو مزوّدك الخاص)، أو إعداد مزوّد API، أو الخروج. في العرض النموذج النشط هو anthropic/claude-sonnet-4.5 عبر OpenRouter. غيّرت رأيك لاحقًا؟ الأمر نفسه: cline auth.

    Cline CLI authorization wizard after running cline auth, listing Authenticate with Cline account, Select active provider and Configure API provider options
    معالج cline auth بخيارات الحساب والمزوّد.المشاهدة عند 3:49

plan وact وأعلام التشغيل اللامتفاعلي

  1. 6

    توقّع plan mode أولًا

    أرسل تحية فيرد Cline بخطة بدلًا من لمس الملفات — فالجلسات التفاعلية تبدأ في plan mode المخصص لجمع المعلومات والتصميم. تنتهي الإجابة بعدد الرموز والتكلفة، ثم يظهر في حقل الإدخال [plan mode] Cline is ready for your message...

    Cline CLI replying to a greeting in plan mode with a Cline has a plan message, a token and cost readout, and the /plan or /act to switch modes hint
    أول إجابة في plan mode مع التكلفة وتلميحات الوضع.المشاهدة عند 4:24
  2. 7

    انتقل إلى act بـ /act

    اكتب /act فتتحول الجلسة إلى act mode حيث يمكن لـ Cline تعديل الملفات وتنفيذ الأوامر؛ و/plan يعيدك للخلف. وفي المهام المفردة يمكنك تحديد وضع البداية بالعلم -m/--mode، كما تسرد المرجعية الحالية للأداة الخيار -p/--plan للمهام التي تخطط أولًا.

    Terminal cursor pointing at the /plan or /act to switch modes hint below the [plan mode] Cline is ready for your message input in the Cline CLI
    تلميح /plan or /act يقع أسفل حقل الإدخال مباشرة.المشاهدة عند 4:16
  3. 8

    احفظ أعلام التشغيل اللامتفاعلي

    قسم INSTANT TASK OPTIONS في المرجعية ورقة الغش: -o (--oneshot) ينفّذ المهمة باستقلالية تامة ثم يخرج، و-y (--yolo) يعطّل كل التأكيدات التفاعلية ويُكمل تلقائيًا، و-s يتجاوز إعدادًا لتلك المهمة فقط، و-m يحدد وضع البداية. تغيّرت الأعلام منذ الإطلاق — المرجعية الحالية تدمج oneshot/yolo داخل --auto-approve و-p/--plan، فجرّب cline -h لترى ما يدعمه إصدارك.

    Cline CLI reference INSTANT TASK OPTIONS section documenting the -o oneshot, -s setting, -y yolo and -m mode flags for headless runs
    Instant task options: oneshot وyolo وإعدادات كل مهمة والوضع.المشاهدة عند 4:35

الوكلاء الفرعيون من إضافة VS Code

  1. 9

    حدّث الإضافة واعثر على اللافتة

    يأتي الوكلاء الفرعيون مع إضافة VS Code، وهم جديد إصدار v4.106.0. حدّث Cline وافتح اللوحة فيظهر سجل التغييرات مع لافتة Cline for CLI is here! — وفيها مقطع npm install -g cline وملاحظة بأن Cline قادرة على تشغيل أوامر cline في عمليات منفصلة لإبقاء نافذة السياق الرئيسية نظيفة.

    VS Code with the Cline panel showing the New in v4.106.0 changelog entry for the Cline CLI and the Cline for CLI is here banner with an npm install -g cline snippet
    لافتة CLI داخل لوحة Cline في VS Code.المشاهدة عند 5:25
  2. 10

    اضغط Enable Subagents

    الزر الثاني في اللافتة، Enable Subagents، يشغّل الميزة من إعدادات الميزات في الإضافة. هذه هي الخطوة التي تفشل بلا الأداة: يعمل الوكلاء الفرعيون بإطلاق نسخ headless من cline في طرفيتك، فلا بد من تنفيذ npm install -g cline أولًا.

    Cline for CLI is here panel in VS Code with the npm install -g cline snippet and the Installed and Enable Subagents buttons above the auto-approve list
    Installed وEnable Subagents يظهران جنبًا إلى جنب في اللوحة.المشاهدة عند 5:32
  3. 11

    اطلب وكيلًا فرعيًا

    أعطِ الوكيل الرئيسي مهمة يستحق فيها الاستكشاف — كما في العرض: Spin up a sub agent that tells me about the repo. ترجح Cline الطلب وتُوفِّد وكيلًا فرعيًا من تلقاء نفسها حين يكون البحث المتوازي مفيدًا؛ ويمكنك طلبه صراحة أيضًا.

    Cline VS Code panel working on the Spin up a sub agent that tells me about the repo task with Thinking output about using the Cline CLI
    الوكيل الرئيسي يخطط لإطلاق sub agent.المشاهدة عند 5:42
  4. 12

    وافق على العبارة المعلقة

    قبل تنفيذ أي شيء تعرض اللوحة Cline wants to use a subagent مع العبارة الكاملة التي سترسلها — وهي هنا تحليل مستودع من خمس نقاط يغطي الغرض وحزمة التقنيات والميزات ونموذج البيانات وأنماط التنفيذ. وافق عليها (أو اترك auto-approve تتولى الأمر) فيعمل الوكيل الفرعي لامتفاعليًا ويعود بتقرير بدلًا من ملء نافذة السياق الرئيسية.

    Cline VS Code panel showing Cline wants to use a subagent with a Pending status and the full five-point repository analysis prompt beside the Terminal panel
    عبارة الوكيل الفرعي المعلقة، نقطة بنقطة.المشاهدة عند 5:46

Cline CLI أم إضافة VS Code: أيهما ومتى

كلتا الواجهتين تشغّلان وكيل Cline نفسه بوضعي plan وact، فالاختيار يتعلق بمكان عمل الوكيل لا بقدراته.

  • 1التطوير اليومي: ابقَ في الإضافة. اللوحة والفروق ونقاط الحفظ وسياق المحرر كلها بين يديك داخل VS Code.
  • 2الأتمتة والمهام المتكررة: اللجوء إلى CLI. عبارات مفردة ونصوص shell وGitHub Actions وبوتات Discord أو Slack — التشغيل اللامتفاعلي بأعلام مثل -o و-y هو الغرض المصممة لأجله.
  • 3الجلسات المختلطة: الحالة تنتقل معك. تبدأ المهمة في الطرفية وتستمر في بيئة التطوير (والعكس)؛ الخطة التي رسمتها في طرفية الليل تصبح بعد ظهيرة من التعديلات في VS Code.
  • 4الوكلاء الفرعيون يحتاجان الاثنين: الإضافة تنسّق بينما CLI تنفّذ. زر Enable Subagents لا يعمل إلا بعد تثبيت CLI — وهذه هي الآلية كلها.

إن اخترت واحدة فقط فاختر حيث يجري عملك فعلًا؛ تثبيت CLI أمر npm واحد، وسيُتاح مفتاح الوكلاء الفرعيين على أي حال.

الوكلاء الفرعيون عمليًا: العبارات والحدود والحلول

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

  • 1لا يظهر زر Enable Subagents؟ حدّث الإضافة إلى v4.106.0 أو أحدث — الزر داخل لافتة Cline for CLI، ويجب أن تكون CLI مثبتة وإلا لن ينطلق شيء.
  • 2لا ينطلق وكيل فرعي أبدًا؟ اطلبه صراحة ("spin up a sub agent to..."). وفق التوثيق الحالي فإن الوكلاء الفرعيين باحثون للقراءة فقط: يمكنهم قراءة الملفات والبحث وتنفيذ أوامر آمنة، لكن لا يمكنهم تعديل الملفات ولا استخدام المتصفح أو MCP ولا استدعاء وكلاء فرعيين آخرين.
  • 3نفّذ — وماذا بعد؟ يعيد كل وكيل فرعي تقريرًا يشير إلى مسارات الملفات التي وجدها، وتظهر إحصاءات كل وكيل (استدعاءات الأدوات والرموز والتكلفة) في المحادثة لتراجع ما أنجزته المجموعة.
  • 4ضجير من الموافقات؟ إطلاق الوكلاء الفرعيون يتبع صلاحية الموافقة التلقائية Read project files — فعّلها فتتوقف العبارات عن الحاجز، وتبقى العبارة الكاملة ظاهرة في اللوحة.
  • 5تغيّر السلوك عن الفيديو؟ عند الإطلاق كان مفتاحًا تجريبيًا في إعدادات الميزات؛ أما التوثيق الحالي فيصف الوكلاء الفرعيين كمفعّلين افتراضيًا وقابلين للضبط من Settings → Features، مع توحيد الأعلام في --auto-approve و-p/--plan. حين تتعارض التوثيق مع مراجعة قديمة، فالتوثيق أصدق.

تعامل مع الوكلاء الفرعيين كمضخِّم للبحث لا كجيش من المبرمجين: يختصرون ساعة من قراءة الشيفرة في تقرير واحد، والكتابة تبقى للوكيل الرئيسي.

أسئلة Cline CLI الشائعة

أدلة ذات صلة لعملاء البرمجة

دليل Cline Desktopأفضل نموذج محلي لـ Cline والإعداد المحليبرنامج تعليمي لـ DeepSeek مع Clineدليل وكلاء Claude Code الفرعيينشرح OpenCodeدليل Google Antigravity CLI