OpenAI
این صفحه به‌صورت ماشینی ترجمه شده است. مقاله اصلی انگلیسی را مشاهده کنید.

استفاده از مدل‌های OpenAI در Cursor

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

به‌روزرسانی: 3 hours ago

OpenAI قصد دارد به قرارداد ارائه مدل‌های OpenAI به Cursor به‌تدریج پایان دهد. ما یک دوره گذار تا ۱۲ نوامبر ۲۰۲۶ پیشنهاد کرده‌ایم. در این دوره، دسترسی Cursor به مدل‌های OpenAI که اکنون استفاده می‌کند ادامه خواهد داشت. ممکن است Cursor تصمیم بگیرد این دسترسی را زودتر قطع کند. به‌محض اینکه هر دو شرکت تاریخ رسمی پایان قرارداد را تأیید کنند، آن را اعلام خواهیم کرد.

برای ادامه استفاده از مدل‌های OpenAI در برنامه Cursor، گزینه‌ای را انتخاب کنید که بیشترین تناسب را با روند کاری شما دارد:

  • از کلید API خودتان برای OpenAI استفاده کنید — استفاده از مدل‌های OpenAI را در قابلیت‌های محلی چت و عامل در Cursor ادامه دهید؛ هزینه‌ها بر اساس تعرفه‌های API شرکت OpenAI محاسبه می‌شوند.

  • از افزونه Codex برای IDE استفاده کنید — با اشتراک ChatGPT یا یک کلید API برای OpenAI، مستقیماً در Cursor از Codex استفاده کنید.

  • از یک ارائه‌دهنده درگاه هوش مصنوعی استفاده کنید — از طریق حسابتان نزد یک ارائه‌دهنده سازگار مانند Amazon Bedrock،‏ Azure یا درگاه دیگری که با OpenAI سازگار است، Cursor را به مدل‌های OpenAI متصل کنید.

راهنمای زیر کلی است و Cursor ممکن است با گذشت زمان، عملکرد و دسترس‌پذیری این قابلیت‌ها را تغییر دهد. برای دریافت تازه‌ترین اطلاعات، به مستندات رسمی Cursor مراجعه کنید. 

این گزینه‌ها برای کار به‌صورت محلی در برنامهٔ دسکتاپ Cursor هستند. Cursor از قابلیت «استفاده از کلید شخصی» در Cursor Tab، حالت خودکار، عامل‌های ابری یا پس‌زمینه، خودکارسازی‌ها، رابط خط فرمان Cursor یا API و SDK ‏Cursor پشتیبانی نمی‌کند. این قابلیت‌ها از مدل‌هایی استفاده می‌کنند که Cursor آن‌ها را ارائه می‌دهد یا درخواست‌ها را به آن‌ها هدایت می‌کند؛ بنابراین نمی‌توانند از کلید API ‏OpenAI یا اطلاعات احراز هویت درگاه شما استفاده کنند.

استفاده از کلید API ‏OpenAI خودتان

Cursor در قابلیت‌های محلی چت و عامل، از کلید API ‏OpenAI خودتان برای استفاده از مدل‌های OpenAI پشتیبانی می‌کند. درخواست‌ها از طریق حساب API ‏OpenAI شما ارسال می‌شوند و هزینهٔ آن‌ها جدا از اشتراک Cursor یا ChatGPT شما محاسبه می‌شود.

برای تنظیم کلید خود:

  1. یک کلید API ‏OpenAI ایجاد کنید. برای دسترسی به API، به یک حساب API ‏OpenAI با تنظیمات پرداخت تکمیل‌شده نیاز دارید.

  2. تنظیمات Cursor را باز کنید، سپس مدل‌ها را انتخاب کنید.

  3. گزینهٔ تنظیم کلید API ‏OpenAI را پیدا کنید، کلید خود را جای‌گذاری کنید و آن را ذخیره یا تأیید کنید.

  4. مدل OpenAI موردنظر خود را فعال کنید.

  5. آن مدل را در بخش چت یا عامل Cursor انتخاب کنید.

مدل‌های در دسترس و سقف استفاده به سازمان شما در API ‏OpenAI بستگی دارند.

کلید API ‏OpenAI شما فقط برای درخواست‌های محلیِ پشتیبانی‌شدهٔ چت و عامل کاربرد دارد. این کلید در موارد زیر قابل استفاده نیست:

  • Cursor Tab و تکمیل خودکار

  • انتخاب مدل و مسیریابی درخواست‌ها در حالت خودکار

  • عامل‌های ابری یا پس‌زمینه

  • خودکارسازی‌ها

  • رابط خط فرمان Cursor

  • API یا SDK ‏Cursor

  • مدل‌های ارائه‌شده توسط Cursor یا مدل‌های اختصاصی

