Как пользоваться Cursor CLI: пошаговое руководство

Чтобы пользоваться Cursor CLI, установите её командой curl https://cursor.com/install -fsS | bash, войдите через agent login, перейдите в папку проекта и запустите agent. Вы описываете задачу, а агент Cursor читает код, правит файлы и выполняет команды после вашего подтверждения. Для скриптов и CI команда agent -p "ваша задача" выполняет один промпт без интерактивного интерфейса.

Это базовый цикл. В руководстве разобрано всё остальное: три режима, print-режим, модели, файлы правил, MCP-серверы, разрешения, то, как CLI расходует лимит тарифа Cursor, её ограничения и работа рядом с другими CLI для программирования. Всё описанное основано на официальной документации Cursor по состоянию на октябрь 2026 года.

Что такое Cursor CLI

Cursor CLI переносит агента из редактора Cursor в терминал. Она использует тот же аккаунт, те же модели, те же правила и те же настройки MCP, что и редактор, поэтому если ваша команда уже работает в Cursor, CLI ведёт себя так, как все и ожидают. Она запускается везде, где есть терминал: на сервере по SSH, на CI-раннере или в панели рядом с другим агентом.

Пара слов об имени: раньше команда называлась cursor-agent. В январе 2026 года Cursor сделал основной командой agent, а cursor-agent продолжает работать как псевдоним. Старые инструкции и инструменты, которые вызывают cursor-agent, не ломаются; в этом руководстве используется agent.

Если вы ещё выбираете между Cursor и агентом, созданным для терминала, сравнение есть в статье Claude Code или Cursor. Здесь мы исходим из того, что вы выбрали Cursor и хотите работать с ним из терминала.

Шаг 1. Установите Cursor CLI

Проверьте установку:

agent --version

Если оболочка не находит agent, добавьте ~/.local/bin в PATH и откройте новый терминал. По умолчанию CLI обновляется сама; обновить вручную можно командой agent update.

Шаг 2. Войдите в аккаунт

agent login     # открывает браузер
agent status    # показывает, под каким аккаунтом вы вошли
agent logout

На машине без браузера задайте NO_OPEN_BROWSER=1, и agent login выведет ссылку вместо того, чтобы её открывать. Для CI и скриптов создайте API-ключ в панели Cursor в разделе API Keys и передайте его через переменную окружения CURSOR_API_KEY или флаг --api-key.

Шаг 3. Интерактивная сессия

Запустите агента в проекте с первым промптом или без него:

cd my-project
agent
agent "add input validation to the signup form"

У CLI три режима, Shift+Tab переключает их по кругу:

Хорошая привычка для любой нетривиальной задачи: начать в Plan, договориться о подходе, затем переключиться в Agent и дать ему реализовать. Ещё несколько вещей на каждый день:

• @ выбирает файлы, которые нужно приложить к сообщению.
• Ctrl+R открывает изменения агента для просмотра.
• Shift+Enter (или Ctrl+J) добавляет перенос строки; стрелка вверх листает прошлые сообщения.
• Команды оболочки перед запуском ждут подтверждения y/n.
• /model меняет модель; /clear начинает новый чат; /summarize сжимает длинный чат.
• Двойное Ctrl+D завершает сессию.

Чаты сохраняются. agent ls показывает их список, agent resume (или --continue) возвращает к последнему, а --resume="chat-id" открывает конкретный. Внутри сессии /resume, /fork и /rewind делают ровно то, что написано в названии.

Стоит знать ещё о двух возможностях. Если начать сообщение с &, разговор передаётся Cursor Cloud Agent, который продолжает работу без вас, а забрать результат можно на cursor.com/agents. А -w (или --worktree имя) запускает агента в новом Git worktree в ~/.cursor/worktrees/, не трогая вашу текущую рабочую копию.

Шаг 4. Print-режим для скриптов и CI

Print-режим выполняет один промпт и завершается. Так CLI можно вызывать из скриптов, Git-хуков и CI-пайплайнов:

# Вопрос только на чтение, ответ обычным текстом
agent -p "summarize what changed in src/billing since the last release"

# Применить изменения (без --force они только предлагаются)
agent -p --force "add JSDoc comments to every exported function in src/utils"

# Машиночитаемый вывод для другого инструмента
agent -p --output-format json "list the TODO comments in this repo"

