# إعداد Devin Desktop (المعروف سابقًا بـ Windsurf)

> **آخر تحقق**: 2026-09-18 · 📄 وفق الوثائق الرسمية (Devin Desktop 3.10.31 (صدر في 2026-09-16))

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | تعتمد على وكيل ACP المثبَّت: Claude ✅ (ثبّت Claude Agent / Claude Code مع توجيه البيئة إلى QCode) · GPT / النماذج الصينية حسب الوكيل · Gemini ❌ |
| البروتوكول وBase URL | بيئة الوكيل `ANTHROPIC_BASE_URL=https://api.qcode.cc/api` |
| مكان الإعداد | علامة تبويب الوكلاء في إعدادات مستخدم Devin، أو `~/.windsurf/acp/registry.json` (Windows: `%USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json`)؛ زوّد الوكيل ببيئته عبر إعداد `devin.acp.agentEnv.<agentName>` |
| الوثائق الرسمية | [docs.devin.ai](https://docs.devin.ai) |

> **⚠️ أُعيد تسمية Windsurf.** في 2026-06-02 أعادت Cognition تسمية **Windsurf إلى Devin Desktop** وأطلقته
> كتحديث عن بُعد. ما وعد به المزوّد بندًا بندًا هو الخطط والأسعار والإعدادات والإضافات؛ أما اختصارات
> لوحة المفاتيح واتصالات MCP فغير مضمونة كلًّا على حدة، ولم نتحقق منها واحدًا واحدًا. أُزيل **وكيل Cascade الأصلي**:
> قالت الأسئلة الشائعة آنذاك إنه «يظل متاحًا حتى يوليو»، لكن الإزالة وقعت فعليًا في
> **سجل تغييرات v3.9.19 (8 سبتمبر 2026)** — «تمت إزالة **Cascade**» — ما يجعل
> **Devin Local الوكيل الوحيد المضمّن في Devin Desktop**.

[Devin Desktop](https://devin.ai/desktop) مبني الآن حول **[ACP (Agent Client Protocol)](/docs/ide/acp)**:
يعمل كمضيف، وتُرفق أي وكيل يتحدث ACP — Claude Code وCodex CLI وOpenCode
وغيرها. تشمل القدرات الجديدة مركز أوامر بأسلوب Kanban، وSpaces لتجميع المهام، ووكيلًا محليًا
**Devin Local** (يصفه المزوّد بأنه يشارك بنية Devin CLI) وCodemaps.

## الطريقة الصحيحة لاستخدام QCode: ACP هو المسار الوحيد

لا يوفّر Devin Desktop **أي** حقل BYOK يمكنك فيه كتابة Base URL عشوائي: البحث في
فهرس الوثائق الرسمي عن BYOK / إحضار مفتاحك الخاص / نقطة النهاية المخصصة / Base URL / تجاوز النموذج
لا يعيد **شيئًا**، وقائمة النماذج كتالوج ثابت مرتبط بخطتك. لاستخدام مفتاح QCode
والحصة الخاصة بك، عليك **إرفاق وكيلك الخاص عبر ACP**:

> 🔑 يشغّل Devin Desktop وكلاء ACP كـ**عمليات فرعية** عند الطلب ويتواصل معها عبر
> JSON-RPC على stdio (بالصياغة الرسمية). الطريقتان الموثقتان لتزويد الوكيل بمتغيرات
> البيئة هما زر «...» في علامة تبويب **Agents** ضمن إعدادات مستخدم Devin، وإعداد
> `devin.acp.agentEnv.<agentName>` في `settings.json`. أما ما إذا كان الوكيل يرث بيئة
> shell الخاصة بك أيضًا، فذلك **غير موعود به حرفيًا** من المزوّد — صحيح عادةً، لكنه غير مضمون، ولهذا
> تضع الخطوة 1 الإعداد في ملف الوكيل نفسه.
## الخطوة 1: توجيه Claude Code إلى QCode

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_qcode_key"
```

من البر الرئيسي للصين، استخدم `https://asia.qcode.cc/api`.

> **أكثر موثوقية**: ضع هذه المتغيرات في كتلة `env` داخل `~/.claude/settings.json` بدلًا من ملف تعريف الصدفة — فتطبيق واجهة رسومية يُشغَّل من أيقونة لا يقرأ `~/.zshrc`، وهذا هو سبب الفشل الأكثر شيوعًا. راجع [نظرة عامة على ACP](/docs/ide/acp) و[متغيرات البيئة](/docs/getting-started/environment).

تأكد أولًا من أن CLI يعمل من الطرفية:

```bash
claude -p "reply with exactly: OK"
```

## الخطوة 2: إرفاق الوكيل داخل Devin Desktop

**الوكيل المدمج الوحيد هو Devin Local.** تسرد الوثائق الرسمية Codex CLI وClaude Agent وOpenCode وJunie وGemini CLI بوصفها *وكلاء نموذجية على سبيل المثال* — أي وكلاء ACP من جهات خارجية يمكنك إرفاقهم، **ويلزمك تثبيت ملفاتهم التنفيذية بنفسك** (تذكر الوثائق أن Devin Desktop لا ينزّل توزيعات الوكلاء من السجل، لأسباب أمنية). منذ الإصدار v3.10.23 (2026-09-10) أصبح ACP مفعّلًا دائمًا، ولم يعد خيار **Enable ACP** القديم موجودًا. طريقة الإرفاق:

- لوحة الأوامر (`Cmd/Ctrl + Shift + P`) → `Devin User Settings` → تبويب **Agents** → فعّل وكلاء ACP الذين تريدهم
- أو حرّر السجل المحلي: `~/.windsurf/acp/registry.json` على macOS / Linux
  (`~/.windsurf-next/acp/registry.json` في Devin Desktop Next)، و
  `%USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json` على Windows
- يفتح الأمر `Open Local ACP Registry Config` في لوحة الأوامر ذلك الملف مباشرة؛ وبعد التحرير نفّذ
  `Reload ACP Connections` — دون حاجة إلى إعادة تشغيل كاملة

المفاتيح والحدود: [وثائق ACP الرسمية لـ Devin](https://docs.devin.ai/desktop/acp).

> ⚠️ تحذير رسمي: ما دامت مساحة عمل مفتوحة في **Restricted Mode**، فإن **كل** وكيل — سواء Devin Local أو وكلاء ACP — غير متاح، ولا تُحمَّل الخطافات ولا تعمل. تحقق من ذلك أولًا عندما لا يظهر أي وكيل على الإطلاق.

بعد الإرفاق، افتح جلسة في Devin Desktop. ردّ طبيعي يعني أنه يستهلك حصتك من QCode.

## تحقق من أن الحركة تذهب فعلًا إلى QCode

افتح [probe.qcode.cc](https://probe.qcode.cc) وأدخل مفتاح API الخاص بك. ينبغي أن تظهر الجلسة التي شغّلتها للتو في قائمة الطلبات (مع النموذج وعدد tokens وطول السياق). **إذا لم تظهر، فالوكيل لم يرث بيئتك** — عُد إلى الخطوة 1 واستخدم صيغة
`~/.claude/settings.json`.

## استكشاف الأخطاء وإصلاحها

| العرَض | السبب | الحل |
|---------|-------|-----|
| يعمل في الطرفية، لكن تفشل المصادقة في Devin Desktop | التشغيل من واجهة رسومية لا يقرأ بيئة الصدفة | استخدم كتلة `env` في `~/.claude/settings.json` |
| اختفاء Cascade | أُزيل في v3.9.19 (2026-09-08) | استخدم Devin Local، أو أرفق وكيل ACP |
| لا يوجد حقل لإدخال Base URL | لا تتضمن الوثائق الرسمية مدخلًا لـ BYOK / نقطة نهاية مخصصة | أرفق وكيلك عبر ACP |
| لا شيء يظهر في probe | الجلسة لم تمر عبر QCode | تحقق من أن الوكيل ورث البيئة |

## ذو صلة

- [نظرة عامة على ACP](/docs/ide/acp) — الإعداد نفسه يغطي أيضًا Zed وJetBrains
- [متغيرات البيئة](/docs/getting-started/environment)
- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths)