اگر با VS Code کار می‌کنی اما از پرش مداوم بین ادیتور، چت‌بات و مستندات خسته شده‌ای، Cursor AI همان چیزی است که ورق را برمی‌گرداند؛ یک فورک هوشمند از VS Code که هوش مصنوعی را نه به‌عنوان افزونه، بلکه در قلب ادیتور جاسازی کرده است. در این راهنما یاد می‌گیری چطور Cursor را در کمتر از ۵ دقیقه نصب کنی، با قابلیت‌های Tab، Chat، Composer و اتصال به مستندات، سرعت کدنویسی‌ات را تا دو برابر افزایش دهی و از خطاهای رایج پیشگیری کنی.

پاسخ سریع: Cursor AI چیست و چرا باید از آن استفاده کنی؟

Cursor AI یک ادیتور کد مبتنی بر VS Code است که مدل‌های GPT-4o و Claude 3.5 را مستقیماً داخل ادیتور اجرا می‌کند؛ با Tab هوشمند کدهای چندخطی را پیش‌بینی می‌کند، با Chat متصل به کل کدبیس جواب متنی می‌دهد و با Composer چند فایل را هم‌زمان می‌سازد یا ریفکتور می‌کند. اگر می‌خواهی بدون کپی‌پیست بین مرورگر و ادیتور، سریع‌تر و دقیق‌تر کد بزنی، ادامه این آموزش قدم‌به‌قدم را بخوان.

Cursor AI چیست و چه فرقی با VS Code دارد؟

Cursor از نظر ظاهری همان VS Code محبوب است، اما زیر کاپوت تفاوت بزرگی دارد: هوش مصنوعی به‌صورت native ادغام شده و به کل پروژه‌ات دسترسی متنی دارد، نه فقط فایل باز. یعنی می‌تواند با فهم ساختار پوشه‌ها، ایمپورت‌ها و حتی فایل‌های تست، پیشنهادهایی بدهد که Copilot معمولی نمی‌دهد.

معماری فورک VS Code و حفظ اکوسیستم اکستنشن‌ها

چون Cursor فورک مستقیم VS Code است، تمام اکستنشن‌های Marketplace، تنظیمات settings.json، تم‌ها و میانبرهای کیبوردت بدون تغییر باقی می‌ماند. کافی است پوشه .vscode را منتقل کنی و همان تجربه آشنا را با لایه هوش مصنوعی داشته باشی. این مزیت برای تیم‌هایی که روی ESLint، Prettier یا پایپ‌لاین CI/CD با GitHub Actions استاندارد شده‌اند، حیاتی است چون نیازی به بازآموزی نیست.

تفاوت Cursor و GitHub Copilot در یک نگاه

هر دو تکمیل خودکار دارند، اما تفاوت در عمق است. Copilot بیشتر تک‌خط یا تک‌بلوک پیشنهاد می‌دهد و برای تغییرات چندفایلی باید خودت دستی اعمال کنی. در مقابل، Cursor با Composer می‌تواند یک فیچر کامل را در ۳ فایل بسازد، تست بنویسد و حتی کامیت پیشنهادی بدهد، آن هم با درک زمینه کل پروژه.

Copilot: پیشنهاد سریع، بدون درک عمیق کل ریپازیتوری، نیاز به کپی‌پیست چت خارجی
Cursor: چت متصل به کدبیس + ویرایش مستقیم فایل‌ها + حافظه از سوال‌های قبلی
حریم خصوصی: هر دو حالت Privacy Mode دارند، اما Cursor به‌صورت پیش‌فرض کد را برای آموزش مدل ذخیره نمی‌کند

نصب و راه‌اندازی اولیه Cursor AI در ویندوز، مک و لینوکس

نصب Cursor به سادگی نصب VS Code است و کمتر از ۲۰۰ مگابایت حجم دارد. نکته کلیدی انتخاب مدل و مدیریت هزینه است.

دانلود و نصب در ۲ دقیقه

به سایت رسمی cursor.sh برو و نسخه سیستم‌عاملت را دانلود کن (ویندوز exe، مک dmg، لینوکس AppImage).
نصب را اجرا کن و در اولین اجرا گزینه Import from VS Code را بزن تا اکستنشن‌ها و تنظیمات منتقل شوند.
وارد حساب Cursor شو. پلن رایگان ۵۰ درخواست کند و ۲۰۰۰ تکمیل Tab در ماه می‌دهد؛ برای استفاده نامحدود از GPT-4o و Claude باید پلن Pro را فعال کنی.

ورود، تنظیم مدل و کلید API

