Как выжать максимум из Claude Code — разбираем конфиги чемпионов хакатона Anthropic

Недавно Anthropic выпустила Claude Code — CLI-инструмент, который обещает превратить терминал в полноценного напарника. Но, как это часто бывает с новыми инструментами, «из коробки» он умеет далеко не всё. Чтобы заставить его работать на реальных проектах, приходится долго возиться с настройками. Репозиторий claude-init — это попытка собрать в одном месте лучшие практики и готовые шаблоны, включая те, что принесли победу команде на официальном хакатоне Anthropic.

Зачем это нужно, если есть официальная документация

Официальный Claude Code обновляется чуть ли не каждый день. В такой спешке документация часто не поспевает за фичами, а примеры остаются слишком абстрактными. Автор проекта claude-init пошел по пути кураторства: он взял наработки победителей хакатона Anthropic x Forum Ventures и адаптировал их под повседневные задачи.

Главная ценность здесь не в самом коде (проект написан на Shell), а в структуре папки .claude. Это готовый набор «мозгов» для AI-агента, который понимает, когда нужно писать тесты, а когда — чистить мертвый код.

Что внутри: агенты, скиллы и правила

Проект предлагает переехать с обычных промптов на модульную систему. Вместо того чтобы каждый раз объяснять Claude, как вы пишете код, вы подсовываете ему готовые роли.

Специализированные агенты

В папке templates/.claude/agents/ лежат конфиги для девяти разных ролей. Например:

planner.md — не дает Claude сразу бросаться писать код. Он заставляет его сначала составить план и разбить задачу на этапы.
tdd-guide.md — превращает AI в строгого ментора, который следит за циклом «красный-зеленый-рефакторинг».
refactor-cleaner.md — заточен на поиск и удаление неиспользуемого кода и технического долга.

Команды для ленивых

Вместо длинных объяснений в терминале появляются короткие слеш-команды. Ввел /code-review — и агент начинает проверять качество и безопасность. Команда /build-fix пытается сама разобраться с логами ошибок компиляции и поправить их. Это экономит кучу времени на копипасте ошибок из терминала в чат.

Правила игры

Самое полезное, на мой взгляд — это rules. В файле security.md прописаны запреты на хардкод ключей, а в testing.md — требование держать покрытие тестами не ниже 80%. Когда эти правила лежат в корне проекта, Claude Code учитывает их при каждом действии, не дожидаясь, пока вы его об этом попросите.

Ловушка контекстного окна

Интересный момент, о котором автор предупреждает в README: не стоит включать всё и сразу. Если подключить слишком много MCP-серверов (Model Context Protocol) и инструментов, контекстное окно в 200k токенов может внезапно «схлопнуться» до 70k.

Автор вывел эмпирическое правило:

Держите в конфиге хоть 30 серверов.
Но для конкретного проекта включайте не больше 10.
Активных инструментов должно быть до 80 штук.

Это дельный совет. Я сам сталкивался с тем, что перегруженный контекст заставляет модель «тупить» и забывать начало диалога.

Как это попробовать

Проект ориентирован на macOS и Linux. Пользователям Windows не повезло — автор честно признается, что у него нет подходящего окружения для тестов.

Если вы уже используете Claude Code, можно просто подсмотреть интересные конфиги:

git clone https://github.com/cfrs2005/claude-init.git
ls templates/.claude/agents/

Или скопировать нужного агента к себе:

cp templates/.claude/agents/planner.md ~/.claude/agents/

Стоит ли оно того

Проект claude-init сейчас находится в статусе «архивного для обучения». Это значит, что слепо копировать всё подряд не стоит — Claude Code меняется слишком быстро. Но как справочник по тому, как структурировать работу с AI-агентами, это отличная находка.

Особенно рекомендую заглянуть в папку examples. Там лежат примеры структур для Python и Node.js проектов, которые уже «причесаны» под работу с нейронками. Если вы чувствуете, что тратите слишком много времени на объяснение очевидных вещей своему AI-помощнику, эти шаблоны могут стать хорошим фундаментом для ваших собственных правил.

В конечном счете, ценность не в том, чтобы сделать Claude «китайским» или «русским», а в том, чтобы сделать его предсказуемым. И наборы правил из этого репозитория справляются с этой задачей лучше, чем стандартные настройки.