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

URL: https://agentvera.dev/ru/blog/how-to-use-cursor-cli/ · Опубликовано: 2026-10-29

Как пользоваться Cursor CLI: установка команды agent, вход, режимы Agent, Plan и Ask, скрипты в print-режиме, настройка моделей, правил и MCP-серверов.

**Коротко:**

- Установите Cursor CLI одной командой curl (в Windows одной строкой PowerShell), войдите через agent login и запустите agent в проекте. Старое имя cursor-agent продолжает работать как псевдоним.
- agent открывает интерактивную сессию с режимами Agent, Plan и Ask. agent -p выполняет одну задачу для скриптов и CI; добавьте --force, чтобы изменения применялись, и --output-format json для машиночитаемого вывода.
- CLI расходует лимит вашего тарифа Cursor и использует те же правила, что и редактор (.cursor/rules, AGENTS.md, CLAUDE.md), и тот же mcp.json, так что ваша настройка Cursor переезжает целиком.

Чтобы пользоваться 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](/ru/blog/claude-code-vs-cursor/ "Claude Code или Cursor"). Здесь мы исходим из того, что вы выбрали Cursor и хотите работать с ним из терминала.

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

| Платформа | Команда |
| --- | --- |
| macOS, Linux, WSL | `curl https://cursor.com/install -fsS \| bash` |
| Windows (PowerShell) | `irm 'https://cursor.com/install?win32=true' \| iex` |

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

```bash
agent --version
```

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

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

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

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

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

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

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

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

| Режим | Что делает | Как включить |
| --- | --- | --- |
| Agent | По умолчанию. Правит файлы и выполняет команды. | По умолчанию |
| Plan | Прорабатывает с вами подход, прежде чем трогать код. | Shift+Tab, `/plan`, `--plan` или `--mode=plan` |
| Ask | Только чтение. Изучает код и отвечает на вопросы. | `/ask` или `--mode=ask` |

Хорошая привычка для любой нетривиальной задачи: начать в 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-пайплайнов:

```bash
# Вопрос только на чтение, ответ обычным текстом
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. Выберите модель

```bash
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` во вложенных папках срабатывают, когда агент правит файлы в этих папках.

```markdown
# 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](/ru/blog/claude-md-agents-md/ "Как писать CLAUDE.md и AGENTS.md").

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

[MCP-серверы](/ru/blog/what-is-mcp-server/ "Что такое MCP-сервер") дают агенту новые инструменты: браузер, трекер задач, базу данных. Cursor CLI читает тот же `mcp.json`, что и редактор: `.cursor/mcp.json` для проекта и `~/.cursor/mcp.json` для всех проектов. Всё, что вы настроили в редакторе, уже доступно в CLI.

```bash
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 без комментариев.

```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, а обновляется он каждую неделю.

| Тариф | Цена в месяц | Включённое использование | Сторонние модели |
| --- | --- | --- | --- |
| Free | 0 $ | Ограниченное | Нет |
| Plus | 8 $ | Базовое | Нет |
| Premium | 30 $ | 4 × Plus | По цене API из предоплаченного баланса |
| Super | 100 $ | 15 × Plus | По цене API из предоплаченного баланса |
| Ultra | 200 $ | 50 × Plus | По цене API из предоплаченного баланса |
| Teams | 30, 100 или 200 $ за место | По уровню места | Цена API плюс токенный тариф Cursor |

Что это значит при работе с 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](/ru/blog/best-cursor-alternatives/ "Лучшие альтернативы Cursor").

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

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

Чтобы попробовать, [скачайте AgentVera](/ru/download/ "Скачать AgentVera").

## Итог

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

## Частые вопросы

**Команда Cursor CLI называется agent или cursor-agent?** Работают обе. По состоянию на октябрь 2026 года основная команда — agent, а cursor-agent оставлен как псевдоним для старых скриптов и инструментов. Проверить установку можно командой agent --version.

**Cursor CLI бесплатен?** Установка бесплатна, и CLI работает на тарифе Free с ограниченным использованием. Платные тарифы дают еженедельный лимит на собственные модели Cursor, общий для редактора, CLI и Cloud Agents. Сторонние модели, такие как Claude, GPT и Gemini, требуют Premium или выше и оплачиваются по прейскурантной цене API из предоплаченного баланса.

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

**Почему agent -p не меняет мои файлы?** Без --force (или его псевдонима --yolo) print-режим только предлагает изменения, а не применяет их. Используйте agent -p --force в скриптах, которые должны записывать файлы, и только в тех репозиториях и на тех машинах, где вы спокойно можете это разрешить.

**Нужно ли, чтобы редактор Cursor был установлен или открыт?** Нет. Cursor CLI устанавливается отдельно и работает сама по себе в любом терминале на macOS, Linux, WSL или Windows. Аккаунт, правила и настройки MCP у неё общие с редактором, но открытый редактор ей не нужен.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/