# راه‌اندازی 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` |
| محل پیکربندی | زبانه Agents در Devin User Settings، یا `~/.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 و
دیگران. قابلیت‌های جدید شامل Command Center به سبک کانبان، Spaces برای گروه‌بندی کارها، عامل محلی
**Devin Local** (فروشنده توضیح می‌دهد که معماری Devin CLI را به اشتراک می‌گذارد) و Codemaps است.

## روش درست استفاده از QCode: ACP تنها مسیر است

Devin Desktop **هیچ** فیلد BYOK ارائه نمی‌دهد که بتوانید در آن یک Base URL دلخواه وارد کنید: جست‌وجو در
فهرست مستندات رسمی برای BYOK / bring your own / custom endpoint / base URL / model override
**هیچ نتیجه‌ای** برنمی‌گرداند، و فهرست مدل‌ها یک کاتالوگ ثابت و وابسته به پلن شماست. برای استفاده از کلید
و سهمیه QCode باید **عامل خود را از طریق ACP متصل کنید**:

> 🔑 Devin Desktop عامل‌های ACP را در صورت نیاز به‌صورت **فرایندهای فرزند** اجرا می‌کند و از طریق
> JSON-RPC روی stdio با آن‌ها صحبت می‌کند (عیناً به نقل از مستندات). دو روش مستندشده برای دادن متغیرهای محیطی
> به یک عامل عبارت‌اند از دکمه «...» در زبانه **Agents** در Devin User Settings، و تنظیم
> `devin.acp.agentEnv.<agentName>` در `settings.json`. اینکه عامل محیط شل شما را نیز
> به ارث ببرد، توسط فروشنده **عیناً وعده داده نشده است** — معمولاً درست است، اما تضمینی نیست؛ به همین دلیل
> مرحله 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` قرار دهید — برنامه GUI که از روی آیکون اجرا می‌شود `~/.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 — در دسترس نیستند و hookها نه بارگذاری می‌شوند و نه اجرا. ابتدا این را بررسی کنید وقتی هیچ عاملی نمایش داده نمی‌شود.

پس از اتصال، یک نشست در Devin Desktop باز کنید. پاسخ عادی یعنی دارد سهمیه QCode شما را مصرف می‌کند.

## تأیید اینکه ترافیک واقعاً به QCode می‌رود

[probe.qcode.cc](https://probe.qcode.cc) را باز کنید و کلید API خود را وارد کنید. نشستی که همین حالا اجرا کردید باید در فهرست درخواست‌ها ظاهر شود (همراه با مدل، توکن‌ها و طول زمینه). **اگر ظاهر نشد، عامل محیط شما را به ارث نبرده است** — به گام 1 بازگردید و از شکل `~/.claude/settings.json` استفاده کنید.

## عیب‌یابی

| نشانه | علت | رفع |
|---------|-------|-----|
| در ترمینال کار می‌کند، اما در Devin Desktop احراز هویت نمی‌شود | اجرای GUI محیط شل را نمی‌خواند | از بلوک `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)