تكامل Cline

استخدم API QCode.cc مع إضافة Cline في VS Code

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-09-18 · 📄 وفق الوثائق الرسمية (إضافة VS Code 4.1.19، صدرت في 2026-09-17؛ Cline Desktop أدناه)

نظرة سريعة¶

Cline إضافة شائعة للبرمجة بالذكاء الاصطناعي في VS Code (ملايين عمليات التثبيت) تدعم أي نموذج ذكاء اصطناعي ونقاط نهاية API مخصصة. وتأتي مزوّدة بوضعي Plan / Act المزدوجين، ومعاينات فروقات تعديل الملفات، وتنفيذ في الطرفية، واستدعاءات أدوات MCP. وباقتران Cline مع API QCode.cc، يمكنك استخدام Claude وGPT ونماذج العائلة الصينية في VS Code بتكلفة منخفضة.

لماذا Cline؟¶

• دون هامش ربح: لا هامش ربح على تكاليف النماذج — أنت تدفع رسوم API QCode.cc فقط

• تبديل مرن بين النماذج: بدّل بين claude-sonnet-5 وclaude-opus-5 وgpt-5.6-terra وغيرها في الواجهة نفسها (لا يزال 4.x يعمل)

• تكامل عميق مع VS Code: لوحة شريط جانبي، إجراءات كود مضمّنة، معاينة فروقات تعديل الملفات، موافقة تلقائية

• وضعا Plan / Act المزدوجان: خطّط أولًا ثم نفّذ — يبقي التغييرات المعقدة تحت السيطرة

• مفتوح المصدر بالكامل: كود شفاف ومجتمع نشط

• دعم MCP: صِل الأدوات الخارجية (قواعد البيانات، المتصفحات، الوثائق) عبر Model Context Protocol

التثبيت والإعداد¶

الخطوة 1: تثبيت إضافة Cline¶

في VS Code:

1. افتح لوحة الإضافات (Ctrl+Shift+X / Cmd+Shift+X)

2. ابحث عن "Cline"

3. انقر على Install

4. بعد التثبيت، تظهر أيقونة Cline في شريط الأنشطة الأيسر

يقدّم Cline أيضًا نسخة سطر أوامر (Cline CLI) تعيد استخدام الإعداد نفسه في الطرفية؛ يركّز هذا الدليل على إضافة VS Code.

الخطوة 2: إعداد API QCode.cc¶

مفتاح API واحد من QCode.cc (يبدأ بـ cr_) متوافق مع بروتوكول Anthropic وبروتوكول OpenAI معًا. يوفّر Cline طريقتين للاتصال — اختر إحداهما:

الخيار A: متوافق مع Anthropic (موصى به لنماذج Claude)¶

في إعدادات Cline (أيقونة الترس)، افتح القائمة المنسدلة API Provider واختر "Anthropic"، ثم املأ:

يضيف SDK تلقائيًا /v1/messages بعد Base URL، لذا اضبط Base URL على /api — لا تكتب /api/v1/messages، ولا تُضمّن شرطة مائلة لاحقة.

الخيار B: متوافق مع OpenAI¶

في القائمة المنسدلة API Provider، اختر "OpenAI Compatible"، ثم املأ:

🔴 لا يمكن لوضع التوافق مع OpenAI استخدام Claude. نقطة نهاية OpenAI لدى QCode تخدم GPT والعائلات الصينية الأربع فقط؛ ويعيد معرّف claude-* القيمة model_not_available_on_endpoint. أما Claude، فارجع إلى الخيار A (Anthropic) مع Base URL https://api.qcode.cc/api. راجع نقاط النهاية ومسارات API.

الخطوة 3: التحقق من الاتصال¶

اكتب رسالة بسيطة (مثل «مرحبًا») في مربع محادثة Cline. إذا تلقيت ردًا، فقد نجح الإعداد.

يمكنك أيضًا التحقق بنفسك باستخدام curl في الطرفية (تعني 401 أن المسار صحيح وأن المصادقة وحدها ناقصة):

# Anthropic protocol
curl -i https://api.qcode.cc/api/v1/messages \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

# OpenAI protocol (note: this endpoint only accepts GPT or China-family ids)
curl -i https://api.qcode.cc/openai/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"hi"}]}'

نقاط النهاية البديلة¶

يعمل المفتاح نفسه عبر 3 نطاقات وصول يمكنك التبديل بينها. إذا كان النطاق الأساسي غير مستقر، فاستبدل api في Base URL بالنطاق الفرعي المقابل أدناه:

