Windsurf

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

Установка

Windsurf скачивается с windsurf.com — кнопка Download в правом верхнем углу. На macOS открываем скачанный .dmg, перетаскиваем в Applications и запускаем. На Windows запускаем инсталлятор и следуем инструкциям. На Linux доступны .deb и .rpm пакеты.

При первом запуске Windsurf проведёт онбординг: выбор раскладки клавиш (VS Code или Vim), перенос настроек из VS Code или Cursor, тема оформления. Перенос работает так же, как в Cursor — настройки переносятся автоматически, а расширения — по возможности, с учётом совместимости. После этого нужно залогиниться или создать аккаунт — через Google, GitHub или почту. При старте предлагается двухнедельный Pro-триал — для его активации запрашиваются данные карты. Если хотите пропустить и сразу использовать бесплатный план — ищите соответствующую ссылку на экране оплаты. Бесплатный план предоставляет ограниченное количество кредитов (точные значения могут меняться)

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

Cascade: агент Windsurf

Агент в Windsurf называется Cascade. Открывается через Cmd+L / Ctrl+L или кликом на иконку Cascade в правом верхнем углу. Cascade работает в трёх режимах, переключаемых через toggle под полем ввода или сочетанием Cmd+. / Ctrl+.:

Code — агентный режим по умолчанию. Cascade самостоятельно читает файлы, вносит изменения, запускает команды в терминале и итерирует. Внутри разговора строится to-do список для отслеживания прогресса на сложных задачах.

Plan — режим планирования. Cascade изучает кодовую базу и сохраняется как отдельный план, доступный для повторного использования. Никаких изменений в код до вашего подтверждения. Когда план готов, нажимаете «Implement» — Cascade переключается в Code режим и начинает реализацию. Готовые планы можно @-упоминать в новых сессиях, чтобы продолжить работу с чистым контекстом.

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

Что отличает Cascade от других агентов

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

Ценообразование по промптам, а не токенам. В Windsurf стоимость обычно привязана к количеству сообщений (кредитов), а не напрямую к числу выполненных действий, что делает расходы более предсказуемыми.

Собственные модели SWE. У Windsurf есть своя линейка моделей — SWE-1.5 и SWE-1.5 Fast, обученных специально на задачах software engineering. Они позиционируются как близкий по качеству к frontier-моделям на кодинговых задачах, но работают быстрее. Помимо собственных моделей доступны Claude, GPT, Gemini, Grok, GLM — выбирается в выпадающем меню под полем ввода. Также есть BYOK для подключения своих API-ключей.

Arena Mode. Запускаем двух агентов с разными моделями параллельно на одну задачу, сравниваем результаты и голосуем за лучший. Можно выбрать конкретные модели или дать Windsurf подобрать их случайно из группы «быстрые» или «умные».

Codemaps. Cascade может строить визуальные карты структуры кодовой базы — показывает связи между файлами, модулями и ключевыми компонентами. Это инструмент навигации и понимания архитектуры: можно быстро увидеть, где находится нужная логика и как части проекта связаны между собой. Каждый узел кликабелен и ведёт к соответствующему месту в коде. Открыть: Ctrl+Shift+P → «Focus on Codemaps View». Карты можно @-упоминать в Cascade как контекст.

Настройка поведения агента

В Windsurf четыре способа задать агенту постоянные инструкции — они дополняют друг друга:

Rules хранятся в .windsurf/rules/, попадают в git и применяются автоматически. Можно задать glob-паттерн (например, только для *.test.ts) или сделать правило всегда активным. Пример правила с frontmatter:

---
trigger: always
---
Используй TypeScript strict mode.
Не изменяй файлы в директории auth/ без явного указания.

Skills — пакеты инструкций для сложных повторяющихся задач. Skill — это папка в .windsurf/skills/ с файлом SKILL.md и вспомогательными файлами (шаблоны, чеклисты, конфиги). Cascade загружает содержимое skill только когда решает его применить — это не раздувает контекст без нужды. @-упоминание skill вызывает его принудительно.

Workflows — переиспользуемые последовательности шагов, вызываемые вручную через /имя-воркфлоу в поле ввода. Хранятся в .windsurf/workflows/ как markdown-файлы. Подходит для регулярных процессов: ревью PR, деплой, запуск тестовых пайплайнов.

AGENTS.md — стандартный файл с инструкциями для агентов, который Windsurf (и другие агенты, поддерживающие этот формат) автоматически подхватывает из корня проекта или нужной директории. Удобен для командного шаринга общих правил через git.

В следующем шаге разберём расширения для VS Code — Cline, Roo Code и Copilot — для тех, кто хочет агентные возможности без смены редактора.