Папка Claude: что хранится в .claude и что можно менять

Папка Claude в Claude Code бывает двух видов: .claude/ внутри проекта и ~/.claude/ в домашней папке пользователя. В первой хранятся общие настройки проекта, правила и навыки, во второй личная конфигурация и данные приложения. Ниже показано, как выбрать правильный файл, внести изменение без потери истории и проверить результат.

Для Windows и macOS доступно приложение Claude Code. По официальной справке Anthropic десктоп и CLI читают одни настройки. На Windows ~/.claude соответствует %USERPROFILE%\.claude.

Чем .claude отличается от CLAUDE.md

.claude является каталогом, а CLAUDE.md является файлом инструкций. Файл можно хранить в корне проекта или как .claude/CLAUDE.md; он загружается в каждую сессию. Каталог объединяет настройки, правила, навыки, команды и субагентов. Отдельная инструкция по CLAUDE.md объясняет именно содержание файла.

• CLAUDE.md: постоянные инструкции и контекст проекта.
• .claude/settings.json: общие разрешения, хуки, переменные среды и другие настройки.
• .claude/settings.local.json: личные переопределения для проекта, которые не отправляют в Git.
• ~/.claude/: личная конфигурация для всех проектов и данные сессий.
• ~/.claude/projects/<project>/memory/: автопамять проекта, а не общий файл правил.

Сначала назовите тип изменения, затем выбирайте файл. Правило поведения идёт в CLAUDE.md, разрешение инструмента в settings.json, повторяемая процедура в skill, а автопамять не заменяет эти файлы.

Что лежит в проектной .claude

Проектная .claude/ находится рядом с кодом. Официальный справочник каталога перечисляет элементы, которые можно хранить на уровне проекта и добавлять в Git для команды.

• settings.json: общие настройки проекта.
• settings.local.json: личные исключения, которые должны оставаться локальными.
• rules/*.md: тематические инструкции, при необходимости ограниченные путями.
• skills/<name>/SKILL.md: повторяемая процедура с дополнительными файлами.
• commands/*.md: однофайловые команды на том же механизме, что skills.
• agents/*.md: определения субагентов с отдельными инструментами.
• output-styles/*.md: инструкции по формату ответов.

Один короткий промпт можно оставить в commands/. Процедуру с примерами, скриптами или справочниками лучше хранить в skills/. Основы механизма разобраны в статье Claude Skills.

По теме: Claude Memory: как работает память в чате и Claude Code

Что хранится в ~/.claude

Глобальный каталог применяется ко всем проектам. В нём соседствуют файлы, которые вы редактируете, и данные приложения. Копировать его целиком в Git или передавать коллеге нельзя.

• ~/.claude/settings.json: личные настройки для всех проектов.
• ~/.claude/CLAUDE.md, rules/, skills/, agents/: глобальные инструкции и расширения.
• ~/.claude/plugins/: установленные плагины и записи об установке.
• ~/.claude/projects/: транскрипты, результаты инструментов и автопамять.
• history.jsonl: история введённых промптов.
• ~/.claude/.credentials.json: данные входа на Linux и файловый запасной вариант на macOS; в Windows файл находится в %USERPROFILE%\.claude\.credentials.json. Его нельзя показывать или коммитить.

Anthropic предупреждает, что транскрипты хранятся как обычный текст. Если инструмент прочитал .env или команда вывела секрет, значение может попасть в запись сессии. Защищайте глобальную папку правами операционной системы и не используйте её как общую резервную копию.

Как выбрать место для изменения

Используйте карту выбора, чтобы не создавать конфликтующие файлы.

1. Правило для команды и каждой сессии проекта: проектный CLAUDE.md.
2. Инструкция только для определённых файлов: .claude/rules/<тема>.md с областью путей.
3. Разрешение или запрет инструмента: .claude/settings.json; личное исключение: settings.local.json.
4. Многофайловая процедура по задаче: .claude/skills/<имя>/SKILL.md.
5. Однофайловый промпт для ручного вызова: .claude/commands/<имя>.md.
6. Личная настройка для всех проектов: соответствующий путь внутри ~/.claude/.

Не храните секреты в файлах, которые отправляются в Git. Указывайте имя переменной окружения, но не её значение. Смежные варианты разобраны в статье настройка Claude.

По теме: Claude Continue: как продолжить прошлую сессию Claude Code

Как безопасно проверить изменение

Проверка должна подтвердить валидный файл, правильную область и наблюдаемое поведение в новой сессии.

1. Сделайте резервную копию только изменяемого файла. Не копируйте весь ~/.claude.
2. Для JSON запустите python3 -m json.tool .claude/settings.json. Для глобального файла подставьте ~/.claude/settings.json.
3. Начните новую сессию Claude Code в нужном проекте.
4. Дайте безопасную тестовую задачу, которая задействует одно новое правило и не меняет файлы.
5. Проверьте результат: skill виден, правило действует только на нужных путях, а запрет инструмента соблюдается.

• Успех: настройка действует в нужном проекте и не проявляется вне своей области.
• Ошибка области: личное исключение случайно сохранено как командное.
• Ошибка синтаксиса: JSON не проходит проверку или игнорируется.
• Конфликт приоритета: управляемая настройка, флаг CLI или переменная среды перекрывает файл.

Почему настройка не применяется

По документации Anthropic о настройках Claude Code читает несколько уровней конфигурации. Управляемые правила организации имеют высокий приоритет, а флаг CLI может перекрыть файл для одной сессии.

• Проверьте, какой файл изменён: проектный или глобальный.
• Убедитесь, что settings.local.json относится к текущему проекту.
• Откройте новую сессию после правки.
• Проверьте переменные среды и флаги запуска.
• Для skill проверьте имя папки, SKILL.md и описание активации.
• Для rules проверьте область путей.

По теме: Claude Code compact: как сжать контекст без потери задачи

Что нельзя удалять вслепую

Не удаляйте ~/.claude.json, ~/.claude/settings.json и ~/.claude/plugins/ ради очистки кэша. Файл учётных данных также не удаляйте вслепую: его путь зависит от системы. Для удаления данных одного проекта Anthropic предлагает предварительный просмотр.

claude project purge /путь/к/проекту --dry-run

Сначала изучите план. Команда без --dry-run удаляет прошлые сессии, автопамять, историю и снимки файлов. Это не способ исправить ошибку одного settings.json.

Частые вопросы

Папку .claude нужно добавлять в Git?

Командные settings, rules, skills и agents обычно добавляют. settings.local.json, секреты и глобальную ~/.claude не добавляют.

CLAUDE.md обязан лежать внутри .claude?

Нет. Он может лежать в корне проекта или как .claude/CLAUDE.md.

Где находится общая память Claude?

Инструкции лежат в CLAUDE.md, а автопамять проекта в ~/.claude/projects/<project>/memory/. Это разные механизмы.

Можно перенести ~/.claude на другой компьютер?

Не переносите каталог целиком: там есть вход, транскрипты и состояние. Копируйте только проверенные настройки и свои skills без секретов.