EnglishРусский中文

Зачем это нужно#

Представьте, что вы наняли помощника. В первый день вы объясняете ему правила: «Мы пишем отчёты в таком-то формате», «Клиентам отвечаем вежливо», «Файлы храним в этой папке». Без этих правил помощник будет делать всё по-своему.

CLAUDE.md — это файл с такими правилами для Claude Code. Вы записываете туда инструкции, и Claude следует им в каждом разговоре. Это экономит время: не нужно повторять одно и то же каждый раз.

Что такое CLAUDE.md#

CLAUDE.md — это обычный текстовый файл в специальном формате Markdown (расширение .md). Markdown — это способ оформления текста с помощью простых символов: # для заголовков, - для списков, ** для жирного текста.

Claude Code читает этот файл в начале каждого разговора и следует написанным там правилам.

Какие бывают CLAUDE.md файлы#

Claude Code поддерживает несколько уровней инструкций. Думайте об этом как о правилах разного масштаба:

Тип Где находится Для кого
Проектный CLAUDE.md в папке проекта Для всей команды
Личный ~/.claude/CLAUDE.md Только для вас, во всех проектах
Локальный CLAUDE.local.md в папке проекта Только для вас, в этом проекте

💡 Символ ~ означает вашу домашнюю папку на компьютере. Например, на Mac это /Users/ваше_имя/.

Пошаговая инструкция: создаём CLAUDE.md#

Шаг 1. Откройте папку вашего проекта#

Перейдите в терминале в папку проекта:

cd мой-проект

Шаг 2. Создайте файл CLAUDE.md#

Откройте текстовый редактор и создайте файл CLAUDE.md в корне проекта. Вот пример содержимого:

# Правила проекта

## Стиль кода
- Пиши комментарии на русском языке
- Используй понятные названия переменных
- Каждая функция должна быть не длиннее 20 строк

## Структура проекта
- Исходный код находится в папке src/
- Тесты находятся в папке tests/
- Конфигурация в папке config/

## Важные команды
- Запуск проекта: npm start
- Запуск тестов: npm test
- Сборка: npm run build

Шаг 3. Проверьте, что Claude прочитал файл#

Запустите Claude Code в папке проекта:

claude

Спросите: «Какие правила проекта ты знаешь?» — Claude должен перечислить то, что вы написали в CLAUDE.md.

Примеры полезных инструкций#

Для веб-сайта#

# Проект: Сайт кафе «Ромашка»

## Технологии
- HTML, CSS, JavaScript
- Фреймворк: не используем, чистый код

## Правила
- Все тексты на русском языке
- Цвета бренда: #FF6B35 (оранжевый), #004E89 (синий)
- Адаптивная верстка для мобильных устройств

Для личных настроек (~/.claude/CLAUDE.md)#

# Мои предпочтения

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

Для локальных настроек (CLAUDE.local.md)#

# Мои локальные настройки

- Мой тестовый сервер: http://localhost:3000
- Для отладки использую порт 9229

Авто-память Claude#

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

  • Паттерны проекта (как устроен код)
  • Решения сложных проблем
  • Ваши предпочтения в работе

Эти заметки хранятся в папке ~/.claude/projects/<проект>/memory/ и загружаются автоматически.

Советы#

  • ✅ Пишите конкретно: «Используй отступ в 2 пробела» лучше, чем «Пиши красиво»
  • ✅ Обновляйте файл, когда правила меняются
  • ✅ Добавляйте CLAUDE.md в систему контроля версий (Git), чтобы команда использовала одни правила
  • ✅ CLAUDE.local.md не добавляйте в Git — это ваши личные настройки

Итоги урока#

  • CLAUDE.md — файл с инструкциями, которые Claude читает в начале каждого разговора
  • Есть три уровня: проектный (для команды), личный (для вас везде), локальный (для вас в одном проекте)
  • Более конкретные настройки имеют приоритет над общими
  • Claude также сохраняет заметки автоматически (авто-память)
  • Хорошие инструкции экономят время и делают работу с Claude предсказуемой