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

آخرین بررسی اطلاعات: ۲۰ مهر ۱۴۰۵ (۱۲ اکتبر ۲۰۲۶) | مناسب دانشجویان دوره برنامه‌نویسی با هوش مصنوعی | اولویت آموزش: Windows 10، Windows 11، macOS و Ubuntu

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

در این آموزش، تمام مراحل را از دانلود Cursor تا باز کردن اولین پروژه و آزمایش قابلیت‌های هوش مصنوعی بررسی می‌کنیم. همچنین مشکلات رایجی را که ممکن است هنگام نصب یا استفاده از Cursor، به‌خصوص با اینترنت ایران، تجربه کنید توضیح می‌دهیم.

هدف این است که بدون نیاز به تماشای ویدیوی نصب، محیط برنامه‌نویسی خود را آماده کنید و با خیال راحت سراغ ویدیوهای فصل چهارم دوره بروید.

فهرست مطالب

1. Cursor چیست و چه تفاوتی با VS Code دارد؟

2. پیش‌نیازهای نصب Cursor

3. دانلود Cursor از وب‌سایت رسمی

4. آموزش نصب Cursor روی Windows 10 و Windows 11

5. آموزش نصب Cursor روی macOS

6. آموزش نصب Cursor روی Ubuntu و Linux

7. ساخت حساب کاربری و ورود به Cursor

8. تنظیمات اولیه Cursor

9. انتقال تنظیمات و Extensionهای VS Code

10. نصب و مدیریت Extensionها

11. آماده‌سازی محیط برای برنامه‌نویسی

12. پلن رایگان و محدودیت‌های مصرف Cursor

13. رفع مشکلات رایج نصب و راه‌اندازی

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

15. چک‌لیست نهایی و منابع رسمی

۱. Cursor چیست؟

Cursor یک محیط ویرایش کد مبتنی بر هوش مصنوعی است که به شما کمک می‌کند کد بنویسید، خطاها را پیدا کنید، بخش‌های مختلف پروژه را بررسی کنید و تغییرات موردنیاز را با کمک AI انجام دهید.

این برنامه بر پایه کد VS Code توسعه یافته است؛ بنابراین بسیاری از بخش‌های محیط آن برای کاربران VS Code آشنا خواهد بود.

تفاوت Cursor با VS Code چیست؟

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

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

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

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

با توجه به اینکه در بخش‌های قبلی دوره با برنامه‌نویسی و Prompt Engineering آشنا شده‌اید، پیش‌نیاز لازم برای شروع کار با Cursor را دارید.

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

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

آیا به ChatGPT Plus نیاز داریم؟

خیر. حساب Cursor مستقل از اشتراک ChatGPT Plus است. برای شروع کافی است در Cursor حساب بسازید و از امکانات پلن خود استفاده کنید.

۲. پیش‌نیازهای نصب Cursor

قبل از دانلود برنامه، مطمئن شوید سیستم شما شرایط اولیه را دارد.

• Windows 10 — پشتیبانی‌شده؛ اولویت این آموزش

• Windows 11 — پشتیبانی‌شده؛ مراحل مشابه Windows 10

• macOS — نسخه 12 Monterey و جدیدتر

• Ubuntu / Debian — نصب از مخزن رسمی APT

• Fedora / RHEL — نصب از مخزن رسمی RPM

• Mac با Apple Silicon — نسخه سازگار با پردازنده‌های سری M

• Mac با Intel — نسخه سازگار با پردازنده Intel

این موارد در راهنمای رسمی شروع سریع Cursor تأیید شده‌اند. مرجع: Cursor Docs.

سخت‌افزار موردنیاز

برای اجرای روان‌تر برنامه، پیشنهاد می‌شود سیستم شما حداقل ۸ گیگابایت RAM داشته باشد و فضای خالی کافی برای برنامه، Extensionها و پروژه‌ها در اختیار داشته باشید.

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

آیا اینترنت لازم است؟

برای دانلود برنامه، ساخت حساب، دریافت Extensionها و استفاده از قابلیت‌های آنلاین AI به اینترنت نیاز دارید. بخش‌هایی از ویرایش کد ممکن است بدون اینترنت نیز کار کنند.

نکته بسیار مهم برای دانشجویان داخل ایران

در این دوره پیشنهاد می‌کنیم هنگام نصب، ورود به حساب و استفاده از قابلیت‌های هوش مصنوعی Cursor، یک VPN قابل اعتماد و پایدار روشن داشته باشید؛ حتی در مواقعی که تصور می‌کنید محدودیت یا تحریم مشخصی وجود ندارد.

متأسفانه اختلالات مسیر اینترنت، محدودیت‌های شبکه و تفاوت کیفیت سرویس‌های VPN می‌توانند باعث شوند وب‌سایت Cursor باز شود، اما ورود به برنامه یا دریافت پاسخ از AI انجام نشود.

اگر یک VPN کار نکرد، چند سرویس معتبر یا سرور مختلف را امتحان کنید تا اتصال پایدارتری پیدا کنید. روشن بودن VPN به‌تنهایی تضمین‌کننده اتصال نیست و گاهی خود VPN نیز علت خطاست. مستندات رسمی Cursor این احتمال را تأیید می‌کنند.

نکته امنیتی: از VPNهای ناشناس و غیرقابل اعتماد استفاده نکنید و برای حل مشکلات اتصال، Windows Defender یا Firewall را به‌طور کامل غیرفعال نکنید. همچنین استفاده از VPN تضمین نمی‌کند که یک سرویس در همه مناطق قابل دسترسی باشد.

آیا نصب Cursor به معنی نصب Python یا Node.js است؟

خیر. Cursor یک محیط توسعه است، نه جایگزین تمام ابزارهای برنامه‌نویسی.

برای اجرای پروژه‌های Python معمولاً باید Python را جداگانه نصب کنید. برای پروژه‌های JavaScript و React نیز بسته به نوع پروژه به Node.js و ابزارهای مرتبط نیاز خواهید داشت.

۳. دانلود Cursor از وب‌سایت رسمی

نسخه مناسب سیستم‌عامل خود را از صفحه دانلود Cursor دریافت کنید.

برای دانلود برنامه مراحل زیر را انجام دهید:

1. مرورگر خود را باز کنید و وارد آدرس cursor.com/downloads شوید.

2. سیستم‌عامل موردنظر خود را انتخاب کنید. ممکن است وب‌سایت به‌صورت خودکار سیستم‌عامل شما را تشخیص دهد.

3. نسخه مناسب معماری دستگاه را بررسی کنید.

4. فایل نصب را دانلود کنید و تا پایان دریافت فایل منتظر بمانید.

5. قبل از اجرا، مطمئن شوید فایل از دامنه رسمی Cursor دریافت شده است.

چگونه معماری سیستم را در Windows تشخیص دهیم؟

1. منوی Start را باز کنید.

2. وارد Settings و سپس System شوید.

3. بخش About را باز کنید.

4. در قسمت System type معماری سیستم را مشاهده کنید.

برای مثال، عبارت x64-based processor نشان‌دهنده معماری x64 است.

چگونه نوع پردازنده Mac را تشخیص دهیم؟

1. منوی Apple را باز کنید.

2. گزینه About This Mac را انتخاب کنید.

3. اگر عبارت Chip همراه با نامی مانند Apple M1 یا M2 دیده شد، دستگاه شما Apple Silicon است.

4. اگر در بخش Processor نام Intel دیده شد، نسخه Intel مناسب دستگاه شماست.

۴. آموزش نصب Cursor روی Windows 10 و Windows 11

این بخش مهم‌ترین قسمت نصب برای دانشجویان دوره است. مراحل Windows 10 و Windows 11 تا حد زیادی یکسان هستند.

مرحله اول: دانلود فایل نصب

1. وارد صفحه رسمی دانلود شوید.
2. نسخه Windows مناسب سیستم خود را دریافت کنید.
3. منتظر بمانید فایل نصب با پسوند .exe به‌طور کامل دانلود شود.
4. پوشه Downloads را باز کنید و فایل دریافتی را پیدا کنید.

مرحله دوم: اجرای نصب‌کننده

1. روی فایل نصب Cursor دوبار کلیک کنید.
2. اگر پنجره تأیید امنیتی Windows نمایش داده شد، نام برنامه و ناشر فایل را بررسی کنید.
3. در صورت معتبر بودن فایل و اطمینان از منبع دانلود، نصب را ادامه دهید.
4. اگر نصب‌کننده از شما مسیر نصب یا گزینه‌های اضافی درخواست کرد، برای شروع می‌توانید تنظیمات پیش‌فرض را نگه دارید.
5. منتظر بمانید نصب تمام شود.

نکته: ظاهر نصب‌کننده و گزینه‌های آن ممکن است با نوع بسته Windows و نسخه برنامه متفاوت باشد. وجود گزینه‌هایی مانند ساخت Desktop Shortcut در تمام بسته‌ها تأیید نشده است؛ بنابراین اگر چنین گزینه‌ای نمایش داده نشد، مشکلی وجود ندارد.

محل Screenshot شماره ۱ — اجرای نصب‌کننده در Windows:

مرحله سوم: اجرای Cursor

1. منوی Start را باز کنید.
2. عبارت Cursor را جست‌وجو کنید.
3. برنامه Cursor را انتخاب کنید.
4. منتظر بمانید صفحه اولیه برنامه نمایش داده شود.
5. اگر برنامه برای ورود به حساب یا انجام تنظیمات اولیه راهنمایی نمایش داد، مراحل را طبق بخش‌های بعدی ادامه دهید.

مرحله چهارم: ساخت Shortcut روی Desktop

اگر بعد از نصب، آیکون Cursor روی Desktop وجود ندارد:

1. در منوی Start عبارت Cursor را جست‌وجو کنید.
2. روی نتیجه برنامه راست‌کلیک کنید.
3. در صورت وجود گزینه Open file location، آن را انتخاب کنید.
4. روی میانبر برنامه راست‌کلیک کرده و از مسیر Send to، گزینه Desktop (create shortcut) را انتخاب کنید.

اگر این گزینه‌ها در Windows 11 متفاوت بودند، از قابلیت ساخت Shortcut خود Windows استفاده کنید. ساخت میانبر برای عملکرد Cursor ضروری نیست.

اگر Windows Defender هشدار داد چه کنیم؟

ابتدا مطمئن شوید فایل از وب‌سایت رسمی دانلود شده است. سپس در Properties فایل، بخش Digital Signatures را در صورت وجود بررسی کنید.

اگر Windows فایل را مشکوک یا آلوده تشخیص داد، بدون بررسی بیشتر هشدار را نادیده نگیرید. فایل را دوباره از منبع رسمی دریافت کنید و در صورت تداوم مشکل از پشتیبانی Cursor یا مدیر سیستم کمک بگیرید.

اگر Windows به دلیل محدودیت دسترسی اجازه نصب نمی‌دهد، ممکن است حساب کاربری شما مجوز کافی نداشته باشد یا سیستم توسط سازمان مدیریت شود.

اگر Cursor روی Windows 10 نصب نشد

ابتدا نسخه Windows و معماری سیستم را بررسی کنید. سپس فضای خالی دیسک، کامل بودن دانلود و مجوزهای حساب کاربری را بررسی کنید.

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

۵. آموزش نصب Cursor روی macOS

Cursor از Macهای دارای پردازنده Intel و Apple Silicon پشتیبانی می‌کند و طبق مستندات رسمی، macOS 12 و نسخه‌های جدیدتر قابل استفاده هستند. مرجع: Cursor Docs.

مراحل نصب

1. وارد صفحه دانلود Cursor شوید.
2. نسخه macOS سازگار با پردازنده دستگاه خود را انتخاب کنید.
3. فایل .dmg را دانلود کنید.
4. فایل دانلودشده را باز کنید.
5. در پنجره نصب، برنامه Cursor را به پوشه Applications منتقل کنید.
6. پوشه Applications را باز کرده و Cursor را اجرا کنید.
7. مراحل ورود به حساب و تنظیمات اولیه را انجام دهید.

محل Screenshot شماره ۲ — نصب روی macOS:

اگر macOS اجازه اجرای برنامه را نداد

گاهی macOS هنگام اجرای برنامه‌های دانلودشده از اینترنت هشدار امنیتی نمایش می‌دهد.

1. مطمئن شوید فایل از وب‌سایت رسمی Cursor دانلود شده است.
2. متن هشدار را بخوانید.
3. اگر برنامه به دلیل تأیید نشدن توسعه‌دهنده مسدود شده، به بخش Privacy & Security در System Settings مراجعه کنید.
4. فقط در صورت اطمینان از اصالت برنامه و وجود گزینه رسمی Open Anyway، آن را بررسی کنید.
5. اگر سیستم فایل را آسیب‌دیده یا بدافزار تشخیص داد، از دور زدن حفاظت سیستم خودداری کنید و نسخه جدید را از منبع رسمی دریافت کنید.

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

۶. آموزش نصب Cursor روی Ubuntu و Linux

برای دانشجویانی که از Ubuntu استفاده می‌کنند، روش نصب از مخزن رسمی APT پیشنهاد می‌شود.

مستندات جدید Cursor علاوه بر بسته‌های قابل دانلود، روش نصب از مخزن رسمی را برای Debian و Ubuntu ارائه می‌کنند. مرجع: Cursor Docs.

مرحله اول: باز کردن Terminal

در Ubuntu یک پنجره Terminal باز کنید.

مرحله دوم: آماده‌سازی ابزارهای موردنیاز

دستور زیر را برای نصب ابزارهای لازم اجرا کنید:

مرحله سوم: اضافه کردن کلید رسمی Cursor

ابتدا پوشه نگهداری کلیدها را در صورت نیاز ایجاد کنید:

سپس کلید رسمی مخزن را اضافه کنید:

این دستور کلید GPG مخزن رسمی Cursor را برای بررسی امضای بسته‌ها ذخیره می‌کند.

مرحله چهارم: اضافه کردن مخزن Cursor

مرحله پنجم: نصب برنامه

بعد از پایان نصب، Cursor را از منوی برنامه‌های Ubuntu اجرا کنید.

اگر دستور نصب با خطای شبکه مواجه شد، اتصال اینترنت و دسترسی به دامنه رسمی دانلود را بررسی کنید.

نصب روی Fedora و RHEL

برای این توزیع‌ها، مستندات رسمی از مخزن RPM و ابزار dnf استفاده می‌کنند.

ابتدا فایل مخزن را بسازید:

سپس برنامه را نصب کنید:

نکته: این دستورات مربوط به برنامه دسکتاپ Cursor هستند. دستور نصب Cursor CLI یا ابزار خط فرمان Agent متفاوت است و نباید آن را با نصب محیط گرافیکی اشتباه گرفت.

برای توزیع‌های دیگر Linux، پیش از استفاده از دستورهای مخصوص Ubuntu یا Fedora، بسته‌های موجود در صفحه رسمی دانلود را بررسی کنید.

۷. ساخت حساب کاربری و ورود به Cursor

بعد از نصب برنامه، نوبت ساخت حساب کاربری و ورود به محیط Cursor است.

مرحله اول: ساخت حساب

