Cursor — это AI-first редактор кода, построенный на основе VS Code. Он сохраняет всё, что вы любите в VS Code — экосистему расширений, привычные горячие клавиши, языковые серверы — и добавляет глубоко интегрированный AI-слой, далеко выходящий за рамки автодополнения. В 2026 году Cursor стал редактором выбора для большого и растущего числа разработчиков, желающих AI-помощника, который действительно понимает их кодовую базу.
Это руководство охватывает всё, что нужно знать новичку для продуктивной работы в Cursor: установку, основные AI-функции, настройку MCP-серверов, конфигурацию .cursorrules, тарифы и практические советы.
Установка и начальная настройка
Скачивание Cursor
Cursor доступен для macOS, Windows и Linux. Скачайте установщик с cursor.sh и запустите его.
Импорт настроек VS Code
При первом запуске Cursor предложит импортировать настройки, расширения и горячие клавиши VS Code. Это настоятельно рекомендуется — Cursor сразу станет привычным. Можно импортировать:
- Расширения VS Code (большинство работают без изменений)
- Горячие клавиши
- Настройки (тема, шрифт, предпочтения редактора)
- Сниппеты
Регистрация
Для использования AI-функций нужен аккаунт Cursor. Зарегистрируйтесь на cursor.sh через email или GitHub. Бесплатный тариф ("Hobby") даёт 2000 автодополнений и 50 медленных запросов в месяц — достаточно для оценки подходит ли Cursor вашему воркфлоу.
Интерфейс Cursor
UI Cursor — это по сути VS Code с несколькими ключевыми дополнениями:
- Панель Chat (справа или снизу) — основная поверхность взаимодействия с AI
- Composer (Cmd+I) — полноэкранный AI-редактор для изменений в нескольких файлах
- Инлайн-редактирование (Cmd+K) — быстрые AI-правки выделенного кода
- Tab-автодополнение — система, предсказывающая следующее редактирование по контексту
Основные AI-функции
Tab-автодополнение
Tab-автодополнение Cursor выходит за рамки традиционного. Вместо дополнения текущего токена оно предсказывает ваше следующее редактирование на основе того, что вы только что изменили, и окружающего кода. Отображается серым ghost-текстом — нажмите Tab для принятия, Escape для отмены.
Советы для лучшего автодополнения:
- Держите связанные файлы открытыми — Cursor использует открытые файлы как контекст
- Сначала пишите комментарии — комментарий, описывающий желаемое поведение, часто даёт гораздо лучшее автодополнение
- Используйте для повторяющихся правок — после одной правки Tab часто предсказывает аналогичную в других местах
Инлайн-редактирование (Cmd+K)
Выделите блок кода, нажмите Cmd+K, введите инструкцию на естественном языке — Cursor перепишет выделенный код на месте.
Практические применения:
- "Добавь обработку ошибок в эту функцию"
- "Конвертируй класс-компонент в функциональный React-компонент"
- "Добавь TypeScript типы ко всем параметрам"
- "Напиши юнит-тест для этой функции"
Cursor показывает дифф перед применением — зелёный для добавлений, красный для удалений. Примите изменение клавишей Tab, отклоните через Escape или попросите повторить с другой инструкцией.
Chat (Cmd+L)
Панель Chat — постоянный разговор с AI о вашем коде. В отличие от Cmd+K, Chat — для обсуждения, изучения и вопросов:
- Архитектурные вопросы: "Как структурировать слой аутентификации для этого приложения?"
- Отладка через вставку сообщений об ошибках
- Генерация кода с предложением применить его к файлу
- Ссылки на файлы через
@filenameили символы через@SymbolName - Ссылки на документацию через
@Docs
Composer (Cmd+I) — многофайловое редактирование
Composer — самая мощная AI-функция в Cursor. Опишите задачу на естественном языке, и Cursor спланирует и реализует изменения в нескольких файлах одновременно.
Использование Composer:
- Нажмите Cmd+I
- Опишите задачу: "Добавь страницу настроек пользователя с именем, email и настройками уведомлений. Создай роут, компонент и обнови навигацию"
- Cursor показывает план и создаёт/редактирует файлы
- Просматривайте каждое изменение в виде диффа и принимайте или отклоняйте отдельные изменения
Режим Agent
Режим Agent (в Composer) даёт Cursor возможность выполнять команды в терминале, запускать тесты, читать результаты и итерировать. Это автономный цикл: AI предлагает изменение, запускает тесты, проверяет результат и продолжает итерировать. Лучше всего подходит для задач с чётким критерием успеха (прохождение тестов, работающее демо).
Настройка MCP-серверов в Cursor
MCP-серверы расширяют возможности AI в Cursor внешними инструментами и источниками данных. С правильными MCP-серверами AI Cursor может семантически искать по кодовой базе, делать запросы к базе данных, создавать GitHub-issues и многое другое.
Как добавить MCP-сервер
Откройте Настройки Cursor (Cmd+,) и перейдите в Features > MCP Servers, или отредактируйте файл конфигурации напрямую в ~/.cursor/mcp.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_ваш_токен"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/projects"]
}
}
}Перезапустите Cursor после добавления серверов. В панели Chat появится иконка молотка, обозначающая доступные инструменты.
Рекомендуемые MCP-серверы для разработчиков
Просмотрите каталог MCP-серверов Mindaxis для кураторского списка. Основные для большинства разработчиков:
- @modelcontextprotocol/server-github — поиск репозиториев, чтение файлов, создание issues и PR
- @modelcontextprotocol/server-filesystem — чтение и запись локальных файлов с контролем доступа
- @modelcontextprotocol/server-postgres — запросы к PostgreSQL из AI
- @modelcontextprotocol/server-brave-search — веб-поиск в контексте AI
Используйте конструктор Mindaxis, чтобы сгенерировать полный mcp.json для вашего стека в несколько кликов.
Настройка .cursorrules
Файл .cursorrules в корне проекта — набор инструкций, которым AI Cursor всегда следует при работе в проекте. Так вы обучаете Cursor соглашениям вашей кодовой базы.
# Проект: Моё Next.js приложение
## Стек
- Next.js 15 App Router
- TypeScript (strict mode)
- Tailwind CSS v4
- Prisma ORM + PostgreSQL
- Zod для валидации
## Стиль кода
- Предпочитать функциональные компоненты классовым
- Именованные экспорты, не дефолтные
- Всегда обрабатывать состояния загрузки и ошибок
- Server Components по умолчанию; "use client" только при необходимости
## Соглашения
- Имена файлов: kebab-case, компоненты: PascalCase
- JSDoc для всех экспортируемых функций
- Запросы к БД через Prisma-транзакции для многошаговых операций
## Запрещено
- Инлайн-стили; только Tailwind-классы
- any-типы без объясняющего комментария
- console.log в продакшн-коде
В каталоге правил Mindaxis есть готовые .cursorrules файлы для популярных стеков: Next.js, Django, FastAPI, Go и других.
Тарифы
- Hobby (бесплатно) — 2000 автодополнений/месяц, 50 медленных запросов к premium-моделям. Достаточно для оценки.
- Pro ($20/месяц) — безлимитные автодополнения, 500 быстрых premium-запросов/месяц, доступ ко всем моделям. Подходит большинству full-time разработчиков.
- Business ($40/пользователь/месяц) — всё из Pro плюс командные функции: централизованный биллинг, admin-контроль, аналитика использования, SSO и privacy mode (ваш код не используется для обучения).
Советы и приёмы
Notepads для переиспользуемого контекста
В Cursor есть функция Notepads, где можно сохранять переиспользуемые фрагменты контекста. Создайте блокнот с архитектурными заметками или API-документацией и ссылайтесь на него через @Notepads в любом разговоре.
@Web для актуальной информации
Обучающие данные AI имеют дату отсечки. Для вопросов о недавно вышедших библиотеках используйте @Web, чтобы Cursor поискал в интернете и включил актуальную документацию в ответ.
Горячие клавиши для запоминания
Tab— принять автодополнениеCmd+K— инлайн-редактированиеCmd+L— открыть/сфокусировать ChatCmd+I— открыть ComposerCmd+Shift+L— добавить текущий файл в контекст Chat
Cursor для само-ревью
Перед пушем ветки используйте Cursor для само-ревью:
Проверь изменения в текущем файле. Ищи:
- Корректность и граничные случаи
- Пропущенную обработку ошибок
- Проблемы безопасностиТипичные ошибки новичков
- Недостаточный контекст — Cursor настолько хорош, насколько хорош контекст, который вы ему даёте
- Принятие изменений Composer без ревью — всегда читайте дифф
- Использование Chat там, где лучше подходит Cmd+K — для быстрых точечных правок Cmd+K быстрее
- Отсутствие файла .cursorrules — без него Cursor применяет общие лучшие практики, с ним — становится специалистом по вашему стеку
- Игнорирование MCP-серверов — они резко расширяют возможности AI
Чек-лист для начала работы: скачайте Cursor, импортируйте настройки VS Code, зарегистрируйтесь, создайте .cursorrules (используйте шаблон из каталога правил Mindaxis), добавьте хотя бы один MCP-сервер, попробуйте Cmd+K и Composer. Используйте конструктор Mindaxis для генерации полного конфига MCP.