~/.claude в вашей домашней директории. Зафиксируйте файлы проекта в git, чтобы поделиться ими с вашей командой; файлы в ~/.claude — это личная конфигурация, которая применяется ко всем вашим проектам.
На Windows ~/.claude разрешается в %USERPROFILE%\.claude. Если вы зададите CLAUDE_CONFIG_DIR, каждый путь ~/.claude на этой странице будет находиться в этом каталоге. То же относится к .claude.json, который в противном случае находится в ~/.claude.json.
Большинство пользователей редактируют только CLAUDE.md и settings.json. Если ваш репозиторий уже содержит AGENTS.md для других агентов кодирования, Claude Code может читать его вместо CLAUDE.md. Остальная часть директории опциональна: добавляйте skills, rules или subagents по мере необходимости.
Изучите директорию
Нажимайте на файлы в дереве, чтобы увидеть, что каждый из них делает, когда он загружается и пример.Что не показано
Обозреватель охватывает файлы, которые вы создаёте и редактируете. Несколько связанных файлов находятся в других местах:~/.claude также содержит данные, которые Claude Code записывает во время работы: стенограммы, историю подсказок, снимки файлов, кэши и журналы. См. данные приложения ниже.
Выберите правильный файл
Различные виды настройки находятся в разных файлах. Используйте эту таблицу, чтобы найти, где должно быть изменение.Справочник файлов
Эта таблица перечисляет каждый файл, который охватывает обозреватель. Файлы с областью действия проекта находятся в вашем репозитории под.claude/ (или в корне для CLAUDE.md, .mcp.json и .worktreeinclude). Файлы с глобальной областью действия находятся в ~/.claude/ и применяются ко всем проектам.
Несколько вещей могут переопределить то, что вы поместили в эти файлы:
- Управляемые настройки, развёрнутые вашей организацией, имеют приоритет над всеми файлами настроек и значениями
--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 отправляет модели вместе с вашими сообщениями:
- Системный промпт
- Определения инструментов
- Параметры запросов
- Загруженные им файлы инструкций, например CLAUDE.md
Автоматически очищаемые данные
Claude Code удаляет файлы по указанным ниже путям, когда они становятся старшеcleanupPeriodDays, при условии что он может надёжно определить срок хранения. Значение по умолчанию — 30 дней, минимальное — 1; значение 0 приводит к ошибке валидации. Тот же порог возраста применяется к автоматическому удалению осиротевших worktree.
Файлы сессий в
sessions/, автоматическая память и транскрипты Claude Desktop и Cowork подчиняются собственным правилам хранения:
-
sessions/: содержит по одному небольшому файлу на каждую запущенную сессию; используется для обнаружения параллельных сессий и сбоев. Этот каталог не входит в очистку по возрасту: Claude Code удаляет каждый файл при завершении его сессии и очищает остатки после сбоев при следующем запуске. -
seed-admin/: временные git-каталоги, которые Claude Code создаёт при упаковке вашего репозитория для ultrareview или загрузки в облачную сессию. Когда загрузка завершается (или в одной из последующих сессий, если загрузка была прервана), Claude Code удаляет каталог этой загрузки, а самseed-admin/оставляет на месте. -
Автоматическая память: очистка не удаляет файлы памяти в каталоге автоматической памяти проекта,
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
- Управляемые настройки задают
- Режим bare: когда вы запускаете
claude -pс--bare, Claude Code не выполняет очистку в этой сессии. - Приостановленная очистка: если Claude Code не может надёжно определить срок хранения, он приостанавливает очистку; событие
retention_sweepперечисляет все конфигурации, которые её приостанавливают. Если причина — файл настроек, который не удаётся прочитать или разобрать, или ошибки настроек при заданныхcleanupPeriodDaysилиdesktopSessionCleanupPeriodDays,/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. В Windows <project> — это 16-символьный хеш этой строки, например 73295dabccd14c56. В сессии приложения Desktop это может быть сама строка. Чтобы узнать точный путь, спросите Claude. Если вы задали 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, поэтому очистка их не удаляет. Очистка по сроку хранения по-прежнему удаляет изображения, когда они становятся старше cleanupPeriodDays; каталог черновиков очищенной сессии остаётся, пока вы его не удалите или ваша операционная система не очистит временный каталог.
Команда выводит полный план удаления и запрашивает подтверждение, прежде чем что-либо удалить.
До v2.1.288 команда называлась claude project purge.
В примерах ниже ~/work/my-repo используется как условное значение. Замените его путём к вашему проекту. Если для указанного пути нет соответствующего состояния, команда выводит ошибку и завершается с кодом 1.
Предварительный просмотр плана без удаления:
Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] и выполняет удаление, только если вы ответите y.
Не указывайте путь, чтобы выбрать проект из интерактивного списка.
Пропуск запроса подтверждения для использования в скриптах:
- Передайте
--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: определите специализированные агенты с их собственным контекстом