Изучите директорию .claude

Где Claude Code читает CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules и auto memory. Изучите директорию .claude в вашем проекте и ~/.claude в вашей домашней директории.

Claude Code читает инструкции, параметры, skills, subagents и память из директории вашего проекта и из ~/.claude в вашей домашней директории. Зафиксируйте файлы проекта в git, чтобы поделиться ими с вашей командой; файлы в ~/.claude — это личная конфигурация, которая применяется ко всем вашим проектам.

На Windows ~/.claude разрешается в %USERPROFILE%\.claude. Если вы установите CLAUDE_CONFIG_DIR, каждый путь ~/.claude на этой странице будет находиться в этой директории вместо этого.

Большинство пользователей редактируют только CLAUDE.md и settings.json. Если ваш репозиторий уже содержит AGENTS.md для других агентов кодирования, Claude Code может читать его вместо CLAUDE.md. Остальная часть директории опциональна: добавляйте skills, rules или subagents по мере необходимости.

Изучите директорию

Нажимайте на файлы в дереве, чтобы увидеть, что каждый из них делает, когда он загружается и пример.

Что не показано

Обозреватель охватывает файлы, которые вы создаёте и редактируете. Несколько связанных файлов находятся в других местах:

~/.claude также содержит данные, которые Claude Code записывает во время работы: стенограммы, историю подсказок, снимки файлов, кэши и журналы. См. данные приложения ниже.

Выберите правильный файл

Различные виды настройки находятся в разных файлах. Используйте эту таблицу, чтобы найти, где должно быть изменение.

Справочник файлов

Эта таблица перечисляет каждый файл, который охватывает обозреватель. Файлы с областью действия проекта находятся в вашем репозитории под .claude/ (или в корне для CLAUDE.md, .mcp.json и .worktreeinclude). Файлы с глобальной областью действия находятся в ~/.claude/ и применяются ко всем проектам.

[!NOTE]

Несколько вещей могут переопределить то, что вы поместили в эти файлы:

• Управляемые настройки, развёрнутые вашей организацией, имеют приоритет над всеми файлами настроек и значениями --settings, за исключением исключений, описанных в разделе «Приоритет настроек»
• Флаги CLI, такие как --permission-mode или --settings, переопределяют settings.json для этого сеанса
• Некоторые переменные окружения имеют приоритет над их эквивалентным параметром, но это варьируется: проверьте справочник переменных окружения для каждого из них

См. приоритет параметров для полного порядка.

Нажмите на имя файла, чтобы открыть этот узел в обозревателе выше.

Frontmatter fields by file

Skills, command files, subagents, output styles, and rules read their configuration from YAML frontmatter at the top of the file, and each accepts its own set of fields. This table lists the field names for each file and links to the reference that describes them.

Agents shipped in a plugin honor a subset of the subagent fields.

Устранение неполадок конфигурации

Если параметр, hook или файл не вступает в силу, см. Отладка вашей конфигурации для команд проверки и таблицы поиска по симптомам.

Данные приложения

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

Автоматически очищаемые данные

Claude Code удаляет файлы по указанным ниже путям, когда они становятся старше cleanupPeriodDays, при условии что он может надёжно определить срок хранения. Значение по умолчанию — 30 дней, минимальное — 1; значение 0 приводит к ошибке валидации. Тот же порог возраста применяется к автоматическому удалению осиротевших worktree.

Файлы сессий в sessions/, автоматическая память и транскрипты Claude Desktop и Cowork подчиняются собственным правилам хранения:

• sessions/: содержит по одному небольшому файлу на каждую запущенную сессию; используется для обнаружения параллельных сессий и сбоев. Этот каталог не входит в очистку по возрасту: Claude Code удаляет каждый файл при завершении его сессии и очищает остатки после сбоев при следующем запуске.

• Автоматическая память: очистка не удаляет файлы памяти в каталоге автоматической памяти проекта, projects/<project>/memory/. Claude Code удаляет этот каталог, только если он оставался пустым в течение всего срока хранения. До v2.1.228 очистка считала папки внутри каталога памяти данными сессий и могла удалять старые файлы в нём.

• Транскрипты Claude Desktop и Cowork: Claude Code хранит транскрипт сессии, которую вы начали или последней продолжили в Claude Desktop или Cowork, независимо от её возраста. Чтобы задать для этих транскриптов ограничение по возрасту, установите desktopSessionCleanupPeriodDays. Требуется Claude Code v2.1.248 или новее; более ранние версии удаляют их по истечении cleanupPeriodDays.

  Вместо этого Claude Code удаляет эти транскрипты по истечении cleanupPeriodDays в любом из следующих случаев:

  • Управляемые настройки задают cleanupPeriodDays
  • К вашим сессиям применяется конфигурация HIPAA

Claude Code пропускает очистку по возрасту в следующих случаях:

• Режим bare: когда вы запускаете claude -p с --bare, Claude Code не выполняет очистку в этой сессии.
• Приостановленная очистка: если Claude Code не может надёжно определить срок хранения, он приостанавливает очистку по сроку хранения; событие retention_sweep перечисляет все конфигурации, которые её приостанавливают. Если причина — файл настроек, который не удаётся прочитать или разобрать, или ошибки настроек при явно заданных cleanupPeriodDays или desktopSessionCleanupPeriodDays, Claude Code также показывает предупреждение в /status, пока вы не исправите ошибки настроек. Когда управляемые настройки задают cleanupPeriodDays, Claude Code в любом случае выполняет очистку с управляемым значением.

Чтобы убедиться, что компьютеры в вашей организации выполняют очистку с заданным вами сроком хранения, см. раздел Проверка очистки по сроку хранения.

Каталог черновиков сессии