1. برنامه Cursor را اجرا کنید.
2. اگر صفحه ورود نمایش داده شد، گزینه Sign In یا گزینه مشابه آن را انتخاب کنید.
3. اگر مرورگر باز شد، مراحل ثبت‌نام را در صفحه رسمی احراز هویت ادامه دهید.
4. روش ثبت‌نام موجود را انتخاب کنید. بسته به صفحه ورود ممکن است گزینه‌های ورود با ایمیل، Google، GitHub یا سرویس هویت دیگری نمایش داده شوند.
5. اگر سرویس از شما تأیید ایمیل یا کد یک‌بارمصرف درخواست کرد، آن مرحله را تکمیل کنید.
6. پس از تأیید حساب، به Cursor برگردید.
7. مطمئن شوید برنامه وضعیت ورود شما را شناسایی کرده است.

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

مرحله دوم: بررسی ورود موفق

بعد از ورود، می‌توانید وضعیت حساب را در Cursor Settings بررسی کنید.

برای باز کردن تنظیمات اختصاصی Cursor در Windows و Linux از میانبر Ctrl + Shift + J و در macOS از Cmd + Shift + J استفاده کنید.

اگر میانبر در نسخه شما عمل نکرد، Command Palette را باز کنید و عبارت Cursor Settings را جست‌وجو کنید.

مرحله سوم: خروج و ورود مجدد

اگر لازم شد حساب را عوض کنید یا مشکل ورود را برطرف کنید:

1. وارد Cursor Settings شوید.
2. بخش Account یا تنظیمات مربوط به حساب را پیدا کنید.
3. در صورت نمایش گزینه Sign Out یا Log Out، از حساب خارج شوید.
4. برنامه را کاملاً ببندید و دوباره باز کنید.
5. فرآیند Sign In را تکرار کنید.

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

اگر صفحه ورود باز نشد چه کنیم؟

این مشکل برای دانشجویانی که از داخل ایران متصل می‌شوند اهمیت بیشتری دارد.

1. ابتدا VPN معتبر خود را روشن کنید و اتصال را بررسی کنید.
2. اگر صفحه ورود باز نشد، سرور یا سرویس VPN دیگری را آزمایش کنید.
3. اگر مرورگر پیش‌فرض شما مشکل دارد، مرورگر دیگری را موقتاً به‌عنوان مرورگر پیش‌فرض تنظیم و ورود را تکرار کنید.
4. اگر در مرورگر وارد شدید اما برنامه همچنان وضعیت ورود را نشان نمی‌دهد، Cursor را کاملاً ببندید و دوباره اجرا کنید.
5. اگر مشکل ادامه داشت، تنظیمات Proxy و Firewall را بررسی کنید.
6. اگر شبکه دانشگاه یا شرکت محدودیت دارد، از مدیر شبکه بخواهید دامنه‌های احراز هویت Cursor را بررسی کند.

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

۸. تنظیمات اولیه Cursor

بعد از اولین ورود، بهتر است چند تنظیم ساده را انجام دهید تا محیط برنامه برای یادگیری راحت‌تر شود.

انتخاب Theme

در مراحل اولیه ممکن است Cursor از شما بخواهد یک Theme انتخاب کنید. اگر چنین صفحه‌ای نمایش داده نشد، می‌توانید بعداً Theme را تغییر دهید.

1. Command Palette را با Ctrl + Shift + P در Windows و Linux یا Cmd + Shift + P در macOS باز کنید.
2. عبارت Preferences: Color Theme را جست‌وجو کنید.
3. از فهرست نمایش‌داده‌شده یک Theme روشن یا تیره انتخاب کنید.
4. تغییر را در محیط ویرایشگر مشاهده کنید.

برای شروع دوره، Theme تیره یا روشن تفاوت فنی خاصی ندارد؛ گزینه‌ای را انتخاب کنید که خواندن کدها برای شما راحت‌تر باشد.

تنظیم اندازه فونت

1. Command Palette را باز کنید.
2. عبارت Preferences: Open Settings (UI) را جست‌وجو کنید.
3. در قسمت Search تنظیمات، عبارت Editor Font Size را وارد کنید.
4. اندازه فونت را متناسب با نمایشگر خود تنظیم کنید.

برای بیشتر نمایشگرهای لپ‌تاپ، اندازه ۱۴ تا ۱۶ نقطه شروع مناسبی است.

همچنین می‌توانید Editor Font Family را جست‌وجو کنید و فونت دلخواه خود را انتخاب کنید؛ البته فونت باید روی سیستم نصب شده باشد.

انتخاب Keyboard Shortcuts

Cursor در اولین راه‌اندازی ممکن است انتخاب میانبرهای آشنا را پیشنهاد دهد. اگر قبلاً با VS Code کار کرده‌اید، استفاده از میانبرهای مشابه VS Code انتخاب مناسبی است.

برای مشاهده یا تغییر میانبرها:

1. Command Palette را باز کنید.
2. عبارت Preferences: Open Keyboard Shortcuts را جست‌وجو کنید.
3. دستور موردنظر را پیدا کنید.
4. در صورت نیاز میانبر آن را تغییر دهید.

تنظیم زبان محیط

برای یادگیری برنامه‌نویسی، پیشنهاد می‌کنیم فعلاً رابط Cursor را به زبان انگلیسی نگه دارید؛ زیرا نام منوها و تنظیمات در آموزش‌ها و مستندات رسمی به انگلیسی نوشته شده‌اند.

امکان استفاده از زبان‌های دیگر می‌تواند به بسته‌های زبان سازگار بستگی داشته باشد. پشتیبانی کامل و رسمی از رابط فارسی در نسخه بررسی‌شده تأیید نشد.

تنظیمات اولیه AI

برای شروع، نیازی نیست تنظیمات پیشرفته Model یا Agent را تغییر دهید.

1. ابتدا مطمئن شوید به حساب خود وارد شده‌اید.
2. بخش Chat یا محیط AI را باز کنید.
3. اگر Model پیش‌فرض قابل استفاده است، همان را نگه دارید.
4. در اولین آزمایش، یک درخواست کوتاه ارسال کنید.
5. اگر پاسخ دریافت کردید، اتصال AI شما آماده است.

در این مرحله لازم نیست درباره Rules، MCP، Skills یا تنظیمات پیشرفته مدل‌ها تصمیم بگیرید؛ این مباحث در ادامه دوره بررسی خواهند شد.

تفاوت Cursor Settings و VS Code Settings

این دو بخش را با هم اشتباه نگیرید.

• Cursor Settings: تنظیمات اختصاصی Cursor مانند حساب، شبکه و بعضی قابلیت‌های AI.
• VS Code Settings: تنظیمات عمومی محیط ویرایشگر مانند فونت، Theme، رفتار Editor و بخش‌هایی از Terminal.

برای پیدا کردن هر بخش می‌توانید از Command Palette استفاده کنید.

۹. انتقال تنظیمات و Extensionهای VS Code به Cursor

اگر قبلاً با VS Code برنامه‌نویسی کرده‌اید، لازم نیست همه تنظیمات خود را از ابتدا انجام دهید.

Cursor قابلیت Import از VS Code را ارائه می‌دهد. با این حال، باید بدانید که انتقال همیشه بدون خطا نیست و ممکن است بعضی Extensionها به‌درستی منتقل نشوند.

چه چیزهایی قابل انتقال هستند؟

• Settings — پشتیبانی از Import
• Theme — پشتیبانی از Import
• Keybindings — پشتیبانی از Import
• Extensions — پشتیبانی، با احتمال ناسازگاری یا خطای انتقال
• Snippets — امکان انتقال از طریق Profile در صورت وجود در داده‌های خروجی
• Sync دائمی با VS Code — همگام‌سازی خودکار و دائمی تأیید نشده

مستندات رسمی Cursor چهار مورد اصلی Settings، Themes، Keybindings و Extensions را برای Import مستقیم معرفی می‌کنند.

روش اول: Import هنگام راه‌اندازی اولیه

اگر در مراحل اولیه Cursor گزینه‌ای برای انتقال اطلاعات از VS Code مشاهده کردید:

