SpyBara
Go Premium

claude-directory.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 85 additions and 84 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 Только глобально Состояние приложения, данные учётной записи, переключатели 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 приводит к ошибке валидации. Тот же порог возраста применяется к автоматическому удалению осиротевших worktree.

Путь в ~/.claude/ Содержимое
projects/<project>/<session>.jsonl Полный транскрипт диалога: каждое сообщение, вызов инструмента и результат инструмента
projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl, projects/<project>/<session>.jsonl.superseded-<timestamp> Предыдущий транскрипт сессии, который Claude Code отложил вместо того, чтобы перезаписать или удалить его. Он не отображается в списке выбора сессий
projects/<project>/<session>/subagents/ Транскрипты диалогов субагентов, удаляются вместе с транскриптом родительской сессии, когда истекает его срок хранения
projects/<project>/<session>/tool-results/ Большие выводы инструментов, вынесенные в отдельные файлы, и полноразмерные копии изображений, которые возвращают инструменты MCP
projects/<project>/<session>/mcp-tasks/ Данные, необходимые возобновлённой сессии, чтобы снова отслеживать выполняющиеся задачи MCP, и результаты завершённых задач, которые Claude ещё не прочитал
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 в любом случае выполняет очистку с управляемым значением.

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

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

Каталог черновиков (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/ Содержимое
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 и автодополнение shell-команд !
~/.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/: в них хранятся данные вашей учётной записи, ваши настройки и установленные плагины.

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