اشتراک ChatGPT شامل استفاده از API ‏OpenAI نمی‌شود. اگر از کلید API استفاده کنید، هزینهٔ استفاده از طریق حساب API ‏OpenAI شما محاسبه می‌شود.

استفاده از افزونهٔ IDE ‏Codex در Cursor

افزونهٔ IDE ‏Codex به شما امکان می‌دهد مستقیماً در Cursor از عامل Codex استفاده کنید. این افزونه به‌صورت مستقل اجرا می‌شود و لازم نیست مدل‌های OpenAI در انتخابگر مدل خودِ Cursor در دسترس باشند.

برای شروع:

  1. صفحهٔ افزونهٔ IDE ‏Codex را از پیوند بالا باز کنید و برای نصب افزونه، Cursor را انتخاب کنید.

  2. Codex را از نوار فعالیت باز کنید.

  3. برای استفاده از اشتراک واجد شرایط ChatGPT، گزینهٔ ورود با ChatGPT را انتخاب کنید یا برای استفاده از حساب API ‏OpenAI، گزینهٔ استفاده از کلید API را انتخاب کنید.

  4. پروژهٔ خود را باز کنید و از پنل Codex یک کار را شروع کنید.

می‌توانید با استفاده از تنظیمات چیدمان Cursor، پنل Codex را به سمت راست ویرایشگر منتقل کنید. نوار کناری دوم را از منوی نمایش > ظاهر فعال کنید، سپس نمای Codex را به داخل آن بکشید.

افزونهٔ Codex محیط مستقلی برای کار با عامل خود در Cursor فراهم می‌کند. این افزونه مدل مورد استفاده در چت، عامل، Tab، حالت خودکار، عامل‌های ابری یا سایر سرویس‌های Cursor را تغییر نمی‌دهد. برای آشنایی با روش‌های ورود موجود، به احراز هویت Codex مراجعه کنید.

استفاده از ارائه‌دهندهٔ درگاه هوش مصنوعی

همچنین می‌توانید Cursor را از طریق یک درگاه هوش مصنوعی یا ارائه‌دهندهٔ میزبانی سازگار به مدل‌های OpenAI متصل کنید. اگر سازمان شما از قبل دسترسی به مدل‌ها و صورتحساب‌ها را از طریق Amazon Bedrock،‏ Azure یا درگاه دیگری مدیریت می‌کند، این روش می‌تواند مفید باشد.

Cursor می‌تواند از طریق تنظیمات ویژهٔ ارائه‌دهنده یا یک نشانی پایهٔ سفارشی سازگار با OpenAI متصل شود. سرویس‌هایی مانند OpenRouter یا Vercel AI Gateway ممکن است با پیکربندی یک API سازگار کار کنند، اما مدل‌ها و قابلیت‌های در دسترس به ارائه‌دهنده بستگی دارند.

جزئیات پیکربندی متفاوت است، اما مراحل کلی راه‌اندازی به این صورت است:

  1. مدل OpenAI را در سرویس ارائه‌دهندهٔ خود راه‌اندازی کنید.

  2. اطلاعات احراز هویت، نقطه پایان و نام مدل یا استقرار موردنیاز را ایجاد کنید.

  3. تنظیمات Cursor را باز کنید، سپس مدل‌ها را انتخاب کنید.

  4. گزینهٔ اتصال به ارائه‌دهنده را انتخاب کنید یا تنظیمات API ‏OpenAI را با نشانی پایهٔ سفارشی درگاه پیکربندی کنید.

  5. نقطه پایان و اطلاعات احراز هویتی را که ارائه‌دهنده در اختیار شما گذاشته است وارد کنید.

  6. مدل مربوطه را در Cursor اضافه یا فعال کنید.

  7. مدل را در یک نشست محلی چت یا عامل آزمایش کنید.

برای Amazon Bedrock، به استفاده از مدل‌های OpenAI با Amazon Bedrock مراجعه کنید.

میزان سازگاری درگاه‌ها متفاوت است. نقطه پایان سفارشی باید از قالب API مورد انتظار Cursor پشتیبانی کند. همچنین ممکن است برخی تنظیمات ویژهٔ مدل در دسترس نباشند یا از طریق نشانی پایهٔ سفارشی به مدل منتقل نشوند. اطلاعات احراز هویت درگاه نیز فقط برای درخواست‌های محلیِ پشتیبانی‌شدهٔ چت و عامل کاربرد دارد و در Cursor Tab، حالت خودکار، عامل‌های ابری یا پس‌زمینه، خودکارسازی‌ها، رابط خط فرمان Cursor یا API و SDK ‏Cursor قابل استفاده نیست.

آیا این مقاله مفید بود؟