از منوی Cursor Settings > Models می‌توانی مدل پیش‌فرض را انتخاب کنی. پیشنهاد حرفه‌ای‌ها: Claude 3.5 Sonnet برای ریفکتور و معماری و GPT-4o برای تولید سریع کدهای تکراری. اگر کلید OpenAI خودت را داری، می‌توانی Bring Your Own Key را فعال کنی تا هزینه مستقیماً از حساب خودت کسر شود. حتماً Privacy Mode را روشن بگذار اگر روی کد محرمانه کار می‌کنی.

شروع سریع؛ اولین پروژه با Cursor AI

بیایید یک اسکریپت پایتون ساده بسازیم تا قدرت Chat و Composer را ببینی. این مثال با همان منطق آموزش AsyncIO برای اجرای هم‌زمان تسک‌ها هم قابل توسعه است.

ساخت پروژه ساده پایتون و درخواست از چت

یک پوشه جدید بساز و فایل app.py را باز کن. کلید میانبر Ctrl+L را بزن تا پنل Chat باز شود و بنویس:

یک اسکریپت پایتون بنویس که قیمت بیت‌کوین را از API کوین‌گکو بگیرد و هر ۶۰ ثانیه در یک فایل CSV ذخیره کند. از aiohttp و asyncio استفاده کن و هندل خطا داشته باش.

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

استفاده از Composer برای تغییرات چندفایلی

حالا Ctrl+I را بزن تا Composer باز شود. دستور بده:

این اسکریپت را به دو فایل تقسیم کن: fetcher.py برای منطق API و main.py برای حلقه اصلی. یک تست pytest هم برای fetcher بساز.

Cursor سه فایل جدید می‌سازد، ایمپورت‌ها را اصلاح می‌کند و تست را با pytest قابل اجرا تحویل می‌دهد. این همان نقطه‌ای است که Copilot کم می‌آورد و Cursor می‌درخشد.

۴ قابلیت کلیدی Cursor که سرعت شما را دو برابر می‌کند

برای اینکه از حالت تازه‌کار به حرفه‌ای بروی، این چهار ابزار را هر روز تمرین کن.

۱. Tab هوشمند؛ پیش‌بینی چندخطی واقعی

برخلاف تکمیل تک‌خطی، Cursor می‌تواند تا ۱۵ خط بعدی را با درک تابع فعلی پیش‌بینی کند. وقتی حلقه یا کلاس می‌نویسی، فقط Tab را بزن. اگر پیشنهاد دقیق نبود، Esc بزن تا مدل دوباره حدس بزند. در تجربه تیم ما، Tab حدود ۳۰٪ زمان تایپ را کاهش می‌دهد.

۲. چت متصل به کدبیس (Ctrl+K / Ctrl+L)

Ctrl+K: ویرایش سریع داخل فایل فعلی؛ مثلاً «این تابع را به TypeScript تایپ‌دار تبدیل کن»
Ctrl+L: چت کلی؛ سوال بپرس «کجای پروژه خطای N+1 کوئری داریم؟» و Cursor با ارجاع به فایل و خط دقیق جواب می‌دهد
@Files / @Folder / @Codebase: با این منشن‌ها دامنه جستجو را محدود کن تا جواب دقیق‌تر شود

۳. Composer؛ عامل خودکار چندفایلی

Composer مثل یک جونیور دولوپر است که دستورات مبهم را به تغییرات دقیق تبدیل می‌کند. برای ریفکتور بزرگ، اول از حالت Agent استفاده کن تا فایل‌ها را بخواند، سپس اجازه بده خودش فایل‌ها را ویرایش کند. همیشه قبل از Accept All تفاوت‌ها را در پنل Diff مرور کن.

۴. Docs و Web؛ اتصال مستندات و اینترنت

از @Docs می‌توانی مستندات Next.js، LangChain یا FastAPI را اضافه کنی تا جواب‌ها بر اساس آخرین داکیومنت باشد، نه حافظه قدیمی مدل. با @Web هم می‌توانی باگ جدید یک کتابخانه را جستجو کنی و راه‌حل به‌روز بگیری.

ترفندهای حرفه‌ای برای نتیجه دقیق‌تر

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

زمینه بده، نه فقط دستور: به‌جای «این کد را بهینه کن» بنویس «این تابع O(n²) است، آن را با هش‌مپ به O(n) تبدیل کن و بنچمارک بگذار»
فایل نمونه نشان بده: با @Files یک فایل مرجع که استایل کدنویسی‌ات را نشان می‌دهد، به مدل معرفی کن
از .cursorrules استفاده کن: فایلی به نام .cursorrules در ریشه پروژه بساز و قوانین کلی مثل «از type hints پایتون استفاده کن، کامنت فارسی ننویس، تست‌ها با pytest» را بنویس تا همیشه رعایت شود
تکه‌تکه بخواه: به‌جای درخواست «یک اپ کامل بساز»، مرحله‌به‌مرحله جلو برو: اول مدل داده، بعد API، بعد فرانت

