Репозиторий с 56k звезд — это вам не хайповый стартап
В июне 2026 года репозиторий с лучшими практиками Claude Code перевалил за 56 тысяч звезд. И знаете что? Восемьдесят процентов советов там — макулатура. «Используйте agentic search», «включайте plan mode» — звучит красиво, но без понимания подкапотной механики вы просто сольете деньги на токены и получите код, который придется переписывать.
Я перелопатил этот репозиторий, добавил свой опыт (четыре продакшн-проекта на Claude Code 2.0, включая полный гайд по настройке) и отсеял зерна от плевел. Дальше — только то, что реально работает и не разорит вас.
Agentic Search: почему grep бьет vector поиск в морду
В репозитории модно писать про «semantic search» и «embedding-based retrieval». Слушайте, я сам фанат векторных баз, но для Claude Code в 90% случаев grep с контекстным окном сделает работу быстрее и дешевле. Почему?
Claude Code использует контекст 200k токенов. Когда вы отправляете запрос с vector search, модель тратит кучу токенов на переваривание релевантных чанков, которые могут быть не в тему. Grep же выдает точные строки — и Claude Code 2.0 мгновенно понимает, что к чему, без лишних затрат.
Правило из репозитория: «Если ты не знаешь, что ищешь — используй vector. Если знаешь хотя бы приблизительно — используй grep». Я добавляю: grep экономнее в 5-10 раз по токенам.
1 Когда включать agentic search?
Агентный поиск (agentic search) — это когда Claude Code сам решает, куда смотреть, а не просто возвращает чанки. Включите его только для задач, где кодовая база незнакома: например, вы зашли в чужой проект и хотите пофиксить баг. Вот как настроить:
# В .claude.yml (актуально для Claude Code 2.0)
agentic_search: true
search_strategy: "hybrid" # grep + vector
max_tokens_for_search: 4000 # не давайте жрать все 200kОшибка новичка: ставят agentic_search:true на каждый чих. В итоге Claude Code начинает лазить по всем файлам проекта в поисках «вдохновения», генерируя 50 тысяч токенов контекста для элементарного фикса. Результат — счет за час работы: $12 вместо $0.50 (подробнее в статье как избежать неожиданных счетов).
На практике я держу agentic search выключенным для своих проектов, где знаю структуру. Включаю только когда нужно разобраться в новом репозитории или при код-ревью.
Plan Mode: головная боль или спасение?
В репозитории пишут: «Always use plan mode before coding». И да, это работает, если правильно задать температуру модели и системный промпт. Но по умолчанию plan mode в Claude Code 2.0 иногда строит такие архитектурные схемы, что хочется плакать. Особенно когда модель начинает «планировать» написание тудушника с микросервисами для обычного калькулятора.
| Режим | Когда использовать | Расход токенов (средний) |
|---|---|---|
| Direct (без плана) | RC-фиксы, мелкие правки | 500-1500 |
| Plan mode (один план) | Новая фича, средний рефакторинг | 3000-8000 |
| Agentic search + Plan mode | Чужая кодовая база, архитектурное решение | 15000-40000 |
Лучшая практика из репозитория: всегда передавайте Claude Code свои граничные условия в плане. Например, если вы пишете функцию для обработки платежей, скажите: «Не используй сторонние API, только встроенную библиотеку stripe. Обрабатывай ошибки через retry с backoff». Без этого план будет generic-решением, которое не учитывает ваши constraints.
Кстати, есть забавный хак: если вы повторите промпт три раза — точность плана взлетает на 350%. Я проверял: действительно, Claude Code в plan mode лучше удерживает требования, если они повторены несколько раз.
Управление контекстом: 200k токенов — это ловушка
Главный миф: «Больше контекста = лучше ответ». Нет. В репозитории с 56k звезд есть issue, где парень скормил Claude Code весь проект (120k токенов) и попросил пофиксить баг. Модель начала «галлюцинировать» — придумывать несуществующие зависимости, потому что утонула в шуме.
Что работает: держать в контексте только то, что напрямую относится к задаче. Используйте .claudeignore:
# .claudeignore — пример для микросервиса
# Игнорируем все, кроме папки payment и общей конфигурации
*
!payment/**
!*.yml
!config/**Еще один совет из репозитория: используйте декларативные промпты. Вместо «напиши код для этого» — «опиши, какие файлы нужно создать, какие функции экспортировать, какие тесты написать». Это резко снижает количество итераций и трату токенов.
--context-limit=4000 (через CLI) или в интерфейсе выберите лимит токенов для контекста. Так Claude Code не будет тащить лишнего из истории диалога.
А если вы работаете с opensource-моделями, заморочьтесь с системным промптом — вот инструкция, как заставить Llama говорить как Claude. Это может сэкономить вам кучу денег, если вы используете кастомные модели.
MCP и кастомные скиллы: нашпигуйте Claude Code инструментами
Model Context Protocol (MCP) — это, пожалуй, единственная фича, ради которой стоит обновляться до Claude Code 2.0. MCP позволяет подключать внешние сервисы: базы данных, API, файловые системы — прямо в контекст модели. Репозиторий кишит примерами интеграций, но я отобрал те, что реально пригождаются в продакшне:
- PostgreSQL MCP — Claude Code сам ходит в базу, делает EXPLAIN ANALYZE, находит узкие места.
- Git MCP — модель видит историю коммитов, diff, blame. Очень помогает при рефакторинге.
- Slack MCP — пишет нотификации о завершении задач. Бесполезно, но забавно.
Кстати, в репозитории есть раздел про 5 скиллов из маркетплейса, которые реально ускоряют разработку. Один из них — автоматический генератор миграций БД. Советую.
Как НЕ надо делать: типичные грабли
Грабли 1. Доверять Claude Code выбор модели. По умолчанию он использует самую мощную (Claude Opus 4.6), но для 80% задач хватит Claude Sonnet 4.0. Если вы гонитесь за дешевизной — вот гайд как сэкономить 54× с DeepSeek V4. Но будьте аккуратны: дешевые модели иногда «срезают углы».
Грабли 2. Игнорировать метрики. Научный эксперимент (о нем здесь) показал, что Claude Code без контроля качества генерирует на 30% больше багов, чем ручная разработка. Всегда запускайте линтеры и тесты после каждого сеанса кодинга.
Грабли 3. Не использовать plan mode в сложных задачах. Я как-то попросил Claude Code «рефакторить авторизацию» без плана — он переписал половину проекта, сломал все. Пришлось откатывать. Анализ кода с Claude Opus показывает, что без предварительного анализа метрик результат плачевен.
Реальная история из репозитория: Разработчик потратил $6000 за месяц, потому что не настроил лимиты на квоту токенов. Он думал, что «agentic search + plan mode» — это магическая пилюля, а оказалось, что модель просто перебирала все возможные варианты решения. Детали в статье как избежать счета в $6000.
Неочевидный совет, который вы нигде не найдете
Большинство гайдов учат, что делать, но не учат чего не делать. Мой личный хак из 56k-репозитория: напишите в системном промпте запрещенные действия. Например:
# .claude/system_prompt.txt
ТЫ НЕ ИМЕЕШЬ ПРАВА:
- Добавлять новые зависимости без моего разрешения
- Рефакторить функции, которые я не указал
- Использовать async/await, если в проекте синхронный код
- Генерировать больше 200 строк кода за один запросЭтот подход резко снижает «галлюцинации» и спасает от неожиданных счетов. Проверено на себе.
И последнее: не верьте слепо репозиториям с кучей звезд. Половина практик там — пересказ документации. Берите только то, что применимо к вашему проекту. И всегда, всегда проверяйте выход модели — даже самый умный Claude Code 2.0 может выдать чушь, как это случилось с 40-миллиардной моделью, ставшей цифровой пылью.
Вбивайте в Claude Code четкие границы, не давайте ему слишком много контекста и помните: AI — это инструмент, а не замена инженеру. Ну, вы и сами знаете.
