# تكامل Cline

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

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (المسار A: مزوّد Anthropic) · GPT ✅ · النماذج الصينية ✅ (المسار B: OpenAI Compatible) · Gemini ❌ (لا يوجد مسار Gemini موثّق هنا) |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| أين تُعدّ | إعدادات إضافة VS Code (API Provider + "Use custom base URL")؛ تطبيق سطح المكتب يتبع المنطق نفسه |
| الوثائق الرسمية | [cline.bot](https://cline.bot) · [GitHub](https://github.com/cline/cline) |

[Cline](https://github.com/cline/cline) إضافة شائعة للبرمجة بالذكاء الاصطناعي في VS Code (ملايين عمليات التثبيت) تدعم أي نموذج ذكاء اصطناعي ونقاط نهاية API مخصصة. وتأتي مزوّدة بوضعي Plan / Act المزدوجين، ومعاينات فروقات تعديل الملفات، وتنفيذ في الطرفية، واستدعاءات أدوات MCP. وباقتران Cline مع API QCode.cc، يمكنك استخدام Claude وGPT و[نماذج العائلة الصينية](/docs/usage/cn-models) في 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"**، ثم املأ:

| الإعداد | القيمة |
|---------|-------|
| مفتاح API | مفتاح API الخاص بك من QCode.cc (يبدأ بـ `cr_`) |
| استخدام Base URL مخصص | حدّده وأدخل `https://api.qcode.cc/api` |
| النموذج | `claude-sonnet-5` (الافتراضي اليومي) أو `claude-opus-5` (المهام الصعبة). لا يزال `claude-sonnet-4-6` / `claude-opus-4-8` معروضًا للبيع |

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

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

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

| الإعداد | القيمة |
|---------|-------|
| Base URL | `https://api.qcode.cc/openai/v1` |
| مفتاح API | مفتاح API الخاص بك من QCode.cc (يبدأ بـ `cr_`) |
| معرّف النموذج | `gpt-5.6-terra` أو `gpt-6-sol` أو [معرّف من العائلة الصينية](/docs/usage/cn-models) مثل `glm-5.2`. **لن يعمل `claude-*` هنا** |

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

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

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

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

```bash
# 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 بالنطاق الفرعي المقابل أدناه:

| نقطة النهاية | Base URL لـ Anthropic | Base URL لـ OpenAI |
|----------|--------------------|-----------------|
| الافتراضي | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| آسيا والمحيط الهادئ (يُفضّل في البر الرئيسي للصين) | `https://asia.qcode.cc/api` | `https://asia.qcode.cc/openai/v1` |
| أمريكا الشمالية / أوروبا | `https://us.qcode.cc/api` | `https://us.qcode.cc/openai/v1` |

> ينبغي لمستخدمي البر الرئيسي للصين تفضيل `asia.qcode.cc`، فهو عادةً نقطة النهاية الأقرب. راجع [نقاط النهاية وتنسيقات API](/docs/getting-started/endpoints-and-api-paths) للتفاصيل.

## Cline Desktop

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

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

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

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

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

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

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

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

| السيناريو | النموذج الموصى به | ملاحظات |
|----------|-------------------|-------|
| البرمجة اليومية | `claude-sonnet-5` | الفئة المتوازنة الحالية، 1M / 128K؛ كان الإدخال أرخص من 4.6 وقت كتابة هذا |
| البنية المعقدة / وضع التخطيط | `claude-opus-5` | الرائد الحالي. لا يزال `claude-opus-4-8` معروضًا للبيع |
| المهام الخفيفة / تعديلات النصوص | `claude-haiku-5-5` | أقل تكلفة |
| تفضيل أسلوب GPT | `gpt-5.6-terra` | قابل للاختيار ضمن بروتوكول OpenAI |
| عائلة النماذج الصينية / سعر وحدة أقل | `glm-5.2` / `deepseek-v4-pro` | راجع [نماذج العائلة الصينية](/docs/usage/cn-models) |

راجع [الفوترة](/docs/reference/billing) للاطلاع على الأسعار الكاملة.

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

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

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

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

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

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

```text
# .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](/docs/usage/image-2) باسم النموذج `gpt-image-2`.

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

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

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

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

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

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

| السيناريو | الأداة الموصى بها |
|----------|------------------|
| تعديلات سريعة في VS Code | Cline |
| تحليل مشروع معقد | Claude Code CLI |
| إعادة هيكلة متعددة الملفات | Cline |
| عمليات Git ومراجعة الشيفرة | Claude Code CLI |
| الترحيل/المراجعة على مستوى قاعدة الشيفرة | Claude Code CLI ([الوكلاء الفرعيون](/docs/advanced/subagents)) |
| أتمتة CI/CD | Claude Code CLI ([الوضع بلا واجهة](/docs/advanced/headless)) |

### 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](https://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](/docs/getting-started/endpoints-and-api-paths) للاطلاع على جميع البروتوكولات والنطاقات

- راجع [تكامل Aider](/docs/ide/aider) للاطلاع على أداة مفتوحة المصدر أخرى متوافقة مع QCode.cc

- راجع [تكامل VS Code](/docs/ide/vscode) لاستخدام إضافة Claude Code الرسمية

- راجع [نماذج عائلة الصين](/docs/usage/cn-models) لاستدعاء GLM / Kimi / DeepSeek / Qwen بالحقول نفسها المتوافقة مع OpenAI

- راجع [الفوترة](/docs/reference/billing) للاطلاع على تفاصيل الأسعار

> أليس لديك مفتاح API بعد؟ [راجع خطط QCode.cc وأسعارها →](https://qcode.cc/pricing)