ينبغي لمستخدمي البر الرئيسي للصين تفضيل asia.qcode.cc، فهو عادةً نقطة النهاية الأقرب. راجع نقاط النهاية وتنسيقات API للتفاصيل.

Cline Desktop¶

في 2026-09-14 أطلقت Cline تطبيق سطح مكتب (الإعلان الرسمي: «أحضر مفتاح API الخاص بك واتصل اتصالًا أصليًا بأي مزوّد — Anthropic أو OpenAI أو Gemini أو نماذج مفتوحة الأوزان أو نقطة نهاية محلية»؛ ولا تحمل صفحة المنتج تاريخًا). يتبع تطبيق سطح المكتب منطق المزوّد نفسه كما في الإضافة (اختيار مزوّد API + Base URL مخصّص)؛ أسماء الحقول الخاصة بتطبيق سطح المكتب غير موثّقة بشكل منفصل لدى Cline — اعتمد على ما يعرضه التطبيق. التنزيلات ودعم المنصات: cline.bot/desktop.

الوضعان المزدوجان: التخطيط / التنفيذ¶

توفّر Cline مفتاح تبديل التخطيط / التنفيذ أسفل مربع الدردشة:

• التخطيط: تقرأ Cline الشيفرة وتطرح أسئلة وتقترح خطة تنفيذ، لكنها لا تعدّل الملفات. مفيد للتوافق على المتطلبات قبل أي تغيير.

• التنفيذ: تنشئ Cline الملفات أو تعدّلها فعليًا، وتشغّل الأوامر، وتستدعي الأدوات. يُعرض كل تغيير كفروق لتوافق عليها أو توافق تلقائيًا.

سير عمل نمطي: استخدم وضع التخطيط أولًا لجعل النموذج يرسم نهجًا ويؤكده، ثم بدّل إلى وضع التنفيذ لتنفيذه خطوة بخطوة. للمهام المعقدة، خطّط باستخدام claude-opus-5، ثم نفّذ باستخدام claude-sonnet-5. لا يزال 4.x متاحًا للمقارنة.

نصائح الاستخدام¶

1. دليل اختيار النموذج¶

راجع الفوترة للاطلاع على الأسعار الكاملة.

2. إعداد أدوات MCP¶

تدعم Cline بروتوكول سياق النموذج (MCP)، ما يتيح للنموذج استدعاء أدوات خارجية (استعلامات قواعد البيانات، والمتصفحات، والبحث في المستندات، إلخ). أضف خادمًا في لوحة خوادم MCP في Cline:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

خوادم MCP منفصلة عن النموذج الذي تستخدمه — تعمل استدعاءات الأدوات سواء اتصلت بـ QCode.cc عبر بروتوكول Anthropic أو OpenAI. لخطوات تثبيت كل خادم ومعاملاته، راجع الوثائق الرسمية للأداة.

3. تعليمات مخصصة على مستوى المشروع (.clinerules)¶

أنشئ ملف .clinerules في جذر المشروع لحقن سياق ثابت لهذا المستودع — نمط الشيفرة، اصطلاحات المكدس التقني، بنية الدليل. تدرج Cline هذه القواعد في كل محادثة، لذا لا تحتاج إلى لصقها مرارًا:

# .clinerules

- Use TypeScript everywhere, strict mode
- Prefer reusing helpers under src/lib
- Run `pnpm test` before committing

لحقول ملف القواعد واستخدامه المتقدم، راجع الوثائق الرسمية لـ Cline.

4. إدخال الصور (الرؤية)¶

claude-opus-5 وclaude-sonnet-5 (و4.8 / 4.6 اللذان لا يزالان معروضين للبيع) وGPT-5.x جميعها تدعم إدخال الصور. اسحب لقطة شاشة لواجهة المستخدم، أو لقطة شاشة لخطأ، أو مخطط بنية إلى مربع دردشة Cline مباشرةً، ودع النموذج يكتب الشيفرة انطلاقًا منها أو يصلح الأخطاء فيها.

ملاحظة: يتعلق هذا بجعل النموذج يقرأ الصور. أما توليد الصور، فاستخدم توليد الصور عبر gpt-image-2 باسم النموذج gpt-image-2.

5. الموافقة التلقائية والتحكم في التكلفة¶

