Установка AI-редактора с агентом Cascade: отдельное приложение или плагин, вход, первый проект и настройка моделей.
Windsurf — редактор кода с агентом Cascade, который видит проект целиком и вносит правки сразу в несколько файлов. Скачивается как отдельное приложение или ставится плагином в VS Code и JetBrains.
Классический автокомплит дописывает строку. Cascade работает на уровне задачи: вы формулируете цель, агент читает файлы проекта, предлагает план и вносит изменения в несколько файлов, показывая диффы.
Второе отличие — единая среда: терминал, браузер и редактор в одном окне, поэтому агент может запустить тесты и посмотреть результат, а не только написать код. Это же требование определяет и системные требования.
| Компонент | Минимум | Комфортно |
|---|---|---|
| ОС | Windows 10+, macOS 12+, Ubuntu 20.04+ | последние версии |
| Память | 8 ГБ | 16 ГБ для крупных проектов |
| Диск | 2 ГБ | 10 ГБ с кэшем и индексами |
| Сеть | обязательна | стабильные 10+ Мбит/с |
| Аккаунт | GitHub, Google или e-mail | — |
Модели работают в облаке, поэтому локальная видеокарта не нужна. Офлайн-режима нет: без сети Cascade не отвечает.
sudo dpkg -i windsurf*.deb
Начните с задачи, которую легко проверить: «объясни структуру проекта» или «найди, где обрабатывается ошибка авторизации». Так вы увидите, как агент читает код, и не рискуете получить большой дифф в первый же день.
| Настройка | Зачем | Где |
|---|---|---|
| Выбор модели | Разная скорость и качество | Настройки → Models |
| Autocomplete | Вкл/выкл подсказки | Настройки → Editor |
| Terminal access | Разрешить агенту команды | Настройки → Cascade |
| Privacy | Исключить файлы из индексации | .codeiumignore |
Файл .codeiumignore работает как .gitignore: в него стоит добавить .env, ключи и тяжёлые артефакты сборки.
| Симптом | Причина | Решение |
|---|---|---|
| Cascade не отвечает | Нет сети или лимит тарифа | Проверьте соединение и остаток запросов |
| Медленная индексация | Большой проект, HDD | Исключите node_modules и dist |
| Не видит файлы | Открыта не та папка | File → Open Folder, корень проекта |
| Не работает вход | Блокировка провайдера | VPN при регистрации, см. раздел оплаты |