1. گزینه مربوط به Import from VS Code را انتخاب کنید.
2. در صورت نمایش اطلاعات قابل انتقال، موارد را بررسی کنید.
3. عملیات Import را شروع کنید.
4. منتظر پایان فرآیند بمانید.
5. بعد از ورود به محیط اصلی، Theme، تنظیمات و Extensionها را بررسی کنید.

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

روش دوم: Import بعد از نصب

این روش برای کسانی مناسب است که قبلاً Cursor را نصب کرده‌اند.

1. برنامه Cursor را باز کنید.
2. با میانبر Ctrl + Shift + J در Windows یا Cmd + Shift + J در macOS وارد Cursor Settings شوید.
3. بخش General و سپس Account را بررسی کنید.
4. قسمت VS Code Import را پیدا کنید.
5. روی گزینه Import کلیک کنید.
6. منتظر بمانید عملیات انتقال تکمیل شود.
7. تنظیمات منتقل‌شده را بررسی کنید.

این مسیر در راهنمای رسمی مهاجرت از VS Code مستند شده است. اگر چینش Settings در نسخه شما تغییر کرده بود، از Command Palette برای یافتن Cursor Settings استفاده کنید.

محل Screenshot شماره ۳ — Import از VS Code:

روش سوم: انتقال با Profile

اگر روش Import مستقیم کار نکرد یا قصد دارید تنظیمات را بین دو کامپیوتر منتقل کنید، استفاده از Profile گزینه مناسبی است.

مرحله اول: خروجی گرفتن از VS Code

1. برنامه VS Code را باز کنید.

2. Command Palette را اجرا کنید.

3. عبارت Preferences: Open Profiles (UI) را جست‌وجو کنید.

4. Profile موردنظر را انتخاب کنید.

5. از منوی سه‌نقطه گزینه Export Profile را انتخاب کنید.

6. خروجی را به‌صورت فایل محلی ذخیره کنید یا در صورت تمایل از GitHub Gist استفاده کنید.

مرحله دوم: وارد کردن Profile در Cursor

1. برنامه Cursor را باز کنید.

2. Command Palette را اجرا کنید.

3. عبارت Preferences: Open Profiles (UI) را جست‌وجو کنید.

4. منوی کنار New Profile را باز کنید.

5. گزینه Import Profile را انتخاب کنید.

6. فایل خروجی یا لینک Gist را وارد کنید.

7. عملیات Import را تکمیل کنید.

8. Profile جدید را انتخاب و فعال کنید.

این مراحل در مستندات رسمی مهاجرت Cursor آمده‌اند.

انتقال Snippets

اگر Snippetهای شخصی در VS Code ساخته‌اید، ابتدا روش Profile را امتحان کنید.

پیش از Export بررسی کنید که Snippets در محتوای Profile انتخاب شده باشند. سپس بعد از Import، یکی از Snippetهای خود را در Cursor آزمایش کنید.

انتقال مستقل و خودکار همه Snippetها از طریق دکمه VS Code Import به‌صورت قطعی تأیید نشده است.

آیا نصب Cursor باعث حذف VS Code می‌شود؟

خیر. Cursor یک برنامه مستقل است و نصب آن به‌صورت معمول VS Code را حذف نمی‌کند.

همچنین Import تنظیمات به معنی انتقال دائمی مالکیت فایل‌ها یا حذف تنظیمات اصلی VS Code نیست.

می‌توانید هر دو برنامه را روی یک سیستم نگه دارید و هر زمان خواستید از آن‌ها استفاده کنید.

آیا همه Extensionهای VS Code منتقل می‌شوند؟

خیر. این موضوع بسیار مهم است.

Cursor برای Extensionهای شخص ثالث از اکوسیستم Open VSX و زیرساخت Marketplace خود استفاده می‌کند. بنابراین بعضی Extensionهایی که در VS Code نصب می‌شوند، ممکن است در Cursor موجود نباشند یا رفتار متفاوتی داشته باشند.

همچنین در گزارش‌های رسمی انجمن Cursor در سال ۲۰۲۶، مشکلی تأیید شده بود که طی آن عملیات Import با پیام موفقیت پایان می‌یافت، اما Extensionها منتقل نمی‌شدند.

اگر چنین اتفاقی افتاد:

1. بخش Extensions را باز کنید.

2. بررسی کنید آیا گزینه Import VS Code Extensions نمایش داده می‌شود.

3. اگر وجود داشت، از همان گزینه استفاده کنید.

4. اگر وجود نداشت، Extensionهای موردنیاز را جداگانه جست‌وجو و نصب کنید.

5. اگر Extension خاصی در دسترس نبود، جایگزین معتبر و سازگار آن را بررسی کنید.

برای دانشجویان مبتدی، نصب دستی Extensionهای ضروری معمولاً ساده‌تر و کم‌خطرتر از کپی کردن پوشه‌های داخلی برنامه است.

تفاوت Import با Sync چیست؟

عملیات Import یک انتقال اطلاعات در زمان مشخص است.

برای مثال، اگر امروز Theme خود را از VS Code به Cursor منتقل کنید و فردا Theme برنامه VS Code را تغییر دهید، نباید انتظار داشته باشید Cursor نیز خودکار تغییر کند.

طبق توضیح پشتیبانی Cursor در ژوئن ۲۰۲۶، همگام‌سازی ابری بومی و خودکار تنظیمات و Extensionها مانند VS Code در آن زمان پشتیبانی نمی‌شد.

بنابراین بهتر است تنظیمات مهم خود را در Profile نگهداری کنید و در صورت نیاز مجدداً منتقل کنید.

۱۰. نصب و مدیریت Extensionها در Cursor

Extensionها قابلیت‌های بیشتری به محیط ویرایشگر اضافه می‌کنند؛ برای مثال، پشتیبانی بهتر از زبان‌های برنامه‌نویسی، قالب‌بندی کد و ابزارهای توسعه.

چگونه یک Extension نصب کنیم؟

1. برنامه Cursor را باز کنید.

2. در Windows و Linux میانبر Ctrl + Shift + X را بزنید.

3. در macOS از پنل Extensions استفاده کنید؛ اگر میانبر استاندارد کار نکرد، دستور View: Show Extensions را در Command Palette جست‌وجو کنید.

4. نام Extension موردنظر را در قسمت Search وارد کنید.

5. نام ناشر و توضیحات Extension را بررسی کنید.

6. روی Install کلیک کنید.

7. در صورت نیاز برنامه یا پنجره ویرایشگر را Reload کنید.

چگونه Extension را حذف یا غیرفعال کنیم؟

1. وارد بخش Extensions شوید.

2. Extension نصب‌شده را پیدا کنید.

3. صفحه جزئیات آن را باز کنید.

4. برای غیرفعال کردن، گزینه Disable را انتخاب کنید.

5. برای حذف کامل، گزینه Uninstall را انتخاب کنید.

6. اگر Extension گزینه Update داشت، می‌توانید نسخه جدید آن را نصب کنید.

بعضی Extensionها امکان Disable فقط برای Workspace فعلی را نیز ارائه می‌دهند.

چه Extensionهایی برای دوره مفید هستند؟

• Python — Python / افزونه سازگار Anysphere — پشتیبانی از توسعه Python

• Python — Ruff — بررسی و قالب‌بندی کد Python

• Django — Django Template — کمک به ویرایش قالب‌های Django

• JavaScript — ESLint — بررسی مشکلات و قواعد کدنویسی

• JavaScript / React — Prettier - Code formatter — قالب‌بندی کد

• React — ES7+ React/Redux/React-Native snippets — Snippetهای کاربردی React

