Zed AI для новичка: как включить агента и внести первую правку в проект

Zed можно использовать не только как быстрый редактор, но и как рабочее место для AI-агента. Для первого знакомства не поручайте ему новую систему целиком. Дайте одну маленькую правку, посмотрите предложенный diff и самостоятельно запустите проверку.

Подготовьте безопасный проект

Откройте небольшой репозиторий, который уже запускается. Перед работой выполните тесты и создайте отдельную ветку. Если проект учебный, подойдет список задач, калькулятор или страница с формой.

Для примера добавим проверку имени: поле не должно принимать строку из одних пробелов. Это маленькая задача с очевидным результатом и без изменения базы.

Настройте модель в Zed

Откройте Agent Panel через палитру команд agent: new thread или значок агента в нижней панели. До первой задачи выберите провайдера и модель. Конкретный набор зависит от вашей учетной записи и настроек Zed.

Если провайдер требует API-ключ, храните его в настройках или переменной окружения. Не вставляйте ключ в файл проекта и тем более в текст промпта, который потом попадет в историю команды.

Сначала попросите план

Дайте агенту контекст только по нужной части проекта:

Найди форму создания профиля и существующую валидацию имени. Ничего не меняй. Объясни, где лучше отклонять строку из одних пробелов, и назови тесты, которые нужно добавить. Не меняй API и структуру формы.

Откройте названные файлы. Если агент предлагает установить библиотеку ради проверки trim(), остановите его: для такой задачи новая зависимость не нужна.

Попросите минимальную правку

После согласования плана продолжите:

Добавь проверку: после удаления пробелов по краям имя должно содержать хотя бы один символ. Покажи понятное сообщение рядом с полем. Добавь один тест на строку из пробелов. Не форматируй остальные файлы и не меняй тексты других ошибок.

Zed Agent умеет читать и изменять файлы, запускать команды и показывать изменения. Разрешайте только команды, смысл которых понимаете. Установка пакетов и любые операции с внешними сервисами для этой задачи не нужны.

Проверьте diff и состояние проекта

В режиме review примите или отклоните отдельные фрагменты. Проверьте четыре случая: нормальное имя, имя с пробелами по краям, пустая строка и строка из пробелов. Затем запустите тесты самостоятельно.

Если правка неудачная, удобнее вернуться к checkpoint или отклонить конкретный hunk, чем просить агента поверх ошибки сделать еще одну большую переработку.

Такой цикл легче осваивать на задачах, где результат можно увидеть и проверить. В проектах ИИ-лаборатории Глеба Кудрявцева тот же принцип применяется в VS Code с Codex, а дальше связывается с Git, базой, безопасностью и деплоем.

Первая работа с Zed AI закончена, когда в ветке есть только нужная валидация и тест, исходные сценарии не сломаны, а каждое изменение в diff вам понятно.