Быстрый старт
В этом руководстве вы перейдёте от установки к первому полезному изменению в Cursor. Вы войдёте в систему, попросите Cursor объяснить вашу кодовую базу, внесёте небольшое изменение и проверите результат.
Установите Cursor и войдите в систему
Скачайте Cursor. Откройте приложение, войдите в систему, выберите папку и начните с небольшой задачи.
- macOS 12 (Monterey) и более поздние версии
- Нативный установщик (.dmg)
- Поддержка Apple Silicon и Intel
- Windows 10 и более поздние версии
- Нативный установщик (.exe)
Debian/Ubuntu (рекомендуется)
# Добавьте GPG-ключ Cursorcurl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null# Добавьте репозиторий Cursorecho "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null# Обновите и установитеsudo apt updatesudo apt install cursorRHEL/Fedora
# Добавьте репозиторий Cursorsudo tee /etc/yum.repos.d/cursor.repo << 'EOF'[cursor]name=Cursorbaseurl=https://downloads.cursor.com/yumrepoenabled=1gpgcheck=1gpgkey=https://downloads.cursor.com/keys/anysphere.ascEOF# Установите Cursorsudo dnf install cursorAppImage (портативная версия)
Скачайте файл .AppImage с cursor.com/downloads, затем:
chmod +x Cursor-*.AppImage./Cursor-*.AppImageПакеты apt и yum предпочтительнее AppImage: они добавляют значки на рабочий стол, поддерживают автоматические обновления и включают инструменты CLI.
Попросите Cursor объяснить вашу кодовую базу
Выбрав папку, откройте Agent с помощью Cmd ICtrl I. Попросите Cursor объяснить кодовую базу и подсказать, какие основные части стоит изучить в первую очередь.
Объясни эту кодовую базу. Укажи основные точки входа, ключевые модули и всё, что мне следует прочитать перед внесением изменений.
Try in CursorCursor найдёт в репозитории нужные файлы, прочитает их и кратко объяснит, как устроен проект. Это один из самых быстрых способов сориентироваться в незнакомой кодовой базе.
Нужен более подробный разбор? См. Изучение кодовой базы.
Внесите небольшое изменение
Когда разберётесь в проекте, попросите Cursor предложить несколько безопасных улучшений. Выберите одно и попросите внести это изменение.
Предложи три небольших безопасных улучшения в этой кодовой базе. Объясни компромиссы и дождись, пока я выберу одно.
Try in CursorДля первых задач лучше выбирать варианты с низким риском — например, улучшение текстов или исправление небольших проблем в UI.
Если вы уже знаете, что хотите изменить, попросите об этом напрямую и опишите желаемый результат.
Проверьте дифф и результат
Теперь можно наблюдать за работой Cursor. В представлении диффа отображаются изменения, внесённые агентом.
Когда он завершит работу, проверьте дифф и попросите Cursor запустить проверки, которые уже используются в вашем проекте. Это могут быть тесты, проверка типов, линтинг или локальная сборка.
Нужен более надёжный процесс ревью? См. Ревью и тестирование кода.
Используйте Plan Mode для крупных изменений
Освоив основы, используйте Plan Mode для крупных изменений. Он хорошо подходит, когда задача затрагивает несколько файлов, требует исследования или одобрения перед написанием кода.
Нажмите Shift+Tab в поле ввода агента, чтобы включить Plan Mode. Вместо того чтобы сразу писать код, Cursor:
- Изучит вашу кодовую базу и найдёт нужные файлы
- Задаст уточняющие вопросы о ваших требованиях
- Создаст подробный план реализации
- Дождётся вашего одобрения перед началом разработки
Более подробное руководство см. в разделе Создание новых функций.