این نام‌ها به‌عنوان گزینه‌های شناخته‌شده برای جست‌وجو معرفی شده‌اند، نه تضمین نصب و سازگاری همه نسخه‌های آن‌ها در Cursor. سازگاری دقیق هر نسخه باید در Marketplace خود Cursor بررسی شود. به‌ویژه درباره افزونه‌های وابسته به Microsoft Marketplace، بهتر است از نسخه‌های مورد تأیید Cursor استفاده کنید.

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

۱۱. آماده‌سازی Cursor برای شروع برنامه‌نویسی

حالا که Cursor نصب شده و حساب کاربری شما آماده است، بهتر است یک پروژه آزمایشی بسازید.

مرحله اول: ساخت پوشه پروژه

در Windows 10 یا Windows 11:

1. File Explorer را باز کنید.

2. وارد پوشه Documents شوید.

3. یک پوشه جدید با نام cursor-first-project بسازید.

4. Cursor را باز کنید.

5. از منوی File گزینه Open Folder را انتخاب کنید.

6. پوشه ساخته‌شده را انتخاب کنید.

7. در صورت نمایش پرسش اعتماد به Workspace، فقط اگر پوشه را خودتان ساخته‌اید یا به منبع آن اطمینان دارید، آن را تأیید کنید.

مرحله دوم: ساخت اولین فایل

1. پنل Explorer را باز کنید.

2. روی گزینه New File کلیک کنید.

3. نام فایل را hello.py قرار دهید.

4. کد زیر را داخل فایل بنویسید:

5. فایل را با Ctrl + S ذخیره کنید.

مرحله سوم: باز کردن Terminal

برای باز کردن Terminal داخلی Cursor، از منوی Terminal گزینه New Terminal را انتخاب کنید.

همچنین می‌توانید در Command Palette عبارت Terminal: Create New Terminal را جست‌وجو کنید.

در Windows ممکن است PowerShell به‌عنوان Terminal پیش‌فرض باز شود. در macOS و Ubuntu نیز معمولاً Shell پیش‌فرض سیستم نمایش داده می‌شود.

مرحله چهارم: بررسی نصب Python

در Terminal ویندوز ابتدا دستور زیر را اجرا کنید:

اگر Python Launcher در دسترس نبود، این دستور را امتحان کنید:

در macOS و Ubuntu:

اگر نسخه Python نمایش داده شد، یعنی مفسر Python از طریق دستور مربوطه قابل دسترسی است.

اگر خطا دریافت کردید، باید Python را جداگانه از وب‌سایت رسمی Python نصب یا تنظیم کنید.

مرحله پنجم: انتخاب Python Interpreter

اگر Cursor مفسر Python را خودکار تشخیص نداد:

1. مطمئن شوید Extension سازگار Python نصب شده است.
2. Command Palette را باز کنید.
3. عبارت Python: Select Interpreter را جست‌وجو کنید.
4. اگر این دستور وجود داشت، آن را انتخاب کنید.
5. از فهرست نمایش‌داده‌شده، مفسر مناسب پروژه را انتخاب کنید.

اگر دستور وجود ندارد، احتمالاً Extension مربوط به Python نصب یا فعال نیست، یا نسخه آن از این فرمان پشتیبانی نمی‌کند.

مرحله ششم: اجرای فایل آزمایشی

در Terminal ویندوز:

در macOS و Ubuntu:

خروجی مورد انتظار:

اگر این خروجی را مشاهده کردید، بخش ویرایش و اجرای Python آماده است.

مرحله هفتم: بررسی Node.js برای پروژه‌های JavaScript

اگر قرار است با JavaScript یا React کار کنید، دستور زیر را در Terminal اجرا کنید. این دستور در PowerShell، macOS و Ubuntu قابل استفاده است:

اگر هر دو دستور نسخه ابزارها را نمایش دادند، Node.js و npm از طریق Terminal در دسترس هستند.

اگر دستورها شناسایی نشدند، باید Node.js را از وب‌سایت رسمی Node.js نصب کنید.

مرحله هشتم: آزمایش اولیه AI

1. یک پروژه آزمایشی باز نگه دارید.

2. بخش Chat یا AI در Cursor را باز کنید.

3. درخواست زیر را ارسال کنید:

اگر Cursor پاسخ مرتبطی ارائه داد، بخش ارتباط با AI نیز آماده است.

اگر پاسخ دریافت نکردید، ابتدا وضعیت ورود، اتصال اینترنت و محدودیت Usage را بررسی کنید.

محل Screenshot شماره ۴ — اولین پروژه موفق:

۱۲. آشنایی اولیه با پلن‌ها و محدودیت مصرف Cursor

برای شروع کار با Cursor لازم نیست بلافاصله اشتراک پولی تهیه کنید.

در زمان بررسی این مقاله، Cursor پلن رایگان Hobby و پلن‌های پولی فردی Pro، Pro+ و Ultra را ارائه می‌کند. پلن‌های سازمانی نیز جداگانه در دسترس هستند.

پلن Hobby

پلن Hobby رایگان است و برای شروع کار با Cursor مناسب است.

این پلن امکان استفاده محدود از قابلیت‌هایی مانند Chat، Agent و تکمیل کد را فراهم می‌کند. مقدار مصرف مجاز و مدل‌های قابل دسترسی ممکن است در طول زمان تغییر کنند.

پلن‌های Pro، Pro+ و Ultra

این پلن‌ها نسبت به Hobby امکانات و سهمیه‌های بیشتری دارند.

انتخاب بین آن‌ها به میزان استفاده، مدل‌های موردنیاز و نوع پروژه بستگی دارد.

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

چگونه Usage را بررسی کنیم؟

1. وارد حساب خود در وب‌سایت Cursor شوید.
2. Dashboard حساب را باز کنید.
3. بخش Spending یا Usage را پیدا کنید.
4. میزان مصرف، سهمیه باقی‌مانده و هرگونه هزینه احتمالی را بررسی کنید.
5. قبل از فعال کردن مصرف اضافه یا Pay-as-you-go، شرایط پرداخت را مطالعه کنید.

طبق راهنمای رسمی، بخش Spending اطلاعات مصرف و سهمیه باقی‌مانده را نشان می‌دهد.

نکات مدیریت هزینه

برای تمرین‌های ابتدایی از امکانات موجود در پلن رایگان استفاده کنید. اگر با پیام پایان سهمیه مواجه شدید، نیازی نیست بدون بررسی اشتراک بخرید.

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

برای مشاهده شرایط فعلی به صفحه رسمی قیمت‌گذاری Cursor مراجعه کنید.

۱۳. رفع مشکلات رایج نصب و راه‌اندازی Cursor

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

پیشنهاد می‌کنیم قبل از حذف و نصب مجدد برنامه، ابتدا راه‌حل‌های ساده‌تر را امتحان کنید. بسیاری از مشکلات Cursor به اتصال اینترنت، تنظیمات شبکه یا Extensionها مربوط هستند و نیازی به نصب دوباره ندارند.

مشکل اول: Cursor نصب نمی‌شود

علائم: فایل نصب اجرا نمی‌شود، نصب نیمه‌کاره می‌ماند یا Windows پیام خطا نمایش می‌دهد.

علت‌های احتمالی: دانلود ناقص، ناسازگاری نسخه، فضای ناکافی دیسک یا محدودیت مجوزهای سیستم.

راه‌حل:

1. فایل نصب را دوباره از وب‌سایت رسمی دانلود کنید.
2. معماری سیستم و نسخه Windows را بررسی کنید.
3. فضای خالی دیسک را بررسی کنید.
4. مطمئن شوید فایل توسط تنظیمات امنیتی سازمان یا Windows مسدود نشده است.
5. اگر سیستم شخصی است و به فایل رسمی اعتماد دارید، در صورت نیاز اجرای نصب‌کننده با مجوز Administrator را بررسی کنید.

