اگر توسعهدهنده هستید و هنوز با VS Code ساده کد میزنید، احتمالاً متوجه شدهاید که همکارانتان سریعتر از شما کار تحویل میدهند. راز آنها یک ابزار است: Cursor. ویرایشگر کدی که هوش مصنوعی را نه بهعنوان یک افزونه جانبی، بلکه بهعنوان هسته اصلی تجربه کدنویسی ادغام کرده.
در این راهنما توضیح میدهیم Cursor دقیقاً چیست، چه تفاوتی با GitHub Copilot و سایر ابزارها دارد، و چطور میتوانید از امروز شروع به استفاده کنید.
Cursor دقیقاً چیست
Cursor یک ویرایشگر کد (IDE) است که روی پایه VS Code ساخته شده — یعنی همان ظاهر، همان اکستنشنها، همان شورتکاتها — ولی با یک تفاوت بنیادی: هوش مصنوعی در هر لایه آن حضور دارد.
وقتی در Cursor کد مینویسید:
- AI خط بعدی را پیشنهاد میدهد (مثل Copilot، ولی با context بیشتر)
- میتوانید با AI چت کنید و بگویید «این فانکشن را ریفکتور کن» یا «یک API endpoint برای ثبتنام بنویس»
- AI کل پروژه شما را میفهمد — نه فقط فایل فعلی، بلکه ساختار پوشهها، import ها، تایپها و وابستگیها
- میتوانید باگ را توضیح دهید و AI مستقیماً فایلهای مربوطه را پیدا و اصلاح کند
فرق اصلی با «افزودن Copilot به VS Code»: Cursor codebase-aware است. وقتی سؤال میپرسید، AI فقط فایل باز را نمیبیند — کل پروژه را ایندکس کرده و context کامل دارد.
چرا توسعهدهندگان مهاجرت کردهاند
در نظرسنجی Stack Overflow 2025، ۳۸٪ توسعهدهندگان حرفهای گفتند از یک AI-native IDE استفاده میکنند. دلایل اصلی:
۱. سرعت. کارهایی که قبلاً ۳۰ دقیقه طول میکشید (نوشتن تست، ریفکتور، ساخت boilerplate) حالا ۲-۳ دقیقه طول میکشد.
۲. Context switching کمتر. دیگر نیازی نیست بین IDE و ChatGPT/Claude رفتوبرگشت کنید. AI همینجا در ویرایشگر است و کد شما را میبیند.
۳. یادگیری سریعتر. اگر وارد codebase جدیدی شدید، میتوانید از AI بپرسید «این فایل چه کار میکند؟» یا «data flow از فرانت تا دیتابیس چطور است؟» و جواب دقیق بگیرید.
۴. کیفیت کد. AI الگوهای بد را شناسایی میکند و جایگزین بهتر پیشنهاد میدهد. مثل یک code reviewer که ۲۴ ساعته کنارتان نشسته.
شروع کار با Cursor — گام به گام
۱. نصب
Cursor را از cursor.com دانلود کنید. نسخههای Windows، macOS و Linux موجود است. حجم نصب مشابه VS Code است (~300 MB).
اگر قبلاً VS Code داشتید، Cursor هنگام نصب میپرسد آیا تنظیمات، اکستنشنها و تم VS Code را import کند. بگویید بله — همه چیز منتقل میشود.
۲. اشتراک
Cursor سه پلن دارد:
- Free — ۲۰۰۰ completion + ۵۰ درخواست چت در ماه. برای امتحان کافی است.
- Pro ($20/ماه) — نامحدود completion، ۵۰۰ درخواست Fast (GPT-4/Claude)، unlimited Slow
- Business ($40/کاربر/ماه) — برای تیمها، admin panel، privacy mode
برای کاربر ایرانی، پرداخت مستقیم ممکن نیست. از طریق راها با تومان یا تتر اشتراک بگیرید.
۳. اولین استفاده
پروژه خود را باز کنید. سه راه اصلی تعامل با AI:
Tab completion — همانطور که تایپ میکنید، AI خط یا بلوک بعدی را پیشنهاد میدهد. Tab بزنید برای قبول.
Cmd+K (Inline Edit) — کد را انتخاب کنید، Cmd+K بزنید، و بگویید چه تغییری میخواهید. مثلاً: «این فانکشن را async کن» یا «error handling اضافه کن».
Cmd+L (Chat) — پنل چت باز میشود. اینجا میتوانید سؤالات پیچیده بپرسید، کد جدید بخواهید، یا دیباگ کنید. AI کل پروژه را context دارد.
قابلیتهای کلیدی
Codebase Indexing
وقتی پروژه را باز میکنید، Cursor تمام فایلها را ایندکس میکند. این یعنی وقتی میپرسید «فانکشنهایی که از دیتابیس read میکنند کجا هستند؟» — AI واقعاً میداند، نه حدس میزند.
Multi-file Editing
میتوانید بگویید «نام این interface را از UserData به UserProfile تغییر بده، همه جا» و Cursor تمام فایلهای مرتبط را پیدا و اصلاح میکند — import ها، type reference ها، تستها، همه.
@ References
در چت میتوانید با @ به فایلها، فولدرها، یا حتی documentation خارجی اشاره کنید:
@filename.ts— این فایل را ببین@folder/— این پوشه را context بگیر@docs— documentation پروژه را بخوان@web— اینترنت را جستجو کن
Composer (Agent Mode)
قویترین قابلیت Cursor. در Composer mode، AI مثل یک توسعهدهنده مستقل عمل میکند:
- شما task را توضیح میدهید: «یک صفحه login بساز با email/password، validation، و redirect به dashboard»
- AI برنامهریزی میکند: چه فایلهایی باید ساخته شود، چه تغییراتی لازم است
- AI کد را مینویسد — چندین فایل همزمان
- شما diff را review میکنید و Accept/Reject میزنید
این برای task های بزرگتر (ساخت feature کامل، migration، refactor بزرگ) فوقالعاده مفید است.
Terminal Integration
Cursor میتواند دستورات ترمینال هم اجرا کند. اگر بگویید «پروژه را ران کن و ببین چه اروری میده»، AI دستور مناسب را اجرا میکند، خروجی را میخواند، و راهحل پیشنهاد میدهد.
Cursor در مقابل رقبا
| ویژگی | Cursor Pro | GitHub Copilot | Windsurf | Replit Agent |
|---|---|---|---|---|
| پایه | VS Code fork | افزونه VS Code | VS Code fork | IDE اختصاصی |
| Codebase awareness | کامل | محدود | کامل | کامل |
| Multi-file edit | بله | محدود | بله | بله |
| Agent mode | بله (Composer) | بله (Workspace) | بله (Cascade) | بله |
| مدلهای AI | GPT-4, Claude, custom | GPT-4, Claude | GPT-4, Claude | GPT-4 |
| قیمت | $20/ماه | $10/ماه | $15/ماه | $25/ماه |
| اکستنشن VS Code | بله | — | بله | خیر |
| Privacy mode | بله (Business) | بله (Enterprise) | بله | خیر |
خلاصه: Cursor بهترین تعادل بین قدرت AI و تجربه توسعهدهنده را دارد. GitHub Copilot ارزانتر است ولی قابلیتهای agent و multi-file ضعیفتر دارد. Windsurf رقیب مستقیم Cursor است با قیمت کمتر. Replit برای کسی است که IDE دسکتاپ نمیخواهد.
کاربردهای عملی
برای فرانتاند دولوپر
- «یک کامپوننت React بساز که لیست محصولات را با pagination نشان دهد»
- «این CSS را به Tailwind تبدیل کن»
- «تستهای unit برای این کامپوننت بنویس»
- «این فرم را accessible کن (ARIA labels, keyboard navigation)»
برای بکاند دولوپر
- «یک REST API برای CRUD عملیات روی users بنویس با Express و TypeScript»
- «این query را optimize کن — الان N+1 problem دارد»
- «middleware احراز هویت JWT اضافه کن»
- «Dockerfile برای این پروژه بنویس»
برای دیتا ساینتیست
- «این CSV را بخوان و نمودار توزیع ستون age رسم کن»
- «یک pipeline ساده ML بنویس برای classification این دیتاست»
- «این pandas code را به polars تبدیل کن برای performance بهتر»
برای مبتدیها
- «این error message یعنی چه؟ چطور حلش کنم؟»
- «فرق async/await با Promise چیست؟ با مثال توضیح بده»
- «این کد را خط به خط توضیح بده»
- «یک پروژه ساده todo app بساز که یاد بگیرم React چطور کار میکند»
نکات حرفهای
۱. Rules file بسازید. در ریشه پروژه فایل .cursorrules بسازید و سبک کدنویسی، convention ها و ترجیحات خود را بنویسید. AI از این قوانین پیروی میکند.
۲. Context محدود کنید. اگر پروژه بزرگ است و AI جواب نامربوط میدهد، با @ فقط فایلهای مرتبط را reference دهید.
۳. Iterative کار کنید. بهجای یک prompt بزرگ، task را به قدمهای کوچک بشکنید. «اول interface را بساز» → «حالا implementation» → «حالا تست».
۴. Review کنید. AI اشتباه میکند. هر diff را قبل از Accept خوانده و مطمئن شوید منطق درست است. AI ابزار است، نه جایگزین فهم شما.
۵. از Docs استفاده کنید. اگر با فریمورک جدیدی کار میکنید، documentation آن را با @docs به context اضافه کنید تا AI از API های قدیمی استفاده نکند.
محدودیتها
۱. Hallucination. گاهی AI API یا فانکشنی پیشنهاد میدهد که وجود ندارد. همیشه verify کنید.
۲. پروژههای بسیار بزرگ. در monorepo های ۱۰۰+ هزار فایل، indexing کند میشود و context window محدود است.
۳. زبانهای کمرایج. برای Python, TypeScript, Go, Rust عالی کار میکند. برای زبانهای نیش (Elixir, Haskell, Zig) کیفیت پایینتر است.
۴. Security. کد شما برای پردازش به سرورهای Cursor ارسال میشود. اگر روی پروژه محرمانه کار میکنید، Privacy mode را فعال کنید یا پلن Business بگیرید.
شروع کنید
اگر توسعهدهنده هستید — مبتدی یا حرفهای — Cursor ابزاری است که بهرهوری شما را ۲ تا ۵ برابر میکند. نسخه رایگان برای امتحان کافی است. اگر بعد از یک هفته برنگشتید به VS Code ساده، پلن Pro ارزش هر ریالش را دارد.
برای خرید اشتراک Cursor Pro از ایران، به صفحه Cursor در راها مراجعه کنید. فعالسازی روی اکانت خودتان، با گارانتی تا پایان دوره.
