اتصال API هوش مصنوعی به VS Code و Cursor: راهنمای کامل دستیار کدنویسی

اگر برنامه‌نویس هستید، احتمالاً تا امروز دستیارهای هوش مصنوعی را در محیط کدنویسی دیده‌اید: ابزارهایی که کد را توضیح می‌دهند، تابع می‌نویسند، خطا را پیدا می‌کنند و حتی چند فایل را هم‌زمان ویرایش می‌کنند. بیشتر این ابزارها در نهایت به یک API هوش مصنوعی وصل می‌شوند. خبر خوب این است که بسیاری از آن‌ها اجازه می‌دهند کلید و آدرس سرویس دلخواه خودتان را وارد کنید. در این راهنما توضیح می‌دهیم چطور یک API Key سازگار با OpenAI را به VS Code، Cursor و ابزارهای خط فرمان وصل کنید، کدام مدل برای چه کاری مناسب‌تر است و چطور هزینه را کنترل کنید.

چرا دستیار کدنویسی را با API شخصی راه بیندازیم؟

بسیاری از دستیارهای کدنویسی اشتراک ماهانهٔ خودشان را دارند و پرداخت آن برای کاربر ایرانی معمولاً به کارت ارزی نیاز دارد. وقتی ابزار را با API شخصی راه می‌اندازید، چند مزیت مهم به دست می‌آورید:

• پرداخت به اندازهٔ مصرف: به‌جای هزینهٔ ثابت ماهانه، فقط به اندازهٔ توکن‌هایی که واقعاً مصرف کرده‌اید پرداخت می‌کنید.
• انتخاب آزاد مدل: می‌توانید برای کارهای سنگین از مدل‌های قوی‌تر و برای تکمیل کدهای ساده از مدل‌های سبک و ارزان استفاده کنید.
• یک کلید برای چند ابزار: همان کلیدی که در اسکریپت‌های پایتون استفاده می‌کنید، در افزونهٔ VS Code و ابزار خط فرمان هم کار می‌کند.
• شفافیت هزینه: مصرف هر روز و هر مدل را در پنل کاربری می‌بینید و غافلگیر نمی‌شوید.

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

پیش‌نیازها: سه مقداری که باید آماده داشته باشید

تقریباً همهٔ ابزارهایی که در ادامه معرفی می‌کنیم، برای اتصال به یک سرویس سازگار با OpenAI همین سه مقدار را می‌خواهند:

1. API Key: کلید اختصاصی شما که بعد از خرید در پنل کاربری الین لند نمایش داده می‌شود.
2. Base URL: آدرس پایهٔ سرویس که آن هم در پنل کاربری درج شده است. ابزار درخواست‌ها را به‌جای سرور پیش‌فرض به این آدرس می‌فرستد.
3. نام مدل (Model ID): شناسهٔ دقیق مدلی که می‌خواهید استفاده کنید. فهرست به‌روز مدل‌های فعال همیشه در پنل دیده می‌شود.

نکتهٔ مهم: کلید را فقط در تنظیمات محلی ابزار یا متغیرهای محیطی نگه دارید و هرگز آن را در مخزن گیت یا فایل‌های پروژه‌ای که با دیگران به اشتراک می‌گذارید قرار ندهید. جزئیات بیشتر را در راهنمای امنیت API Key توضیح داده‌ایم.

اتصال API به VS Code با افزونه‌های متن‌باز

VS Code به‌تنهایی دستیار هوش مصنوعی مستقل ندارد، اما چند افزونهٔ متن‌باز و محبوب امکان اتصال به هر سرویس سازگار با OpenAI را فراهم می‌کنند. دو گزینهٔ شناخته‌شده Continue و Cline هستند.

افزونهٔ Continue: گفتگو و تکمیل خودکار کد

Continue یک افزونهٔ متن‌باز برای VS Code و محیط‌های JetBrains است که پنجرهٔ گفتگو، ویرایش کد انتخاب‌شده و تکمیل خودکار را در اختیار شما می‌گذارد. پس از نصب افزونه از Marketplace، فایل تنظیمات آن را باز کنید و یک مدل با ارائه‌دهندهٔ openai تعریف کنید. نمونهٔ ساده‌ای از تنظیمات به شکل زیر است:

models:
  - name: Elin GPT
    provider: openai
    model: نام-مدل-از-پنل
    apiBase: آدرس-BASE_URL-از-پنل
    apiKey: کلید-API-شما
    roles:
      - chat
      - edit

ساختار فایل تنظیمات Continue در نسخه‌های مختلف ممکن است کمی تغییر کند؛ اگر فیلدها با نسخهٔ شما متفاوت بود، مستندات رسمی افزونه را ببینید. اصل ماجرا ثابت است: ارائه‌دهنده را openai بگذارید، آدرس پایه و کلید را وارد کنید و نام مدل را از پنل بردارید.

افزونهٔ Cline: دستیار ایجنتی برای کارهای چندمرحله‌ای

Cline افزونه‌ای است که فراتر از پیشنهاد کد عمل می‌کند: می‌تواند فایل بسازد، چند فایل را ویرایش کند و با اجازهٔ شما دستور ترمینال اجرا کند. برای اتصال آن به API شخصی:

1. افزونهٔ Cline را از Marketplace نصب کنید و پنل آن را از نوار کناری باز کنید.
2. در تنظیمات، ارائه‌دهندهٔ OpenAI Compatible را انتخاب کنید.
3. در فیلد Base URL آدرس پنل، در فیلد API Key کلید خود و در فیلد Model ID نام مدل را وارد کنید.
4. تنظیمات را ذخیره کنید و با یک درخواست ساده مثل «این تابع را توضیح بده» اتصال را آزمایش کنید.

ابزارهای ایجنتی مثل Cline در هر مرحله بخش زیادی از کد پروژه را برای مدل می‌فرستند؛ بنابراین مصرف توکن آن‌ها بیشتر از یک گفتگوی ساده است. در ادامه دربارهٔ کنترل این هزینه صحبت می‌کنیم.

استفاده از API شخصی در Cursor

Cursor یک ویرایشگر کد مبتنی بر VS Code است که هوش مصنوعی را در هستهٔ خود دارد. در بخش تنظیمات مدل‌های Cursor، گزینه‌ای برای وارد کردن کلید OpenAI و تغییر آدرس پایه (Override OpenAI Base URL) وجود دارد. مراحل کلی به این صورت است:

1. تنظیمات Cursor را باز کنید و به بخش Models بروید.
2. کلید API خود را در فیلد مربوط به OpenAI وارد کنید و گزینهٔ تغییر Base URL را فعال کنید.
3. آدرس پایهٔ پنل الین لند را وارد کنید و نام مدل موردنظر را به فهرست مدل‌ها اضافه کنید.
4. کلید را تأیید کنید و در پنجرهٔ گفتگو، مدل اضافه‌شده را انتخاب کنید.

توجه داشته باشید که همهٔ قابلیت‌های Cursor با کلید شخصی کار نمی‌کنند. برخی امکانات، مانند تکمیل خودکار اختصاصی، روی مدل‌های خود Cursor اجرا می‌شوند و جزئیات آن ممکن است با به‌روزرسانی‌های این ویرایشگر تغییر کند. اگر می‌خواهید همه‌چیز را با API خودتان کنترل کنید، افزونه‌های VS Code که بالاتر معرفی کردیم انعطاف بیشتری دارند.

ابزارهای خط فرمان: Aider و اسکریپت‌های شخصی

اگر بیشتر در ترمینال کار می‌کنید، Aider یکی از ابزارهای متن‌باز شناخته‌شده برای «برنامه‌نویسی جفتی» با هوش مصنوعی است. Aider روی مخزن گیت شما کار می‌کند، تغییرات را مستقیم در فایل‌ها اعمال و برای هر تغییر کامیت جداگانه ثبت می‌کند. برای اتصال آن به یک سرویس سازگار با OpenAI کافی است دو متغیر محیطی را تنظیم کنید:

export OPENAI_API_BASE="آدرس-BASE_URL-از-پنل"
export OPENAI_API_KEY="کلید-API-شما"
aider --model openai/نام-مدل-از-پنل

پیشوند openai/ به Aider می‌گوید که مدل را از طریق یک سرویس سازگار با OpenAI صدا بزند. همین الگو در بسیاری از ابزارهای دیگر هم کار می‌کند؛ هر جا گزینه‌ای مثل «OpenAI Compatible» یا «Custom Base URL» دیدید، می‌توانید از کلید الین لند استفاده کنید.

برخی ابزارها، مانند Claude Code، به‌طور پیش‌فرض با قالب اختصاصی API شرکت Anthropic کار می‌کنند و فقط با سرویس‌هایی که همان قالب را پشتیبانی کنند سازگارند. پیش از خرید، سازگاری ابزار موردنظرتان را با پشتیبانی بررسی کنید.

کدام مدل برای کدنویسی مناسب‌تر است؟

انتخاب مدل به نوع کار بستگی دارد و هیچ مدلی در همهٔ کارها بهترین نیست. یک تقسیم‌بندی کاربردی این است:

• کارهای پیچیده و چندفایلی: بازنویسی معماری، پیدا کردن باگ‌های دشوار و کارهای ایجنتی به مدل‌های قوی‌تر نیاز دارند. مدل‌های پرچم‌دار Claude و OpenAI در این دسته محبوب‌اند.
• توضیح کد و کارهای روزمره: برای نوشتن تست، توضیح یک تابع یا تبدیل کد بین زبان‌ها، مدل‌های اقتصادی‌تر مثل DeepSeek معمولاً کیفیت کافی را با هزینهٔ کمتر می‌دهند.
• کار با پروژه‌های بزرگ: مدل‌هایی با پنجرهٔ زمینهٔ بزرگ مانند Gemini برای خواندن فایل‌های طولانی و مستندات حجیم مناسب‌اند.
• پاسخ بسیار سریع: اگر سرعت برایتان مهم‌تر از عمق تحلیل است، مدل‌های متن‌باز روی زیرساخت سریع Groq گزینهٔ خوبی هستند.

