- Понадобится поддерживаемая операционная система, аккаунт и папка для проекта.
- Пример запроса: «Добавь в index.html счётчик нажатий по кнопке.
- Ask нужен для чтения и объяснения кода без изменений.
- В диффе проверьте список затронутых файлов, удалённые строки и новую конфигурацию.
- Проверьте, правильно ли открыта папка, установлен ли Node.js, виден ли файл агенту и доступна ли выбранная модель на вашем тарифе.
Cursor — редактор кода с ИИ-помощником, который умеет разбираться в файлах, делать правки и запускать команды. Начинать знакомство лучше с маленького проекта, где легко увидеть каждое изменение. Тогда даже при неудачной генерации можно определить причину и вернуть рабочую версию.
Что подготовить перед установкой
Понадобится поддерживаемая операционная система, аккаунт и папка для проекта. По привычкам интерфейс близок к VS Code: можно импортировать многие настройки и расширения. Не переносите сразу десятки дополнений — сначала проверьте базовые функции, терминал и горячие клавиши. Для JavaScript-проектов со сборкой или серверным кодом понадобится Node.js, для Python — соответствующий интерпретатор. Простая HTML-страница с JavaScript запускается непосредственно в браузере. Cursor не устанавливает среду исполнения автоматически.
Первый проект шаг за шагом
- Установите и запустите Cursor, затем проверьте вход в аккаунт.
- Создайте папку
hello-cursorи откройте её через Open Folder. - Создайте файл
index.htmlс заголовком и кнопкой. - Инициализируйте Git и сохраните исходное состояние коммитом.
- Откройте панель Agent, выберите режим изменения файлов.
- Поручите добавить счётчик нажатий, ограничив задачу одним файлом.
- Посмотрите diff, откройте страницу в браузере и проверьте кнопку.
Пример запроса: «Добавь в index.html счётчик нажатий по кнопке. Не используй библиотеки, не меняй стили и не создавай другие файлы. После правки объясни, какие строки изменены, и напиши шаги проверки». Такая задача помогает увидеть, выполняет ли редактор точные указания и не меняет ли лишнее.
Как работают Ask, Plan, Agent и Debug
Ask нужен для чтения и объяснения кода без изменений. Plan помогает предварительно согласовать последовательность шагов. Agent читает файлы, редактирует проект, при необходимости вызывает терминал. Debug ориентирован на ошибки, для которых важны логи и поведение программы во время выполнения. Состав доступных режимов может отличаться между версиями.
| Режим | Практическая задача |
|---|---|
| Ask | Объяснить назначение функции |
| Plan | Согласовать новую форму |
| Agent | Добавить обработчик и тест |
| Debug | Установить причину сбоя |
Что проверить после работы агента
В диффе проверьте список затронутых файлов, удалённые строки и новую конфигурацию. Не оценивайте качество по фразе «задача выполнена». Должны работать кнопка, браузерная консоль и существующие тесты. Агент иногда добавляет ненужные библиотеки или меняет соседние компоненты ради небольшой правки. Если видите это, попросите минимальный патч и повторите проверку.
При работе с терминалом читайте команды до подтверждения. Операции удаления, миграции и установки зависимостей могут затронуть данные. Для экспериментов используйте тестовую ветку Git и копию проекта, не подключённую к рабочей базе.
Если первое задание не удалось
Проверьте, правильно ли открыта папка, установлен ли Node.js, виден ли файл агенту и доступна ли выбранная модель на вашем тарифе. Сообщение о недоступной модели нельзя исправить переписыванием HTML. Ошибку «команда не найдена» сначала диагностируйте обычным терминалом. Если код изменён, но страница осталась старой, проверьте открытый файл и обновите браузер.
Как перейти от одного файла к настоящему проекту
После успешного теста добавьте CSS, отдельный файл JavaScript и автоматическую проверку. Перед изменениями попросите агента перечислить предполагаемые файлы и объяснить зависимости. Для больших задач есть руководство по Cursor Agent, для требований к стилю — настройка Cursor Rules.
Как измерить пользу Cursor
Возьмите три обычных задания: написать тест, исправить дефект и объяснить незнакомый модуль. Сравните время до принятого результата и число ручных исправлений. Большое количество сгенерированных строк не доказывает пользу. Хороший итог — понятная правка, которую можно проверить и поддерживать.
Установка Cursor на Windows, macOS и Linux
Сначала скачайте установщик Cursor для своей операционной системы из раздела загрузки самого продукта. Для Windows запустите установщик, дождитесь окончания установки и откройте Cursor из меню приложений. На macOS откройте скачанный пакет, перенесите приложение в «Программы», затем запустите его. Для Linux выберите предлагаемый в загрузках формат для своего дистрибутива и следуйте способу установки именно этого пакета. Не копируйте команды из устаревших инструкций для другой сборки.
После первого запуска выполните вход, откройте настройки импорта VS Code, если ранее им пользовались, и проверьте расширения. Далее выберите File → Open Folder, укажите отдельную учебную папку и откройте встроенный терминал. Если система запрашивает доверие к рабочей папке, подтверждайте его только для знакомого проекта. При ошибке входа сначала проверьте региональные ограничения и доступность аккаунта, а не переустанавливайте программу.
Проверяемый мини-проект без зависимостей
Создайте index.html с кодом ниже, откройте файл в браузере и убедитесь, что счётчик работает ещё до обращения к агенту. Затем попросите Agent изменить цвет кнопки, не затрагивая JavaScript. Так вы сразу проверите и обычный редактор, и ИИ-правку.
<!doctype html>
<html lang="ru">
<meta charset="utf-8">
<title>Первый проект Cursor</title>
<button id="counter">Нажатий: 0</button>
<script>
let clicks = 0;
document.querySelector('#counter').onclick = (event) => {
clicks += 1;
event.currentTarget.textContent = 'Нажатий: ' + clicks;
};
</script>
</html>
Важное отличие: для такой статической страницы Node.js не нужен. Он понадобится позже для проектов со сборкой. Если кнопка не меняет текст, откройте консоль браузера, посмотрите ошибку и проверьте, что открыли именно созданный файл. Для продолжения есть руководство по созданию сайта, настройка Cursor Tab и разбор ограничений доступа в России.
Частые вопросы
Обязательно ли платить?
Для первого знакомства можно использовать доступный бесплатный режим. Ограничения описаны в статье о тарифах.
Можно ли сразу открыть рабочий репозиторий?
Для обучения безопаснее взять копию без секретов и клиентских данных. После освоения diff, Git и проверки команд расширяйте доступ постепенно.