Папка .claude и настройки Claude Code: разбор файлов

Папка claude и настройки без паники: где лежат CLAUDE.md, settings.json, скиллы и память, чем проектная .claude отличается от домашней и что можно трогать.

claude-codeclaude-directorysettingsclaude-mdconfiguration
Обновлено 2026-06-12ЕАЕвгений АрсентьевЕвгений Арсентьев · MD, PhD

Проверено на точность — Евгений Арсентьев, MD, PhD · 2026-06-12

Claude Code хранит настройки и файлы в двух местах: папка .claude внутри вашего проекта и папка ~/.claude в домашнем каталоге — для всего личного. Как только понимаешь, что где лежит, тревога про «загадочную скрытую папку» испаряется.

Я Евгений, и я помню день, когда впервые заметил, что в проекте появилась папка .claude, и засомневался, можно ли вообще туда заглядывать. Можно. Более того, заглянуть внутрь — самый быстрый способ понять, как Claude Code на самом деле думает о вашем проекте. Идём на экскурсию, комната за комнатой.

Где хранятся настройки Claude?

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

Две территории одним взглядом
ваш-проект/
  CLAUDE.md              <- инструкции проекта, читаются каждую сессию
  .claude/
    settings.json        <- общие настройки команды (в гите)
    settings.local.json  <- ваши личные правки (вне гита)
    rules/  skills/  agents/
~/
  .claude/
    CLAUDE.md            <- ваши предпочтения, во всех проектах
    settings.json        <- ваши глобальные умолчания
    projects/            <- здесь живут сессии и автопамять

Как найти папку .claude?

Обе папки начинаются с точки, поэтому в большинстве файловых менеджеров они невидимы — это соглашение «конфигурация, а не контент», а не заговор. Проектная лежит в корне любой папки, где вы запускали Claude Code; личная всегда находится в ~/.claude в домашнем каталоге.

Показать скрытую папку
ls -a ~/.claude

Флаг -a показывает файлы с точкой. Запустите `ls -a` внутри проекта, чтобы найти его локальную .claude/. На Windows ищите те же имена в папке пользователя.

Где Claude хранит мои файлы и память?

Разговоры и память живут в ~/.claude/projects/, по папке на проект. Внутри папки памяти каждого проекта Claude самостоятельно ведёт файл MEMORY.md — заметки, которые он делает, когда вы его поправляете или озвучиваете предпочтения. Первые 200 строк загружаются в начале каждой сессии — вот почему Claude «помнит», что вы ненавидите эмодзи. Эта автопамять — зеркальный близнец CLAUDE.md: CLAUDE.md пишете вы для Claude, а MEMORY.md Claude пишет сам для себя. Когда индекс разрастается, Claude выносит детали в отдельные тематические файлы и подглядывает в них по мере надобности.

Что за остальные папки — rules, skills, agents?

Каждая подпапка — точка расширения, и каждая существует на обеих территориях: проектная — для команды, ~/.claude — только для вас. В rules/ лежат тематические инструкции, которые могут подгружаться только при работе с нужными файлами. В skills/ — переиспользуемые сценарии, вызываемые как /имя. В agents/ — сабагенты со своей отдельной памятью.

А что за папка commands?

commands/ — старый однофайловый формат скиллов: старые файлы работают, но новые сценарии лучше класть в skills/. Ничего из этого не обязательно: пустая папка .claude — совершенно здоровая папка .claude. Загляните в любую из них — внутри обычный markdown, который можно читать и править как заметку.

Как сменить папку, в которой работает Claude?

Это нигде не настраивается — Claude Code просто работает в той папке, из которой вы его запустили, и каждая сессия привязана к этому каталогу. Нужен Claude в другом проекте? Сначала зайдите в ту папку командой cd, потом запустите `claude`. Вот и весь механизм. Поэтому же запускать Claude из домашнего каталога — плохая идея: он видит вообще всё ваше.

Лаба: оставьте Claude свою первую записку

0/5
!Что трогать можно, а что нельзя

Можно смело править: CLAUDE.md, всё в rules/ и skills/, settings.local.json. Осторожнее с командным settings.json — на него полагаются другие. И никогда не кладите пароли и API-ключи в файлы, попадающие в гит: settings.json путешествует вместе с проектом, а settings.local.json остаётся на вашей машине. Это разделение придумано ровно для того, чтобы секреты и личные причуды не утекали в общий код.

Домашка на вечер: откройте ~/.claude/projects/ и почитайте собственные файлы MEMORY.md. Вы увидите, что именно Claude выучил о вашей манере работать. А когда осознаете, что вся система — это просто читаемые текстовые файлы в папках, перестанете бояться конфигурации навсегда. Это не чёрный ящик. Это картотека, и ключ у вас.

Бесплатный курс

Хватит читать про ИИ — начни строить с ним

Бесплатный курс Claude Code: свой первый сайт, инструмент или игра — без программирования. Без апсейлов и кросс-сейлов — здесь нечего купить.

Начать →

Источники и исследования

Подборка рецензируемых работ и препринтов по научной основе этой темы.

  1. [1]Shrivastava et al. (2022). Repository-Level Prompt Generation for Large Language Models of Code. arXiv:2206.12839
  2. [2]Wu et al. (2024). Repoformer: Selective Retrieval for Repository-Level Code Completion. arXiv:2403.10059
  3. [3]Liu et al. (2024). STALL+: Boosting LLM-based Repository-level Code Completion with Static Analysis. arXiv:2406.10018
  4. [4]Deng et al. (2024). R2C2-Coder: Enhancing and Benchmarking Real-world Repository-level Code Completion Abilities of Code Large Language Models. arXiv:2406.01359
  5. [5]Liu et al. (2024). M2rc-Eval: Massively Multilingual Repository-level Code Completion Evaluation. arXiv:2410.21157
  6. [6]Zhang et al. (2025). CodeRAG: Finding Relevant and Necessary Knowledge for Retrieval-Augmented Repository-Level Code Completion. arXiv:2509.16112
  7. [7]Khan et al. (2025). Kodezi Chronos: A Debugging-First Language Model for Repository-Scale Code Understanding. arXiv:2507.12482
ЕАЕвгений Арсентьев

Автор

Евгений Арсентьев

MD, PhD · Руководитель ИИ-трансформации

Чтение — это синяя пилюля

Хочешь реально это построить?

Гайды объясняют. Бесплатный курс превращает — персонально, с геймификацией и заточенный на быстрый запуск.

Начать бесплатный курс →