~/.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 |
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
--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: определите специализированные агенты с их собственным контекстом