نقطه
Cursor
ادیتور مستقل·راهنمای رسمی اتصال

اتصال Cursor به نقطه

ادیتور Cursor را با کلید نقطه راه بینداز — با محدودیت‌های BYOK خود Cursor آشنا شو.

شروع اتصالگرفتن کلید API
قدم‌های اتصال
۵ قدم
زمان راه‌اندازی
~۵ دقیقه
هزینه‌ی خود ابزار
اشتراک Cursor Pro
پیش‌نیاز
کلید پلن پرو

قبل از شروع بدان: از اواخر ۲۰۲۵ Cursor قابلیت BYOK (کلید خارجی) را بسیار محدود کرده: حتی با اشتراک Pro، Agent و Edit (ویژگی‌های اصلی Cursor) با کلید خارجی کار نمی‌کنند — فقط Chat با مدل‌های استاندارد روی کلید نقطه راه می‌افتد. مدل‌های reasoning (o1, o3) و GPT-5 از مسیر BYOK پشتیبانی نمی‌شوند. اگر قابلیت Agent برایت مهم است، به‌جای Cursor از Cline (همان VS Code، رایگان) یا Claude Code (ترمینال) استفاده کن.

راهنمای اتصال

قدم‌به‌قدم تا اولین پاسخ

هر جا کد یا مقدار دیدی، با دکمهٔ کپی بردار و همان‌جا که گفتیم بگذار. کلید sk-noqte نداری؟ با پلن پرو در چند ثانیه می‌گیری.

  1. Cursor Pro لازم است

    BYOK روی پلن رایگان فعال نیست. اگر اشتراک Pro نداری، توصیه می‌کنیم به‌جای ادامه‌ی این مراحل از Cline یا Claude Code (روی همان VS Code/ترمینال) استفاده کنی.

  2. بازکردن تنظیمات مدل

    Cursor → Settings (Cmd+, روی مک، Ctrl+, روی ویندوز) → از منوی سمت چپ روی Models کلیک کن. به بخش «API Keys» اسکرول کن.

  3. فعال‌سازی OpenAI API Key و Custom Base URL

    روی «OpenAI API Key» کلیک کن تا باز شود. تیک «Override OpenAI Base URL» را فعال کن، سپس مقادیر را وارد کن (⚠ مقدار Base URL حتماً باید با /v1 ختم شود):

    Base URL:        https://api.noqte.ai/v1
OpenAI API Key:  sk-noqte-…
    بخش API Keys در تنظیمات Cursor با مقادیر نقطه (نمای بازسازی‌شده)
    بخش API Keys در تنظیمات Cursor با مقادیر نقطه (نمای بازسازی‌شده)

  4. تأیید با Verify

    روی دکمه‌ی Verify کلیک کن. این دکمه یک درخواست GET به /v1/models می‌زند تا اتصال را چک کند — اگر سبز شد، اتصال درست است.

    حالت موفق Verify — اتصال تأیید شد (نمای بازسازی‌شده)
    حالت موفق Verify — اتصال تأیید شد (نمای بازسازی‌شده)

  5. محدودیت‌های Cursor BYOK

    در یک Chat جدید، مدل‌های استاندارد (مثل gpt-4o) را انتخاب کن — درخواست به نقطه می‌رود و خودکار به مدل Sonnet نگاشت می‌شود (هر نام مدلی به‌جز Opus و Haiku به‌صورت پیش‌فرض با Sonnet جواب می‌گیرد). ⚠ Agent و Edit با BYOK کار نمی‌کنند و خطای «Custom models cannot be billed to API key» می‌گیری. این محدودیت سمت Cursor است و قابل دور زدن نیست.

رفع اشکال

سوالات پرتکرار دربارهٔ Cursor

آیا با پلن رایگان Cursor می‌توانم به نقطه وصل شوم؟

نه. Cursor قابلیت BYOK (استفاده از کلید خارجی) را فقط برای مشترکین Pro فعال می‌کند. اگر اشتراک Pro نداری، Cline روی همان VS Code رایگان است و تجربه‌ی ایجنتی کامل‌تری هم می‌دهد.

چرا Agent و Edit با کلید نقطه کار نمی‌کنند؟

این محدودیت سمت خود Cursor است، نه نقطه. از اواخر ۲۰۲۵ Cursor اجرای Agent و Edit را به صورت‌حساب داخلی خودش گره زده و با هیچ کلید خارجی‌ای (از هر ارائه‌دهنده‌ای) اجازه‌ی اجرا نمی‌دهد. فقط Chat با کلید خارجی کار می‌کند.

جایگزین Cursor برای قابلیت Agent چیست؟

Cline (افزونه‌ی رایگان VS Code) یا Claude Code (ابزار ترمینال رسمی Anthropic). هر دو با همان کلید sk-noqte کار می‌کنند و قابلیت‌های ایجنتی کامل — ساخت فایل، اجرای دستور و کارهای چندقدمی — دارند.

دکمه‌ی Verify دقیقاً چه چیزی را بررسی می‌کند؟

یک درخواست GET به مسیر /v1/models درگاه نقطه می‌زند تا مطمئن شود Base URL و کلید درست‌اند. اگر سبز شد یعنی اتصال شبکه و احراز هویت هر دو برقرار است.

یک کلید، همهٔ مدل‌ها — با ظرفیت اشتراک خودت

کلید API در پلن‌های پرو فعال می‌شود؛ سهمش را بین ابزارها پخش کن و مصرف را زنده در داشبورد ببین — بدون کارت خارجی، بدون فیلترشکن، با پرداخت ریالی.

مشاهدهٔ پلن‌های پروورود / ثبت‌نام

همین کلید در بقیهٔ ابزارها هم کار می‌کند

Claude Code و DesktopClineContinue.devAiderOpenCodeهمهٔ ابزارها