Cursor

Cursor یک ویرایشگر کد مبتنی بر هوش مصنوعی است که روی VS Code ساخته شده. حالت عامل (Agent) برای کدنویسی خودمختار، تکمیل پیشگویانهٔ تب، ویرایش‌های درون‌خطی، یک CLI و عامل‌های ابری دارد. Cursor علاوه بر مدل‌های اختصاصی خود (مثل Composer)، از مدل‌های پیشروی OpenAI، Anthropic، Google و دیگران هم پشتیبانی می‌کند.

با مسیردهی Cursor از طریق آشا، با یک کلید API واحد به صدها مدل دسترسی پیدا می‌کنید؛ به‌همراه جابه‌جایی خودکار پروایدر و ردیابی متمرکز مصرف.

چرا باید Cursor را به آشا وصل کنیم؟

دسترسی به صدها مدل

BYOK داخلی Cursor فقط از تعداد محدودی ارائه‌دهنده پشتیبانی می‌کند. با آشا به صدها مدل از ده‌ها ارائه‌دهنده، همه از طریق یک override واحد OpenAI، دسترسی دارید.

جابه‌جایی خودکار پروایدر برای دسترس‌پذیری بالا

اگر یک ارائه‌دهنده در دسترس نباشد یا محدودیت نرخ داشته باشد، آشا به‌صورت خودکار درخواست را به پروایدر دیگری مسیردهی می‌کند و نشست کدنویسی شما بی‌وقفه ادامه می‌یابد.

کنترل بودجهٔ سازمانی

برای تیم‌ها، آشا مدیریت بودجهٔ متمرکز فراهم می‌کند: سقف هزینه تعیین کنید، اعتبار را بین اعضای تیم تقسیم کنید و مصرف توسعه‌دهندگانی که با Cursor کار می‌کنند را از داشبورد فعالیت آشا کنترل کنید.

دید و تحلیل مصرف

از یک داشبورد واحد ببینید هر عضو تیم از کدام مدل‌ها استفاده می‌کند، هزینه‌ها را لحظه‌ای کنترل کنید و الگوی مصرف را بر حسب مدل، کاربر و هزینه بررسی کنید. هم‌چنین می‌توانید کنترل کنید کدام پروایدر بالادستی درخواست‌های شما را رسیدگی می‌کند؛ به راهنمای انتخاب پروایدر مراجعه کنید.

شروع سریع

Cursor از قابلیت Override OpenAI Base URL برای اتصال به آشا پشتیبانی می‌کند. این قابلیت درخواست‌های override پروایدر OpenAI را به نقطهٔ پایانی اختصاصی آشا می‌فرستد که فرمت درخواست Cursor را به‌صورت بومی مدیریت می‌کند.

گام ۱ — دریافت کلید API آشا

1. در داشبورد آشا ثبت‌نام یا وارد شوید.
2. به صفحهٔ کلیدهای API بروید.
3. یک کلید API جدید بسازید.
4. کلید را کپی کنید (با sk-asha-... شروع می‌شود).

گام ۲ — پیکربندی Cursor

1. تنظیمات Cursor را باز کنید (آیکون چرخ‌دنده یا Cmd/Ctrl + ,).
2. به بخش Models بروید و بخش API Keys را باز کنید.
3. گزینهٔ OpenAI API Key را روشن کنید، سپس:

• کلید API آشا را در فیلد OpenAI API Key قرار دهید.
• گزینهٔ Override OpenAI Base URL را روشن کنید و آن را به این آدرس بگذارید:

https://app.asha-ai.ir/v1/cursor

گام ۳ — افزودن مدل‌ها

پس از اتصال، مدل‌هایی را که می‌خواهید اضافه کنید. در بخش Models روی + Add model کلیک کنید و یک شناسهٔ مدل آشا وارد کنید:

~anthropic/claude-opus-latest
~openai/gpt-latest
~anthropic/claude-sonnet-latest
~openai/gpt-4o

گام ۴ — انتخاب مدل

انتخاب‌گر مدل را در پنل چت یا عامل باز کنید و یکی از مدل‌های افزوده‌شده را انتخاب کنید. درخواست‌های شما حالا از درگاه آشا عبور می‌کنند.

نحوهٔ کار

آشا یک نقطهٔ پایانی اختصاصی برای Cursor در مسیر /v1/cursor ارائه می‌دهد که پیش از مسیردهی، فرمت درخواست Cursor را به قالب استاندارد OpenAI Chat Completions نرمال می‌کند.

محدودیت‌ها

• تکمیل تب (Tab completions) تحت تأثیر تنظیمات BYOK نیست؛ همیشه از مدل‌های داخلی Cursor استفاده می‌کند.
• حالت‌های Auto و Composer 2 ممکن است از کلید API شما عبور نکنند؛ آخرین رفتار را در مستندات Cursor بررسی کنید.
• فقط مدل‌هایی که از نقطهٔ پایانی OpenAI-سازگار آشا در دسترس‌اند کار می‌کنند؛ بیشتر مدل‌های چت و استدلال پشتیبانی می‌شوند.

رفع اشکال

• Invalid API key: مطمئن شوید کلید API آشا را استفاده می‌کنید (با sk-asha-... شروع می‌شود)، نه یک کلید OpenAI.
• مدل پیدا نشد: شناسهٔ مدل باید دقیقاً با قالب فهرست مدل‌های آشا یکی باشد. نام‌های مستعار مسیریاب به پیشوند ~ نیاز دارند (مثل ~anthropic/claude-opus-latest، نه بدون آن).
• آدرس Base URL: آدرس override حتماً باید https://app.asha-ai.ir/v1/cursor باشد. اگر از https://app.asha-ai.ir/v1 (بدون /cursor) استفاده کنید، فراخوانی ابزارها و برخی فرمت‌های درخواست درست کار نمی‌کنند.
• خطاهای ابزار (Tool errors): اگر فراخوانی ابزار به‌صورت غیرمنتظره شکست خورد، بررسی کنید به نقطهٔ پایانی /cursor اشاره کرده‌اید. نقطهٔ پایانی اختصاصی، فرمت flat ابزار Cursor را مدیریت می‌کند؛ نقطهٔ پایانی عمومی /v1 چنین نمی‌کند.

منابع

• مستندات Cursor
• صفحهٔ کمک BYOK کرسر
• فهرست مدل‌های آشا
• مستندات API آشا