🤖 Настройка среды разработки для AI-ассистента

Настройка среды разработки для работы с AI-ассистентом

Ключевые тезисы:

Без правильной среды AI-ассистент не понимает проект и пишет абстрактный, нерабочий код.
Минимальный набор инструментов: локальный сервер, фреймворк, редактор кода и AI-ассистент.
Ключевой файл claude.md с описанием архитектуры проекта — основа для понимания контекста AI.
Эффективная работа с AI — это управление контекстом, выбор модели и правильные режимы задач.

Минимальный набор инструментов

Локальный веб-сервер

Веб-приложение — это папка с десятками файлов. Для локальной разработки нужен сервер, который запускает эту цепочку (веб-сервер + язык + БД) на вашем компьютере.

Готовые пакеты (все в одном):

XAMPP: Бесплатный, но только для Windows.
MAMP: Изначально для macOS, есть версия для Windows (бесплатная версия урезана).
Surfbay (используется в видео): Работает на Windows и macOS. Бесплатная версия позволяет держать до 5 сайтов.

Что дают такие пакеты:

Удобная настройка локальных доменов (например, myproject.local).
Визуальные инструменты для работы с БД (phpMyAdmin, pgAdmin).
Поддержка MySQL и PostgreSQL.

Установка Surfbay:

Скачать с сайта.
Указать домен (например, myproject.local).
Выбрать PHP (последнюю стабильную версию).
Создать в папке проекта файл index.php с кодом <?php echo "Hello"; ?>.
Открыть в браузере myproject.local и убедиться, что сервер работает.
Сохранить пароль от MySQL (понадобится для установки фреймворка).

Фреймворк (OneShot)

OneShot — это PHP-фреймворк, созданный автором для быстрого запуска SaaS-проектов. Он включает готовые решения для регистрации, авторизации, подписок, платежей, админ-панели и т.д.

Преимущества:

Не нужно тратить время на базовые, одинаковые для всех проектов вещи.
Архитектура фреймворка описана в файлах репозитория, что помогает AI-ассистенту сразу понимать структуру проекта и писать код, который в неё вписывается.

Установка:

Скачать актуальную версию (ветка dev или main) с GitHub.
Распаковать архив в папку сайта, созданную в Surfbay.
Запустить инсталлятор для настройки БД и базовой конфигурации.

Редактор кода (Cursor)

Популярные варианты (все — форки VS Code с добавлением AI-функций):

Cursor (выбор автора) — наиболее удобный и популярный для работы с AI.
Windsurf
Cline

Установка Cursor:

Скачать с cursor.com.
Использовать бесплатный тариф, так как код пишут не редакторы, а AI-сервисы (Claude, GPT, Gemini). Платить нужно напрямую провайдеру AI.

AI-ассистент (Claude Code)

Три основных ассистента для кода: Claude Code (Anthropic), Codex (OpenAI), Gemini (Google).

Установка Claude Code:

Для macOS/Linux: Установить одной командой из терминала.
Для Windows: Предварительно установить Git, затем запустить команду установки Claude.
В редакторе Cursor установить расширение Claude Code (производитель: Anthropic).
Авторизоваться в аккаунте с платным тарифом.

Настройка AI-ассистента и принципы работы

Ключевой шаг: Инициализация проекта

Первое действие в любом новом проекте — запустить команду init через интерфейс Claude Code.

Что происходит: AI сканирует структуру проекта, зависимости и создаёт файл claude.md в корне.
Зачем нужен claude.md: Это инструкция для AI о проекте (язык, фреймворк, правила). У OneShot уже есть готовая заготовка.
AI не имеет памяти между сессиями. При каждом новом чате он начинает с нуля. Файл claude.md даёт ему контекст.
Файл нужно редактировать вручную, добавляя особенности архитектуры и проекта. После каждой значимой задачи просите AI обновить этот файл.

Управление контекстом

У каждой языковой модели есть контекстное окно (по умолчанию ~200 000 токенов). В него входит весь промпт, история чата, прочитанные файлы.

Команды:

/context: Показывает, сколько контекста использовано и осталось.
/clear: Полностью очищает контекст (как новый чат).
/compact: Сжимает историю чата, оставляя "важное" (может терять нужный контекст).

Лучший подход: Делить задачи на небольшие части, чтобы укладываться в лимит.

Выбор модели (Claude)

Haiku: Не для написания кода. Используется самим Claude Code для вспомогательных задач (сканирование файлов).
Sonnet (основная): Быстрее, дешевле, справляется с большинством задач.
Opus: Медленнее, дороже, но лучше для размытых или архитектурно сложных задач. Новичкам может быть полезнее начинать с Opus.

Режимы выполнения задач

Plan Mode (режим плана): AI сначала пишет план действий, не меняя файлов. Вы его проверяете и корректируете. Обязателен для крупных задач.
Auto Edit (автоматическое редактирование): AI вносит все изменения сам. Хорош для небольших, понятных правок.
Ask Before Edit (спрашивать перед редактированием): AI показывает каждое изменение и ждёт подтверждения. Для чувствительных изменений и полного контроля.

Стоимость и лимиты

Стартовый тариф Claude Code: ~$20/месяц (достаточно для Sonnet).
Для серьёзной работы с большим кодом: $100–200/месяц.
Оплата по токенам (фактическому объёму) обычно дороже.
В подписке есть лимиты: 5-часовая сессия и недельный лимит на объём (/usage).
При достижении лимита можно переключиться на другой аккаунт.

Цикл работы на реальном примере (добавление модуля "Контент")

Задача: Добавить в OneShot универсальный модуль для управления текстовым контентом (страницы, посты, категории, теги) с админкой и визуальным редактором.

Начинаем с Plan Mode. Пишем подробный промпт с описанием:
- Что нужно сделать (универсальный модуль).
- Какие сущности (страницы, посты, категории, теги).
- Что должно быть в админке (поля, статусы, SEO-метатеги).
- Логика шаблонов (разное отображение для поста и страницы).
- Рекомендации по роутингу и оптимизации БД.
Проверяем рассуждение модели. Смотрим, как AI разбирает задачу. Если видим непонимание — останавливаем (Escape), уточняем в чате и запускаем снова.
Утверждаем план. Когда план нас устраивает, запускаем выполнение (часто в режиме Auto Edit).
Тестируем в браузере. Открываем созданные страницы, проверяем функционал.
Исправляем ошибки. Если что-то не работает, копируем текст ошибки из браузера или логов и отправляем AI в чат без объяснений. AI сам поймёт, что исправить.
Обновляем контекст. Просим AI обновить файл claude.md с учётом сделанных изменений. Одобряем предложенные правки.
Новая задача — новый чат. Для несвязанной задачи начинаем новый чат с командой /clear. AI при старте автоматически прочитает обновлённый claude.md.

Выводы

Правильно настроенная среда (сервер + фреймворк + редактор + AI) — фундамент для эффективной разработки с AI-ассистентом.
Файл claude.md — это главный инструмент для передачи контекста о проекте. Без него AI каждый раз пишет "в пустоту".
Работа в Plan Mode для крупных задач экономит время и предотвращает неверную реализацию.
Качество кода от AI зависит не от "секретных промптов", а от чёткой архитектуры проекта, которую он понимает через claude.md.