Cursor: установка и режимы работы

Cursor — один из самых популярных AI-native редакторов в 2026 году: широкая пользовательская база, активное сообщество и зрелая экосистема. Он построен как форк VS Code, но с переработанным ядром под агентную разработку. Именно его мы будем использовать в примерах по курсу — поэтому начнём с установки и разберём все основные режимы работы.

Установка

Cursor скачивается с cursor.com — сайт определяет операционную систему автоматически. Установка стандартная, а после запуска, необходимо залогинится. Предварительно нужно создать аккаунт на сайте либо создав новый аккаунт используя почту, либо с помощью Google, GitHub или Apple аккаунтов. Регистрация тоже стандартная, не требует ввода данных карт и прочих сложностей, так что не будем на ней долго задерживаться. После неё вам сразу доступен Free Plan, предоставляющий возможность начать пользоваться агентами и моделями с определёнными лимитами.

Первоначальная настройка

В Cursor есть два слоя настроек, и это важно понять сразу. Стандартные настройки, как в VS Code — открываются через Ctrl+, (на Windows/Linux. Тут и далее имейте ввиду что Ctrl на MacOS меняем на Cmd) — это шрифты, темы, расширения, всё привычное.

Cursor Settings — отдельный раздел для всего, что касается AI: модели, правила, MCP, приватность. Открывается через Ctrl+Shift+J или меню: File → Preferences → Cursor Settings.

Если вы работали в VS Code, переход будет практически незаметным. Cursor использует Open VSX и поддерживает большинство популярных расширений VS Code. Для переноса настроек в Cursor Settings нажмите кнопку import в пункте Import Settings from VS Code

Это автоматически подхватит и перенесёт в курсор все ваши настройки из VS Code, включая и расширения.

Выбор моделей

По умолчанию у нас стоит режим Auto: Cursor сам выбирает подходящую модель из доступных премиум-моделей в зависимости от типа задачи и текущей нагрузки. Если нужен ручной контроль — в меню Models доступен список доступных моделей. В этом разделе можно включить конкретные модели, и они появятся в выпадающем списке внутри чата.

Здесь же добавляются собственные API-ключи провайдеров: Anthropic, OpenAI, Google, Azure, AWS Bedrock. Ключ вставляется в соответствующее поле, кнопка Verify проверяет его валидность.

Важное ограничение: BYOK-ключи работают только для стандартных моделей в чате и Cmd+K — Tab-автодополнение и ряд агентных функций всегда используют встроенные модели Cursor.

Режимы работы

Вся агентная работа в Cursor сосредоточена в одном интерфейсе — панели, которая открывается через  Ctrl+I. Внутри неё четыре режима, переключаемые через picker под полем ввода или сочетанием клавиш Shift+Tab:

Agent — режим по умолчанию для сложных задач. Агент самостоятельно изучает кодовую базу, определяет нужные файлы, вносит изменения сразу в нескольких местах, запускает команды в терминале и итерирует по ошибкам. Перед каждым значимым действием Cursor запрашивает подтверждение, если не включён Run Everything режим (автоодобрение всех действий — настраивается в Cursor Settings → Agents).

Plan — режим планирования перед реализацией. Агент задаёт уточняющие вопросы, строит интерактивный план с to-do списком, но не вносит изменения в код. Удобно для сложных задач, где нужно сначала согласовать подход. Из плана можно отправлять отдельные to-do прямо в новые агентные сессии.

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

Ask — режим только для чтения. Агент ищет по кодовой базе и отвечает на вопросы, но никаких изменений в файлы не вносит. Подходит для изучения незнакомого кода или планирования подхода без риска что-то поменять.

Помимо основной панели есть Inline Edit — быстрое редактирование прямо в файле. Выделяем фрагмент кода, нажимаем Ctrl+K, описываем изменение — Cursor вносит правку и показывает диф прямо в редакторе. Принять — Ctrl+Shift+Y, отклонить — Ctrl+N. Удобен для быстрых точечных правок без открытия боковой панели.

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

Контекст: что видит агент

Agent mode индексирует кодовую базу при открытии проекта и использует этот индекс при поиске релевантных файлов. Дополнительно контекст можно передавать явно через @-символы прямо в поле ввода:

Прикрепить можно конкретный файл или папку, документацию (можно добавить свою через Cursor Settings → Indexing & Docs), вывод терминала, предыдущие чаты, git diff, поиск в интернете.

Rules: постоянный контекст для агента

Агент не помнит инструкции между сессиями — каждый новый разговор начинается с чистого листа. Чтобы соглашения по коду, архитектурные ограничения и стилевые предпочтения применялись автоматически, в Cursor есть система Rules.

Правила могут быть общими, пользовательскими или проектными и хранятся в директории .cursor/rules в корне проекта, попадают в git и шарятся с командой. Каждое правило — отдельный .mdc-файл с метаданными: можно задать glob-паттерн (применять только к *.test.ts), сделать правило всегда активным или оставить агенту решать по контексту. User Rules — глобальные предпочтения в Cursor Settings → Rules, применяются во всех проектах.

Создать правило: Cursor Settings → Rules, Skills, Subagents → Rule → +New.

Это можно сделать и с помощью самого же агента, заодно протестировав что он работает. С помощью команды /create-rule описываем агенту что за правило мы хотим создать. Агент поспрашивает разрешения (создание папок, файлов и т.д.) и создаст папку .cursor в корне проекта и добавит туда правило

После подтверждения создания этого файла, это правило будет действовать

Для наглядности того факта, что правило действительно работает, мы тут попросили его писать комментарии на китайском, чего он сам бы вряд ли стал делать, но на практике стоит тщательно продумывать что именно вы тут пишите. Не стоит делать этот файл слишком большим, потому как это увеличивает контекст, а значит и стоимость каждого запроса. Лучше разбивать правила на несколько файлов и ограничивать их область применения через glob-паттерны — например, правила для тестов применять только к *.test.ts, а общие соглашения по стилю вынести в отдельный файл. Так агент получает только релевантные инструкции, а не весь набор правил сразу.

Правила работают лучше всего, когда они конкретны и однозначны. «Пиши чистый код» — бесполезная инструкция. «Не используй any в TypeScript», «все HTTP-запросы делай через lib/api.ts», «функции длиннее 40 строк разбивай на части» — это работает.