اگر نصب همچنان با خطای مشخصی متوقف می‌شود، متن خطا را در راهنمای رسمی نصب و انجمن پشتیبانی Cursor جست‌وجو کنید.

مشکل دوم: Cursor اجرا نمی‌شود یا صفحه سفید نمایش می‌دهد

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

علت‌های احتمالی: فرآیند باقی‌مانده از اجرای قبلی، مشکل Extensionها یا فایل‌های برنامه.

راه‌حل:

1. برنامه را کاملاً ببندید.
2. در Windows از Task Manager بررسی کنید که فرآیند Cursor همچنان در حال اجرا نباشد.
3. سیستم را Restart کنید.
4. در صورت امکان Cursor را به‌روزرسانی کنید.
5. اگر مشکل ادامه داشت، برنامه را از منبع رسمی مجدداً نصب کنید.

اگر حتی پس از نصب مجدد مشکل باقی ماند، قبل از حذف داده‌های برنامه از Profile و تنظیمات خود نسخه پشتیبان تهیه کنید.

مشکل سوم: Cursor روی Loading باقی می‌ماند

علائم: برنامه باز می‌شود، اما محیط Editor، Terminal یا بخش AI به‌طور کامل بارگذاری نمی‌شود.

علت‌های احتمالی: مشکل Extension Host، Extension ناسازگار، داده‌های موقت یا اختلال اتصال.

راه‌حل:

1. Cursor را کاملاً ببندید و دوباره اجرا کنید.
2. Command Palette را باز کرده و Developer: Reload Window را اجرا کنید.
3. Extensionهای غیرضروری را غیرفعال کنید.
4. در صورت امکان، برنامه را بدون Extensionها آزمایش کنید.
5. اگر مشکل پس از نصب یک Extension شروع شده، همان Extension را غیرفعال یا حذف کنید.

اگر مشکل در نسخه جدید نیز تکرار شد، از Command Palette دستور Developer: Export Logs را جست‌وجو کنید و گزارش را برای پشتیبانی آماده کنید.

مشکل چهارم: ورود به حساب Cursor انجام نمی‌شود

علائم: صفحه Sign In باز نمی‌شود، ورود در مرورگر موفق است اما برنامه وارد حساب نمی‌شود، یا خطای Authentication دریافت می‌کنید.

علت‌های احتمالی: مشکل مرورگر، اتصال VPN، Proxy، Firewall یا سرویس احراز هویت.

راه‌حل:

1. اتصال اینترنت را بررسی کنید.
2. برای اتصال از ایران، ابتدا VPN معتبر و پایدار خود را روشن کنید.
3. اگر ورود انجام نشد، سرور یا سرویس VPN دیگری را آزمایش کنید.
4. مرورگر پیش‌فرض را بررسی کنید.
5. پس از ورود در مرورگر، اجازه دهید فرآیند بازگشت به برنامه تکمیل شود.
6. Cursor را کاملاً ببندید و مجدداً وارد شوید.
7. اگر از شبکه سازمانی استفاده می‌کنید، تنظیمات Proxy و دامنه‌های ورود را با مدیر شبکه بررسی کنید.

مشکل پنجم: Cursor به سرور متصل نمی‌شود

علائم: پیام Connection Error، Reconnect یا Network Error نمایش داده می‌شود.

علت‌های احتمالی: اختلال اینترنت، مشکل VPN، محدودیت Firewall یا ناسازگاری پروتکل ارتباطی.

راه‌حل:

1. وارد Cursor Settings شوید.
2. بخش Network را باز کنید.
3. گزینه Run Diagnostics را اجرا کنید.
4. نتیجه آزمایش اتصال را بررسی کنید.
5. اگر خطای ارتباطی مشاهده شد، VPN یا شبکه دیگری را امتحان کنید.
6. اگر مشکل مربوط به ارتباط HTTP/2 بود، گزینه HTTP Compatibility Mode را در صورت وجود روی HTTP/1.1 قرار دهید.
7. Cursor را کاملاً ببندید و دوباره اجرا کنید.

تغییر HTTP Compatibility Mode به HTTP/1.1 یکی از راهکارهای رسمی برای بعضی مشکلات ارتباطی پشت Proxy است؛ اما برای همه خطاها ضروری یا مؤثر نیست.

محل Screenshot شماره ۵ — تنظیمات Network:

مشکل ششم: هوش مصنوعی Cursor پاسخ نمی‌دهد

علائم: پیام ارسال می‌شود اما پاسخ دریافت نمی‌کنید، درخواست روی حالت انتظار باقی می‌ماند یا خطای Model نمایش داده می‌شود.

علت‌های احتمالی: مشکل شبکه، اختلال سرویس، محدودیت Usage یا ناسازگاری Model انتخاب‌شده با پلن.

راه‌حل:

1. ابتدا مطمئن شوید به حساب خود وارد شده‌اید.
2. بخش Usage حساب را بررسی کنید.
3. اگر Model انتخاب‌شده در پلن شما قابل استفاده نیست، از مدل در دسترس استفاده کنید.
4. یک گفت‌وگوی جدید باز کنید و درخواست کوتاهی ارسال کنید.
5. اتصال VPN و نتیجه Network Diagnostics را بررسی کنید.
6. وضعیت سرویس را در status.cursor.com بررسی کنید.

اگر سرویس Cursor دچار اختلال سراسری باشد، تغییر مداوم تنظیمات محلی معمولاً کمکی نمی‌کند و بهتر است تا برطرف شدن مشکل منتظر بمانید.

مشکل هفتم: تنظیمات VS Code منتقل نمی‌شوند

علائم: عملیات Import موفق گزارش می‌شود اما Theme، Keybindings یا Extensionها منتقل نشده‌اند.

علت‌های احتمالی: خطای Import، Profile نامناسب یا ناسازگاری Extensionها.

راه‌حل:

1. مطمئن شوید VS Code و تنظیمات موردنظر در سیستم موجود هستند.
2. از بخش VS Code Import عملیات انتقال را بررسی کنید.
3. اگر مشکل ادامه داشت، روش Export و Import Profile را امتحان کنید.
4. Extensionهای ضروری را به‌صورت دستی نصب کنید.
5. پس از انتقال، Theme و Keybindings را جداگانه بررسی کنید.

مشکل هشتم: Extension نصب نمی‌شود

علائم: Extension در جست‌وجو پیدا نمی‌شود، نصب متوقف می‌شود یا افزونه پس از نصب کار نمی‌کند.

علت‌های احتمالی: نبود Extension در Marketplace، مشکل اینترنت یا ناسازگاری نسخه.

راه‌حل:

1. نام و شناسه Extension را بررسی کنید.
2. مطمئن شوید ناشر افزونه معتبر است.
3. اتصال اینترنت و VPN را بررسی کنید.
4. Cursor را به‌روزرسانی کنید.
5. اگر Extension موجود نیست، جایگزین سازگار آن را جست‌وجو کنید.
6. اگر افزونه نصب شده اما مشکل ایجاد می‌کند، آن را Disable کنید و دوباره آزمایش کنید.

از نصب فایل‌های VSIX ناشناس یا نسخه‌های غیررسمی افزونه‌ها خودداری کنید.

مشکل نهم: Terminal اجرا نمی‌شود

علائم: پنل Terminal باز نمی‌شود، روی Loading باقی می‌ماند یا Shell اجرا نمی‌شود.

علت‌های احتمالی: مشکل Shell پیش‌فرض، Extension Host یا تنظیمات محیط.

راه‌حل:

1. Cursor را Restart کنید.
2. Command Palette را باز کنید.
3. دستور Terminal: Create New Terminal را اجرا کنید.
4. در صورت وجود گزینه Terminal: Select Default Profile، Shell دیگری مانند PowerShell را در Windows امتحان کنید.
5. اگر Terminal بیرون از Cursor کار می‌کند اما داخل برنامه نه، Extensionهای غیرضروری را غیرفعال کنید.
6. دستور Developer: Reload Window را اجرا کنید.

