Как эффективно использовать Claude Code: опыт разработчика по созданию полноценного SaaS-приложения

Разработчик, который занимается созданием SaaS-продуктов с 2021 года, недавно построил полноценное приложение под названием codefluent.app с помощью Claude Code. Ключевая идея заключается в том, что эффективное использование инструмента требует подробных технических спецификаций, а не расплывчатых промптов вроде «построй мне приложение». Разработчик подчеркивает, что все архитектурные решения принимает сам, используя Claude Code для быстрого преобразования четких спецификаций в рабочий код.

Детали проекта и стек технологий

Проект — это codefluent (codefluent.app), приложение с интервальным повторением для изучения синтаксиса программирования. Вся целевая страница была создана с помощью Claude Code путем описания разделов и ссылок на желаемое визуальное направление, что привело к отзывчивой, чистой разметке на Tailwind.

Технологический стек:

• SvelteKit монолит
• PostgreSQL + Drizzle ORM
• Better Auth
• OpenRouter для функциональности LLM
• Stripe
• CodeMirror 6
• Tailwind v4
• Railway

Метод работы: подробные спецификации

Разработчик не использует расплывчатые промпты. Вместо этого каждая функция начинается с написания точных требований: схема, стратегия аутентификации, иерархия компонентов, структура API и крайние случаи. Затем Claude Code читает существующую кодовую базу, улавливает шаблоны и соглашения и пишет код, который им соответствует.

Пример использованного промпта:

«Добавьте таблицу daily_stats с колонками userId, date, cardsStudied, correctCount, streakCount. Создайте сервисную функцию, которая выполняет upsert при завершении практики. Увеличивайте стрик, если пользователь практиковался вчера, сбрасывайте до 1, если нет. Добавьте серверную конечную точку, которая возвращает статистику за последние 30 дней для вошедшего пользователя.»

Разработчик проверяет каждую строку сгенерированного кода, выявляет крайние случаи, улучшает его и выпускает. Суть в том, что архитектурные решения — какие таблицы существуют, как работает область действия аутентификации, бизнес-правила — принимаются разработчиком, а не ИИ.

Что сработало хорошо

• Операции с базой данных: Описание изменений схемы и ограничений приводило к рабочим миграциям Drizzle за секунды.
• Интеграция Stripe: Указание потока оформления заказа и жизненного цикла вебхуков генерировало весь вспомогательный код, экономя как минимум полный день работы.
• Команда /simplify: Эта команда проверяет код на повторное использование, качество и эффективность, выявляя технический долг, который разработчик мог оставить.
• Согласованность: Как только были установлены шаблоны для структуры маршрутов и сервисов, Claude Code поддерживал их с минимальным отклонением.

Проблемы и предостережения

• Излишняя сложность: Claude Code склонен создавать абстракции и вспомогательные функции даже для одноразовых случаев. Разработчику приходилось активно возражать: «проще, сделай прямое решение».
• Сложность аутентификации: Better Auth с обработкой сессий SSR в SvelteKit был сложным. Сгенерированные шаблоны иногда работали изолированно, но ломались при серверном рендеринге, требуя от разработчика понимания потока аутентификации для выявления проблем.
• Система оценки ИИ: Приложение использует LLM для оценки объяснений кода. Достижение последовательной оценки без излишней снисходительности или строгости потребовало обширной ручной итерации промптов, которую нельзя было делегировать ИИ.

Ключевой вывод

Claude Code не заменяет понимание того, что вы строите. Разница между хорошими результатами и беспорядком зависит от вашей способности писать четкие спецификации и выявлять плохие решения в выводе. Если вы уже выпускали проекты, вы уже знаете, на что обращать внимание. Если нет, это именно тот навык, который нужно развивать — а не техники промптинга.