اگر می‌خواهید چند مدل را با یک کلید امتحان کنید، اعتبار OpenRouter دسترسی به مدل‌های متعدد را از یک نقطه فراهم می‌کند. برای آشنایی بیشتر با تفاوت مدل‌ها مقالهٔ مقایسهٔ GPT، Claude و Gemini و مقایسهٔ DeepSeek و ChatGPT را بخوانید.

کنترل هزینه در دستیارهای کدنویسی

دستیارهای کدنویسی، به‌خصوص نوع ایجنتی، می‌توانند در مدت کوتاهی توکن زیادی مصرف کنند؛ چون علاوه بر سؤال شما، محتوای فایل‌ها، تاریخچهٔ گفتگو و خروجی ترمینال را هم برای مدل می‌فرستند. این عادت‌ها هزینه را منطقی نگه می‌دارد:

• زمینه را محدود کنید: فقط فایل‌های مرتبط را به گفتگو اضافه کنید و پوشه‌هایی مثل node_modules یا فایل‌های ساخته‌شده را کنار بگذارید.
• گفتگو را تازه کنید: وقتی موضوع کار عوض شد، یک گفتگوی جدید شروع کنید تا تاریخچهٔ طولانی دوباره ارسال نشود.
• مدل را با کار هماهنگ کنید: برای پرسش‌های ساده از مدل سبک و برای کارهای دشوار از مدل قوی استفاده کنید.
• درخواست دقیق بنویسید: درخواست مبهم باعث رفت‌وبرگشت‌های بیشتر می‌شود. نکات راهنمای پرامپت‌نویسی در اینجا هم کاربرد دارد.
• مصرف را پایش کنید: هر چند روز یک بار گزارش مصرف را در پنل ببینید تا الگوی هزینه دستتان بیاید.

رفع خطاهای رایج هنگام اتصال

• خطای 401: کلید اشتباه وارد شده یا فاصلهٔ اضافی در ابتدا یا انتهای آن کپی شده است.
• خطای 404 یا «مدل یافت نشد»: نام مدل دقیق نیست یا آدرس پایه کامل وارد نشده است. نام مدل را دقیقاً از پنل کپی کنید.
• خطای 429: به محدودیت نرخ درخواست رسیده‌اید یا اعتبار حساب تمام شده است.
• قطع شدن پاسخ‌های طولانی: مقدار حداکثر توکن خروجی در تنظیمات ابزار را بیشتر کنید.

برای آزمایش مستقل از ابزار، می‌توانید با چند خط پایتون یک درخواست ساده بفرستید؛ مراحل آن در راهنمای اتصال به API هوش مصنوعی با پایتون آمده است. اگر درخواست پایتون کار کرد ولی ابزار نه، مشکل در تنظیمات همان ابزار است.

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

آیا می‌توانم یک کلید را هم‌زمان در چند ابزار استفاده کنم؟

بله، از نظر فنی ممکن است. ولی برای امنیت و پیگیری مصرف بهتر است برای هر ابزار یا پروژه کلید جداگانه در نظر بگیرید تا اگر یکی از آن‌ها لو رفت، فقط همان را غیرفعال کنید.

آیا کد من برای سرویس هوش مصنوعی ارسال می‌شود؟

بله. دستیار کدنویسی برای تحلیل، بخش‌هایی از کد را برای مدل می‌فرستد. اطلاعات محرمانه مانند رمزها و کلیدهای دیگر را در کد قرار ندهید و فایل‌های حساس را از زمینهٔ ابزار خارج کنید.

برای شروع کدام ابزار را پیشنهاد می‌کنید؟

اگر VS Code دارید، Continue برای گفتگو و ویرایش کد شروع ساده‌ای است. اگر می‌خواهید هوش مصنوعی کارهای چندمرحله‌ای را انجام دهد، Cline را امتحان کنید و اگر در ترمینال راحت‌ترید، Aider انتخاب خوبی است.

چرا ابزار من خطای «مدل پشتیبانی نمی‌شود» می‌دهد؟

برخی ابزارها فقط نام‌های مشخصی را می‌شناسند یا برای قابلیت‌هایی مثل فراخوانی ابزار به مدلی نیاز دارند که آن قابلیت را پشتیبانی کند. مدلی را انتخاب کنید که در پنل فعال است و از قابلیت موردنیاز ابزار پشتیبانی می‌کند.

آیا با API شخصی هزینه کمتر از اشتراک ماهانه می‌شود؟

به حجم استفادهٔ شما بستگی دارد. برای استفادهٔ متوسط و نامنظم، پرداخت به اندازهٔ مصرف معمولاً به‌صرفه‌تر است؛ برای استفادهٔ بسیار سنگین روزانه، باید مصرف واقعی چند روز را بسنجید و بعد تصمیم بگیرید.

دستیار کدنویسی خودتان را بسازید. کلید API مدل‌های OpenAI، Claude، Gemini و DeepSeek را با پرداخت ریالی، تحویل فوری و پشتیبانی فارسی از فروشگاه الین لند تهیه کنید و همین امروز آن را به VS Code یا Cursor وصل کنید.