Большинство людей открывают Claude Code, пишут задачу — и получают код. Потом закрывают. На следующий день открывают снова, объясняют всё с нуля, получают результат в другом стиле, без тестов, с устаревшим API. И так каждый раз.
Проблема не в Claude. Проблема в том, что без настройки Claude Code работает на 20–30% своих возможностей. Это как купить профессиональную камеру и снимать в полностью автоматическом режиме.
В этом руководстве — девять инструментов, которые превращают Claude Code из умного чата в полноценную среду разработки. Все бесплатные (кроме одного опционального). Полная установка — 20–30 минут.
Прежде чем начать: что нужно знать
Прежде чем разбирать инструменты, объясним два понятия, которые встретятся часто.
MCP (Model Context Protocol) — это способ подключить к Claude Code внешние инструменты. Представьте это как плагины для браузера: браузер работает без них, но с ними — совершенно другой опыт. MCP-сервер запускается локально на вашем компьютере и даёт Claude новые возможности: искать в интернете, читать документацию, управлять памятью.
Хук (hook) — это правило, которое срабатывает автоматически при определённом событии. Например: «перед каждым сохранением файла — проверить, есть ли тест». Хуки нельзя обойти, они работают на уровне системы, не на уровне просьбы.
Обзор: девять инструментов и что они закрывают
| # | Инструмент | Проблема без него |
|---|---|---|
| 1 | claude-code-setup | Не знаешь, с чего начать настройку |
| 2 | CLAUDE.md + Karpathy Skills | Claude каждый раз пишет по-разному |
| 3 | AgentMemory / claude-mem | Всё объяснённое вчера — забыто сегодня |
| 4 | GitHub CLI | Дорогой и ненадёжный GitHub MCP |
| 5 | Context7 / Deepcon | Claude выдумывает несуществующие API |
| 6 | Sequential Thinking | Не понятно, почему Claude принял неверное решение |
| 7 | TDD Guard | Код пишется без тестов и ломается в продакшне |
| 8 | ccusage | Токены кончаются непредсказуемо |
| 9 | tech-debt-skill | Технический долг копится незаметно |
Инструмент 1: claude-code-setup — начните с анализа
Что это и зачем
Это официальный плагин от команды Anthropic. Он делает одну вещь: сканирует ваш проект и говорит, что можно улучшить. Смотрит на структуру папок, зависимости (package.json, requirements.txt), конфигурационные файлы — и выдаёт конкретные рекомендации: какие хуки поставить, какие скиллы подключить, нужны ли MCP-серверы или субагенты.
Работает в режиме read-only — ничего не меняет, только анализирует. Вы сами решаете, что из рекомендаций применять.
Как установить и запустить
# Шаг 1: установка (один раз)
npm install -g @anthropic-ai/claude-code-setup
# Шаг 2: запуск в папке вашего проекта
cd ваш-проект
claude-code-setupЧерез 10–30 секунд получаете отчёт с конкретными рекомендациями.
Плюсы и минусы
Плюсы:
- Официальный от Anthropic — ничего не сломает
- Помогает понять, что настраивать в первую очередь, если опыта нет
- Быстрый: 10–30 секунд на любой проект
Минусы:
- Только рекомендации, сам ничего не настраивает
- На простых проектах советы бывают банальными
- На сложных проектах — полезнее
Правило: первое, что делаете в любом новом проекте — запускаете
claude-code-setup. Он покажет, с чего начать.
Инструмент 2: CLAUDE.md + Karpathy Skills — конституция проекта
Почему Claude «забывает» ваши правила
Представьте, что вы наняли подрядчика. Каждый раз, когда он приходит, вы объясняете: «У нас TypeScript, тесты обязательны, не трогай базу данных напрямую, используй репозитории». Он кивает, делает работу. Завтра приходит снова — и снова ничего не помнит.
Именно так работает Claude Code без CLAUDE.md. Каждая сессия — чистый лист.
Что такое CLAUDE.md
CLAUDE.md — это файл в корне вашего проекта. Claude автоматически читает его при каждой сессии, без исключений. Это ваши правила, ваша «конституция проекта».
Пример того, что туда пишут:
- Стек технологий (React + TypeScript + PostgreSQL)
- Стиль кода (ESLint конфиг, соглашения по именованию)
- Правила архитектуры (что можно трогать, что нельзя)
- Обязательные требования (тесты, типизация, логирование)
- Как деплоить и тестировать
С таким файлом Claude читает архитектуру, знает про баги, знает что тесты обязательны — и пишет код по правилам с первого раза. Без файла: спрашивает какой фреймворк, пишет без типов, забывает про тесты, и вам три раза переделывать.
Как создать CLAUDE.md с нуля
Если файла ещё нет — откройте Claude Code и введите команду:
/init
Claude задаст вам вопросы:
- Какой стек у проекта?
- Как тестировать?
- Как деплоить?
- Какие правила важны?
Если не знаете ответов — просто опишите проект и попросите Claude порекомендовать. Через несколько минут получите готовый CLAUDE.md.
Принципы Андрея Карпати
Андрей Карпати — бывший директор AI в Tesla, один из основателей OpenAI. Он опубликовал свой файл с принципами кодирования для Claude — Karpathy Skills. На GitHub уже 77 000+ звёзд. Это не плагин и не фреймворк — просто файл с четырьмя правилами, которые резко повышают качество кода.
| Принцип | Что значит на практике |
|---|---|
| Think Before Coding | Перед написанием кода — проговори вслух допущения. Что делаешь, почему именно так, какие альтернативы рассматривал |
| Simplicity First | Не добавляй то, что не просили. Не создавай универсальный фреймворк там, где нужна одна функция |
| Surgical Changes | Минимальные правки. Попросили поменять одну строку — меняй одну строку, не рефактори весь файл |
| Goal-Driven | Не «сделай хорошо», а конкретный критерий: «endpoint возвращает 200», «тест проходит», «нет регрессии» |
Как добавить принципы Карпати в существующий CLAUDE.md
Важно: не копируйте поверх существующего файла — потеряете свои настройки. Вместо этого скажите Claude прямо в терминале:
Скачай CLAUDE.md с GitHub по ссылке:
https://github.com/karpathy/karpathy-skills
Изучи наш текущий CLAUDE.md.
Добавь в него те правила из скачанного файла,
которые будут полезны именно нашему проекту.
Добавляй как дополнение к нашим текущим правилам.
Не удаляй и не меняй то, что уже есть.
Claude прочитает оба файла, поймёт что у вас уже настроено, и встроит принципы Карпати без конфликтов — меньше чем за минуту.
Практический совет по размеру файла
Золотая середина: 100–200 строк. Не пишите CLAUDE.md на 500 строк — Claude запутается. Самое важное — в первых строках. Детали — ссылками на другие файлы.
В длинных сессиях (100+ сообщений) Claude может «забыть» правила из-за перегрузки контекста. В этом случае используйте:
/clear— очищает контекст и начинает сессию заново с чтения CLAUDE.mdcompact— сжимает историю, сохраняя ключевой контекст
Инструмент 3: AgentMemory / claude-mem — память между сессиями
Проблема, которую не решает CLAUDE.md
CLAUDE.md хранит правила. Но не хранит контекст работы:
- Что вы делали вчера
- Какие решения приняли и почему
- Какие баги нашли и как починили
- Что пробовали и что не сработало
Работаете несколько часов, настраиваете, объясняете архитектуру, разбираете баги. Закрываете. Открываете завтра — Claude ничего не помнит. Снова с нуля.
AgentMemory решает именно эту проблему — постоянная память между сессиями.
Как работает AgentMemory: четыре уровня
AgentMemory хранит не просто «что-то произошло», а структурированные воспоминания четырёх типов:
| Уровень | Что хранит | Пример |
|---|---|---|
| Рабочая память | Текущий контекст | Сейчас работаем над модулем авторизации |
| Эпизодическая | События прошлых сессий | Вчера работал над Авито-интеграцией, нашёл баг в конфигурации Redis |
| Семантическая | Знание о проекте | Проект использует FastAPI + PostgreSQL 16, деплой через Docker |
| Процедурная | Как делать вещи | Для деплоя: docker compose build → push → ssh на сервер |
Как Claude ищет нужное воспоминание: три алгоритма одновременно:
- BM25 — поиск по точным словам (как Ctrl+F)
- Векторный поиск — поиск по смыслу (находит похожее, даже если слова другие)
- Граф знаний — поиск по связям (если A связан с B, а вы спросили про A — B тоже найдётся)
Точность: 95,2% из 5 результатов — то есть почти каждый запрос попадает в точку.
Всё работает локально, SQLite, никуда не отправляет данные.
Установка AgentMemory
# Установка
npm install -g agent-memory-mcp
# Добавление как MCP-сервер в Claude Code
# (команда появится после установки в README)AgentMemory или claude-mem — что выбрать?
На рынке много инструментов памяти. Два самых популярных:
| AgentMemory | claude-mem | |
|---|---|---|
| Звёзд на GitHub | 21 000 | 68 900 |
| Уровней памяти | 4 (все типы) | меньше |
| Алгоритм поиска | BM25 + вектор + граф | вектор |
| Точность | 95,2% | ниже |
| Зависимостей | Ноль | есть |
| Кроссагентность | Да (через MCP) | ограничена |
| Сообщество | Молодое | большое, много гайдов |
Если вы новичок и хотите проверенный инструмент с большим сообществом — берите claude-mem. Гайдов много, проверен на тысячах проектов.
Если работаете с несколькими AI-агентами или хотите максимальную точность — AgentMemory технически сильнее.
Инструменты 4–5: GitHub CLI + актуальная документация
Эти два инструмента идут в паре, потому что оба решают проблему «Claude не знает актуальное состояние».
GitHub CLI: не ставьте GitHub MCP
Первый вопрос, который возникает: «Но ведь есть GitHub MCP — зачем что-то ещё?»
Вот конкретные цифры:
| GitHub CLI | GitHub MCP | |
|---|---|---|
| Стоимость (10 000 операций) | $3,20 | $55,20 |
| Разница в цене | — | в 17 раз дороже |
| Надёжность | 100% | 72% (падает при нагрузке серверов) |
| Токены контекста | 0 | 28 000 (съедает ваше окно) |
| Количество инструментов | встроено нативно | 43 отдельных |
GitHub CLI уже встроен в Claude Code нативно — у Claude есть gh pr view, gh issue create и другие команды из коробки. Вам нужно только одно: подключить свой GitHub-аккаунт.
# Если gh ещё не установлен:
# macOS: brew install gh
# Windows: winget install GitHub.cli
# Авторизация (один раз)
gh auth loginПосле этого Claude Code умеет работать с GitHub без MCP — дешевле, надёжнее, без лишних токенов.
GitHub MCP оправдан только для enterprise-команд с кастомными GitHub Actions workflow. Для всех остальных — GitHub CLI.
Context7 и Deepcon: Claude не знает новых API
Любая языковая модель обучена до определённой даты. Это значит, что Claude может:
- Не знать о методах, которые появились в новой версии библиотеки
- Использовать устаревшие API, которые уже задеприкейчены
- Уверенно выдумывать несуществующие функции («галлюцинации»)
Context7 и Deepcon решают это через MCP: подтягивают актуальную документацию прямо в контекст Claude перед ответом.
| Context7 | Deepcon | |
|---|---|---|
| Цена | Бесплатно (1 000 запросов/мес) | Платный (есть пробный период) |
| Точность документации | ~65% | ~90% |
| Расход токенов | стандартный | в 2 раза меньше |
| Для кого | для старта, всем | если упираетесь в точность |
# Context7 — обязателен, ставим сразу
claude mcp add context7
# Deepcon — когда нужна точность и экономия токенов
# 1. Зайдите на deepcon.ai, получите API-ключ
# 2. Установите:
claude mcp add deepcon --api-key ВАШ_КЛЮЧПрактический порядок: начните с Context7 (бесплатно). Когда почувствуете, что треть ответов по документации неточная — переходите на Deepcon.
Инструмент 6: Sequential Thinking — видимые рассуждения
В чём проблема «думающего» Claude
Claude умеет думать — у него есть встроенный режим Extended Thinking. Но процесс скрыт: вы видите только финальный ответ. Если ответ неверный или решение кажется странным — непонятно, где именно логика сломалась, что Claude принял во внимание, а что проигнорировал.
Sequential Thinking MCP (официальный инструмент от Anthropic) делает мышление видимым:
- Claude разбивает задачу на конкретные шаги
- Вы видите каждый шаг в реальном времени
- Он может вернуться назад и пересмотреть предыдущее решение
- Может разветвиться на два варианта и сравнить их
- Вы можете вмешаться в любой момент: «этот вариант не подходит, потому что…» — и Claude пересмотрит
Установка
claude mcp add sequential-thinkingВсё. Один раз — и доступно в каждой сессии.
Когда использовать, а когда нет
Используйте для:
- Выбора архитектуры: «Redis или PostgreSQL для хранения сессий — что выбрать?»
- Сравнения вариантов: «Есть три способа интегрировать CRM — какой лучше для нашего случая?»
- Сложного дебага: «Почему эндпоинт работает локально, но падает на сервере?»
- Любой задачи, где несколько путей и неочевидный выбор
Не используйте для:
- Простых задач: «добавь console.log», «переименуй переменную»
- Быстрого прототипирования — слишком медленно
- Рутинного кодирования — съедает лишние токены
Разница: Extended Thinking думает про себя → выдаёт ответ. Sequential Thinking думает вслух → вы контролируете процесс. Оба можно включить одновременно — они не конфликтуют.
Инструмент 7: TDD Guard — тесты до кода, без исключений
Почему Claude Code пишет ненадёжный код
Вот типичный сценарий. Вы просите Claude добавить новый эндпоинт. Claude за 30 секунд пишет аккуратный, рабочий код. Вы деплоите. Через неделю рефакторите что-то рядом — и эндпоинт ломается. Вы узнаёте об этом от пользователей.
Почему? Потому что не было тестов. Claude не написал их сам (зачем, если не попросили?), вы не напомнили. И теперь нет способа автоматически проверить, что всё ещё работает.
Что такое TDD Guard
TDD Guard — это не советник. Это хук, который физически блокирует запись кода, если нет падающего теста.
Не «рекомендую написать тест». А «не дам сохранить файл, пока тест не упадёт».
Обойти нельзя. Только отключить.
Три жёстких правила TDD Guard
-
Нельзя писать реализацию без падающего теста. Хочешь новый эндпоинт? Сначала тест. Тест должен упасть (потому что кода ещё нет). Только потом — пиши код.
-
Реализация не должна превышать требования теста. Написал тест на один кейс — пиши код только для этого кейса. Не надо заранее обрабатывать десять ситуаций, которые никто не просил.
-
Один тест — один цикл. Нельзя добавить сразу пять тестов и потом писать под них код. Один тест → минимальная реализация → рефакторинг → следующий тест.
Поддерживаемые языки: JavaScript, TypeScript, Python, PHP, Go, Rust.
Установка
# Установка
npm install -g tdd-guard
# Интеграция с Claude Code (добавляет хуки)
tdd-guard installКак это выглядит в реальной работе
Без TDD Guard:
Вы: "Добавь endpoint POST /companies"
Claude: (через 30 секунд) Вот код endpoint'а, всё готово!
[нет ни одного теста]
[через неделю ломается после рефакторинга]
С TDD Guard:
Вы: "Добавь endpoint POST /companies"
Claude: Начинаю писать...
TDD Guard: ⛔ Стоп. Нет падающего теста. Сначала тест.
Claude: Пишу тест test_create_company...
[тест падает — endpoint не существует]
TDD Guard: ✅ Тест падает. Теперь можно писать код.
Claude: Пишет минимальную реализацию...
[тест проходит]
Claude: Рефакторинг...
[тест всё ещё проходит]
✅ Цикл завершён.
Да, это медленнее. Зато код не ломается через неделю.
Альтернатива для тех, кому жёстко
Если TDD Guard кажется слишком строгим — есть Superpowers TDD Skill. Он работает в режиме advisory: рекомендует написать тест, но не блокирует. Мягче, но Claude может проигнорировать рекомендацию.
Совет: для прототипов и экспериментов — отключайте TDD Guard (
tdd-guard disable). Для продакшн-проектов, где цена ошибки высокая — оставляйте включённым.
Инструмент 8: ccusage — контроль расхода токенов
Почему токены заканчиваются непредсказуемо
Claude Code потребляет токены активно. Claude Opus 4 — ещё больше (Anthropic официально подтвердил, что это самая «прожорливая» модель). Если вы работаете в автономном режиме без команды /clear — длинная сессия легко съедает миллион токенов к обеду.
Проблема: вы не знаете, сколько уходит и на что. Какие задачи самые дорогие? В какой момент контекст начинает раздуваться? Без инструмента — только догадки.
Что делает ccusage
ccusage — CLI-инструмент для анализа расходов токенов. Читает локальные логи Claude Code и строит отчёты.
# Установка
npm install -g ccusage
# Отчёт за сегодня
ccusage --daily
# Отчёт за неделю
ccusage --weekly
# Отчёт за месяц
ccusage --monthly
# Экспорт в JSON (для своей аналитики)
ccusage --export json > report.jsonЧто показывает:
- Сколько токенов потрачено за день/неделю/месяц
- Сколько пришло из кэша (кэшированные токены дешевле)
- Какие сессии самые дорогие
MCP-интеграция: можно подключить как MCP-сервер и спрашивать прямо во время работы:
"Сколько токенов я потратил за эту неделю?"
"Сколько осталось до лимита?"
Ключевая привычка для экономии
Команда /clear — ваш главный инструмент экономии.
Как работает: когда контекст вырастает — Claude тратит больше токенов на каждый запрос (читает всю историю снова). /clear обнуляет контекст. При следующем запросе Claude снова прочитает CLAUDE.md и начнёт с чистого листа.
Правило: используйте /clear после каждой логической задачи. Не после каждого сообщения — после каждой завершённой задачи. Новая задача = новый контекст.
Альтернативы ccusage
- Claude Code Usage Monitor — показывает расход в реальном времени + ML-предсказание будущих расходов
- Claude Usage Dashboard — визуальный дашборд в браузере, если не любите терминал
Минимальный вариант: запускайте
ccusage --weeklyраз в неделю. 5 секунд — и понимаете, куда уходили токены. Это первый шаг к осознанной экономии.
Инструмент 9: tech-debt-skill — аудит технического долга
Что такое технический долг и почему он копится незаметно
Технический долг — это всё то, что «сделаем потом»:
- Код, написанный быстро, а не правильно
- Тесты, которые забыли написать
- Зависимости, которые не обновляли
- SQL-запросы, которые работают, но уязвимы к инъекциям
- Захардкоженные ключи API в коде
Большую часть этого вы не знаете — просто не видите. Или знали, но забыли.
Что делает tech-debt-skill
Это скилл (встроенный инструмент) Claude Code, который делает полный аудит проекта по 9 измерениям. Каждая найденная проблема — конкретный файл и строка. Не «есть проблемы с безопасностью», а «файл auth.py, строка 47, SQL-запрос без параметризации — уязвим к SQL-инъекции».
9 измерений аудита
| # | Категория | Что ищет |
|---|---|---|
| 1 | Архитектура | Нарушение паттернов, циклические зависимости между модулями |
| 2 | Типобезопасность | any в TypeScript, отсутствие Type Hints в Python |
| 3 | Покрытие тестами | Какие модули не покрыты, что нужно добавить |
| 4 | Зависимости | Устаревшие версии, пакеты с известными уязвимостями |
| 5 | Безопасность | SQL-инъекции, отсутствие rate limiting, незащищённые эндпоинты |
| 6 | Дублирование | Повторяющийся код, который стоит вынести в общие функции |
| 7 | Мёртвый код | Функции и классы, которые никто не вызывает |
| 8 | Конфигурация | Захардкоженные ключи, неправильный формат .env файлов |
| 9 | Документация | Отсутствующие доки, устаревшие README |
Как запустить
/tech-debt-audit
Одна команда. Время первого запуска: 5–20 минут в зависимости от размера проекта.
Что делать с результатами
После аудита вы получаете список: файл → строка → описание проблемы → рекомендация. Открываете файл, читаете строку, чините.
Можно передать список Claude: «Исправь все проблемы безопасности из аудита, начиная с критических». Он сделает по одной, с тестом на каждое изменение.
Ограничения
- Первый запуск медленный: 5–20 минут
- На проектах больше 100 000 строк может пропустить часть проблем
- Нет интеграции с CI/CD — только ручной запуск
- Тратит заметное количество токенов на больших кодовых базах
Когда запускать: раз в месяц или перед каждым крупным релизом. 15 минут — и вы знаете, что реально болит в проекте. Гораздо лучше узнать от инструмента, чем от пользователей, которые просто уйдут и ничего не скажут.
Как всё работает вместе
Представьте типичный рабочий день с настроенным стеком:
Утро. Открываете Claude Code.
→ CLAUDE.md прочитан автоматически — Claude знает ваш стек и правила
→ AgentMemory загрузила вчерашний контекст — Claude помнит, что вы делали
→ Context7 готов подтянуть актуальную документацию при необходимости
Работаете над задачей.
→ Sequential Thinking помогает выбрать архитектурное решение — видно каждый шаг
→ TDD Guard следит: сначала тест, потом код
Заканчиваете задачу.
→ /clear — чистите контекст для следующей задачи
Конец недели.
→ ccusage --weekly — смотрите, сколько токенов ушло
→ /tech-debt-audit — проверяете, что накопилось
Перед релизом.
→ GitHub CLI — создаёте PR нативно, без MCP
→ tech-debt-audit — последняя проверка перед деплоем
Таблица: проблема → решение
| Симптом | Причина | Инструмент |
|---|---|---|
| Claude каждый раз пишет по-разному | Нет правил | CLAUDE.md + Karpathy Skills |
| Надо объяснять контекст каждую сессию | Нет памяти | AgentMemory / claude-mem |
| Claude выдумывает несуществующие методы | Устаревшие знания | Context7 / Deepcon |
| Принятое решение кажется странным | Мышление скрыто | Sequential Thinking |
| Код ломается после рефакторинга | Нет тестов | TDD Guard |
| Токены кончаются неожиданно | Нет аналитики | ccusage + /clear |
| Нарастает непонятное ощущение «что-то не так» | Технический долг | tech-debt-skill |
С чего начать: план на первую неделю
Главное правило: не ставьте всё сразу.
Каждый инструмент добавляет контекст в окно Claude. 20 скиллов и плагинов, которые борются за внимание — хуже, чем три хороших. Лучшие разработчики используют несколько инструментов максимум, а остальное — в хорошо написанном CLAUDE.md.
День 1 (15 минут)
└── Запустите claude-code-setup — посмотрите, что рекомендует
└── Создайте CLAUDE.md командой /init
└── Добавьте принципы Карпати
День 2 (10 минут)
└── Установите один инструмент памяти: AgentMemory или claude-mem
└── Поработайте день — почувствуйте разницу
День 3 (5 минут)
└── Установите Context7 (бесплатно, обязательно)
└── claude mcp add context7
День 4 (10 минут)
└── Установите TDD Guard для важного проекта
└── Попробуйте написать одну фичу через цикл тест → код
День 5 (5 минут)
└── Установите ccusage
└── Посмотрите, сколько токенов ушло за неделю
Конец первого месяца
└── Запустите /tech-debt-audit
└── Посмотрите, что накопилось
Поработайте неделю с каждым новым инструментом, почувствуйте разницу — и только потом решайте, нужно ли больше.
Итог
Claude Code — мощный инструмент. Но без настройки он как профессиональная камера в автоматическом режиме: нормальный результат, но далеко не максимум.
Эти девять инструментов дают Claude то, чего ему не хватает из коробки:
- Память — он помнит, что вы делали вчера
- Правила — он пишет в вашем стиле с первого раза
- Актуальность — он знает новые API библиотек
- Прозрачность — вы видите, как он думает
- Дисциплину — он не пишет код без тестов
- Контроль — вы знаете, куда уходят токены
- Качество — технический долг не копится незаметно
Полная установка — 20–30 минут. Разница — ощущается с первого же дня.
Источник
Эдвард Гришин, Futura AI — YouTube-видео «Сделай Claude Code в 10 раз эффективнее. 9 инструментов — CLAUDE.md, Карпати, память, тесты. Бесплатно.», апрель 2026.
Все инструменты бесплатны, если не указано иное. Deepcon — платный.
Связанные материалы: LLM Wiki вместо RAG, Скиллы для Claude Code, Claude Code + Codex вместе