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

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

Управляемые параметры, развёрнутые вашей организацией, имеют приоритет над всем остальным
Флаги CLI, такие как --permission-mode или --settings, переопределяют settings.json для этого сеанса
Некоторые переменные окружения имеют приоритет над их эквивалентным параметром, но это варьируется: проверьте справочник переменных окружения для каждого из них

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

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

Файл	Область	Зафиксировать	Что он делает	Справочник
`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. Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни один сохранённый checkpoint, удаляются, за исключением первого снимка каждого файла
`plans/`	Файлы плана, написанные во время plan mode
`debug/`	Журналы отладки для каждого сеанса, написанные только при запуске с `--debug` или запуске `/debug`
`paste-cache/`, `image-cache/`	Содержимое больших вставок и прикреплённых изображений
`session-env/`	Метаданные окружения для каждого сеанса
`tasks/`	Списки задач для каждого сеанса, написанные инструментами задач
`shell-snapshots/`	Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые инструментом Bash к каждой команде. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя.
`backups/`	Временные копии `~/.claude.json`, сделанные перед миграциями конфигурации
`feedback-bundles/`	Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта 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.

Управляйте памятью Claude: пишите и организуйте CLAUDE.md, rules и auto memory
Настройте параметры: установите разрешения, hooks, переменные окружения и значения по умолчанию модели
Создавайте skills: создавайте переиспользуемые подсказки и рабочие процессы
Настройте subagents: определите специализированные агенты с их собственным контекстом

Начало работы

Основные концепции

Использовать Claude Code

Платформы и интеграции

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