Флаги, которые здесь важны:

• --force (псевдоним --yolo) позволяет агенту записывать файлы и выполнять команды без вопросов, если их не блокирует правило запрета. Именно этот переключатель заставляет print-режим действительно что-то менять.
• --output-format принимает text (по умолчанию), json или stream-json. Добавьте к stream-json флаг --stream-partial-output, чтобы получать текст по мере генерации.
• --trust доверяет рабочей папке без вопроса; --approve-mcps одобряет настроенные MCP-серверы.
• --model и --workspace задают модель и папку.

Cursor также описывает запуск CLI в GitHub Actions. Если вы используете --force в CI, относитесь к нему как к любому агенту без присмотра: API-ключ с узкими правами, одноразовый раннер и изменения, которые приходят в ветку на ревью.

Шаг 5. Выберите модель

agent models                   # модели, доступные вашему аккаунту
agent --model <model-id>       # запуск с конкретной моделью

Внутри сессии /model открывает выбор модели, а /model grok фильтрует список. Если модель не указана, CLI берёт ту, что задана в аккаунте. Список моделей зависит от тарифа (см. раздел о ценах ниже): все платные тарифы включают собственные модели Cursor, а сторонние требуют Premium или выше.

Шаг 6. Правила, AGENTS.md и CLAUDE.md

Cursor CLI использует ту же систему правил, что и редактор. Правила лежат в .cursor/rules, а кроме того CLI читает AGENTS.md и CLAUDE.md в корне проекта и тоже применяет их как правила. Начиная с октябрьского релиза 2026 года файлы AGENTS.md во вложенных папках срабатывают, когда агент правит файлы в этих папках.

# Project rules

- Package manager: pnpm. Run `pnpm test` before you finish a task.
- TypeScript strict mode; no `any` in new code.
- Never edit files in src/generated/.

Если в одном репозитории работают несколько агентов, AGENTS.md — это файл, который читают все, поэтому общие правила лучше держать именно там. agent generate-rule интерактивно создаёт новое правило Cursor. О том, что писать в эти файлы, рассказывает статья Как писать CLAUDE.md и AGENTS.md.

Шаг 7. MCP-серверы

MCP-серверы дают агенту новые инструменты: браузер, трекер задач, базу данных. Cursor CLI читает тот же mcp.json, что и редактор: .cursor/mcp.json для проекта и ~/.cursor/mcp.json для всех проектов. Всё, что вы настроили в редакторе, уже доступно в CLI.

agent mcp list                 # настроенные серверы и их статус
agent mcp list-tools <id>      # инструменты, которые даёт сервер
agent mcp login <id>           # вход на сервер с OAuth
agent mcp disable <id>         # отключить, не удаляя

Внутри сессии /mcp list показывает то же самое. Каждый сервер добавляет свои инструменты в контекст агента, поэтому держите включёнными только нужные.

Шаг 8. Разрешения и конфигурация

Глобальные настройки хранятся в ~/.cursor/cli-config.json (в Windows — %USERPROFILE%\.cursor\cli-config.json). В проекте можно добавить .cursor/cli.json, где хранятся только разрешения. Оба файла — чистый JSON без комментариев.

{
  "permissions": {
    "allow": ["Shell(git)", "Shell(ls)", "Read(src/**/*.ts)", "Write(package.json)", "Mcp(datadog:*)"],
    "deny": ["Shell(rm)", "Read(.env*)", "Write(**/*.key)"]
  }
}

Каждая запись указывает инструмент и шаблон: Shell(...), Read(...), Write(...), WebFetch(домен) и Mcp(сервер:инструмент). Запрет важнее разрешения. В глобальном файле также задаются режим подтверждения (allowlist, auto-review или unrestricted), настройки песочницы и то, добавлять ли в коммиты строку «Made with Cursor».

Как Cursor CLI связана с тарифом Cursor

Отдельной подписки на CLI нет. Она работает через ваш аккаунт Cursor, а по состоянию на октябрь 2026 года Cursor продаётся в составе The X Subscription вместе с Grok и X. В каждом платном тарифе есть единый лимит на собственные модели Cursor (Grok 4.7, Grok 4.6, Grok 4.5 и Composer 2.5). Из него расходуют редактор, CLI, Cloud Agents и приложения Grok, а обновляется он каждую неделю.

