آموزش‌ها / آموزش Cursor با API سفارشی و Base URL دلخواه

آموزش Cursor با API سفارشی و Base URL دلخواه

به‌روزرسانی: 2026-10-06

Cursor یک ویرایشگر کد مبتنی بر VS Code با قابلیت‌های هوش مصنوعی داخلی است. تنظیم مدل سفارشی در Cursor فقط از صفحهٔ Settings خودش انجام می‌شود، پس اتصال آن به llmapi دستی است؛ حدود یک دقیقه طول می‌کشد.

دستور یک‌خطی برای Cursor چه می‌کند؟

دستور راه‌اندازی llmapi Cursor را خودکار تنظیم نمی‌کند، اما اگر بخواهید می‌تواند مراحل را با کلید و مدل خودتان چاپ کند (macOS/Linux):

curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only cursor

دستور کامل (برای ابزارهای دیگری که روی سیستم دارید، مثل Claude Code یا Codex):

curl -fsSL https://llmapi.cheap/install.sh | sh

irm https://llmapi.cheap/install.ps1 | iex

راه‌اندازی دستی

  1. در Cursor به Settings → Models بروید.
  2. در بخش OpenAI API Key کلید llmapi را وارد کنید.
  3. گزینهٔ Override OpenAI Base URL را فعال کنید و آدرس را وارد کنید.
  4. یک مدل سفارشی با شناسهٔ مدل llmapi اضافه کنید.
Base URL:  https://llmapi.cheap/v1
API Key:   YOUR_API_KEY
Model:     gemini-3.8-flash-high

Cursor درخواست‌ها را از سرورهای خودش می‌فرستد و این روش با llmapi کار می‌کند.

Cursor با llmapi چه کارهایی می‌کند و چه کارهایی نه؟

  • کار می‌کند: چت با مدل‌های llmapi داخل Cursor.
  • کار نمی‌کند: قابلیت‌های ایجنتی اختصاصی Cursor به سرورهای خود Cursor نیاز دارند. Cursor CLI و Background Agents هم امکان تنظیم endpoint سفارشی ندارند.

اگر یک ایجنت کامل با llmapi می‌خواهید، می‌توانید افزونه‌هایی مثل Cline، Roo Code یا Kilo Code را داخل Cursor نصب کنید، یا Claude Code را در ترمینال Cursor اجرا کنید.

تغییر مدل

در Settings → Models مدل سفارشی دیگری اضافه کنید، مثلاً gemini-3.1-pro-high یا (در پلن‌های پولی) claude-sonnet-4-6، و از انتخابگر مدل چت آن را برگزینید.

مشکلات رایج

  • خطای 404 یا «invalid model»: Base URL باید دقیقاً https://llmapi.cheap/v1 باشد و نام مدل یکی از شناسه‌های llmapi.
  • کلید رد می‌شود: گزینهٔ Override OpenAI Base URL را فعال کرده‌اید؟ بدون آن، Cursor کلید را برای OpenAI می‌فرستد.
  • مدل Claude کار نمی‌کند: در دورهٔ آزمایشی فقط مدل‌های Gemini فعال‌اند.

سؤالات متداول

آیا Agent mode کرسر با llmapi کار می‌کند؟

قابلیت‌های ایجنتی اختصاصی Cursor به سرورهای Cursor وابسته‌اند. برای کار ایجنتی با llmapi، Cline یا Claude Code داخل Cursor گزینهٔ مطمئن‌تری است.

Cursor CLI را هم می‌شود وصل کرد؟

نه. Cursor CLI و Background Agents تنظیم endpoint سفارشی ندارند.

چرا دستور یک‌خطی Cursor را خودکار تنظیم نمی‌کند؟

چون Cursor تنظیمات مدل را فقط از صفحهٔ Settings خودش می‌پذیرد.

شروع کنید

ثبت‌نام کنید، کلید API را از داشبورد کپی کنید و در Cursor بگذارید. یک ساعت آزمایش رایگان با ۲ میلیون کردیت روی مدل‌های Gemini دارید.