Cursor یک ویرایشگر کد بر پایهٔ VS Code است که حالت Agent برای کدنویسی خودمختار،
تکمیل تب، ویرایش درونخطی، CLI و ایجنتهای ابری دارد. Cursor علاوه بر مدلهای
اختصاصی خودش (مثل Composer)، از مدلهای مرزی OpenAI، Anthropic، Google و بقیه هم
پشتیبانی میکند. با هدایت Cursor به آشا، با یک کلید به صدها مدل دسترسی پیدا
میکنید، جابهجایی خودکار بین ارائهدهندگان دارید و مصرف را بهصورت متمرکز
دنبال میکنید.
با توجه به انتشار بتا: این یکپارچهسازی ممکن است با بهروزرسانی
نسخهٔ Cursor تغییر کند. رفتار فعلی را در مستندات Cursor پیگیری کنید.
شروع سریع
Cursor از طریق قابلیت Override OpenAI Base URL با آشا کار
میکند. این ویژگی درخواستهای زبانی OpenAI را از یک نقطهٔ پایانی اختصاصی آشا رد
میکند که قالب درخواست Cursor را بهصورت بومی میفهمد.
گام ۱ — دریافت کلید API آشا
- در پنل کاربری آشا ثبتنام یا وارد شوید.
- به صفحهٔ کلیدهای API بروید.
- یک کلید جدید بسازید و آن را کپی کنید (با قالب
sk-asha-...شروع میشود).
گام ۲ — پیکربندی Cursor
- تنظیمات Cursor را باز کنید (آیکون چرخدنده یا Cmd/Ctrl + ,).
- به بخش Models بروید و بخش API Keys را باز کنید.
- گزینهٔ OpenAI API Key را فعال کنید و کلید آشا را در فیلد OpenAI API Key جایگذاری کنید.
- Override OpenAI Base URL را فعال کنید و مقدار زیر را بگذارید:
Cursor → Models → Override OpenAI Base URL
https://app.asha-ai.ir/v1/cursor
آدرس پایه باید دقیقاً .../v1/cursor باشد (نه .../v1).
این نقطهٔ پایانی اختصاصی، قالب درخواست Cursor را بهدرستی مدیریت میکند.
گام ۳ — افزودن مدلها
در بخش Models، روی + Add model کلیک کنید و شناسهٔ مدل آشا را
وارد کنید:
Cursor → Models
~anthropic/claude-opus-latest
~openai/gpt-latest
deepseek/deepseek-v4-flash
qwen/qwen3
شناسههای با پیشوند ~ فقط با مدلهای منتخب سراسری سازگارند؛ برای
بقیهٔ مدلها، شناسهٔ دقیق را از
فهرست مدلهای آشا بردارید.
گام ۴ — انتخاب مدل
انتخابگر مدل را در پنل چت یا Agent باز کنید و یکی از مدلهایی را که اضافه
کردهاید برگزینید. از این لحظه درخواستهای شما از مسیر آشا میروند.
چطور کار میکند؟
آشا یک نقطهٔ پایانی اختصاصی برای Cursor در
/api/v1/cursor فراهم کرده است که قالب درخواست Cursor را پیش از مسیریابی،
به فرمت استاندارد Chat Completions تبدیل میکند.
چرا Cursor را به آشا وصل کنیم؟
دسترسی به صدها مدل
BYOK داخلی Cursor فقط از چند ارائهدهنده پشتیبانی میکند. با آشا، از طریق همان تکی
بودن OpenAI provider override، به صدها مدل در دهها ارائهدهنده دسترسی دارید.
جابهجایی خودکار (Failover)
اگر یک ارائهدهنده قطع یا پرترافیک شود، آشا بهطور خودکار به دیگری سوئیچ میکند و نشست کدنویسی شما قطع نمیشود.
کنترلهای سازمانی
برای تیمها، بودجه را بهصورت متمرکز مدیریت کنید: سقف هزینه بگذارید، اعتبار تقسیم کنید و مصرف را از داشبورد فعالیت پیگیری کنید — به تومان در کیف پول خودتان.
شفافیت مصرف
ببینید تیم شما کدام مدلها را استفاده میکند، هزینه را در لحظه نظارت کنید و
الگوهای مصرف را از یک داشبورد بخوانید، بدون توجه به ارائهدهندهٔ زیرین. صفحهٔ
فعالیت، تحلیل را به تفکیک مدل، کاربر و هزینه نشان میدهد.
محدودیتها
- تکمیلهای تب (Tab completions) تحت تأثیر تنظیمات BYOK نیستند؛ همیشه از مدلهای داخلی Cursor استفاده میکنند.
- حالتهای Auto و Composer 2 ممکن است از کلید شما رد نشوند. رفتار فعلی را در مستندات Cursor بررسی کنید.
- فقط مدلهایی که از طریق نقطهٔ پایانی سازگار با OpenAI در آشا قابل دسترسیاند کار میکنند؛ بیشتر مدلهای چت و استدلالی پشتیبانی میشوند.
رفع اشکال متداول
پیام «Invalid API key»
مطمئن شوید از کلید API آشا استفاده میکنید (با sk-asha-... شروع
میشود)، نه کلید دیگری.
مدل پیدا نشد
شناسهٔ مدل را دقیقاً با همان قالب
فهرست مدلهای آشا بنویسید. نامهای مستعار سراسری (Router
aliases) به پیشوند ~ نیاز دارند (مثلاً
~anthropic/claude-sonnet-latest، نه
anthropic/claude-sonnet-latest).
آدرس Base URL
آدرس override باید https://app.asha-ai.ir/v1/cursor باشد. اگر از
.../v1 (بدون /cursor) استفاده کنید، فراخوانی ابزارها و
بعضی فرمتهای درخواست ممکن است درست کار نکنند.
خطای ابزارها (Tool errors)
اگر شکست غيرمنتظرهٔ فراخوانی ابزار دیدید، بررسی کنید که به نقطهٔ پایانی
/cursor اشاره کردهاید. نقطهٔ پایانی اختصاصی، قالب تخت ابزارهای
Cursor را مدیریت میکند؛ پایانپوینت عمومی /v1 این کار را نمیکند.
جمعبندی
با چهار گام ساده، Cursor شما به آشا وصل شد: صدها مدل با یک کلید، پایداری بهتر،
کنترل هزینه برای تیم و صورتحساب شفاف به تومان. فهرست کامل مدلها و قیمتها را در
صفحهٔ مدلهای آشا ببینید.
