Звідки береться правило

Одна й та сама команда Claude Code може поводитися по-різному в різних репозиторіях або локальних копіях. Під час діагностики корисно почати з питання: «Звідки Claude отримав це правило?»

Налаштування мають різну область дії. Правило потрібно розміщувати на тому рівні, де воно справді належить, а не дублювати все в одному глобальному файлі.

РівеньОбласть діїПриклад
userОсобисті вподобання в усіх проєктахПросити спочатку складати план
projectСпільні правила конкретного репозиторіюКоманди тестування та проєктні конвенції
localОсобливості конкретної локальної копіїЛокальний порт бази даних
managedПолітики організаціїОбмеження доступу до певних шляхів

Каталог `.claude` як інженерний шар

Каталог `.claude/` зберігає службові інструкції та налаштування, які допомагають Claude працювати в межах домовленостей проєкту. Це не бізнес-логіка застосунку, а контекстний шар для роботи з ним.

На старті достатньо знати роль основних елементів. Не потрібно одразу опановувати всі розширення, якщо поточна задача їх не використовує.

  • CLAUDE.md — спільні інструкції проєкту.
  • rules/ — вузькі правила для окремих областей.
  • skills/, agents/, hooks/ і mcp/ — розширені механізми для наступних рівнів гайда.
Орієнтовна структура
.claude/
├── CLAUDE.md
├── rules/
├── skills/
├── agents/
├── hooks/
└── mcp/

Огляд конфігурації без поспіху

  1. Переконайтеся, що відкрито потрібну локальну копію репозиторію.
  2. Перегляньте Git-стан до читання конфігурації.
  3. Огляньте вміст .claude/ і спочатку прочитайте CLAUDE.md.
  4. Потім досліджуйте rules/ або інші каталоги, якщо вони стосуються задачі.
  5. Визначте, чи знайдене правило є user-, project-, local- або managed-рівнем.
pwd
git status
ls -la .claude
find .claude -maxdepth 2 -type f

Спільне проти локального

Командні правила мають бути доступними в репозиторії та корисними для більшості сесій. Локальні налаштування призначені для машинозалежних деталей або особистих вподобань і зазвичай не комітяться.

Локальний файл не є сховищем секретів. Токени, паролі й ключі не можна класти туди лише тому, що файл виключений із Git.

.claude/CLAUDE.local.md
.claude/settings.local.json

Діагностика дивної поведінки

  1. Перевірте шлях і Git-стан, щоб виключити неправильний каталог.
  2. Прочитайте спільний CLAUDE.md перед висновками про поведінку.
  3. Знайдіть джерело конкретного правила, а не змінюйте всі налаштування одразу.
  4. Якщо правило managed-рівня, не намагайтеся обходити його локальними правками.
  5. Змініть лише той шар, якому справді належить правило.

Канонічне джерело уроку · JavaRush

Відкрити матеріал JavaRush