Настройка CLAUDE.md для Claude Code по наблюдениям Андрея Карпатского

Гайд по созданию файла CLAUDE.md, который улучшает поведение Claude Code, основываясь на наблюдениях Андрея Карпатского о типичных ошибках LLM при написании кода.

Средний

Алексей Кузнецов

Системный администратор19 октября 2026 г.3 мин чтения

touch CLAUDE.md

# Стиль кодирования

- Пиши лаконичный и эффективный код
- Не добавляй лишних абстракций без необходимости
- Используй понятные имена переменных
- Избегай дублирования логики

# Изменения

- Вноси минимальные изменения для достижения цели
- Проверяй каждое изменение перед продолжением
- Не рефакторь код без необходимости

# Библиотеки

- Используй проверенные и стабильные библиотеки
- Избегай экспериментальных или малоизвестных пакетов
- Предпочитай стандартные решения из стандартной библиотеки

# Тестирование

- Пиши тесты для нового функционала
- Запускай существующие тесты после изменений
- Не удаляй тесты без весклой причины

# Ошибки

- Обрабатывай ошибки явно, не игнорируй их
- Используй осмысленные сообщения об ошибках
- Не используй пустые блоки catch

ls -la CLAUDE.md

claude-code

Настройка CLAUDE.md для Claude Code по наблюдениям Андрея Карпатского

Гайд по созданию файла CLAUDE.md, который улучшает поведение Claude Code, основываясь на наблюдениях Андрея Карпатского о типичных ошибках LLM при написании кода.

Предварительные требования

• Установленный Claude Code
• Базовые знания Markdown
• Доступ к терминалу

Шаг 1: Создание файла CLAUDE.md

Создайте файл CLAUDE.md в корне вашего проекта. Этот файл будет автоматически распознаваться Claude Code и влиять на его поведение при выполнении задач.

touch CLAUDE.md

Шаг 2: Добавление инструкций по стилю кода

Вставьте в CLAUDE.md секцию с инструкциями по стилю кодирования. Основываясь на наблюдениях Карпатского, укажите, что LLM склонны к избыточности и неэффективным решениям. Чёткие правила помогут избежать этого.

# Стиль кодирования

- Пиши лаконичный и эффективный код
- Не добавляй лишних абстракций без необходимости
- Используй понятные имена переменных
- Избегай дублирования логики

Шаг 3: Ограничение объёма изменений

Добавьте правило ограничения объёма изменений за один раз. Карпатский отмечал, что LLM часто вносят слишком много изменений сразу, что затрудняет отладку. Укажите, что нужно вносить минимальные изменения и проверять их.

# Изменения

- Вноси минимальные изменения для достижения цели
- Проверяй каждое изменение перед продолжением
- Не рефакторь код без необходимости

Шаг 4: Использование проверенных библиотек

Укажите предпочтения в выборе библиотек и фреймворков. Карпатский подчёркивал, что LLM склонны использовать новые или нестандартные библиотеки, что может привести к проблемам с поддержкой.

# Библиотеки

- Используй проверенные и стабильные библиотеки
- Избегай экспериментальных или малоизвестных пакетов
- Предпочитай стандартные решения из стандартной библиотеки

Шаг 5: Требования к тестированию

Добавьте секцию о тестировании. По наблюдениям Карпатского, LLM часто пропускают тесты или пишут их поверхностно. Чёткие требования помогут избежать этой проблемы.

# Тестирование

- Пиши тесты для нового функционала
- Запускай существующие тесты после изменений
- Не удаляй тесты без весклой причины

Шаг 6: Правила работы с ошибками

Определите, как обращаться с ошибками. Карпатский отмечал, что LLM могут «заглушать» ошибки вместо их корректной обработки. Укажите, что ошибки должны обрабатываться явно.

# Ошибки

- Обрабатывай ошибки явно, не игнорируй их
- Используй осмысленные сообщения об ошибках
- Не используй пустые блоки catch

Шаг 7: Проверка конфигурации проекта

Убедитесь, что CLAUDE.md находится в корне проекта и доступен для чтения. Claude Code автоматически загружает этот файл при запуске.

ls -la CLAUDE.md

Шаг 8: Тестирование поведения Claude Code

Запустите Claude Code и дайте простую задачу, чтобы проверить, что инструкции из CLAUDE.md применяются. Обратите внимание на стиль кода и объём изменений.

claude-code