SpyBara
Go Premium

claude-directory.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 23 additions and 1470 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Wed 14 22:58 Fri 16 22:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Mon 26 22:57 Thu 29 23:57

Изучите директорию .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 по мере необходимости.

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

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

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

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

Файл Расположение Назначение
managed-settings.json Уровень системы, варьируется в зависимости от ОС Настройки, применяемые предприятием, которые не могут переопределить ни ваши собственные файлы настроек, ни значения --settings, за исключением узких исключений. См. где сохранить файл и какой управляемый источник использует Claude Code.
CLAUDE.local.md Корень проекта Ваши личные предпочтения для этого проекта, загружаемые вместе с CLAUDE.md. Создайте его вручную и добавьте в .gitignore.
AGENTS.md Корень проекта, .claude/ или любой каталог Инструкции проекта, которые вы пишете для агентов AI кодирования. Claude Code может загрузить его вместо CLAUDE.md.
Установленные плагины ~/.claude/plugins Клонированные маркетплейсы, установленные версии плагинов, запись установки installed_plugins.json и данные для каждого плагина, управляемые командами claude plugin. Плагины, синхронизированные с вашей учётной записью claude.ai, загружаются в ~/.claude/plugins/synced/. Для плагина, установленного из маркетплейса с источником command в режиме ссылки, Claude Code хранит здесь ссылки вместо копии, и файлы плагина остаются в каталоге, который выводит команда. Источник command требует Claude Code v2.1.229 или позже. Плагин, указанный относительным путём в маркетплейсе, который вы добавили из локального пути, также загружается на месте из своего исходного каталога, а не из копии в кэше. См. кэширование плагинов, чтобы узнать, как очищаются заброшенные версии.

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

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

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