مقایسه Cursor با ابزارهای مشابه

برای انتخاب نهایی، این جدول را ذخیره کن:

ابزار	نقطه قوت	ضعف اصلی	هزینه ماهانه	بهترین برای
Cursor AI	چت متصل به کدبیس + Composer چندفایلی	مصرف توکن بالا در پروژه بزرگ	رایگان / ۲۰ دلار Pro	پروژه‌های واقعی چندفایلی
GitHub Copilot	ادغام عمیق با گیت‌هاب و VS Code	بدون ویرایش خودکار چندفایلی	۱۰ دلار	تکمیل سریع روزمره
Windsurf (Codeium)	رایگان سخاوتمندانه	دقت کمتر در ریفکتور بزرگ	رایگان / ۱۰ دلار	دانشجویان و پروژه‌های کوچک
VS Code بدون AI	سبک و بدون وابستگی	بدون کمک هوش مصنوعی	رایگان	محیط‌های امن بدون اینترنت

خطاهای رایج و راه‌حل سریع

پیشنهاد Tab بی‌ربط می‌دهد: فایل‌های بلااستفاده را ببند، از @Codebase با فیلتر پوشه استفاده کن و .cursorignore بساز تا node_modules ایندکس نشود.
Composer فایل را خراب کرد: همیشه قبل از Accept، از Git یک شاخه جدید بساز. Cursor دکمه Reject و Undo هم دارد.
مدل کند است: در Settings مدل را به cursor-small برای کارهای ساده تغییر بده و برای تسک سنگین به Claude برگرد.
جواب فارسی ناقص است: پرامپت را انگلیسی بنویس اما بخواه کامنت‌ها فارسی باشد؛ دقت مدل انگلیسی ۲۰٪ بالاتر است.

جمع‌بندی؛ آیا مهاجرت به Cursor می‌ارزد؟

اگر روزانه بیش از ۲ ساعت کدنویسی می‌کنی، جواب کوتاه بله است. Cursor نه‌تنها Tab و چت را به داخل ادیتور آورده، بلکه با Composer و اتصال به Docs، چرخه فکر-کد-تست را کوتاه کرده است. با پلن رایگان شروع کن، یک هفته روی پروژه واقعی تست کن و سپس تصمیم بگیر. به‌عنوان قدم بعدی، پیشنهاد می‌کنیم سراغ اجرای هم‌زمان تسک‌ها با AsyncIO بروی و همان اسکریپت قیمت بیت‌کوین را با Cursor بهینه کنی تا تفاوت سرعت را لمس کنی.

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

آیا Cursor AI رایگان است؟

بله، نسخه رایگان شامل حدود ۵۰ درخواست کند به مدل‌های پیشرفته و ۲۰۰۰ تکمیل Tab در ماه است. برای استفاده نامحدود از GPT-4o و Claude 3.5 و ویژگی Composer بدون محدودیت، پلن Pro ماهانه ۲۰ دلار فعال می‌شود. برای دانشجویان و پروژه‌های شخصی نسخه رایگان کاملاً کافی است.

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

در حالت Privacy Mode که به‌صورت پیش‌فرض روشن است، کد شما برای آموزش مدل ذخیره نمی‌شود و پس از پردازش حذف می‌گردد. همچنین می‌توانی با .cursorignore پوشه‌های حساس مثل .env را از ایندکس خارج کنی. برای پروژه‌های سازمانی، نسخه Business با قرارداد عدم نگهداری داده ارائه می‌شود.

برای کار تیمی بهتر است Cursor بمانیم یا VS Code + Copilot؟

اگر تیم‌تان زیاد ریفکتور چندفایلی و تولید فیچر از صفر دارد، Cursor به‌خاطر Composer و چت متصل به کدبیس بهره‌وری بالاتری دارد. اما اگر سازمان شما روی اکوسیستم گیت‌هاب Copilot Enterprise استاندارد شده و نیاز به ادمین مرکزی دارد، Copilot انتخاب محافظه‌کارانه‌تری است. بسیاری از تیم‌ها به‌صورت هیبریدی هر دو را نگه می‌دارند.

آموزش Cursor AI از صفر تا حرفه‌ای؛ کدنویسی سریع‌تر با هوش مصنوعی در ادیتور