Skip to main content
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/ и применяются ко всем проектам.
Несколько вещей могут переопределить то, что вы поместили в эти файлы:См. приоритет параметров для полного порядка.
Нажмите на имя файла, чтобы открыть этот узел в обозревателе выше.

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 в любом из следующих случаев:
Claude Code пропускает очистку на основе возраста в этих случаях:
  • Режим 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/ также содержит файлы, не перечисленные в таблицах раздела Данные приложения. Из них кэши и файлы блокировки безопасно удалять. Сохраняйте эти файлы состояния:

Хранилище в виде простого текста

Транскрипты и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл .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. Предпросмотр плана без удаления:
План перечисляет каждый совпадающий элемент и причину его включения:
Удалить с одним запросом подтверждения:
Команда выводит тот же план, затем спрашивает 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/: они содержат вашу аутентификацию, предпочтения и установленные плагины.