SpyBara
Go Premium

claude-directory.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

40 added, 1413 removed.

2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Изучите директорию .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. Остальная часть директории опциональна: добавляйте skills, rules или subagents по мере необходимости.

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

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

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

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

Файл Местоположение Назначение
managed-settings.json Системный уровень, варьируется в зависимости от ОС Параметры, установленные предприятием, которые вы не можете переопределить. См. параметры, управляемые сервером.
CLAUDE.local.md Корень проекта Ваши личные предпочтения для этого проекта, загруженные вместе с CLAUDE.md. Создайте его вручную и добавьте в .gitignore.
Установленные plugins ~/.claude/plugins Клонированные маркетплейсы, установленные версии plugins и данные для каждого plugin, управляемые командами claude plugin. Сиротские версии удаляются через 7 дней после обновления или удаления plugin. См. кэширование plugins.

~/.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/ и применяются ко всем проектам.

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

Файл Область Зафиксировать Что он делает Справочник
CLAUDE.md Проект и глобально Инструкции, загруженные каждый сеанс Memory
rules/*.md Проект и глобально Инструкции с областью действия темы, опционально с ограничением по пути Rules
settings.json Проект и глобально Разрешения, hooks, переменные окружения, значения по умолчанию модели Settings
settings.local.json Только проект Ваши личные переопределения, автоматически добавлены в .gitignore Области параметров
.mcp.json Только проект Серверы MCP, общие для команды Области MCP
.worktreeinclude Только проект Файлы, игнорируемые Git, для копирования в новые worktrees Worktrees
skills/<name>/SKILL.md Проект и глобально Переиспользуемые подсказки, вызываемые с /name или автоматически вызываемые Skills
commands/*.md Проект и глобально Подсказки в одном файле; тот же механизм, что и skills Skills
output-styles/*.md Проект и глобально Пользовательские разделы системной подсказки 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 Только глобально Пользовательские цветовые темы Пользовательские темы

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

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

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

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

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

Файлы в путях ниже удаляются при запуске, как только им исполняется больше cleanupPeriodDays. По умолчанию это 30 дней.

Путь под ~/.claude/ Содержимое
projects/<project>/<session>.jsonl Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента
projects/<project>/<session>/subagents/ Стенограммы разговоров Subagent, удаляемые вместе со стенограммой родительского сеанса, когда она устаревает
projects/<project>/<session>/tool-results/ Большие выходные данные инструмента разлиты в отдельные файлы
file-history/<session>/ Снимки файлов перед редактированием, которые Claude изменил, используемые для восстановления checkpoint
plans/ Файлы плана, написанные во время plan mode
debug/ Журналы отладки для каждого сеанса, написанные только при запуске с --debug или запуске /debug
paste-cache/, image-cache/ Содержимое больших вставок и прикреплённых изображений
session-env/ Метаданные окружения для каждого сеанса
tasks/ Списки задач для каждого сеанса, написанные инструментами задач
shell-snapshots/ Захваченное окружение оболочки, используемое инструментом Bash. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя.
backups/ Временные копии ~/.claude.json, сделанные перед миграциями конфигурации
feedback-bundles/ Отредактированные архивы стенограмм, написанные /feedback на сторонних поставщиков, для отправки команде вашего аккаунта Anthropic
todos/, statsig/, logs/ Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию.

Сохраняется до удаления вами

Следующие пути не охватываются автоматической очисткой и сохраняются неопределённо долго.

Путь под ~/.claude/ Содержимое
history.jsonl Каждая подсказка, которую вы ввели, с временной меткой и путём проекта. Используется для отзыва стрелки вверх.
stats-cache.json Агрегированные подсчёты токенов и затрат, показанные /usage
remote-settings.json Кэшированная копия управляемых сервером параметров для вашей организации. Присутствует только если ваша организация их настроила. Обновляется при каждом запуске.

Другие небольшие файлы кэша и блокировки появляются в зависимости от того, какие функции вы используете, и безопасны для удаления.

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

Стенограммы и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл .env или команда выводит учётные данные, это значение записывается в projects/<project>/<session>.jsonl. Чтобы снизить риск:

  • Снизьте cleanupPeriodDays, чтобы сократить время хранения стенограмм
  • Установите переменную окружения CLAUDE_CODE_SKIP_PROMPT_HISTORY, чтобы пропустить запись стенограмм и истории подсказок в любом режиме. В неинтерактивном режиме вы можете вместо этого передать --no-session-persistence вместе с -p или установить persistSession: false в Agent SDK.
  • Используйте правила разрешений для запрета чтения файлов учётных данных

Очистить локальные данные

Запустите claude project purge, чтобы удалить состояние, которое Claude Code хранит для одного проекта. Команда требует Claude Code v2.1.124 или более позднюю версию. Она удаляет:

  • Стенограммы и автоматическую память под projects/
  • Записи tasks/, debug/ и file-history/ для каждого сеанса
  • Соответствующие строки подсказок в history.jsonl
  • Запись проекта в ~/.claude.json

Команда выводит полный план удаления и запрашивает подтверждение перед удалением чего-либо.

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

claude project purge ~/work/my-repo --dry-run

Удалите с одним запросом подтверждения:

claude project purge ~/work/my-repo

Опустите путь, чтобы выбрать проект из интерактивного списка.

Пропустите запрос подтверждения для использования в скриптах:

claude project purge ~/work/my-repo --yes

Передайте --all вместо пути, чтобы очистить состояние для каждого проекта одновременно, что удаляет history.jsonl полностью, а не фильтрует его. Передайте -i, чтобы пройти через план удаления по одному элементу за раз.

Команда оставляет shell-snapshots/ и backups/ в покое, потому что они не ограничены проектом, и предупреждает о них в выводе плана. Она выходит со статусом 1, если никакое состояние не соответствует заданному пути.

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

Удалить Вы потеряете
~/.claude/projects/ Возобновление, продолжение и перемотка для прошлых сеансов
~/.claude/history.jsonl Отзыв подсказки стрелки вверх
~/.claude/file-history/ Восстановление checkpoint для прошлых сеансов
~/.claude/stats-cache.json Исторические итоги, показанные /usage
~/.claude/remote-settings.json Ничего. Повторно загружается при следующем запуске.
~/.claude/debug/, ~/.claude/plans/, ~/.claude/paste-cache/, ~/.claude/image-cache/, ~/.claude/session-env/, ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/ Ничего, видимого пользователю
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/ Ничего. Устаревшие директории, не записываемые текущими версиями.

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