راه‌اندازی Devin Desktop (پیش‌تر Windsurf)

Windsurf اکنون Devin Desktop است و حول ACP ساخته شده است: Claude Code را به‌عنوان یک عامل ACP متصل کنید و محیط آن را به QCode اشاره دهید

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بازبینی: 2026-09-18 · 📄 طبق مستندات رسمی (Devin Desktop 3.10.31 (منتشرشده در 2026-09-16))

یک نگاه کلی¶

⚠️ Windsurf تغییر نام داد. در 2026-06-02، Cognition نام Windsurf را به Devin Desktop تغییر داد و آن را به‌صورت به‌روزرسانی از راه دور منتشر کرد. چیزهایی که فروشنده مورد به مورد وعده داده بود عبارت بودند از پلن‌ها، قیمت‌گذاری، تنظیمات و افزونه‌ها؛ کلیدهای میان‌بر و اتصال‌های MCP به‌طور جداگانه تضمین نشده‌اند و ما آن‌ها را یکی‌یکی بررسی نکردیم. عامل اصلی Cascade حذف شده است: در آن زمان پرسش‌های متداول می‌گفت که «تا ژوئیه در دسترس می‌ماند»، اما حذف در واقع در تغییرات نسخه v3.9.19 (8 سپتامبر 2026) انجام شد — «Cascade حذف شده است» — و بدین ترتیب Devin Local تنها عامل تعبیه‌شده در Devin Desktop است.

Devin Desktop اکنون حول ACP (Agent Client Protocol) ساخته شده است: نقش میزبان را ایفا می‌کند و شما هر عاملی که با 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 متصل کنید¶

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 و متغیرهای محیطی مراجعه کنید.

ابتدا تأیید کنید که CLI از ترمینال کار می‌کند:

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.

⚠️ هشدار رسمی: تا زمانی که یک فضای کاری در Restricted Mode باز است، همه عامل‌ها — چه Devin Local و چه عامل‌های ACP — در دسترس نیستند و hookها نه بارگذاری می‌شوند و نه اجرا. ابتدا این را بررسی کنید وقتی هیچ عاملی نمایش داده نمی‌شود.

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

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

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

عیب‌یابی¶

مرتبط¶

• مرور کلی ACP — همین تنظیمات Zed و JetBrains را نیز پوشش می‌دهد
• متغیرهای محیطی
• نقاط پایانی و مسیرهای API

سازمانی ←