پرش به مطلب اصلی

اتصال Cursor به چابکان

Cursor چیست؟​

Cursor یک ویرایشگر کد مبتنی بر VS Code با قابلیت‌های هوش مصنوعی مانند chat، ویرایش کد، autocomplete و agent است. بسیاری از توسعه‌دهندگان آن را به‌دلیل رابط آشنا و یکپارچگی نزدیک با workflow کدنویسی انتخاب می‌کنند. Cursor علاوه بر مدل‌ها و سرویس داخلی خود، در بعضی نسخه‌ها امکان واردکردن API Key و override کردن OpenAI Base URL را ارائه می‌دهد.

اتصال مستقیم Cursor به provider سفارشی به اندازه ابزارهایی مانند Cline یا Continue قابل پیش‌بینی نیست. این صفحه هم روش موجود را توضیح می‌دهد و هم مرز فنی آن را شفاف می‌کند تا کاربر تصور نکند تمام قابلیت‌های Cursor الزاماً از endpoint چابکان عبور می‌کنند.

این روش برای چه کسی مناسب است؟​

  • کاربری که از Cursor استفاده می‌کند و می‌خواهد یک مدل OpenAI-compatible را آزمایش کند؛
  • تیمی که ابتدا یک pilot محدود و قابل بازگشت انجام می‌دهد؛
  • استفاده ساده chat، مشروط به موفقیت Verify و آزمون مدل.

برای اتصال قابل‌کنترل‌تر در همان محیط، افزونه Cline، Continue یا Roo Code معمولاً انتخاب روشن‌تری است.

پشتیبانی محدود در Cursor

قابلیت Override OpenAI Base URL در Cursor در نسخه‌های مختلف رفتار یکسانی ندارد، روی مدل‌های داخلی نیز اثر می‌گذارد و درخواست‌ها همچنان از سرورهای Cursor عبور می‌کنند. برای اتصال پایدارتر داخل همان ویرایشگر، نصب افزونه Cline یا Continue پیشنهاد می‌شود.

تنظیم مستقیم در نسخه‌هایی که Override دارند​

  1. Cursor را به آخرین نسخه به‌روزرسانی کنید.
  2. Cursor Settings را باز کنید.
  3. به Models → API Keys بروید.
  4. در بخش OpenAI، کلید چابکان با قالب sk-chbk-... را وارد کنید.
  5. گزینه Override OpenAI Base URL را فعال کنید.
  6. آدرس زیر را وارد کنید:
https://ai.chabokan.net/v1
  1. اگر گزینه افزودن مدل سفارشی وجود دارد، شناسه دقیق مدل پنل، مانند openai/gpt-4o-mini، را اضافه کنید.
  2. کلید یا اتصال را Verify کنید.
  3. در یک چت تازه، مدل افزوده‌شده را انتخاب و یک درخواست ساده ارسال کنید.

اگر مدل‌های داخلی Cursor از کار افتادند​

Override در بعضی نسخه‌ها سراسری است. برای بازگشت به مدل‌های اشتراکی خود Cursor:

  1. به Settings → Models → API Keys برگردید.
  2. گزینه Override OpenAI Base URL را خاموش کنید.
  3. یک چت جدید باز کنید؛ در صورت نیاز Cursor را بازنشانی کنید.

نکات حریم خصوصی و سازگاری​

  • استفاده از API Key شخصی به معنی اتصال مستقیم دسکتاپ به چابکان نیست؛ Cursor ابتدا context و prompt نهایی را در backend خود می‌سازد.
  • برخی قابلیت‌های Agent یا مدل‌های reasoning ممکن است با endpoint سفارشی درست کار نکنند.
  • هم‌زمان نگه‌داشتن provider داخلی و Base URL سفارشی ممکن است انتخاب مدل را به‌هم بزند.
  • اگر Verify موفق است اما Agent در حلقه می‌افتد، از Cline یا Continue استفاده کنید.

منابع: توضیح عبور درخواست BYOK از backend در انجمن Cursor، محدودیت Base URL سراسری