Вы хотите Редактировать Область Справочник
Дать Claude контекст проекта и соглашения CLAUDE.md проект или глобально Memory
Разрешить или заблокировать определённые вызовы инструментов settings.json permissions или hooks проект или глобально Permissions, Hooks
Запустить скрипт до или после вызовов инструментов settings.json hooks проект или глобально Hooks
Установить переменные окружения для сеанса settings.json env проект или глобально Settings
Сохранить личные переопределения вне git settings.local.json только проект Области параметров
Добавить подсказку или возможность, которую вы вызываете с /name skills/<name>/SKILL.md проект или глобально Skills
Определить специализированный subagent с его собственными инструментами agents/*.md проект или глобально Subagents
Организовать множество subagents из скрипта workflows/*.js проект или глобально Dynamic workflows
Подключить внешние инструменты через MCP .mcp.json только проект MCP
Изменить способ форматирования ответов Claude output-styles/*.md проект или глобально Output styles

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

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

[!NOTE]

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

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

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

Файл Область Зафиксировать Что он делает Справочник
CLAUDE.md Проект и глобально ✓ Инструкции, загруженные каждый сеанс Memory
rules/*.md Проект и глобально ✓ Инструкции с областью действия темы, опционально с ограничением по пути Rules
settings.json Проект и глобально ✓ Разрешения, hooks, переменные окружения, значения по умолчанию модели Settings
settings.local.json Только проект Ваши личные переопределения, автоматически добавлены в .gitignore при сохранении параметра Claude Code Области параметров
.mcp.json Только проект ✓ Серверы MCP, общие для команды Области MCP
.worktreeinclude Только проект ✓ Файлы, игнорируемые Git, для копирования в новые worktrees Worktrees
skills/<name>/SKILL.md Проект и глобально ✓ Переиспользуемые подсказки, вызываемые с /name или автоматически вызываемые Skills
commands/*.md Проект и глобально ✓ Подсказки в одном файле; тот же механизм, что и skills Skills
output-styles/*.md Проект и глобально ✓ Пользовательские наборы инструкций, которые изменяют способ работы Claude Output styles
agents/*.md Проект и глобально ✓ Определения subagents с их собственной подсказкой и инструментами Subagents
workflows/*.js Проект и глобально ✓ Динамические скрипты рабочего процесса, написанные Claude и сохранённые из /workflows; каждый файл становится командой /<name> Dynamic workflows
agent-memory/<name>/ Проект и глобально ✓ Постоянная память для subagents Постоянная память
~/.claude.json Только глобально Состояние приложения, OAuth, переключатели UI, личные серверы MCP Глобальная конфигурация
projects/<project>/memory/ Только глобально Auto memory: заметки Claude самому себе между сеансами Auto memory
keybindings.json Только глобально Пользовательские сочетания клавиш Keybindings
themes/*.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.

File Frontmatter fields Reference
skills/<name>/SKILL.md name, description, when_to_use, argument-hint, arguments, disable-model-invocation, user-invocable, allowed-tools, disallowed-tools, model, effort, context, agent, background, hooks, paths, shell, metadata, license, compatibility Skill frontmatter
commands/*.md The skill fields except name and paths Skill frontmatter
agents/*.md name, description, tools, disallowedTools, model, permissionMode, maxTurns, autoCompactWindow, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt, omitClaudeMd, experimental Frontmatter субагента
output-styles/*.md name, description, keep-coding-instructions, force-for-plugin Output style frontmatter
rules/*.md paths Rule frontmatter

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

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

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

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

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

Автоматическая очистка

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

Путь в ~/.claude/ Содержимое
projects/<project>/<session>.jsonl Полный транскрипт беседы: каждое сообщение, вызов инструмента и результат инструмента
projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl, projects/<project>/<session>.jsonl.superseded-<timestamp> Предыдущий транскрипт сеанса, который Claude Code отложил вместо перезаписи или удаления. Не отображается в средстве выбора сеанса
projects/<project>/<session>/subagents/ Транскрипты беседы Subagent, удаляются вместе с транскриптом родительского сеанса при его устаревании
projects/<project>/<session>/tool-results/ Большие выходные данные инструментов, перенесённые в отдельные файлы, и полноразмерные копии изображений, возвращаемых инструментами MCP
file-history/<session>/ Снимки файлов до редактирования, которые Claude изменил, используются для восстановления контрольной точки. Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни одна сохранённая контрольная точка, удаляются, кроме первого снимка каждого файла
plans/ Файлы плана, написанные во время режима плана
debug/ Журналы отладки для каждого сеанса, записываемые при включённой отладке, например при запуске с --debug или выполнении /debug
paste-cache/ Содержимое больших вставок
image-cache/<session>/ Изображения, прикреплённые и сохранённые Claude Code v2.1.274 и более ранними версиями. Более поздние версии сохраняют вставленные и прикреплённые изображения вне ~/.claude, в каталоге images/ для каждого сеанса в временном каталоге, который контролирует CLAUDE_CODE_TMPDIR. Очистка удаляет оставшиеся каталоги других сеансов здесь, независимо от их возраста.
uploads/<session>/ Файлы, которые вы прикрепляете из веб-приложения или мобильного приложения, и фотографии, которые вы прикрепляете из мобильного приложения, при отправке сообщения в сеанс Remote Control. Вложение в облачный сеанс сохраняется в собственной облачной среде этого сеанса, а не на вашей машине.
dev-mods/<session>/ Моды, которые написал Claude во время сеанса
session-env/ Метаданные окружения для каждого сеанса
tasks/ Списки задач, написанные инструментами задач, один каталог на список
shell-snapshots/ Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые инструментом Bash к каждой команде. Удаляются при корректном выходе. Очистка удаляет оставшиеся после сбоя.
backups/ Более ранние версии ~/.claude.json, скопированные при перезаписи файла Claude Code. Claude Code сохраняет пять самых новых, плюс копию любой версии, которую он не смог разобрать.
feedback-bundles/ Отредактированные архивы транскриптов, написанные /feedback на сторонних поставщиков или когда учётные данные Anthropic не настроены, для отправки команде вашего аккаунта Anthropic
feedback/drafts/ Очередь черновиков обратной связи, написанных Claude, ожидающих вашего рассмотрения в /feedback. Очищается после cleanupPeriodDays или 30 дней, в зависимости от того, что меньше. Когда очередь достигает лимита в 10 черновиков, Claude Code удаляет самый старый черновик, чтобы освободить место.
usage-data/ report.html и копии отчётов с временными метками, написанные /insights, плюс кэшированные данные анализа для каждого сеанса, используемые для их построения
skills/.trash/, plugins/.trash/ Навыки и плагины, которые синхронизация claude.ai удалила, например после отключения одного на claude.ai или остановки синхронизации. Файлы остаются здесь, чтобы вы могли их восстановить, пока очистка их не удалит
plugins/installed_plugins.set-aside.<date>.<hash>.json, plugins/installed_plugins.unreadable.<date>.<hash>.kept Датированные копии, которые Claude Code создаёт перед перезаписью installed_plugins.json: записи об установке, которые он удалил, и содержимое файла, который он не смог прочитать.
todos/, statsig/, logs/ Устаревшие каталоги из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустой каталог.

Файлы сеанса в 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/ Содержимое
history.jsonl Каждый промпт, который вы ввели, с временной меткой и путём проекта. Используется для вызова стрелкой вверх, поиска по истории Ctrl+R и завершения shell-команд !. Каждая очистка удаляет записи старше cleanupPeriodDays, когда к вашим сессиям применяется конфигурация HIPAA.
stats-cache.json Агрегированные подсчёты токенов и затрат, показанные /usage
remote-settings.json Кэшированная копия управляемых параметров сервера для вашей организации, или {} когда ваша организация не настроила никаких. Присутствует только когда сеанс их получает. Claude Code проверяет обновления при запуске и ежечасно во время сеанса. Claude Code удаляет его при выходе.
cache/changelog.md Кэшированная копия журнала изменений Claude Code, показанная /release-notes. Обновляется в фоне.
policy-limits.json Кэшированные параметры политики функций для вашей организации. Присутствует только для некоторых типов аккаунтов. Обновляется автоматически. Файл-спутник policy-limits.json.stamp.json записывает, какому аккаунту или ключу API принадлежит кэш. 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.

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

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/projects/ Возобновление, продолжение и перемотку для прошлых сеансов, и автоматическую память для каждого проекта
~/.claude/history.jsonl Вызов запроса стрелкой вверх, поиск истории Ctrl+R и завершение команды оболочки !
~/.claude/paste-cache/ Вставленный текст в вызванных запросах; см. вставка большого содержимого
~/.claude/uploads/ Вложения, на которые ссылаются прошлые сеансы Remote Control по пути
~/.claude/file-history/ Восстановление контрольной точки для прошлых сеансов
~/.claude/stats-cache.json Исторические итоги, показанные /usage
~/.claude/usage-data/ Прошлые отчёты /insights и кэшированные данные анализа, используемые для их построения
~/.claude/feedback-bundles/ Архивы обратной связи и отчётов об ошибках, которые вы ещё не отправили команде вашего аккаунта Anthropic
~/.claude/feedback/drafts/ Черновики обратной связи, написанные Claude, которые вы не отправили
~/.claude/remote-settings.json Ничего. Повторно получается при следующем запуске.
~/.claude/cache/changelog.md Ничего. Обновляется в фоне.
~/.claude/policy-limits.json Ничего. Обновляется автоматически.
~/.claude/tasks/ Ваши списки задач, включая те, которые ещё используются
~/.claude/skills/.trash/, ~/.claude/plugins/.trash/ Возможность восстановления синхронизированных навыков и синхронизированных плагинов, которые Claude Code удалил
~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json, ~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept Копии записей об установке плагинов, которые Claude Code удалил или не смог прочитать. Ничто их не читает обратно
~/.claude/debug/, ~/.claude/plans/, ~/.claude/session-env/, ~/.claude/shell-snapshots/, ~/.claude/backups/ Ничего видимого пользователю
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/, ~/.claude/image-cache/ Ничего. Устаревшие каталоги, не записываемые текущими версиями.

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

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