Каталог черновиков (scratchpad) — это отдельный для каждой сессии каталог, который Claude Code предоставляет Claude для временных файлов: промежуточных результатов, вспомогательных скриптов и черновиков, которым не место в вашем проекте. Когда Claude сообщает, что сохранил что-то «в scratchpad», файл находится именно там. Claude использует его вместо /tmp и может создавать, редактировать и читать в нём файлы без запроса разрешения.

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

• macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
• Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/ или такой же путь внутри $TMPDIR, если он задан в вашей системе
• Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> — это путь к вашему рабочему каталогу, в котором каждый символ, кроме букв и цифр, заменён на -, например -Users-you-my-project. Если вы задали CLAUDE_CODE_TMPDIR, всё дерево перемещается в этот каталог. Хуки получают путь текущей сессии в поле scratchpad_dir.

Файлы каталога черновиков хранятся столько же, сколько транскрипт сессии: очистка по сроку хранения удаляет каталог вместе с транскриптом, а claude purge не затрагивает временный каталог. Поскольку каталог находится в системном временном расположении, ваша операционная система также может очистить его, например при перезагрузке. Чтобы сохранить что-то, что Claude там записал, попросите Claude переместить это в ваш проект.

Каталог черновиков есть у сессии, только если выполнены все следующие условия:

• Вы вошли с учётной записью claude.ai, а не с API-ключом
• Сессия использует Anthropic API, а не Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry
• enableArtifact не установлен в false

Хранятся, пока вы их не удалите

За исключением строк, где указано иное, очистка по сроку хранения не удаляет указанные ниже пути, и Claude Code хранит их, пока вы их не удалите.

Файлы состояния, которые нужно сохранить

В зависимости от используемых функций ~/.claude/ также содержит файлы, не перечисленные в таблицах раздела Данные приложения. Из них кэши и файлы блокировок можно безопасно удалять. Сохраните следующие файлы состояния:

• .credentials.json: ваши учётные данные для входа
• agent-memory/: память субагентов
• jobs/ и daemon/: состояние фоновых сессий

Хранение в открытом виде

Транскрипты и история не шифруются при хранении. Единственная защита — права доступа к файлам ОС. Если инструмент читает файл .env или команда выводит учётные данные, это значение записывается в projects/<project>/<session>.jsonl. Чтобы снизить риск:

• Уменьшите cleanupPeriodDays, чтобы сократить срок хранения транскриптов в Claude Code
• Установите desktopSessionCleanupPeriodDays, чтобы задать ограничение по возрасту и для транскриптов Claude Desktop и Cowork
• Установите переменную окружения CLAUDE_CODE_SKIP_PROMPT_HISTORY, чтобы не записывать транскрипты и историю промптов в любом режиме. В неинтерактивном режиме вместо этого можно передать --no-session-persistence вместе с -p или установить persistSession: false в TypeScript Agent SDK; в Python SDK эквивалентного параметра нет.
• Используйте правила разрешений, чтобы запретить чтение файлов с учётными данными

Очистка локальных данных

Выполните claude purge, чтобы удалить состояние, которое Claude Code хранит для одного проекта. Команда удаляет:

• Транскрипты и автоматическую память в projects/
• Записи tasks/, debug/ и file-history/ для каждой сессии
• Соответствующие строки промптов в history.jsonl
• Запись проекта в ~/.claude.json

Изображения, которые вы вставляли или прикрепляли в сессиях проекта, и каталог черновиков каждой сессии хранятся во временном каталоге Claude Code, а не в ~/.claude, поэтому очистка их не удаляет. Очистка по сроку хранения по-прежнему удаляет изображения, когда они становятся старше cleanupPeriodDays; каталог черновиков очищенной сессии остаётся, пока вы его не удалите или ваша операционная система не очистит временный каталог.

Команда выводит полный план удаления и запрашивает подтверждение, прежде чем что-либо удалить.

До v2.1.288 команда называлась claude project purge.

В примерах ниже ~/work/my-repo используется как условное значение. Замените его путём к вашему проекту. Если для указанного пути нет соответствующего состояния, команда выводит ошибку и завершается с кодом 1.

Предварительный просмотр плана без удаления:

claude purge ~/work/my-repo --dry-run

План перечисляет каждый подходящий элемент и причину его включения:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Удаление с одним запросом подтверждения:

claude purge ~/work/my-repo

Команда выводит тот же план, затем спрашивает Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] и выполняет удаление, только если вы ответите y.

Не указывайте путь, чтобы выбрать проект из интерактивного списка.

Пропуск запроса подтверждения для использования в скриптах:

claude purge ~/work/my-repo --yes

Другие параметры:

• Передайте --all вместо пути, чтобы очистить состояние всех проектов сразу; в этом случае history.jsonl удаляется целиком, а не фильтруется.
• Передайте -i, чтобы пройти по плану удаления поэлементно.

Команда не трогает shell-snapshots/ и backups/, поскольку они не привязаны к проекту, и предупреждает о них в выводе плана. Если кто-либо выполнял /heapdump на этом компьютере, удалите также записанные им файлы .heapsnapshot. Снимок кучи содержит весь диалог и все учётные данные, которые хранил процесс, и ни очистка по сроку хранения, ни команда purge его не затрагивают.

Вы также можете самостоятельно удалить любые из указанных выше путей данных приложения, за исключением файлов состояния, которые нужно сохранить.

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

Связанные ресурсы

• Управляйте памятью Claude: пишите и организуйте CLAUDE.md, rules и auto memory
• Настройте параметры: установите разрешения, hooks, переменные окружения и значения по умолчанию модели
• Создавайте skills: создавайте переиспользуемые подсказки и рабочие процессы
• Настройте subagents: определите специализированные агенты с их собственным контекстом