Как создать CLAUDE.md для улучшения работы Claude Code

Пошаговый гайд по подготовке единого markdown‑файла, который помогает Claude Code выдавать более точные и предсказуемые результаты, основанный на наблюдениях Andrej Karpathy.

Средний

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

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

cat > CLAUDE.md <<'EOF'
# CLAUDE.md – руководство по улучшению поведения Claude Code

## Введение
Опишите, зачем нужен этот файл и какие задачи он решает.

## Цели
- Что должно быть достигнуто с помощью Claude Code.
- Критерии успешного выполнения.

## Контекст
Предоставьте необходимый контекст (файлы, команды, описание задачи).

## Инструкции
- Чётко сформулируйте запрос.
- Укажите требуемый формат вывода (текст, код, список).
- Опишите шаги, которые нужно выполнить.

## Примеры запросов
Приведите несколько примеров корректных и некорректных запросов.

## Проверка ошибок
- Как проверять наличие ошибок в выводе.
- Что делать, если результат не соответствует ожиданиям.
EOF

# Создать директорию и файл
mkdir -p ~/projects && touch ~/projects/main.py

echo "# Пример команды" > example_command.md

Как создать CLAUDE.md для улучшения работы Claude Code

Пошаговый гайд по подготовке единого markdown‑файла, который помогает Claude Code выдавать более точные и предсказуемые результаты, основанный на наблюдениях Andrej Karpathy.

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

• Доступ к Claude Code
• Базовые знания Linux‑команд и работы с markdown
• Прочитанные наблюдения Andrej Karpathy о pitfalls LLM‑кода

Шаг 1: Изучить наблюдения Andrej Karpathy

Прочитайте статьи и посты Карпатти, где он описывает типичные ошибки LLM‑кода: неявные инструкции, отсутствие контекста, плохая структура запросов, отсутствие проверки ошибок и т.д.

Шаг 2: Создать шаблон CLAUDE.md

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

cat > CLAUDE.md <<'EOF'
# CLAUDE.md – руководство по улучшению поведения Claude Code

## Введение
Опишите, зачем нужен этот файл и какие задачи он решает.

## Цели
- Что должно быть достигнуто с помощью Claude Code.
- Критерии успешного выполнения.

## Контекст
Предоставьте необходимый контекст (файлы, команды, описание задачи).

## Инструкции
- Чётко сформулируйте запрос.
- Укажите требуемый формат вывода (текст, код, список).
- Опишите шаги, которые нужно выполнить.

## Примеры запросов
Приведите несколько примеров корректных и некорректных запросов.

## Проверка ошибок
- Как проверять наличие ошибок в выводе.
- Что делать, если результат не соответствует ожиданиям.
EOF

Шаг 3: Определить ключевые принципы

В CLAUDE.md опишите принципы, которые помогут Claude Code работать надёжнее:

• Ясные и конкретные инструкции.
• Предоставление полного контекста (файлы, пути, окружение).
• Ограничение объёма запроса, разбиение на небольшие шаги.
• Явное указание желаемого формата ответа.
• Включение проверки ошибок и fallback‑планов.

Шаг 4: Добавить примеры корректных команд

Включите в файл примеры команд, которые Claude Code может выполнить, и покажите, как их правильно оформлять. Например:

# Создать директорию и файл
mkdir -p ~/projects && touch ~/projects/main.py

Покажите, как указать ожидаемый результат (например, «файл main.py создан»).

echo "# Пример команды" > example_command.md

Шаг 5: Тестировать и улучшать

Выполните несколько тестовых запросов, используя CLAUDE.md как справочник. Оцените качество результата, при необходимости доработайте раздел «Инструкции» и примеры. Повторяйте цикл до тех пор, пока Claude Code не будет выдавать предсказуемые и корректные ответы.