Большинство пользователей Claude Code знают
.claude/
существование папки, но никогда по-настоящему не открывали её. Недавно инженер AI Акшай подготовил полный гид, разбирающий функции каждого файла этой папки и как настроить систему так, чтобы Claude работал полностью по вашему усмотрению.
Две папки, а не одна
Прежде всего, нужно развеять распространённое заблуждение:
Папка .claude/ — их две, а не одна.
На уровне проекта (ваш проект/.claude/): хранит общие настройки команды, коммиты в Git, обеспечивает единые правила и команды для всех
На глобальном уровне (~/.claude/): личные предпочтения и настройки между проектами, влияет только на ваш компьютер
CLAUDE.md: самый важный файл
При каждом запуске Claude Code, первым делом он читает
CLAUDE.md
и загружает его в системный подсказчик (system prompt), постоянно соблюдая указания внутри.
Что должно содержаться:
команды сборки, тестирования, lint (например, npm run test)
важные архитектурные решения
неочевидные замечания (например, «включён строгий режим TypeScript, неиспользуемые переменные вызовут ошибку»)
правила именования, стиль обработки ошибок
Что не следует писать: правила для линтеров, полные документы, длинные теоретические объяснения.
Акшай советует держать CLAUDE.md в пределах 200 строк — при превышении этого размера, уровень соблюдения команд Claude фактически снижается, так как это занимает слишком много контекста.
Папка rules/ : модульные команды, подходят для расширения командной базы командой
Когда CLAUDE.md становится всё более громоздким,
.папка .claude/rules/
— решение. Каждый Markdown-файл представляет собой отдельную тему, например code-style.md, testing.md, api-conventions.md, — Claude автоматически читает все файлы.
Более мощная возможность — «правила области путей»: добавляя YAML-метаданные в файлы правил, можно сделать так, чтобы правила применялись только к файлам в определённых путях, избегая загрузки нерелевантных правил в контекст.
Папка commands/ : пользовательские команды с слэшем
Все Markdown-файлы в
.claude/commands/
превращаются в слэш-команды. review.md соответствует /project:review, fix-issue.md — /project:fix-issue.
Самая полезная функция — использование
!
в файле команды для выполнения shell-команд и вставки вывода — например, автоматическое получение git diff и вставка в подсказку, чтобы Claude «видел» ваши изменения кода. Личные команды в ~/.claude/commands/ доступны во всех проектах.
skills/ и agents/ : автоматический запуск vs. назначение подагентов
Основное отличие Skills и agents — способ активации:
Skills: Claude автоматически решает, когда вызывать их, исходя из диалога, без ручного ввода команд. У каждого skill есть свой каталог и SKILL.md, а также поддерживающие файлы.
Agents: задают профессиональные подагенты с отдельными системными подсказками, правами на инструменты и настройками модели. В сложных задачах Claude создаёт изолированный контекст для агента, чтобы не засорять основной рабочий процесс большим количеством токенов.
В agents есть
tools
— ограничение поведения подагента: например, аудит безопасности — только чтение, без прав на запись. Параметр model позволяет выбрать лёгкую модель для фокусных задач, экономя ресурсы.
settings.json: белые и чёрные списки разрешённых операций
Файл
.claude/settings.json
управляет разрешёнными или запрещёнными действиями Claude:
allow — список разрешённых команд для немедленного выполнения (например, npm run *, git *)
deny — список запрещённых команд (например, rm -rf *, чтение .env)
операции, не указанные в списках, вызывают вопрос у Claude о продолжении.
Личные настройки можно хранить в
.claude/settings.local.json
, который автоматически игнорируется Git и не попадает в репозиторий.
С чего начать?
Рекомендуемый Акшаем практический порядок: сначала выполнить
/init
, чтобы сгенерировать начальный CLAUDE.md, настроить basic permissions в settings.json, затем создать одну-две часто используемые пользовательские команды — остальные добавлять по мере необходимости.
Главное понимание:
Папка .claude/ — это протокол, который говорит Claude «кто ты, что за проект, какие правила соблюдать». Чем яснее настройки, тем меньше времени уйдёт на исправление ошибок Claude.
Эта статья: Разбираемся с папкой .claude/: центральным узлом управления Claude Code, полным разбором CLAUDE.md, команд, навыков и прав доступа, впервые опубликована на ABMedia.