مشکل دهم: پروژه باز نمی‌شود

علائم: پوشه پروژه نمایش داده نمی‌شود، خطای Permission دریافت می‌کنید یا فایل‌ها قابل ویرایش نیستند.

علت‌های احتمالی: مسیر اشتباه، مجوز ناکافی یا قرار گرفتن پروژه در پوشه محافظت‌شده.

راه‌حل:

1. بررسی کنید پوشه پروژه واقعاً وجود داشته باشد.
2. از منوی File گزینه Open Folder را انتخاب کنید.
3. یک پروژه آزمایشی در Documents بسازید.
4. بررسی کنید آیا پروژه آزمایشی باز می‌شود یا خیر.
5. اگر فقط پروژه اصلی مشکل دارد، مجوزهای همان پوشه را بررسی کنید.
6. اگر پروژه از اینترنت دریافت شده، قبل از اعتماد به Workspace منبع آن را بررسی کنید.

مشکل یازدهم: Cursor کند است

علائم: تایپ با تأخیر انجام می‌شود، برنامه RAM زیادی مصرف می‌کند یا باز شدن پروژه طول می‌کشد.

علت‌های احتمالی: Extensionهای زیاد، پروژه سنگین، پردازش فایل‌های تولیدشده یا کمبود منابع سیستم.

راه‌حل:

1. برنامه‌های غیرضروری را ببندید.
2. Extensionهای بلااستفاده را Disable کنید.
3. Cursor را Restart کنید.
4. یک پروژه کوچک را باز کنید و سرعت را مقایسه کنید.
5. اگر مشکل فقط در پروژه بزرگ رخ می‌دهد، پوشه‌های خروجی مانند dist، build یا .next را در صورت مناسب بودن از پردازش‌های غیرضروری کنار بگذارید.
6. از Command Palette دستور Developer: Open Process Explorer را اجرا کنید و فرآیندهای پرمصرف را بررسی کنید.

مشکل دوازدهم: Modelها نمایش داده نمی‌شوند

علائم: فهرست Modelها خالی است یا مدلی که در آموزش دیده‌اید در حساب شما وجود ندارد.

علت‌های احتمالی: تفاوت پلن، تغییر فهرست مدل‌ها، اختلال شبکه یا محدودیت دسترسی.

راه‌حل:

1. وضعیت ورود به حساب را بررسی کنید.
2. پلن فعال خود را در Dashboard مشاهده کنید.
3. اتصال اینترنت را آزمایش کنید.
4. Cursor را به‌روزرسانی کنید.
5. فهرست مدل‌های موجود در رابط فعلی برنامه را بررسی کنید.
6. اگر Model خاصی نمایش داده نمی‌شود، به‌جای تلاش برای فعال کردن اجباری آن، مستندات رسمی مدل‌ها و محدودیت پلن را بررسی کنید.

مشکل سیزدهم: پیام محدودیت Usage نمایش داده می‌شود

علائم: Cursor اعلام می‌کند سهمیه مصرف تمام شده یا امکان ادامه درخواست‌ها وجود ندارد.

علت‌های احتمالی: رسیدن به سقف پلن، محدودیت مدل انتخاب‌شده یا پایان سهمیه دوره مصرف.

راه‌حل:

1. Dashboard حساب را باز کنید.
2. بخش Spending یا Usage را بررسی کنید.
3. مقدار مصرف و زمان بازنشانی سهمیه را مشاهده کنید.
4. در صورت امکان از قابلیت‌های باقی‌مانده پلن استفاده کنید.
5. اگر واقعاً به مصرف بیشتری نیاز دارید، شرایط ارتقای پلن را بررسی کنید.

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

مشکل چهاردهم: Proxy یا Firewall مانع اتصال می‌شود

علائم: مرورگر اینترنت دارد اما Cursor به سرورها متصل نمی‌شود، یا AI فقط روی بعضی شبکه‌ها کار می‌کند.

علت‌های احتمالی: تنظیمات Proxy، فیلتر دامنه‌ها، ناسازگاری HTTP/2 یا تفاوت مسیر ترافیک مرورگر و برنامه.

راه‌حل:

1. ابتدا Network Diagnostics را اجرا کنید.
2. بررسی کنید آیا VPN شما ترافیک برنامه Cursor را نیز پوشش می‌دهد یا فقط مرورگر را.
3. اگر از Proxy سازمانی استفاده می‌کنید، تنظیمات را با مدیر شبکه بررسی کنید.
4. در صورت نیاز HTTP Compatibility Mode را روی HTTP/1.1 آزمایش کنید.
5. اگر مشکل ادامه داشت، از مستندات رسمی Network Configuration استفاده کنید.
6. اگر دامنه‌های Cursor در Firewall سازمانی مسدود هستند، از مدیر شبکه بخواهید فهرست رسمی دامنه‌های موردنیاز را بررسی کند.

از خاموش کردن کامل Firewall، غیرفعال کردن بررسی گواهی‌های امنیتی یا نصب گواهی‌های ناشناس خودداری کنید.

مشکل پانزدهم: Cursor در ایران با VPN هم کار نمی‌کند

این مشکل ممکن است در مراحل دانلود، ثبت‌نام، ورود یا استفاده از AI رخ دهد.

نکته مهم این است که باز شدن وب‌سایت Cursor به معنی سالم بودن تمام ارتباطات برنامه نیست. بخش ورود، Marketplace و سرویس‌های AI ممکن است از مسیرها و دامنه‌های متفاوت استفاده کنند.

راه‌حل پیشنهادی برای دانشجویان داخل ایران:

1. یک VPN معتبر با اتصال پایدار روشن کنید.
2. مرورگر را باز کنید و مطمئن شوید وب‌سایت Cursor قابل دسترسی است.
3. Cursor را کاملاً ببندید و پس از اتصال VPN دوباره اجرا کنید.
4. اگر ورود یا AI کار نکرد، سرور دیگری از همان VPN را امتحان کنید.
5. اگر مشکل ادامه داشت، سرویس VPN معتبر دیگری را آزمایش کنید.
6. در تنظیمات VPN بررسی کنید آیا حالت Split Tunneling باعث شده Cursor خارج از مسیر VPN قرار بگیرد.
7. اگر برنامه هنوز متصل نمی‌شود، Network Diagnostics را اجرا کنید.
8. در صورت وجود خطاهای مرتبط با HTTP/2، حالت HTTP/1.1 را آزمایش کنید.
9. اگر اتصال روی شبکه دیگری برقرار می‌شود، احتمال مشکل مسیر اینترنت یا تنظیمات شبکه فعلی را بررسی کنید.
10. اگر هیچ‌کدام از روش‌ها جواب نداد، خطا را همراه با نسخه Cursor و نتیجه Diagnostics در انجمن رسمی گزارش کنید.

متأسفانه مشکلات اتصال برای کاربران داخل ایران می‌توانند تکرارشونده باشند و ممکن است یک VPN که امروز کار می‌کند، در زمان دیگری عملکرد مناسبی نداشته باشد. به همین دلیل بهتر است از قبل چند گزینه معتبر را بشناسید و برای زمان برگزاری دوره اتصال خود را آزمایش کنید.

با این حال، هیچ VPN مشخصی تضمین دائمی اتصال یا رفع محدودیت منطقه‌ای ارائه نمی‌کند. اگر سرویس به‌صورت رسمی دسترسی منطقه‌ای را محدود کرده باشد، باید شرایط استفاده از سرویس را نیز بررسی کنید.

چه زمانی باید به پشتیبانی Cursor مراجعه کنیم؟

اگر بعد از انجام مراحل ساده هنوز مشکل دارید، اطلاعات زیر را آماده کنید:

