Скрытая папка .claude: назначение, структура и управление

Скрытая папка .claude создаётся инструментами, интегрированными с Claude, для хранения локального состояния. Она содержит конфигурацию, кэшированные данные, определения задач и иногда контекст, обеспечивающий согласованность выполнения.

На первый взгляд папка кажется небольшой и несущественной. Однако при работе с агентными рабочими процессами или повторяющимися задачами она становится частью основной функциональности. Удаление папки — это не просто очистка файлов, а сброс того, как Claude взаимодействует с проектом.

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

Папка .claude — это скрытая директория, действующая как локальное рабочее пространство для инструментов на основе Claude. Точка в начале названия означает, что папка скрыта по умолчанию, как .git или .vscode.

В основе её existence — сохранение состояния. При взаимодействии с Claude через CLI-инструмент, агентный фреймворк или локальную интеграцию система нуждается в месте для фиксации происходящего: настроек, промежуточных данных и, иногда, памяти, распространяющейся между сессиями.

Без этой папки каждое взаимодействие начиналось бы с чистого листа. Папка .claude служит связующим звеном между проектом и моделью. Сама модель ничего не запоминает между запусками, если контекст не указан явно. Эта папка восполняет этот пробел, сохраняя всё необходимое для последовательного и воспроизводимого взаимодействия.

Папка .claude создаётся автоматически при первом использовании инструмента на основе Claude в проекте. Это происходит, например, при запуске CLI-инструмента, эксперименте с агентным рабочим процессом или использовании среды разработки с интеграцией Claude.

Цель существования папки — сохранение и контроль:

• Хранение контекста, специфичного для проекта: Claude может ссылаться на предыдущие запуски, сохранённые инструкции и структурированные данные.
• Поддержание согласованного поведения: настройки, как модель должна отвечать, какие инструменты использовать и как структурировать задачи, сохраняются здесь.
• Поддержка продвинутых рабочих процессов: при переходе от простых запросов к многошаговым задачам и агентам, выполняющим последовательности действий, система отслеживает прогресс именно в этой папке.

После открытия папки .claude структура становится понятнее. Хотя она может отличаться в зависимости от инструмента, большинство реализаций следуют общему шаблону:

• config.json — определяет поведение Claude в проекте: предпочтения модели, настройки API и инструкции для направления ответов или рабочих процессов.
• memory/ или context/ — хранят данные, сохраняющиеся между взаимодействиями: историю диалога, эмбеддинги или структурированный контекст, который система может повторно использовать.
• agents/ или tasks/ — содержит определения задач, инструкции для многошаговых процессов и логику их выполнения.
• logs/ — записывает ход выполнения: запросы, ответы, ошибки и промежуточные шаги.
• cache/ — хранит временные данные, чтобы избежать повторных вычислений: кэшированные ответы, промежуточные результаты и обработанные данные.

При выполнении задачи система сначала загружает конфигурацию из config.json, затем — контекст из memory/ или context/, затем выполняет задачу и записывает изменения обратно в папку .claude. Это создаёт замкнутый цикл: чтение → выполнение → запись.

Пример содержимого папки:

.clause/
  config.json
  memory/
  agents/
  logs/
  cache/

При выполнении команды вроде claude run "Summarize all user feedback from the last 7 days":

1. Система читает config.json для выбора модели и определения ограничений.
2. Загружает контекст из memory/, если есть данные из предыдущих операций.
3. При необходимости обращается к agents/ для выполнения многошаговой последовательности.
4. Обновляет logs/ и cache/ по ходу выполнения.

Каждый запуск обновляет состояние папки — это не разовый вывод, а накопление информации.

Папку .claude можно удалить — ничего критичного не сломается, но будут последствия:

• Потеря накопленного контекста: система начнёт «с чистого листа».
• Потеря пользовательских настроек: все кастомные настройки и рабочие процессы исчезнут, если не сохранены отдельно.
• Снижение скорости: отсутствие кэша потребует пересчёта ранее обработанных данных.

Однако удаление папки полезно при сбоях: это сброс некорректного состояния, устаревшего контекста или ошибочных настроек.

Для корректного управления:

• Добавьте .claude в .gitignore: большинство данных внутри — локальные и не должны попадать в репозиторий.
• Избегайте коммита содержимого: логи могут содержать пользовательский ввод, а config.json — чувствительные настройки.
• Очищайте старые логи и кэш: это предотвращает переполнение и конфликты устаревшего состояния.

Типичные ошибки разработчиков:

• Удаление папки без понимания последствий — сброс всех настроек и контекста.
• Коммит папки без проверки содержимого — утечка чувствительных данных.
• Игнорирование логов — упущенная возможность быстрой диагностики.

Папка .claude — центр управления состоянием при работе с Claude. Без неё каждое взаимодействие было бы изолированным. С ней — процессы становятся последовательными, воспроизводимыми и мощными.