Что это значит при работе с CLI:

• Модели расходуют лимит с разной скоростью. Остаток и дата следующего обновления видны в настройках редактора и на панели использования.
• Claude, GPT и Gemini в лимит не входят. На Premium и выше они оплачиваются с первого запроса по прейскурантной цене API из предоплаченного баланса. На Plus и Free они недоступны.
• В Plus нет Cloud Agents и Auto. Передать разговор Cloud Agent через & можно только на Premium или выше.
• Старые тарифы продолжают работать. Pro, Pro+, Ultra, Start и места Teams Standard или Premium считаются устаревшими тарифами и сохраняют два ежемесячных лимита и оплату по факту.

Ограничения, о которых стоит знать

• У Shell Mode тайм-аут 30 секунд. /shell выполняет команды напрямую, но не может держать долгоживущие серверы или отвечать на интерактивные запросы, а cd между командами не сохраняется.
• Print-режим по умолчанию осторожен. Без --force он предлагает изменения, а не записывает их, и в первый раз это удивляет почти всех.
• Файлы конфигурации — строгий JSON. Комментарий или лишняя запятая в cli-config.json ломают файл.
• Один чат на терминал. В CLI есть worktree и Cloud Agents, но нет встроенного вида, где видно сразу несколько локальных агентов.

Частые ошибки

• command not found: agent. В PATH нет ~/.local/bin.
• Какой-то инструмент всё ещё вызывает cursor-agent. Ничего страшного, псевдоним остаётся. На agent перешла только документация.
• Нужной модели нет в списке. Это сторонняя модель, а ваш тариф — Free или Plus.
• Правила игнорируются. Проверьте, что AGENTS.md или CLAUDE.md лежит в корне проекта или что правило из .cursor/rules применяется к редактируемым файлам.
• CI зависает на запросе подтверждения. Добавьте --trust, используйте CURSOR_API_KEY и передайте --approve-mcps, если настроены MCP-серверы.

Cursor CLI рядом с другими CLI

Если ваша команда уже живёт в Cursor, Cursor CLI — хороший выбор: одни и те же модели, правила и MCP-серверы в редакторе и терминале. Если нужны глубокие точки расширения в терминале, такие как хуки, skills и плагины, здесь сильнее Claude Code. А если вы думаете уйти с Cursor совсем, честный обзор вариантов есть в статье Лучшие альтернативы Cursor.

Многие в итоге запускают Cursor CLI рядом с Claude Code, Codex или Gemini CLI, давая каждому свою задачу. В обычных терминалах это значит одна вкладка на агента и worktree через -w, чтобы они не мешали друг другу. AgentVera — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и входами. Поддержка Cursor устроена так:

• У каждого агента свой чат. Для каждого нового агента Cursor создаётся пустой чат (cursor-agent create-chat), и агент всегда возвращается к нему, поэтому несколько агентов Cursor работают в одном проекте, не путаясь. Редактор Cursor открывать не нужно.
• Ваш вход, ваши модели. Используется собственный вход Cursor CLI; если поле модели пустое, берётся модель из настроек Cursor.
• Правила, а не ролевой промпт. У Cursor CLI нет флага для дополнительных инструкций, поэтому поле «Роль» агента до Cursor не доходит. Постоянные инструкции пишите в AGENTS.md или файлы правил.
• MCP из одного места. MCP-серверы, добавленные в AgentVera, и браузер AgentVera подключаются как локальный плагин и одобряются на время запуска.
• Сетка, аккаунты и серверы. Запускайте Cursor в сетке рабочего пространства рядом с другими агентами, с автоматическим код-ревью по окончании каждого хода. В «Настройки → Аккаунты» можно выстроить несколько аккаунтов Cursor в резервном порядке, а агент Cursor может работать и на сохранённом SSH-сервере.

Чтобы попробовать, скачайте AgentVera.

Итог

Чтобы пользоваться Cursor CLI, установите её, выполните agent login и запустите agent в проекте. Перед крупными изменениями переключайтесь в Plan через Shift+Tab, в скриптах используйте agent -p --force, правила держите в AGENTS.md или .cursor/rules, а инструменты в mcp.json. Сколько вы сможете использовать, определяет тариф Cursor, поэтому выбирайте модели с оглядкой на недельный лимит.