Изучите директорию .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`	Уровень системы, варьируется в зависимости от ОС	Параметры, установленные предприятием, которые вы не можете переопределить, за исключением узких исключений. См. где сохранить файл и какой управляемый источник использует Claude Code.
`CLAUDE.local.md`	Корень проекта	Ваши личные предпочтения для этого проекта, загружаемые вместе с CLAUDE.md. Создайте его вручную и добавьте в `.gitignore`.
`AGENTS.md`	Корень проекта, `.claude/` или любой каталог	Инструкции проекта, которые вы пишете для агентов AI кодирования. Claude Code может загрузить его самостоятельно или вместе с `CLAUDE.md`.
Установленные plugins	`~/.claude/plugins`	Клонированные маркетплейсы, установленные версии plugins, запись установки `installed_plugins.json`, и данные для каждого plugin, управляемые командами `claude plugin`. Plugins синхронизированные с вашей учётной записью claude.ai загружаются в `~/.claude/plugins/synced/`. Для plugin, установленного из маркетплейса с источником `command` в режиме ссылки, Claude Code хранит здесь ссылки вместо копии, и файлы plugin остаются в каталоге, который выводит команда. Источник `command` требует Claude Code v2.1.229 или позже. 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 при сохранении параметра 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`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental`	Subagent 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 приводит к ошибке валидации. Тот же порог возраста применяется к автоматическому удалению orphaned 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. Вложение в облачный сеанс сохраняется в собственной облачной среде этого сеанса, а не на вашей машине.
`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/`	Skills и plugins, которые синхронизация claude.ai удалила, например после отключения одного на claude.ai или остановки синхронизации. Файлы остаются здесь, чтобы вы могли их восстановить, пока очистка их не удалит
`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. Когда управляемые параметры устанавливают cleanupPeriodDays, Claude Code удаляет эти транскрипты после этого периода. Требуется Claude Code v2.1.248 или позже; более ранние версии удаляют их после cleanupPeriodDays.

Claude Code пропускает очистку на основе возраста в этих случаях:

Bare mode: когда вы запускаете claude -p с --bare, Claude Code не запускает очистку в этом сеансе.
Paused sweep: если 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 project 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` и завершения команды оболочки `!`.
`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 удаляет оба файла при выходе.

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

.credentials.json: ваши учётные данные входа
agent-memory/: память subagent
jobs/ и daemon/: состояние фонового сеанса

Хранение в виде простого текста

Транскрипты и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл .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 project purge, чтобы удалить состояние, которое Claude Code хранит для одного проекта. Он удаляет:

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

Изображения, которые вы вставили или прикрепили в сеансах проекта, и временная память каждого сеанса хранятся в временном каталоге Claude Code, а не в ~/.claude, поэтому очистка их не удаляет. Очистка хранения всё ещё удаляет изображения, как только они становятся старше cleanupPeriodDays; временная память очищенного сеанса остаётся до удаления вручную или пока ваша операционная система не очистит временный каталог. Команда выводит полный план удаления и запрашивает подтверждение перед удалением чего-либо. Примеры ниже используют ~/work/my-repo в качестве заполнителя. Замените его на путь к вашему проекту. Если состояние не совпадает с путём, команда выводит ошибку и выходит со статусом 1. Просмотрите план без удаления:

claude project 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 project purge ~/work/my-repo

Команда выводит тот же план, затем спрашивает Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] и удаляет только если вы ответите y. Опустите путь, чтобы выбрать проект из интерактивного списка. Пропустите запрос подтверждения для использования в скриптах:

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

Передайте --all вместо пути, чтобы очистить состояние для каждого проекта одновременно, что удаляет history.jsonl полностью, а не фильтрует его. Передайте -i, чтобы пройти через план удаления по одному элементу за раз. Команда оставляет shell-snapshots/ и backups/ в покое, потому что они не ограничены проектом, и предупреждает о них в выводе плана. Вы также можете удалить любой из путей данных приложения выше вручную, за исключением файлов состояния для сохранения. Новые сеансы не затронуты. Таблица ниже показывает, что вы теряете для прошлых сеансов.

Удалить	Вы теряете
`~/.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/`	Возможность восстановления синхронизированных skills и синхронизированных plugins, которые 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/: они содержат вашу аутентификацию, предпочтения и установленные plugins.

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

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

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

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

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

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