~/.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/ и применяются ко всем проектам.
Несколько вещей могут переопределить то, что вы поместили в эти файлы:
- Управляемые настройки, развёрнутые вашей организацией, имеют приоритет над всеми файлами настроек и значениями
--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 приводит к ошибке валидации. Тот же порог возраста применяется к автоматическому удалению сиротских worktrees.
Файлы сеанса в
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
- Управляемые настройки задают
- Режим Bare: когда вы запускаете
claude -pс--bare, Claude Code не запускает очистку в этом сеансе. - Приостановленная очистка: если Claude Code не может безопасно определить период хранения, он приостанавливает очистку хранения; событие
retention_sweepперечисляет каждую конфигурацию, которая её приостанавливает. Когда причина — файл параметров, который не может быть прочитан или разобран, или ошибки параметров с явно установленнымиcleanupPeriodDaysилиdesktopSessionCleanupPeriodDays, Claude Code также показывает предупреждение в/statusдо тех пор, пока вы не исправите ошибки параметров. Когда управляемые параметры предоставляютcleanupPeriodDays, Claude Code запускает очистку с управляемым значением в любом случае.
Каталог блокнота сеанса
Блокнот — это каталог для каждого сеанса, который Claude Code предоставляет Claude для временных файлов: промежуточные результаты, вспомогательные скрипты и черновики, которые не принадлежат вашему проекту. Когда Claude говорит, что он сохранил что-то «в блокнот», файл находится там. 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, дерево переместится в этот каталог вместо этого. Hooks получают путь текущего сеанса как 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/: память subagentjobs/и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: определите специализированные агенты с их собственным контекстом