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

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

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

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

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

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

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

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

Cursor در قابلیت‌های محلی چت و عامل خود، از کلید API شخصی شما برای استفاده از مدل‌های 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 نصب کنید. اینجا کلیک کنید (cursor:extension/openai.chatgpt)

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 آن کاربرد ندارند.