Денис Матаков

Блог технического руководителя

Секреты продуктивной работы с Claude Code

Написано

Денис Матаков

в

,

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

1. Подготовка репозитория: README

Первое, что необходимо сделать в новом проекте, — попросить Claude сгенерировать README.md. Но не в «человеческом» понимании, где много описаний, картинок и диаграмм, а в утилитарном виде:

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

Формулировать запрос стоит максимально чётко: «Напиши краткий README, который ты будешь использовать для дальнейшей работы над новыми фичами». Такой файл избавит от лишних затрат токенов при повторных обращениях.

2. Правила и лучшие практики: CLAUDE.md

Следующий шаг — формирование файла CLAUDE.md. Это набор правил и ограничений, которые Claude будет учитывать при каждом промпте. Важно, чтобы файл был компактным: каждая строка попадает в контекст при запросах.

Создать его можно реверс-промптингом: попросить Claude сгенерировать правила, затем сократить их, сохранив суть.

Пример:

# CLAUDE.md - Project Rules & Guidelines

## CRITICAL RULES
- Read all .md files before starting work
- NO git push without explicit permission
- NO modifying/deleting tests without permission
- NO touching files not mentioned in requests

## KISS & DRY Principles
- Keep it simple — aim for <50 lines when possible
- Reuse existing code, don't reinvent
- No over-engineering or unnecessary abstractions

## DEVELOPMENT WORKFLOW
- Use English only
- Follow existing patterns and conventions
- Run tests before commits
- Keep files under 500 lines

Полная версия может быть длиннее, но её нужно оптимизировать до десятков строк, а не сотен.

3. Управление контекстом: /clear

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

/clear

Это позволяет избежать накопления мусора и ненужных токенов, а также выхода в «бесконечные циклы», когда Claude опирается на ошибочные предположения.

4. Работа с небольшими доработками

Для простых задач последовательность такова:

  1. Очистить контекст.
  2. Сослаться на README.md и CLAUDE.md.
  3. Сформулировать задачу: «Используя информацию из файлов, сделай доработку X».
  4. Начать с небольшой фичи, проверить стиль мышления Claude.

Важно проверять код: Claude иногда пытается обойти проблему и создаёт новые методы или файлы, которые не нужны. Если повторяется ошибка — добавить новое правило в CLAUDE.md.

5. Работа с крупными задачами и продуктами

Если доработка крупная или это создание нового продукта, то подход похожий, но в README.md вместо структуры проекта кладётся план разработки.

Или файл можно назвать, например, feature.md. Туда помещается детальный пошаговый план реализации: задачи, чек-листы, тесты, коммиты.

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

6. Общие рекомендации

  • Не расслабляться. Claude может сломать уже рабочий код.
  • Тесты критичны. Каждая фича должна быть покрыта тестами.
  • Фиксировать рабочие состояния. Делать коммиты после успешных шагов, чтобы всегда можно было откатиться.
  • Не бояться перезапусков. Если зашли в тупик, лучше очистить контекст, переформулировать задачу, сделать реверт до рабочего состояния и начать заново.

Так выстраивается базовая методология работы с Claude Code: минимизация лишнего контекста, формализация правил и строгая дисциплина коммитов.

Больше записей