Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md — конфигурационный файл в формате Markdown, размещаемый в корне проекта, который предоставляет Claude Code постоянные инструкции, специфичные для проекта. Он сообщает агенту о ваших соглашениях по написанию кода, архитектуре, типичных командах и правилах — выступая формой долгосрочной памяти, применяемой на каждом сеансе работы с данным проектом.

Как работает CLAUDE.md

Когда Claude Code начинает сеанс, он автоматически читает файл CLAUDE.md в корне проекта (а также любые файлы CLAUDE.md в родительских каталогах или подкаталогах). Содержимое становится частью системного контекста агента, поэтому он следует вашим инструкциям без необходимости напоминать об этом на каждом сеансе. Это делает поведение агента согласованным с соглашениями вашей команды.

Что включать в CLAUDE.md

  • +Обзор архитектуры проекта и местонахождение ключевых файлов
  • +Соглашения по написанию кода (именование, форматирование, паттерны для использования или избегания)
  • +Типичные команды для тестирования, сборки и развёртывания
  • +Правила вроде «всегда пиши тесты для новых функций» или «не изменяй модуль auth напрямую»
  • +Подробности о технологическом стеке, о которых должен знать агент
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Держите CLAUDE.md кратким. Агент читает его на каждом сеансе, поэтому включайте только информацию, актуальную для нескольких задач. Вместо этого переносите детали, специфичные для задачи, в свои промпты.

Где разместить файл CLAUDE.md?+
Разместите его в корневом каталоге проекта. Claude Code также поддерживает файлы CLAUDE.md в подкаталогах для инструкций, специфичных для модуля, и в родительских каталогах для правил на уровне организации. Все применимые файлы объединяются.
Работает ли CLAUDE.md с другими инструментами ИИ?+
CLAUDE.md специфичен для Claude Code. Однако некоторые другие инструменты приняли похожие концепции. Cursor использует .cursorrules, а другие агенты могут читать пользовательские конфигурационные файлы. Концепция инструкций ИИ на уровне проекта становится общепринятым паттерном.
Насколько длинным должен быть CLAUDE.md?+
Держите его в пределах 500 строк. Сосредоточьтесь на наиболее важных соглашениях и правилах. Агент всегда может прочитать отдельные файлы для получения деталей — CLAUDE.md должен давать высокоуровневый контекст, применимый к различным задачам.

Related terms

Агентное программированиеClaude CodeПромпт-инжиниринг для кода

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS