Тюнинг начинается не с настроек

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

В benuame этот вывод появился не из теории. Рядом живут несколько самостоятельных проектов: платформа, сайты и видеопроизводство. У каждого свой репозиторий, свои правила и свои опасные действия. Общий файл объясняет границы контейнера, проектный — устройство конкретного продукта, а проверки ловят расхождение между словами и файлами. Такая система позволяет продолжить работу в новом чате без пересказа всей истории.

Что именно мы настраиваем

У рабочего контура пять слоёв:

Правила. Где агент находится, что здесь считается источником правды, какие действия запрещены и когда нужен человек.
Повторяемые операции. Команды, skills и hooks убирают импровизацию там, где маршрут уже известен.
Инструменты. MCP даёт доступ к браузеру, базе, трекеру или другой программе, но не отменяет права и проверки.
Оркестрация. План и параллельные агенты ускоряют независимые части задачи, если заранее разведены файлы и ответственность.
Доказательство. Тест, статическая проверка, визуальный осмотр и отрицательный контроль отвечают не на вопрос «агент доволен?», а на вопрос «требование выполнено?».

Слои идут именно в таком порядке. Подключать десять серверов к проекту без правил доступа — значит увеличить число способов ошибиться. Запускать пять агентов без разделения файлов — значит получить пять быстрых конфликтов.

Признаки плохого тюнинга

Один огромный файл правил пересказывает весь проект и устаревает после каждой правки.
Одинаковая инструкция скопирована в три папки, но исправлена только в одной.
Слово «никогда» есть, а теста запрещённого сценария нет.
Инструменту выданы все права «чтобы не спрашивал».
Команда смешивает исследование, правки, публикацию и оплату в одном запуске.
Агенты работают параллельно над общим файлом и узнают о конфликте в конце.
Отчёт «готово» считается доказательством без просмотра diff и запуска проверок.

Что получится к концу

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

Материал не требует конкретного фреймворка. Примеры подходят сайту, текстовому проекту, автоматизации или медиаконвейеру. Но нужен уже созданный локальный проект и базовый навык работы с Claude Code. Установку, Git с нуля и первый запрос разбирает предыдущий курс.

Снимок текущей среды

Перед тюнингом проверьте фактическую версию клиента, доступные модели, выбранный режим рассуждения и условия своего тарифа. Не переносите названия и лимиты из чужого скриншота: они меняются быстрее архитектуры проекта. Модель отвечает за способность решить задачу, а уровень усилия — за объём вычислений; максимальный режим на каждой мелочи расходует лимит без обязательного выигрыша.

Разделяйте подписку для интерактивной работы и API-доступ для программных запусков. Одно не всегда является заменой другому, а стоимость автоматизации зависит от числа вызовов. В учебном контуре мы не включаем фоновый расход и не используем боевой ключ.

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

Граница курса

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

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

Первичный аудит

До настройки зафиксируйте исходное состояние. Возьмите реальную небольшую задачу, которую делали на прошлой неделе, и ответьте:

сколько раз пришлось повторно объяснить устройство проекта;
сколько файлов агент открыл до первой полезной правки;
какой рискованный шаг он предложил без предупреждения;
какая проверка подтвердила результат;
что пришлось восстанавливать из разговора после нового чата.

Это нулевая точка. В конце сравним не впечатление, а число повторных объяснений, лишних чтений и непойманных ошибок.

Практика

Создайте в проекте заметку tuning-audit.md.
Запишите одну настоящую задачу, на которой будете проверять курс. Она должна менять не больше трёх файлов и иметь наблюдаемый результат.
Опишите текущее состояние по пяти вопросам первичного аудита.
Разделите желаемые улучшения на пять слоёв: правила, операции, инструменты, оркестрация, доказательство.
Отметьте красным действия, которые нельзя выполнять в учебном проекте: публикацию, расход денег, удаление единственной копии, работу с боевыми секретами.
Запишите версию клиента и способ самостоятельно посмотреть доступные модели и лимиты, не копируя устаревающие цифры в канон.

Проверка

В заметке названа одна конкретная задача, а не «настроить Claude получше».
У результата есть наблюдаемый признак: страница открывается, тест проходит или файл имеет заданную структуру.
Зафиксированы исходные числа либо честное «не измерялось»; придуманных данных нет.
Каждое улучшение отнесено к одному из пяти слоёв.
Опасные внешние действия исключены из учебного прогона до начала работы.
Интерактивная подписка, API-доступ и удалённое управление не смешаны в одно разрешение.

Что дальше

Начнём с двух файлов, которые часто смешивают: CLAUDE.md и AGENTS.md. У них разные читатели и одна задача — дать агенту ровно тот контекст, который меняет его решения.