5 файлов, без которых Claude Code работает неэффективно

5 шагов, после которых Claude Code получит рабочий мозг и память.

Этот гайд для тех, кто уже установил Claude Code или только начинает погружение в AI и хочет настроить его один раз. Чтобы помнил проект, не переспрашивал одно и то же и делал рутину сам.

Пять файлов ниже решают это раз и навсегда. Настроил один раз — Claude работает в твоём контексте.

Что внутри

1. CLAUDE.md — память проекта
2. .claude/settings.json — что Claude может, а что нет
3. .claude/commands/ — твои личные команды
4. Hooks — автоматика в фоне
5. MCP Servers — руки Claude за пределами твоих файлов

1. CLAUDE.md — память проекта

Что это

Текстовый файл, который Claude читает перед каждой сессией. Его инструкция по твоему проекту: как писать код, какие библиотеки использовать, что никогда не трогать без спроса.

Зачем

Без CLAUDE.md каждая сессия начинается с нуля. Claude не знает, что ты хочешь минималистичный дизайн без анимаций. Не знает, что в проекте нет React и не надо его предлагать. Не знает, как ты оформляешь коммиты. Начинает догадываться — и часто не туда.

Что туда писать

• на каком языке писать код и комментарии
• какие библиотеки использовать, а какие — никогда
• как оформлять коммиты
• что Claude не должен трогать без явного разрешения

Файл живёт в корне проекта — рядом с основными файлами.

Промпт для Claude Code

Изучи файлы в этой папке и создай CLAUDE.md с описанием проекта:
стек, правила стиля, что нельзя делать.

Claude сам прочитает файлы и заполнит CLAUDE.md. Тебе останется проверить и добавить свои правила.

[TODO: скрин — пример CLAUDE.md в корне проекта]

2. .claude/settings.json — что Claude может, а что нет

Что это

Файл с настройками прав. Ты заранее говоришь Claude, какие действия он может делать сам, а какие — только с твоего подтверждения.

Зачем

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

Что туда писать

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

Файл лежит в папке .claude/ внутри проекта.

Промпт для Claude Code

Создай папку .claude и файл settings.json внутри. Разреши: чтение
файлов, запись, редактирование кода, запуск терминальных команд.
Запрети: удаление файлов без подтверждения.

3. .claude/commands/ — твои личные команды

Что это

Папка, где каждый .md файл становится командой. Сохранил промпт в файл review.md — получил команду /review. Написал deploy.md — получил /deploy.

Зачем

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

Команды поддерживают аргументы. Написал /review index.html — Claude возьмёт чек-лист из review.md и применит его к этому конкретному файлу.

Команды, которые стоит завести сразу

• /review — проверить код по чек-листу перед коммитом
• /deploy — пройтись по шагам подготовки к публикации
• /describe — написать описание страницы или раздела для SEO

Промпт для Claude Code

Создай папку .claude/commands/ и добавь файл review.md — чек-лист
для проверки HTML/CSS кода перед коммитом: чистота кода, работа на
мобильных устройствах, корректность ссылок.

Теперь, когда в терминале пишешь /review, Claude предлагает выбрать команду и выполнить её.

[TODO: скрин — выпадающий список команд в терминале]

4. Hooks — автоматика в фоне

Что это

Hooks (хуки) — скрипты, которые запускаются автоматически до или после того, как Claude что-то делает с файлами. Он изменил код — запустилось автоформатирование. Написал новый файл — прогналась проверка.

Зачем

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

Что можно автоматизировать

• автоформатирование кода — программа приводит его в порядок после каждого сохранения файла (убирает лишние пробелы, выравнивает отступы)
• проверка ошибок перед коммитом — Claude не отправит код, если в нём очевидные проблемы
• уведомление, когда Claude закончил долгую задачу
• запуск тестов после изменений в коде

Настраивается внутри settings.json, в разделе hooks.

Промпт для Claude Code

Добавь в settings.json хуки: запускать prettier после каждого
изменения HTML и CSS файлов. Если prettier не установлен — покажи,
как его поставить.

5. MCP Servers — руки Claude за пределами твоих файлов

Что это

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

Зачем

Без MCP Claude — хороший помощник с локальными файлами. С MCP он делает запрос в базу данных и сразу пишет код на основе реальных данных. Или находит информацию в интернете прямо в процессе работы. Или создаёт задачу в GitHub, не выходя из редактора.

Что можно подключить

• базу данных (Supabase, Postgres) — Claude пишет и выполняет запросы напрямую
• поиск в интернете — для ресёрча без переключения в браузер
• GitHub — создавать задачи, смотреть PR, управлять ветками
• любой сервис, для которого есть готовый MCP-сервер

Настраивается в settings.json, в разделе mcpServers.

Промпт для Claude Code

Покажи, как подключить MCP-сервер для поиска в интернете (Brave
Search). Добавь конфигурацию в settings.json и объясни, что нужно
сделать дополнительно.

Частые ошибки

[BAD] CLAUDE.md слишком общий. «Пиши чистый код» — пожелание, не правило. Claude проигнорирует.

[GOOD] Конкретика: «не используй Bootstrap», «коммиты только на английском», «не добавляй анимации без согласования».

settings.json не там. Claude продолжает переспрашивать про каждое действие — скорее всего файл не создан или лежит не в том месте. Папка .claude в корне проекта, settings.json внутри неё.

Команды не работают. Файлы в commands/ должны иметь расширение .md. Команда называется так же, как файл: review.md → /review.

Hooks не запускаются. Убедись, что инструмент установлен в проекте. Хук есть, но если prettier не установлен — запускать нечего. Попроси Claude проверить.

MCP не подключается. Неверный API-ключ или URL. Перепроверь конфигурацию.

Итого: что сделать прямо сейчас

1. Создать CLAUDE.md с правилами проекта
2. Создать .claude/settings.json с разрешениями и запретами
3. Создать папку .claude/commands/ и добавить первую команду /review
4. Добавить хуки для автоформатирования
5. Подключить хотя бы один MCP-сервер, который нужен для работы

Где ещё это пригодится

Эти файлы работают в любом проекте. Телеграм-бот, веб-приложение, скрипт автоматизации — структура .claude/ и CLAUDE.md переезжают с проектом без изменений. Разобрался один раз — применяешь везде.

Что почитать дальше

• Claude для новичков — если ещё не настроил основной аккаунт
• Топ-16 скилсов для Claude — какие готовые навыки поставить сразу
• AGENTS.md и Memory Bank (paid) — следующий уровень после CLAUDE.md
• Экономия токенов — как не сжечь подписку, когда вайбкодишь активно