Создание CLAUDE.md для улучшения поведения Claude Code

Пошаговый гайд по подготовке единого markdown‑файла, основанного на наблюдениях Андрэжа Кэрпатхя о подводных камнях LLM‑кодинга.

Средний

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

Системный администратор14 ноября 2026 г.2 мин чтения

touch CLAUDE.md

cat > CLAUDE.md <<'EOF'
# CLAUDE.md – рекомендации для Claude Code

## Введение
Claude Code работает лучше при чётких и конкретных запросах.

## Основные принципы
- Будьте конкретны в описании задачи.
- Включайте нужный контекст (код, логи).
- Делайте запросы простыми и разбивайте сложные задачи.

## Пример запроса
# Добавьте функцию parse_config в config.py.
# Вход: содержимое config.py.
# Ожидаемый результат: функция, принимающая строку и возвращающая словарь.
# Пример входа:
#   config_text = 'host=127.0.0.1\\nport=8080'
# Пример вывода:
#   {'host': '127.0.0.1', 'port': 8080}

## Чек‑лист
- [ ] Задача чётко сформулирована.
- [ ] При необходимости приложен контекст.
- [ ] Ожидаемый формат ответа указан.
EOF

claude code lint CLAUDE.md

Создание CLAUDE.md для улучшения поведения Claude Code

Пошаговый гайд по подготовке единого markdown‑файла, основанного на наблюдениях Андрэжа Кэрпатхя о подводных камнях LLM‑кодинга.

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

• Установлен Claude Code
• Знание основных рекомендаций Андрэжа Кэрпатхя о LLM‑кодинге
• Базовые навыки работы с markdown‑файлами

Шаг 1: Изучите наблюдения Андрэжа Кэрпатхя

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

Шаг 2: Составьте список критических проблем

Запишите в виде списка основные проблемы, которые часто встречаются у Claude Code: 1) Непонятные или расплывчатые инструкции; 2) Недостаточный контекст в промпте; 3) Слишком сложные запросы; 4) Отсутствие ясности в ожидаемом результате; 5) Несоблюдение соглашений об именах и структуре кода.

Шаг 3: Создайте пустой файл CLAUDE.md

Создайте новый markdown‑файл, в котором будете хранить рекомендации для Claude Code.

touch CLAUDE.md

Шаг 4: Заполните CLAUDE.md шаблоном

Используйте следующий шаблон, чтобы добавить структурированные рекомендации. Каждый раздел описывает конкретный аспект поведения Claude Code.

cat > CLAUDE.md <<'EOF'
# CLAUDE.md – рекомендации для Claude Code

## Введение
Claude Code работает лучше при чётких и конкретных запросах.

## Основные принципы
- Будьте конкретны в описании задачи.
- Включайте нужный контекст (код, логи).
- Делайте запросы простыми и разбивайте сложные задачи.

## Пример запроса
# Добавьте функцию parse_config в config.py.
# Вход: содержимое config.py.
# Ожидаемый результат: функция, принимающая строку и возвращающая словарь.
# Пример входа:
#   config_text = 'host=127.0.0.1\\nport=8080'
# Пример вывода:
#   {'host': '127.0.0.1', 'port': 8080}

## Чек‑лист
- [ ] Задача чётко сформулирована.
- [ ] При необходимости приложен контекст.
- [ ] Ожидаемый формат ответа указан.
EOF

Шаг 5: Проверьте файл с помощью Claude Code

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

claude code lint CLAUDE.md

Шаг 6: Обновите файл на основе обратной связи

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