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

Agentic CodingClaude CodePrompt Engineering for 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