• في الإعدادات يمكنك تمكين الموافقة التلقائية بشكل منفصل لكل من «قراءة الملفات» و«كتابة الملفات» و«تنفيذ الأوامر» لتقليل المقاطعات؛ أبقِ التأكيد اليدوي للعمليات عالية المخاطر.

• تعرض Cline استخدام token والتكلفة التقديرية لكل طلب، ما يسهّل تتبع الإنفاق. للمهام المعقدة، ضيّق النطاق باستخدام وضع التخطيط أولًا لتجنب التفاعل غير الضروري ذهابًا وإيابًا.

• لقواعد الشيفرة الكبيرة، استخدم @ (لذكر ملف/مجلد/URL) لتزويد النموذج بسياق دقيق بدلًا من ترك النموذج يمسح المشروع بأكمله — يوفر ذلك tokens ويحافظ على التركيز.

6. الاقتران مع Claude Code CLI¶

لكل من Cline وClaude Code CLI نقاط قوة — استخدمهما معًا:

7. الحصة المشتركة¶

تستخدم Cline وClaude Code CLI مفتاح API نفسه الخاص بـ QCode.cc وتتشاركان حصة الخطة — لا حاجة إلى طلب مفاتيح منفصلة لكل أداة.

الأسئلة الشائعة¶

فشل الاتصال / 401 / 404؟¶

1. تأكد من أن Base URL لا ينتهي بـ /

2. في وضع Anthropic، عيّن Base URL على /api (يضيف SDK المسار /v1/messages) — لا تكتب المسار الكامل يدويًا

3. في وضع OpenAI، عيّن Base URL على /openai/v1

4. تحقق من أن مفتاح API يبدأ بـ cr_ وأنه نُسخ كاملًا

5. جرّب التبديل إلى نقطة نهاية بديلة (مثل asia.qcode.cc)

6. تأكد من أن شبكتك تستطيع الوصول إلى خدمات QCode.cc

قائمة النماذج فارغة؟¶

في الوضع المتوافق مع OpenAI، اكتب اسم النموذج يدويًا في حقل معرّف النموذج (مثل glm-5.3) — لست بحاجة إلى الاختيار من قائمة.

وضع Plan لا يغيّر الملفات؟¶

هذا متوقع. وضع Plan يخطط فقط؛ ولا تُكتب التغييرات إلا بعد التبديل إلى وضع Act.

ظهور 401 رغم أن الإعدادات تبدو صحيحة؟¶

يعني 401 عادةً أن المسار صحيح وأن المصادقة وحدها فشلت. أعد التحقق من أن مفتاح API كامل، وأنك اخترت نوع المزوّد الصحيح (Anthropic مقابل OpenAI Compatible) مع Base URL المطابق.

Cline CLI 3.0.69 (2026-10-07)¶

تحمل ملاحظات إصدار GitHub الخاصة بـ Cline CLI v3.0.69، المنشورة في 2026-10-07، بندًا واحدًا يمس الإعدادات أعلاه. وبكلمات الملاحظات نفسها:

لم يعد Claude عبر Base URL مخصص لـ Anthropic (Azure AI Foundry، بوابات الشركات) يفشل بخطأ 400

المصدر: github.com/cline/cline/releases/tag/cli-v3.0.69. لا تذكر الملاحظات نطاق الإصدارات المتأثرة ولا تفسيرًا يتجاوز تلك الجملة؛ وتقول الصياغة نفسها إن الفشل زال في هذا الإصدار، ما يعني أن طلب Claude المرسل عبر Base URL مخصص لـ Anthropic كان يعيد خطأ 400 في إصدارات Cline CLI الأقدم. لا تذكر الملاحظات QCode، ولم يُتحقق هنا من أي شيء مقابل نقطة نهاية QCode. إذا أعاد Cline CLI الخطأ 400 لـ Claude عبر Base URL مخصص، فتحقق من إصدار CLI لديك أولًا.

الخطوات التالية¶

• راجع نقاط النهاية وتنسيقات API للاطلاع على جميع البروتوكولات والنطاقات

• راجع تكامل Aider للاطلاع على أداة مفتوحة المصدر أخرى متوافقة مع QCode.cc

• راجع تكامل VS Code لاستخدام إضافة Claude Code الرسمية

• راجع نماذج عائلة الصين لاستدعاء GLM / Kimi / DeepSeek / Qwen بالحقول نفسها المتوافقة مع OpenAI

• راجع الفوترة للاطلاع على تفاصيل الأسعار

أليس لديك مفتاح API بعد؟ راجع خطط QCode.cc وأسعارها →

المؤسسات ←