Клиент на прошлой неделе показал мне свой CLAUDE.md на 400 строк. Там были правила стиля кода, его биография, принципы компании, инструкция по деплою и даже список любимых фреймворков. Claude этот файл читал. И игнорировал половину. Модель, которая получает на входе простыню, перестает следовать инструкциям - они тонут в шуме. Через 20 минут мы ужали файл до 30 строк, и разница в качестве ответов стала заметна сразу.
Как настроить Claude под себя - вопрос, который звучит постоянно, но почти все отвечают на него неправильно: пишут в чат подробный промпт и считают, что настройка закончена. Промпт живет до конца сессии. Настройка живет всегда. Claude, которому просто вводят задачи, и Claude, настроенный под ваш рабочий процесс, - два разных инструмента.
Четыре файла конфигурации, в которых все решается
Вся настройка Claude Code держится на файлах. Не на кнопках в интерфейсе и не на специальных командах. На файлах, которые лежат в конкретных местах и читаются в конкретном порядке. Люди до них не доходят - и удивляются, почему Claude каждый раз заново объясняет, что у них монорепа и что коммитить в master нельзя.
Уровней четыре:
- ~/.claude/CLAUDE.md - глобальный. Ваши личные правила, действуют во всех проектах. Не коммитятся никуда.
- ./CLAUDE.md - уровень проекта. Общая конфигурация команды, лежит в репозитории, действует для всех участников одинаково.
- CLAUDE.local.md - локальное переопределение проекта. Ваши персональные корректировки в рамках конкретного проекта, автоматически исключаются из коммитов.
- Skills - специализированные инструкции в .claude/skills/, загружаются только при вызове.
Логика простая. Глобальный файл - то, что верно про вас везде: «отвечай на русском», «у меня такой стек», «не используй классы без необходимости». Файл проекта - то, что верно про проект: структура, команды, соглашения. Локальный файл - то, что касается вас лично в этом проекте и не должно попадаться коллегам.
Claude в начале каждой сессии первым делом читает CLAUDE.md. Файл загружается в системный промпт и действует весь диалог. Написали там правило - Claude будет его соблюдать. Но только если написано правильно.
CLAUDE.md на 30 строк вместо 300
Главная ошибка, которую я вижу в 9 из 10 файлов: люди пишут в них документацию. Claude не нужен документ. Ему нужны правила.
Тощий CLAUDE.md выглядит примерно так:
«Проект: e-commerce API на FastAPI. СУБД - PostgreSQL, миграции через alembic. Тесты: pytest, запускать перед каждым коммитом. Не используй голые SQL-запросы, только ORM. Ответы на русском. Комментарии в коде - на английском.»
Пять строк. Уже работают. Что не нужно: история проекта, «наш продукт решает задачи клиентов», список фич. Claude не воплощает продукт-видение, он выполняет задачи - каждая лишняя строка размывает важные. В обсуждениях на Reddit разработчики сходятся в одном: чем короче CLAUDE.md, тем послушнее модель.
Проверенный прием: держите в CLAUDE.md только то, что Claude нарушит без вашего указания. Правила коммитов, соглашения по именованию, запреты. Все остальное - в skills, о которых дальше.
Skills: куда девать инструкции, которые не влезли
Skills - то, что превращает Claude Code из продвинутого автокомплита в настраиваемую платформу. Каждый skill лежит в .claude/skills/ в своей папке с файлом SKILL.md. Ключевое свойство: skill загружается только когда нужен. CLAUDE.md, напротив, съедает контекст в каждой сессии независимо от того, актуален он или нет.
Практический пример из моей работы. В проекте есть процедура релиза - 12 шагов, от обновления changelog до прогонки миграций на стейджинге. В CLAUDE.md эти 12 шагов не нужны. Но когда я говорю «release», Claude загружает skill и проходит по шагам. Так контекст не тратится, а инструкция всегда под рукой.
Хорошие кандидаты для skills:
- процедуры, которые выполняются регулярно (релиз, код-ревью, рефакторинг под конкретный паттерн)
- специфические знания по инфраструктуре, нужные в отдельной работе
- шаблоны - код-ревью чеклист, структура README, формат баг-репорта
Правило разделения: постоянное и короткое - в CLAUDE.md, редкое и объемное - в skills. Если сомневаетесь, считайте строки: инструкция длиннее 10 строк, которую вы используете раз в неделю, - это skill.
Sandbox: почему permission-промпты исчезают
Самая раздражающая часть работы с Claude Code - постоянные вопросы «разреши мне выполнить команду». Да. Да. Да. Каждое действие, каждое изменение файла. За один день я жал approve десятки раз.
Sandbox - не режим auto-approve. Это фильтр на уровне ОС, который ограничивает, что Claude физически может сделать, независимо от того, что он собрался. На macOS работает через Seatbelt, на Linux через bubblewrap, на WSL2 работает. WSL1 не поддерживается.
Идея простая: если у Claude нет возможности что-то сломать, незачем спрашивать разрешение на каждое действие в этой зоне. Настроенный sandbox снижает permission-промпты на 84% по данным Anthropic. Восемьдесят четыре процента. Четыре пятых бесконечных «разрешите» исчезают.
Настройка занимает минут десять. Сначала разрешите только то, что безопасно: чтение файлов, запись в рабочую директорию, запуск тестов. Сеть, доступ к системным путям, глобальные команды оставьте за фильтром. Claude будет работать свободно в разрешенной зоне и спрашивать только там, где это действительно важно.
Настройка Claude как ассистента, не только для кода
Все, что выше, - про Claude Code. Но Claude используют и как чат-ассистента для текстов, документов, анализа. Там настройка тоже есть, просто она менее явная.
В веб-интерфейсе Claude есть Projects - отдельные рабочие пространства с собственными инструкциями и файлами. Загружаете туда описание проекта, свои примеры текстов, методологию - и Claude в каждом диалоге внутри проекта работает с этим контекстом. По сути, Projects - тот же CLAUDE.md, только с кнопками.
Skills тоже есть в веб-версии. Логика та же: не грузить в каждый диалог контекст, а держать готовые наборы под конкретные задачи.
Проблема для российских пользователей - не в функциях, а в доступе. Claude требует зарубежной карты и VPN со стабильным зарубежным IP. Выход - 3GPT от 3SELLER: от 149₽ в месяц за доступ к свежим флагманским моделям - Chat GPT 6 Astra, Claude Fable 5, Claude Opus 5.5, Chat GPT 5.5, Nano Banana для изображений. Пополнение российской картой, через СБП или криптой. Это ИИ-роутер: один интерфейс, все модели на выбор - удобно, когда нужно сравнить ответы разных моделей, не переключаясь между сервисами.
Порядок настройки, который я бы выбрал
Не пытайтесь сделать все сразу. Вот последовательность, которая работает:
Начните с глобального ~/.claude/CLAUDE.md. Пять-десять строк: язык, стиль ответов, ключевые предпочтения. Проверьте, что правила работают в двух разных проектах.
Затем CLAUDE.md проекта. Пять-двадцать строк: стек, команды, соглашения. Скоммитите в Git - коллеги скажут спасибо.
Потом настройте sandbox. Пятнадцать минут работы - и минус 84% разрешений. Самое быстрое улучшение по соотношению «время на настройку - выигранный комфорт».
Skills оставьте на потом. Поймали себя на том, что повторяете одну и ту же инструкцию в разных сессиях, - переносите ее в skill. Снизу вверх, по необходимости.
Частые ошибки, которые я вижу
Первая - CLAUDE.md как документация вместо правил. Claude читает файл и не понимает, что из этого инструкция, а что фон. Нужен формат: «делай X», «не делай Y», «когда Z, используй W».
Вторая - дублирование. Одно и то же правило в глобальном и проектном файле. Если правило работает везде, оно должно быть в глобальном. В проектном - только то, что специфично для проекта.
Третья - слишком много skills при полном CLAUDE.md. Десять skills при коротком файле - нормально. Десять skills при CLAUDE.md на 300 строк - у модели уже не хватает контекстного внимания на все сразу. Сначала ужмите CLAUDE.md, потом добавляйте skills.
Четвертая - отсутствие проверки. Настройка считается завершенной, когда вы убедились, что Claude следует новым правилам. Спросите его: «какой у нас стек? что запрещено?» - и проверьте, что ответ берется из конфигурации, а не выдумывается.
Что это дает в цифрах
Настроенный Claude Code и Claude, в который просто вводят промпты, - два разных инструмента. По моим ощущениям, настройка экономит 20-40 минут в день. Считается легко: пять минут на переобъяснение контекста в каждой сессии, а сессий в день бывает пять-десять. Плюс несколько минут на однотипные approve вместо непрерывной работы. Плюс качество: Claude не забывает про обязательные тесты и не коммитит в main.
Инвестиция в настройку приносит сложный процент: один вечер работы - и каждая следующая сессия дешевле предыдущей.
Если вы не разработчик
Все описанное применимо к Claude Code, где есть файлы и терминал. Для текстов, аналитики и маркетинга достаточно веб-интерфейса: Projects, стандартизированные промпты, свои примеры. Загрузили описание бренда, тон общения и три удачных поста - и Claude пишет следующие в том же стиле. Это уже половина настройки.
Для доступа без VPN и зарубежных карт - 3GPT с пополнением российской картой или через СБП. Модель можно менять прямо в чате, не уезжая с одного сервиса в другой.
Отдельная фишка 3GPT - готовые ИИ-агенты под конкретные задачи. Выбираете нужного агента и сразу начинаете с ним общение, модель агента меняется прямо в чате. Вариант для тех, кто пока не готов писать конфиги и навыки сам: https://3seller.com/ai/agents
С чего начать прямо сегодня
Откройте терминал, создайте ~/.claude/CLAUDE.md и напишите там пять строк. Любые. «Отвечай на русском». «Не используй эмодзи в коде». «Проверяй, что тесты проходят перед коммитом». Все. Больше не нужно.
Затем подключите доступ: 3GPT от 3SELLER - от 149₽ в месяц, российская карта, СБП или крипта. Chat GPT 6, Claude Fable 5, Nano Banana для изображений и генерация видео - в одном интерфейсе.
Настроенный Claude окупится за первую же неделю. Четыре файла, пятнадцать строк в каждом, один вечер - и вместо того, чтобы каждый раз объяснять Claude, кто вы и как работаете, вы просто даете задачи. Остальное он знает.