Cursor با هوش مصنوعی FluxCDN
Cursor اجازه میدهد آدرس OpenAI را عوض کنید و مدل دلخواه اضافه کنید. این برای چت در حالت Ask و Plan کار میکند. حالت Agent با آدرس سفارشی قابل اعتماد نیست و تکمیل Tab همیشه با مدلهای خود Cursor است. برای ایجنت، Cline یا Kilo Code را داخل Cursor نصب کنید (راهنمای VS Code)، یا Claude Code و Codex را در ترمینال Cursor اجرا کنید.
- مجوز:
- اختصاصی؛ طبق راهنماهای موجود، مدل سفارشی فقط در اشتراک پولی Cursor فعال است
- سیستمعاملها:
- macOS، Linux، Windows
- آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
راهاندازی
گام 1: متغیرهای قدیمی را پاک کنید
اگر
OPENAI_API_KEYیاOPENAI_BASE_URLرا در سیستم تعریف کردهاید، پاکشان کنید؛ ممکن است با تنظیم Cursor تداخل کنند.گام 2: کلید و آدرس را بدهید
Cursor Settings → Models و بعد بخش API Keys. کلید را در OpenAI API Key بگذارید و روشنش کنید. Override OpenAI Base URL را روشن کنید و بهجای آدرس پیشفرض
https://ai.fluxcdn.cloud/api/v1را بنویسید، بدون/chat/completions.گام 3: مدل را اضافه کنید
+ Add Custom Model را بزنید، شناسه را دقیقاً بنویسید و روشنش کنید.
قیمت هر میلیون توکن. قیمتهای طرح رایگان، به تومان با نرخ امروز. مسیریابها (
router/autoو مانند آن) برای ایجنتها پیشنهاد نمیشوند: ایجنت به مدلی نیاز دارد که حتماً ابزار را پشتیبانی کند.+ Add Custom Modelanthropic/claude-sonnet-5.5گام 4: در حالت Ask چت کنید
در پنل چت حالت Ask را بردارید و مدل را انتخاب کنید.
بررسی کنید که کار میکند
گام 1: یک سؤال بپرسید
در حالت Ask دربارهٔ یک فایل بپرسید. درخواست را در فعالیت کنسول میبینید.
رفع مشکل
- حالت Agent خطا میدهد (مثلاً «model is required» یا خطای tools)
- حالت Agent در Cursor با آدرس سفارشی درخواستهایی میفرستد که با این مسیر جور نیستند. از Ask یا Plan استفاده کنید، یا Cline، Kilo Code، Claude Code یا Codex را داخل Cursor به کار ببرید.
- پاسخها خالی میآیند
- Settings → Network → HTTP Compatibility Mode را روی HTTP/1.1 بگذارید.
- پیام «does not work with your current plan or api key»
- مدل سفارشی در اشتراک رایگان Cursor فعال نیست، یا کلید درست کپی نشده.
- مدلهای GPT خود Cursor کار نمیکنند
- تغییر آدرس OpenAI در Cursor برای همهٔ مدلهای OpenAI است. برای استفاده از مدلهای خود Cursor آن را خاموش کنید.
- خطای 401 یا
invalid_api_key - کلید کامل کپی نشده، باطل شده یا جای دیگری گذاشته شده. کلید با
flux_live_شروع میشود و فاصلهٔ اضافه ندارد. اگر ابزار کلید را از متغیر محیطی میخواند، پس از تنظیم آن یک ترمینال یا پنجرهٔ تازه باز کنید. - خطای 402،
insufficient_credit(در Codex:insufficient_quota) با اینکه اعتبار دارید - پیش از هر درخواست، بیشترین هزینهای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته میشود. وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته میشود و بقیه برمیگردد. ابزاری که برای هر درخواست خروجی خیلی بلندی میخواهد، مبلغ بزرگی کنار میگذارد. سقف خروجی ابزار را کمتر کنید (مثلاً 32000 توکن) یا اعتبار اضافه کنید.
- خطای 404 یا
model_not_found - شناسهٔ مدل باید دقیقاً همان باشد که در صفحهٔ مدلها آمده، با پیشوند سازنده:
anthropic/claude-sonnet-5.5، نهclaude-sonnet-5.5. حروف کوچک و نقطهها مهماند. شناسه را کپی کنید، تایپ نکنید. - خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
محدودیتها
- درخواستها از سرورهای Cursor فرستاده میشوند، نه از کامپیوتر شما؛ یعنی Cursor کلید و متن درخواستها را میبیند. سیاست نگهنداشتن داده (Zero Data Retention) Cursor برای درخواستهای با کلید شخصی اعمال نمیشود.
- تکمیل Tab هرگز از کلید شما استفاده نمیکند و حالت Agent قابل اعتماد نیست.

