در Cursor کلید OpenAI را با Override Base URL به API پیکو هوش وصل کنید، مدلهای سفارشی اضافه کنید و محدودیت‌های این روش را بشناسید.
پیکو هوش·انتشار: ·به‌روزرسانی: ·۵ دقیقه مطالعه
خلاصه: Cursor در تنظیمات مدل‌ها امکان گذاشتن کلید OpenAI و تغییر Base URL را دارد. با وارد کردن https://api.picoai.ir/v1 و کلید پیکو هوش و افزودن نام مدل، می‌توانید از مدلهای کاتالوگ در چت Cursor استفاده کنید. هشدار: رابط و محدودیت‌های Cursor مرتب تغییر میکند؛ بخشی از قابلیت‌ها (مثل Tab completion و برخی حالت‌های Agent) به مدلهای داخلی خود Cursor وابسته‌اند و با کلید شخصی کار نمی‌کنند. نام منوها را مطابق نسخه‌ی خودتان بررسی کنید.
Cursor را باز کنید و به Settings و سپس بخش Models بروید.
در بخش کلید OpenAI، گزینه‌ی OpenAI API Key را فعال و YOUR_API_KEY (کلید خودتان) را وارد کنید.
گزینه‌ی Override OpenAI Base URL را روشن کنید و این نشانی را بگذارید:
https://api.picoai.ir/v1
با Add Model نام مدل را دقیقاً مطابق کاتالوگ اضافه کنید، مثلاً gpt-6-sol یا claude-sonnet-5-5.
روی Verify یا ذخیره بزنید و یک گفتگوی کوتاه تست کنید.
مسیر Cursor Settings > Models و نام گزینه‌ی Override OpenAI Base URL در راهنماهای اخیر تأیید شده است، اما مستندات رسمی Cursor این صفحه را با جزئیات منتشر نکرده و این بخش بر اساس راهنماهای جانبی و گزارش‌های کاربران نوشته شده است. نکات شناخته‌شده:
این override سراسری است، نه برای یک مدل مشخص؛ طبق گزارش‌های انجمن Cursor ممکن است درخواست مدلهای داخلی Cursor هم به همین نشانی برود و خراب شود. راه‌حل رایج: هنگام استفاده از مدلهای خود Cursor، override را موقتاً خاموش کنید.
Claude Code را با متغیرهای ANTHROPIC_BASE_URL و کلید پیکو هوش روی اندپوینت سازگار با Anthropic (/v1/messages) اجرا کنید؛ مرحله‌به‌مرحله و با عیب‌یابی.
·
خبرنامه
آموزش‌ها و تغییرات جدید را به‌موقع بگیرید
فقط مطالب مفید دربارهی API هوش مصنوعی؛ بدون هرزنامه.
گزارشها میگویند این قابلیت به پلن Pro یا بالاتر نیاز دارد و در بعضی نسخه‌های جدید Cursor برای همهی پلنها نمایش داده نمیشود (مستندات LiteLLM هم به این اشاره کرده است).
برای مدلهای Claude و Gemini، Cursor ممکن است کلید جداگانهی خودشان را بخواهد؛ اگر claude-sonnet-5-5 از این مسیر کار نکرد، این محدودیت را در نظر بگیرید و با نسخه‌ی خود امتحان کنید.
نام و جای این گزینه‌ها ممکن است در نسخه‌های مختلف فرق کند. اگر گزینه‌ای را پیدا نکردید، جستجوی «Base URL» در تنظیمات و مستندات رسمی Cursor را بررسی کنید.
تست از بیرون Cursor
پیش از دیباگ در ویرایشگر، مطمئن شوید کلید و مدل کار می‌کنند:
کلید شما در تنظیمات محلی ذخیره میشود و درخواست‌ها بسته به معماری Cursor ممکن است از سرورهای خود Cursor عبور کنند. سیاست حریم خصوصی Cursor را بخوانید و برای پروژه‌های حساس، کلید جداگانه با سقف مصرف بسازید.
برای استفاده‌ی واقعی در Cursor چند عادت هزینه و کیفیت را بهتر میکند. ابتدا قبل از پرسیدن، فایل یا بخش مرتبط را انتخاب کنید و کل پروژه را در پیام نگذارید؛ زمینه‌ی کوچک‌تر هم ارزان‌تر است و هم دقیق‌تر. دوم، برای تغییرات چندفایلی، از مدل قوی‌تر استفاده کنید و برای توضیح یک تابع از مدل سریع. سوم، قواعد پروژه (مثل سبک کدنویسی و ساختار پوشه‌ها) را در فایل rules پروژه بنویسید تا هر بار تکرار نشود؛ نام و محل این فایل را از مستندات Cursor بررسی کنید.
چند مدل برای کارهای مختلف
می‌توانید چند مدل کاتالوگ را هم‌زمان اضافه کنید و در چت بین آن‌ها جابه‌جا شوید. این کار برای مقایسه‌ی کیفیت روی کد خودتان مفید است: یک مسئله‌ی ثابت را به سه مدل بدهید و نتیجه، سرعت و هزینه را مقایسه کنید. هزینه‌ی هر درخواست را با فرمول مقاله‌ی هزینه تخمین بزنید. اگر مدلی در Cursor خطای عجیب داد ولی با curl کار کرد، ممکن است Cursor پارامترهایی (مثل ابزارها یا قالب پیام) بفرستد که آن مدل خوب مدیریت نمی‌کند؛ مدل دیگری را امتحان کنید.
چرا گاهی خطا می‌گیرم؟
ویرایشگرهایی مانند Cursor درخواست‌هایی با ابزار، پیام‌های سیستمی و پارامترهای متعدد می‌فرستند. اگر مدل یا مسیر پردازش یکی از آن‌ها را نپذیرد، پیام خطای کلی در ویرایشگر دیده میشود. برای تشخیص علت، همان مدل را با curl ساده تست کنید؛ اگر ساده کار کرد، مدل دیگری را در Cursor امتحان کنید. همچنین در صورت امکان لاگ شبکه یا کنسول توسعه‌دهنده‌ی Cursor را بررسی کنید.
سوالات متداول
آیا همهی قابلیتهای Cursor با کلید شخصی کار میکند؟
خیر. بخشی از ویژگیها به مدلهای اختصاصی Cursor وابسته است. چت و ویرایش با مدل سفارشی معمولاً قابل استفاده است اما محدودیتها را در مستندات Cursor ببینید.
آیا میتوانم Claude را انتخاب کنم؟
بله، با اضافهکردن claude-sonnet-5-5 از همان مسیر OpenAI-سازگار.