Cursor AI: настройка и первые шаги

Cursor — редактор кода, в который ИИ-агент встроен не плагином, а частью интерфейса. Внешне он почти неотличим от VS Code: тот же вид, те же расширения, те же горячие клавиши. Разница в том, что рядом с кодом живёт агент, который видит проект целиком, сам ищет нужные файлы, правит их и запускает команды в терминале. Ниже — что поставить, что настроить в первый час и какие настройки дальше экономят деньги и нервы.

Чем Cursor отличается от VS Code с плагином

Cursor — форк VS Code, то есть отдельное приложение на том же движке. Отсюда два следствия. Миграция почти бесплатна: расширения, тема, настройки и раскладка клавиш переносятся при первом запуске одной кнопкой. И ИИ встроен глубже, чем может позволить себе плагин — агент видит ошибки линтера, читает вывод терминала и правит сразу несколько файлов.

Сами подходы — плагин к редактору, отдельное приложение, агент в терминале — мы сравнивали в обзоре Cursor vs Claude Code vs Copilot. Здесь речь только о Cursor.

Установка

Дистрибутивы есть для macOS 12 и новее (Apple Silicon и Intel), Windows 10 и новее и для Linux — пакеты Debian/Ubuntu и RHEL/Fedora либо портативный AppImage.

При первом запуске Cursor предложит импортировать конфигурацию VS Code — соглашайтесь: расширения подтянутся из совместимого реестра, настройки и клавиши переедут один в один. Дальше — вход в аккаунт и выбор папки проекта.

Ещё стоит поставить команду cursor в PATH (палитра команд → «Install 'cursor' command») — открывать проекты из терминала как с code.

Четыре способа работать с кодом

Новички обычно используют один режим из четырёх и жалуются, что «ИИ мешает». У каждого своя задача.

Tab — автодополнение, которое правит несколько строк

Tab предлагает продолжение по мере набора, опираясь на последние правки, окружающий код и ошибки линтера. От обычного автокомплита отличается тем, что меняет сразу несколько строк, дописывает недостающие импорты и предлагает согласованные правки в связанном коде. После принятия подсказки редактор сам прыгает к следующему месту; при правках в соседнем файле показывается окно с предпросмотром.

Принять целиком — Tab, отклонить — Esc, принять по слову — Cmd/Ctrl + →. Индикатор Tab справа внизу отключает подсказки временно, полностью или для отдельных типов файлов — пригодится, если они лезут в конфиги.

Inline Edit — точечная правка выделенного

Выделяете фрагмент, жмёте сочетание инлайн-правки и пишете, что с ним сделать: «вынеси в функцию», «добавь обработку ошибок». Результат показывается диффом. Удобно там, где задача локальна и звать агента избыточно.

Agent — основной режим

Агент открывается по Cmd/Ctrl + I и работает не с выделением, а с проектом: сам находит нужные файлы, редактирует их, запускает тесты и линтер, читает вывод и исправляется. Все изменения показываются диффом до применения.

Для поиска по коду используется собственный движок Instant Grep — по заявлению Cursor, на больших репозиториях он быстрее ripgrep. Для широких запросов агент запускает подагента Explore: тот ищет в отдельном окне контекста более быстрой моделью и возвращает сводку, а не простыню исходников, — контекст основного диалога не забивается мусором.

Plan Mode — сначала план, потом код

Переключается по Shift + Tab в поле ввода агента: модель сначала изучает проект, задаёт уточняющие вопросы и составляет план работ и только потом берётся за правки. Для задач на несколько файлов это самая полезная кнопка в интерфейсе — план дешевле прочитать и поправить, чем разгребать десяток неверных диффов.

Модели: свои, чужие и Auto

У Cursor есть собственные модели с отдельным, более щедрым пулом лимитов, и подключённые модели сторонних вендоров. Флагман своих — Composer 2.5: агентная модель с окном контекста 200 тысяч токенов, обученная под длинные задачи и заточенная под инструменты Cursor — правки файлов, терминал, поиск. Стоит заметно дешевле сторонних: $0,5 за миллион входных токенов и $2,5 за миллион выходных (ускоренный вариант — $3 и $15). В этот же пул входят Grok 4.6 и 4.5.

Из сторонних доступны Claude Opus 5, Sonnet 5 и Fable 5.1 от Anthropic, Gemini 3.1 Pro и 3.8 Flash от Google, линейка GPT-5.6 от OpenAI и Muse Spark 1.3 от Meta — про сильные стороны семейств мы писали в сравнении нейросетей.

Режим Auto отдаёт выбор модели маршрутизатору Cursor: три профиля — Cost, Balance и Intelligence (по цене, по балансу, по качеству). Запрос тарифицируется по прайсу той модели, на которую ушёл, плюс надбавка Cursor Token Rate $0,25 за миллион токенов для сторонних моделей.

Практика простая: рутину — Composer 2.5, сложный рефакторинг и разбор архитектуры — топовой сторонней модели вручную.

Правила проекта: .cursor/rules и AGENTS.md

Ради этого и стоит потратить полчаса в первый день. Правила — постоянные инструкции агенту: стек, соглашения об именах, запреты, структура папок.

Правила проекта лежат в каталоге .cursor/rules/ в файлах .mdc — markdown с фронтматтером; обычные .md в этой папке игнорируются. Фронтматтер задаёт, когда правило подключается:

---
description: Стандарты компонентов фронтенда
globs: src/components/**/*.tsx
alwaysApply: false
---

• alwaysApply: true — правило подмешивается в каждый диалог;
• заполнен description, globs пуст — агент сам решает по описанию, нужно ли правило;
• заполнены globs — правило включается, когда в работе файлы под шаблон;
• пусто и то и другое — правило подключается только явным @-упоминанием.

Шаблоны обычные, как в gitignore: *.ts, **/*.tsx, src/**, несколько через запятую; сами правила можно раскладывать по подпапкам.

Более простой вариант — файл AGENTS.md в корне проекта: обычный markdown без фронтматтера. Его понимают и другие агентные инструменты, так что для смешанного инструментария это удобнее. Вложенные AGENTS.md приоритетнее корневого: backend/AGENTS.md перебивает общие правила. Общий порядок: правила команды → правила проекта → пользовательские.

Логика та же, что у CLAUDE.md в Claude Code, и грабли те же: правила читаются в каждом запросе и тратят токены — держите их короткими и конкретными. «Пиши хороший код» — мусор; «только функциональные компоненты, стили — CSS-модули, запросы — через хук useApi» — рабочее правило.

Контекст: @-упоминания и .cursorignore

Через символ @ контекст подключается вручную: конкретный файл, папка, документация, веб-страница. Если знаете, где лежит нужный код, дешевле указать его прямо, чем ждать, пока агент найдёт сам.

Обратная задача — закрыть от ИИ лишнее. За это отвечает .cursorignore в корне проекта с синтаксисом gitignore: перечисленные файлы недоступны агенту, автодополнению, инлайн-правке и @-упоминаниям. Cursor и без того игнорирует .gitignore плюс встроенный список — lock-файлы, бинарники, медиа, node_modules, .git, __pycache__.

Важная оговорка из документации: терминал и подключённые MCP-инструменты правилам .cursorignore не подчиняются — закрытый файл агент прочитает командой cat. Это защита от случайного попадания секретов в контекст, а не гарантия: настоящие секреты держите в переменных окружения и менеджере секретов. Остальные риски — в заметке как не слить данные через ИИ.

MCP: подключаем внешние инструменты

MCP (Model Context Protocol) — стандарт, по которому агент получает доступ к внешним системам: базе, трекеру задач, API вашего сайта. Если тема новая, начните с заметки что такое MCP простыми словами. В Cursor серверы описываются в JSON: .cursor/mcp.json в корне проекта либо ~/.cursor/mcp.json глобально. Локальный сервер запускается командой:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": { "API_KEY": "value" }
    }
  }
}

Удалённый — по URL, через Streamable HTTP или SSE:

{
  "mcpServers": {
    "my-server": {
      "url": "https://api.example.com/mcp",
      "headers": { "API_KEY": "value" }
    }
  }
}

Включаются серверы в панели Customize. Осторожность обычная: каждый сервер расширяет права агента, а описания его инструментов попадают в контекст модели.

Сколько это стоит

Тарифы для одного разработчика: Pro — $20 в месяц, Pro Plus — $60, Ultra — $200. Для команд: Teams Standard — $40 за пользователя, Teams Premium — $120 (впятеро выше лимиты агента). Есть бесплатный уровень с ограниченным числом агентных запросов и Enterprise по договорной цене.

В каждый тариф включён объём использования моделей. Когда он кончается, есть два пути: подключить оплату по факту (on-demand) и продолжать по тем же ставкам API либо перейти на тариф выше. Качество и скорость запросов при этом не режутся.

Главный источник перерасхода — не тариф, а привычки: длинные диалоги, дорогие модели на мелких задачах, гигантские правила в каждом запросе. Приёмы экономии — в заметках про токены и лимиты и кэширование промптов.

Первая неделя: что настроить и чего не делать

Порядок, который экономит время:

1. Импортировать настройки VS Code и поставить команду cursor в PATH.
2. Открыть реальный проект, а не пустую папку.
3. Создать AGENTS.md на 20–30 строк: стек, структура, соглашения, запреты.
4. Добавить .cursorignore — конфиги окружения, дампы, выгрузки клиентов.
5. Неделю поработать на Composer 2.5, переключаясь на топовую модель только под сложные задачи.
6. Взять привычку включать Plan Mode для всего, что трогает больше двух файлов.

Типичные ошибки: просить «переписать проект» одним запросом и получить дифф, который невозможно проверить; принимать правки не глядя; держать открытыми десятки вкладок и удивляться расходу токенов. И отдельно — работать без контроля версий: агент правит файлы сам, и git здесь единственная кнопка «отменить всё».

Про приватность: по документации пути файлов шифруются перед отправкой на серверы Cursor, а содержимое кода не хранится в открытом виде — но сам код всё равно уходит к поставщикам моделей. Для проектов под NDA включайте режим приватности и согласуйте это с заказчиком заранее.

Вывод

Cursor стоит ставить, если вы уже работаете в VS Code и хотите агента, который видит проект целиком, а не текущий файл. Разница между «ИИ мешает» и «ИИ экономит день» держится на трёх вещах: короткие правила проекта, закрытый .cursorignore и привычка включать Plan Mode перед крупной задачей. Полчаса в первый день — и окупается на первой же многофайловой задаче.