• نسخه Cursor و سیستم‌عامل
• متن دقیق خطا
• Screenshot بدون اطلاعات حساس
• مراحل لازم برای تکرار مشکل
• نتیجه Network Diagnostics در صورت ارتباط
• Request ID در صورت وجود خطای AI
• فایل Log در صورت درخواست پشتیبانی

برای تهیه Log می‌توانید در Command Palette عبارت Developer: Export Logs را جست‌وجو کنید. قبل از ارسال فایل‌ها، اطلاعات محرمانه، مسیرهای حساس، Tokenها و داده‌های شخصی را بررسی و حذف کنید.

برای گزارش مشکل از انجمن رسمی Cursor و راهنمای رسمی عیب‌یابی استفاده کنید.

۱۴. سؤالات متداول درباره نصب Cursor

آیا Cursor روی Windows 10 نصب می‌شود؟

بله. طبق راهنمای رسمی، Cursor از Windows 10 و نسخه‌های جدیدتر پشتیبانی می‌کند. برای نصب، نسخه مناسب معماری سیستم را از وب‌سایت رسمی دریافت کنید.

آیا برای نصب Cursor باید VS Code داشته باشیم؟

خیر. Cursor یک برنامه مستقل است و بدون نصب VS Code نیز قابل استفاده است. وجود VS Code فقط در صورتی مفید است که بخواهید تنظیمات یا Extensionهای قبلی خود را منتقل کنید.

آیا نصب Cursor باعث حذف VS Code می‌شود؟

خیر. هر دو برنامه می‌توانند در کنار یکدیگر نصب باشند.

آیا برای استفاده از Cursor به ChatGPT Plus نیاز داریم؟

خیر. حساب و اشتراک Cursor مستقل از ChatGPT Plus هستند.

آیا برای شروع دوره باید اشتراک Pro بخریم؟

خیر. برای نصب، تنظیم محیط و تمرین‌های اولیه می‌توانید از پلن رایگان Hobby شروع کنید. اگر در ادامه دوره به سهمیه بیشتری نیاز داشتید، می‌توانید شرایط پلن‌های پولی را بررسی کنید.

آیا Cursor بدون اینترنت کار می‌کند؟

بعضی امکانات ویرایش کد می‌توانند بدون اینترنت کار کنند، اما ورود اولیه، دریافت Extensionها و قابلیت‌های آنلاین AI به اتصال شبکه نیاز دارند.

آیا باید Python و Node.js را جداگانه نصب کنیم؟

بله. Cursor به‌تنهایی جایگزین مفسر Python یا محیط اجرای Node.js نیست. این ابزارها باید متناسب با نوع پروژه نصب شوند.

آیا می‌توانیم Extensionهای VS Code را در Cursor نصب کنیم؟

بسیاری از Extensionها قابل استفاده‌اند، اما همه آن‌ها لزوماً سازگار یا در Marketplace Cursor موجود نیستند.

آیا Cursor روی Macهای M1، M2، M3 و نسل‌های جدیدتر اجرا می‌شود؟

بله. Cursor از معماری Apple Silicon پشتیبانی می‌کند. برای نصب، نسخه مناسب دستگاه را از صفحه رسمی دریافت کنید.

آیا برای استفاده از Cursor در ایران VPN لازم است؟

برای کاهش مشکلات دسترسی و اتصال، توصیه عملی این دوره استفاده از VPN معتبر و پایدار هنگام ورود و استفاده از AI است. با این حال، نیاز فنی به VPN در همه شبکه‌ها و همه زمان‌ها یکسان نیست و روشن بودن آن نیز تضمین اتصال نیست.

اگر یک VPN کار نکرد، می‌توانید سرویس یا سرور دیگری را آزمایش کنید. همچنین باید احتمال اختلال خود VPN یا محدودیت رسمی سرویس را در نظر بگیرید.

آیا تنظیمات VS Code و Cursor همیشه با هم Sync می‌شوند؟

خیر. Import اولیه به معنی همگام‌سازی دائمی نیست. برای انتقال تغییرات بعدی می‌توانید از روش Profile استفاده کنید.

چگونه Cursor را به‌روزرسانی کنیم؟

در Command Palette عبارت Cursor: Attempt Update را جست‌وجو کنید. اگر این دستور در نسخه شما موجود بود، آن را اجرا کنید و طبق راهنمای برنامه ادامه دهید.

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

۱۵. چک‌لیست نهایی نصب و راه‌اندازی Cursor

قبل از شروع ویدیوهای فصل چهارم، موارد زیر را بررسی کنید.

• Cursor روی سیستم نصب شده و بدون خطا اجرا می‌شود.
• حساب کاربری Cursor ساخته و فعال شده است.
• ورود به حساب داخل برنامه با موفقیت انجام شده است.
• یک پوشه پروژه در Cursor باز می‌شود.
• امکان ساخت و ذخیره فایل وجود دارد.
• Terminal داخلی باز می‌شود و دستورها را اجرا می‌کند.
• ابزارهای موردنیاز مانند Python یا Node.js در صورت نیاز نصب شده‌اند.
• Extensionهای ضروری پروژه نصب یا فعال شده‌اند.
• بخش AI باز می‌شود و حداقل یک درخواست آزمایشی پاسخ دریافت کرده است.
• اتصال اینترنت و VPN موردنیاز آزمایش شده است.

موارد تکمیل‌شده را علامت بزنید تا مشخص شود کدام مراحل باقی مانده‌اند.

منابع و لینک‌های ضروری

اطلاعات این مقاله با اولویت مستندات رسمی Cursor و راهنماهای پشتیبانی آن بررسی شده‌اند. بعضی جزئیات رابط کاربری، محدودیت پلن‌ها و فهرست Extensionها ممکن است پس از تاریخ انتشار تغییر کنند.

• وب‌سایت رسمی Cursor — cursor.com
• دانلود نسخه‌های Cursor — صفحه دانلود
• مستندات رسمی — Cursor Docs
• راهنمای شروع سریع — Quickstart
• راهنمای نصب — Installation
• انتقال از VS Code — VS Code Migration
• راهنمای Extensionها — Extensions
• قیمت‌گذاری — Pricing
• مصرف و محدودیت‌ها — Usage and Limits
• مشکلات نصب و اجرا — Installation Troubleshooting
• مشکلات اتصال — Network Troubleshooting
• وضعیت سرورها — Cursor Status
• انجمن پشتیبانی — Cursor Forum

تاریخ آخرین بررسی و به‌روزرسانی مقاله: ۲۰ مهر ۱۴۰۵، برابر با ۱۲ اکتبر ۲۰۲۶.

در این بررسی، پشتیبانی Windows 10، macOS 12 به بعد، روش نصب Ubuntu با APT، قابلیت Import از VS Code، محدودیت‌های پلن Hobby و روش‌های رسمی عیب‌یابی شبکه بررسی شده‌اند. شماره دقیق جدیدترین نسخه Stable در زمان تدوین به‌صورت قطعی تأیید نشد؛ برای دریافت نسخه فعلی، صفحه رسمی Downloads مرجع نهایی است.

آماده شروع فصل آموزش Cursor هستید؟

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

بهتر است قبل از شروع ویدیوها، Terminal و ارتباط AI را نیز یک بار آزمایش کنید تا هنگام تمرین با مشکل غیرمنتظره مواجه نشوید.

حالا می‌توانید وارد ویدیوهای فصل چهارم دوره برنامه‌نویسی با هوش مصنوعی شوید و کار عملی با Cursor را شروع کنید.

در ادامه دوره یاد می‌گیرید چگونه از قابلیت‌های هوش مصنوعی Cursor برای درک پروژه‌ها، نوشتن کد، پیدا کردن خطاها و توسعه برنامه‌های واقعی استفاده کنید.