Ты уже умеешь работать в Windsurf — открываешь чат, пишешь промпт, получаешь код. Но это только 20% от того, на что способен этот инструмент. Остальные 80% — в настройках, которые большинство вайб-кодеров никогда не трогают.
2026/04/16
Ты уже умеешь работать в Windsurf — открываешь чат, пишешь промпт, получаешь код. Но это только 20% от того, на что способен этот инструмент. Остальные 80% — в настройках, которые большинство вайб-кодеров никогда не трогают.
В этом гайде разберём продвинутую настройку Windsurf: Cascade Rules, Arena Mode, кастомные агенты, MCP-интеграции с GitHub и Supabase. Хаки собраны из реального опыта и транскрипций 10 видео от опытных пользователей.
Cascade Rules — это набор инструкций, которые Windsurf читает перед каждым запросом. Без них AI каждый раз заново анализирует твой проект, тратит токены и иногда ошибается с версиями фреймворков. С Rules он сразу знает, что ему делать.
Есть два типа правил:
Global Rules — применяются ко всем проектам. Сюда пишешь универсальные инструкции: язык ответов, стиль кода, запрет на удаление существующей логики без подтверждения.
Workspace Rules — специфичны для конкретного проекта. Здесь указываешь стек, версии, архитектурные решения.
Открой Settings → Cascade → AI Rules. Увидишь два раздела: Global AI Rules и Workspace AI Rules.
Для воркспейс-правил файл хранится в директории проекта по пути windsurf/rules — его можно коммитить в репозиторий и шарить с командой.
Важный лимит: суммарный объём глобальных и воркспейс-правил не может превышать 12 000 строк кода. На практике это очень много — даже подробные правила занимают 200–400 строк.
Плохой пример правил — общие слова вроде «пиши чистый код». Хороший — конкретные технические инструкции.
Примеры полезных правил для Next.js проекта:
- Используй Next.js 15 с App Router. Никогда не используй Pages Router.
- Стек: TypeScript, Tailwind CSS, shadcn/ui, Sanity CMS.
- При добавлении новой страницы автоматически добавляй роут в app-routes.ts.
- Не удаляй существующий код без явного подтверждения в промпте.
- Отвечай на русском языке.
- Импорты только через @/ алиасы, не через относительные пути.Не надо писать правила вручную — попроси сам Windsurf это сделать. Открой Cascade и напиши:
Проанализируй package.json, tsconfig.json и структуру проекта.
Сгенерируй Workspace Rules для этого проекта.Windsurf изучит конфигурацию и создаст подходящие правила. Тебе останется только проверить и подкорректировать под свои предпочтения.
Если прописать в Rules текущий стек, Windsurf будет предупреждать при попытке добавить несовместимые инструменты. Например, если проект на Next.js и ты спросишь про интеграцию Svelte — он объяснит риски, а не просто сгенерирует код.
Cascade Memories — система сохранения контекста между разговорами. Это отличается от Rules: правила ты пишешь сам, а воспоминания Cascade создаёт автоматически на основе ваших предыдущих сессий.
Если ты несколько раз объяснял Windsurf, что в проекте используется кастомная система аутентификации — он запомнит это и учтёт в следующий раз.
Settings → Cascade → Manage Memories. Здесь можно:
Хак: После добавления или изменения Rules всегда нажимай «Refresh Rules» — без этого изменения не применятся в текущей сессии.
Хак: Установи «Activation mode» правила в «Always On» — тогда оно будет применяться по умолчанию без необходимости каждый раз вызывать через @.
MCP (Model Context Protocol) — это стандарт, который позволяет Cascade работать с внешними сервисами: читать данные из GitHub, управлять базой данных Supabase, получать макеты из Figma.
Без MCP Windsurf знает только то, что находится в твоём редакторе. С MCP он становится агентом, который может действовать в реальном мире.
MCP-серверы — это локальные процессы, которые через веб-API общаются с внешними сервисами и предоставляют Cascade доступ к нужным данным. Ключевое: серверы Open Source, создавать их самому не нужно — бери готовые.
mcp_config.json вставь JSON-конфигурацию сервераПример конфигурации для GitHub MCP:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}GitHub MCP — Cascade может читать issues, PRs, создавать коммиты, работать с репозиторием напрямую из чата.
Supabase MCP — прямой доступ к базе данных. Попроси Cascade проанализировать структуру таблиц или написать SQL-запрос на основе реальной схемы.
Figma MCP — Windsurf получает доступ к твоим дизайн-файлам и может генерировать компоненты, точно повторяющие макет.
Slack MCP — агент читает стандарты кодирования из Slack-каналов и использует их при рефакторинге.
Хак для Figma MCP: если после установки статус показывает «loading» больше минуты — не жди. Удали сервер и добавь заново, обычно со второго раза подключается мгновенно. При авторизации убедись, что в браузере открыт нужный аккаунт Figma — иначе подключится не тот воркспейс.
Cascade работает в двух режимах, и путаница между ними — частая причина неожиданных результатов.
Write Mode — Cascade создаёт и редактирует файлы. Используй для реализации фич, рефакторинга, исправления ошибок.
Chat Mode — оптимизирован для вопросов о коде и общих принципах. Файлы не меняет. Используй для обсуждения архитектуры, объяснения кода, планирования.
Хак: Перед тем как дать Windsurf большую задачу, переключись в Chat Mode и попроси составить «game plan» — пошаговый план действий. Обсуди его, сохрани в markdown-файл, и только потом переходи к Write Mode. Это снижает риск того, что AI уйдёт не в ту сторону.
Сохрани этот план в файл PLAN.md.
Потом используй @PLAN.md в каждом новом чате, чтобы не терять контекст.Windsurf даёт доступ к нескольким моделям, и выбор модели влияет и на качество, и на расход кредитов.
Практика опытных пользователей из транскрипций:
Хак: Настрой автоматическую генерацию коммитов через DeepSeek — сэкономишь платные кредиты для реального кодинга.
Хак: Если LLM остановился с ошибкой при редактировании файлов — просто напиши continue. В большинстве случаев он продолжает с места остановки.
По умолчанию Windsurf спрашивает разрешение перед каждой командой в терминале. Для частых операций это замедляет работу.
Settings → Cascade → Terminal Permissions. Три варианта настройки:
Allow List — команды, которые выполняются автоматически без подтверждения. Сюда вноси безопасные команды: git status, git add, pnpm install, pnpm lint.
Deny List — команды, которые никогда не выполняются автоматически. Сюда: rm -rf, DROP TABLE, деструктивные операции.
Auto-execution — когда команда не в списках, Cascade сам решает, нужно ли разрешение. Требует premium-модели.
Пример Allow List для Next.js разработки:
git status
git add
git commit
pnpm install
pnpm dev
pnpm build
pnpm lintAI работает с контекстом того, что видит в проекте. Мёртвый код, неиспользуемые файлы, устаревшие директории — всё это «шум», который снижает качество ответов.
Регулярно запускай очистку:
Проверь, используется ли директория /home где-нибудь в проекте.
Если нет — удали её.Windsurf проверит зависимости и предложит удалить только действительно неиспользуемый код.
Windsurf видит все открытые вкладки и учитывает их как контекст. Открытый, но нерелевантный файл может запутать AI.
Хак: Перед важным промптом закрой все вкладки, кроме тех файлов, с которыми работаешь прямо сейчас.
Хак противоположный: Если хочешь, чтобы Windsurf понял связь между файлами — открой их все одновременно. Например, при создании нового туториала открой существующие аналогичные файлы, и Cascade воспроизведёт нужный стиль и структуру автоматически.
Большие промпты типа «переделай весь проект» — плохая идея. Малые изменения лучше по трём причинам: легче ревьюить, проще откатить, меньше вероятность сломать что-то смежное.
Вместо «добавь авторизацию» пиши «добавь форму логина в файл login.tsx».
Не всегда нужно открывать Cascade — для точечных изменений есть In-line Command (Ctrl+I на нужном фрагменте кода). Windsurf изменит только выделенный участок, не трогая остальной файл.
Работает умно: если попросить изменить цвет поля email в форме, Windsurf заметит, что поле password тоже должно быть обновлено для визуальной консистентности.
Часто используемые команды терминала, которые ты обычно гуглишь — собери в markdown-файл. Когда нужна команда, просто покажи файл Windsurf через @ и попроси найти нужную.
Перед миграцией БД, рефакторингом архитектуры или любой задачей с высоким риском:
PLAN.md@PLAN.md в первый промптЕсли в процессе AI начинает «плыть» или дублировать код — начни новый чат с тем же @PLAN.md. Контекст восстановится.
Если работаешь с UI и хочешь консистентного дизайна — пропиши дизайн-систему в Rules. Это один из самых ценных сценариев использования правил: LLM не знает твои кастомные токены и стили, пока ты сам не объяснишь.
Пример правил для дизайн-системы:
Используй только цвета из дизайн-токенов: primary=#6366F1,
secondary=#8B5CF6, background=#0F0F0F.
Все компоненты строй на shadcn/ui.
Border radius: 8px для карточек, 4px для кнопок.
Типографика: Inter, размеры только из шкалы: 12/14/16/20/24/32.Правила с твоей дизайн-системой ценнее любых готовых шаблонов — потому что они содержат информацию о твоём конкретном коде и стилях.
Линтинг — не про красоту кода, а про то, чтобы Windsurf эффективно работал с TypeScript. Если линтер настроен, можно скормить его вывод Cascade:
pnpm lintИ попросить исправить все найденные ошибки сразу. Windsurf работает с несколькими файлами параллельно — ты видишь изменения в реальном времени и одобряешь каждую правку.
Это работает лучше, чем описывать ошибки словами — Cascade получает точный, машиночитаемый список проблем.
Windsurf Rules и .cursorrules — это одно и то же? Похожая концепция, но реализация разная. В Cursor правила хранятся в папке .cursor/rules/ как markdown-файлы. В Windsurf — в windsurf/rules. Логика применения схожа: файлы отправляются как системный контекст LLM.
Сколько правил можно написать? Суммарный лимит глобальных и воркспейс-правил — 12 000 строк. На практике даже подробные правила занимают 300–500 строк, так что лимит практически недостижим.
MCP работает только в Windsurf? Нет, MCP — это открытый стандарт. Те же серверы работают в Cursor, Claude Desktop и других инструментах, поддерживающих протокол.
Как понять, что Rules применились? После изменения Rules нажми «Refresh Rules» в разделе Manage Memories. Если забыть это сделать — новые правила в текущей сессии не заработают.
Windsurf удалил рабочий код. Как вернуть? Используй механизм Checkpoint — Windsurf создаёт контрольные точки перед изменениями. В Cascade есть кнопка отката к предыдущему чекпоинту. Также используй git — коммить перед большими задачами.
Какую модель выбрать для вайб-кодинга? Для большинства задач — Claude Sonnet или GPT-4.1. Для архитектурных решений и высокоуровневого планирования попробуй Gemini 2.5 Pro. Для рутины (коммиты, простые правки) — DeepSeek, он бесплатный.
Windsurf из коробки — хороший инструмент. С правильной настройкой — это другой уровень продуктивности.
Минимальный набор для старта:
Эти четыре шага занимают 30 минут, но экономят часы каждую неделю.
Статья обновлена: апрель 2026
Версия Windsurf: актуальная на дату публикации (после приобретения Cognition)
Читай также: