Найти в Дзене

7 фишек при работе с Claude Code

Часто слышим, что вайбкодинг только для небольших проектов и ничего более-менее серьезного на этом не сделаешь, тем более, если не знаешь программирования. Решили попробовать на члене нашей команды — справится или нет с такой задачей. Взяли Claude Code и за неделю создали полноценную систему управления задачами: ролевая модель для 4 типов пользователей, интеграция с Google Sheets, автоматические уведомления, экспорт данных, система продления дедлайнов. Код модульный, масштабируемый. Для тех, кто не в курсе: Claude Code — это инструмент от Anthropic, который ставится в терминал и может работать с файлами на вашем компьютере. Он сам создает код, редактирует файлы, запускает тесты и даже заливает все на GitHub. По сути, полноценный помощник-разработчик. Работаем с Claude Code уже не первый месяц, поэтому знаем подводные камни. Благодаря этому опыту проект пошел быстро — сразу следовали проверенным принципам. И да, код создавала гуманитарий. Ниже фишки, которые вам точно пригодятся, если
Оглавление

Часто слышим, что вайбкодинг только для небольших проектов и ничего более-менее серьезного на этом не сделаешь, тем более, если не знаешь программирования. Решили попробовать на члене нашей команды — справится или нет с такой задачей.

Взяли Claude Code и за неделю создали полноценную систему управления задачами: ролевая модель для 4 типов пользователей, интеграция с Google Sheets, автоматические уведомления, экспорт данных, система продления дедлайнов. Код модульный, масштабируемый.

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

Для тех, кто не в курсе: Claude Code — это инструмент от Anthropic, который ставится в терминал и может работать с файлами на вашем компьютере. Он сам создает код, редактирует файлы, запускает тесты и даже заливает все на GitHub. По сути, полноценный помощник-разработчик.

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

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

!!! Больше кейсов на канале “AI для продакта”.

1. Детальное ТЗ — это половина успеха

Главная ошибка новичков: сразу идти в Claude Code и просить "сделай мне бота для задач".

Правильный подход: сначала все проработать в обычном Claude.

Обсудите с нейронкой проект, прежде, чем писать код. Пройдитесь по каждой функции и обговорите, где можно сделать проще, быстрее, надежнее.
Обсудите с нейронкой проект, прежде, чем писать код. Пройдитесь по каждой функции и обговорите, где можно сделать проще, быстрее, надежнее.

Как делали мы:

  1. Черновой функционал — описали на пальцах, что хотим
  2. Обсуждение с Claude — разобрали возможные проблемы и варианты реализации
  3. Структура по блокам — набросали архитектуру и основные функции
  4. User Journey — расписали движение каждого типа пользователя по боту
-4

В итоге получилось ТЗ листов на 40. Звучит много. Зато потом в Claude Code просто скармливали по частям: "сделай модуль 1", он делает, тестируем, идем дальше.

Результат: доработки были минимальными, Claude Code сразу понимал задачу и не фантазировал лишнего.

2. Чистый код — это не заумность, а выживание

Каждый второй запрос повторяли как мантру (цитата дословно):

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

Почему это критично: даже не зная программирования, понимаем — если одно изменение ломает все остальные функции, проект мертв.

Практика: Claude Code отлично следует таким инструкциям, если их четко проговаривать. Получили модульную архитектуру, где каждая часть живет своей жизнью, но работает в общей системе.

3. Ежедневная уборка спасает проект

В конце каждого рабочего дня просили Claude:

Проверь, нет ли временных решений и файлов. Если создавались для отладки — вычисти из проекта.

Почему важно: временные костыли имеют неприятную особенность становиться постоянными. А потом весь проект превращается в неподъемный набор файлов.

Если регулярно акцентировать Claude на чистке файлов. проект остается чистым, и надежда на то, что мусора накопилось немного, вполне обоснованная.

4. Большие файлы — враг народа

Каждый день (или пару раз в день) при новом подключении просили:

Проверь чистоту кода.
-5

На прошлых проектах постоянно попадались файлы-монстры. Критический лимит: больше 800 строк — это уже проблема.

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

-6

Поэтому в этом проекте сразу поставили правило: ежедневно проверять размер файлов и при необходимости делать рефакторинг. За всю разработку такая ситуация возникла тут только один раз.

5. Рефакторинг = перезагрузка Claude

Если находились уязвимости от прошлой работы, просили делать рефакторинг проекта. Занимает минут 30, Claude отчитывается, что все готово.

Важный момент: после существенного рефакторинга ОБЯЗАТЕЛЬНО перезапустить Claude при новом соединении. Иначе он начинает врать, что все исправлено, хотя баги остались.

6. При больших задачах — всегда новый старт

Когда даете Claude большой блок работы (например, "сделай всю систему уведомлений" или "добавь экспорт в CSV"), запускайте его каждый раз заново, чтобы он с чистого листа оценивал проект.

7. Следите за процессом работы

Смотрите, что Claude пишет в процессе. Иногда видно: "странно, у меня не получается так, не получается этак, а сделаю-ка я пока вот так". То есть он ставит костыль вместо глобального решения проблемы.

Это надо пресекать на корню. Лучше потратить время на правильное решение, чем потом разгребать развалины.

Что в итоге получилось

Telegram-бот для управления задачами с полным функционалом:

Ролевая система — администратор, менеджер, исполнитель, клиент. У каждого свои права и возможности.

Система уведомлений — новые задачи, напоминания о дедлайнах, изменения статусов, запросы на продление.

Интеграции — Google Sheets для синхронизации данных, CSV экспорт, PostgreSQL/SQLite с миграциями.

Технологии — Python, aiogram, SQLAlchemy, Google API, Docker. Полный стек для продакшна.

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

Сколько это заняло времени

3 дня по 3 часа на основную разработку + столько же на доработки. Итого около 20 часов.

Работали только на Claude Opus 4 — Sonnet подходит только для мелких правок, на больших задачах плывет. Когда лимиты кончались — либо делали мелкие правки типа "поменяй название кнопки", либо шли отдыхать до следующего дня.

Лайфхак: пока Claude пишет код, можно заниматься другими задачами. Главное — потом просмотреть журнал действий, хотя бы мельком.

Главный вывод

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

Детальное ТЗ + контроль размера файлов + ежедневная чистка + перезапуск Claude после рефакторинга + постоянное наблюдение за процессом = рабочий продукт за разумное время

Без этих принципов проект превратится в кашу из костылей, которая развалится при первом же серьезном изменении.

Хотите попробовать?

Весь код выложен на GitHub

В репозитории найдете:

  • Полную документацию по установке
  • Docker-контейнеры для быстрого запуска
  • Примеры настройки Google Sheets
  • Структуру базы данных

Сейчас бот работает на небольшую команду — все перешли из хаоса рабочих чатов в структурированную систему. Ничего не теряется, все под контролем. Бот дорабатывается до сих пор — в процессе использования хочется все больше и больше удобства.

Если нужна помощь с настройкой под вашу команду — обращайтесь в личку. Поможем разобраться и адаптировать под ваши задачи.

А какие у вас фишки при работе с большими проектами в Claude Code? Делитесь в комментариях — соберем коллективную мудрость!

!!! Больше кейсов на канале “AI для продакта”.