لم تتم ترجمة هذا المقال إلى هذه اللغة بعد؛ تشاهد النسخة الفارسية.

ادیتورت رو وصل کن: Cline توی VS Code

یاد بگیر Cline یا افزونهٔ رسمی Claude Code رو تو VS Code با کلیدت به بنفش وصل کنی و تو صفحهٔ مصرف خودت ببینی مصرفت ثبت شده — یا، اگه پلن پولی Cursor داری، از همون استفاده کنی.

چی یاد می‌گیری

یاد می‌گیری همون الگوی آدرس سرویس + کلید رو تو یه ادیتور گرافیکی هم پیاده کنی — تو VS Code، با افزونهٔ رسمی Claude Code یا با Cline. اگه پلن پولی Cursor رو داری، همین کلید اونجا هم کار می‌کنه (جزئیاتش پایین‌تر). همین‌جا با یه محدودیت واقعی هم آشنا می‌شی: بخشی از هر ادیتوری که مستقیم به سرورهای خودِ سازنده‌ش می‌زنه، از سرویس بنفش رد نمی‌شه. یکی رو انتخاب کن و درست راه‌بندازش، نه چندتا رو نصفه‌نیمه.

تمرین

اگه VS Code داری:

یکی از این دوتا رو انتخاب کن، بر اساس نوع کلیدت:

  • کلید اشتراک کدنویسی: افزونهٔ رسمی Claude Code رو نصب کن (از Marketplace یا لینک مستقیم تو VS Code). Command Palette رو باز کن («Preferences: Open User Settings (JSON)») — حتماً تنظیمات کاربر (User)، نه Workspace. تو «کلیدهای API» کارت Claude Code رو باز کن، سوییچ «VS Code» رو بزن، بلاک رو کپی و تو همون فایل بچسبون، ذخیره کن، و پنجره رو ری‌لود کن.
  • کلید پرداخت به‌اندازه‌ی مصرف: Cline رو نصب کن. دفعهٔ اول که باز می‌شه می‌پرسه چطور می‌خوای استفاده کنی — بزن «Bring my own API key» و Continue. تو «Configure your provider»، فیلد API Provider رو بنویس «OpenAI Compatible» (پیش‌فرضش چیز دیگه‌ایه، باید عوضش کنی) و سه مقدار رو از کارت Cline تو «کلیدهای API» کپی کن، بعد Continue رو بزن. توجه: Cline خودش فایل بازت رو نمی‌بینه، پس تو هر سؤالی اسم فایل رو هم بنویس.

اگه پلن پولی Cursor داری:

Cursor فقط با پلن پولی خودش اجازه‌ی کلید و آدرس دلخواه رو می‌ده؛ با پلن رایگان از Cline توی VS Code استفاده کن. اگه پلن پولی داری: برو Settings → Models و سه مقدار رو از کارت Cursor تو «کلیدهای API» وارد کن (آدرس سرویس، کلید، شناسهٔ مدل). اگه فیلد («Override OpenAI Base URL») رو ندیدی، ممکنه پلن یا نسخهٔ Cursorت این امکان رو نداشته باشه — همین کلید رو تو یکی از مسیرهای VS Code بالای همین صفحه بذار.

یه مخزن واقعی باز کن، یه فایل رو باز کن، و تو سؤالت اسمِ همون فایل رو هم بنویس — مثلاً «src/api.ts چیکار می‌کنه؟». اگه جواب گرفتی، وصلی. اگه خواستی، چند دقیقه بعد یه نگاه هم به «مصرف» بنداز: شاید عدد ستون «توکن» تو ردیف «کد و ابزارها (IDE/CLI)» بالا رفته باشه — ولی اگه عوض نشده بود نگران نباش، گاهی دیر می‌رسه یا صفر می‌مونه.

این تمرین معمولاً یه کم از سهم اشتراک کدنویسی‌ات یا یه مبلغ کوچیک از کیف پولت (پرداخت به‌اندازه‌ی مصرف) می‌گیره.

کی تمومه؟

  • ادیتورت جواب یه سؤال درباره‌ی فایل بازِ خودت رو داد.

چی کار نمی‌کنه

VS Code: اگه با افزونهٔ Claude Code درخواست ورود با حساب اومد، یعنی بلاک تو فایل تنظیمات کاربر نرفته یا پنجره ری‌لود نشده. اگه به‌جای این دوتا از GitHub Copilot استفاده می‌کنی، تکمیل خودکار خودِ Copilot از بنفش استفاده نمی‌کنه (فقط چت و agent)؛ راه‌اندازیش تو کارت GitHub Copilot تو «کلیدهای API»ه، جدا از این درس.

Cursor: حتی با پلن پولی، این مسیر فقط برای Chat و Agent کار می‌کنه، از راه «Override OpenAI Base URL». تکمیل خودکار Tab خودِ Cursor از بنفش استفاده نمی‌کنه، و تا این override روشنه مدل‌های خودِ Cursor (مثل Composer) کار نمی‌کنن.

عادت ارزون‌نگه‌داشتن

فقط فایل‌هایی که واقعاً لازمه رو تو context بذار، نه کل مخزن. context کم یعنی درخواست کم‌هزینه و سریع.