Как настроить Claude Code: полный гайд с хаками и best practices 2026

Claude Code — это CLI-агент от Anthropic, который живет в терминале и самостоятельно читает файлы, пишет код, запускает тесты и коммитит изменения. Из коробки он работает неплохо. С правильной настройкой — совершенно иначе. Именно поэтому один и тот же инструмент у одного разработчика «тупит», а у другого закрывает задачи часами без участия.

Здесь — всё, что нужно для нормальной работы: установка, ключевые конфиги, Plan Mode, CLAUDE.md, MCP-серверы, скилы, хуки и реальные хаки от людей, которые провели в Claude Code сотни часов.

Установка Claude Code: от нуля за 5 минут

Для работы нужны Node.js 20+ и подписка Anthropic (Claude Pro от $20/мес) или API-ключ.

Шаг 1: Установка Claude Code

npm install -g @anthropic-ai/claude-code

Шаг 2: Добавить API-ключ

# Вариант 1: временно для текущей сессии

export ANTHROPIC_API_KEY="ваш-ключ-здесь"

# Вариант 2: постоянно (добавить в профиль shell)

echo 'export ANTHROPIC_API_KEY="ваш-ключ-здесь"' >> ~/.bashrc
source ~/.bashrc

Шаг 3: Первый запуск

# Перейти в папку проекта и запустить

cd ваш-проект
claude

При первом запуске Claude Code попросит принять условия использования. После этого — готово к работе.

Выбор модели при запуске:

# По умолчанию — Sonnet 4.6 (быстрый, хорошее качество)

claude

# С Opus 4.6 (медленнее, но глубже для сложных задач)

claude --model claude-opus-4-6

# Сменить модель прямо в сессии

/model

Как Claude Code думает: важно понять перед настройкой

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

Claude Code — «чистый агент». Он не использует сложный RAG, не индексирует весь код заранее. Вместо этого он ведет дедуктивный поиск: читает файлы по мере необходимости, запускает команды, смотрит на вывод и принимает следующий шаг. Это означает: чем четче вы описываете задачу и структуру проекта — тем меньше лишних шагов.

Ещё один важный момент: контекстное окно — 200 000 токенов. Звучит огромно, но при активной работе с большим проектом, множеством файлов и инструментов оно заполняется быстрее, чем кажется. Управление контекстом — это отдельный навык.

CLAUDE.md: самый важный файл, о котором многие не знают

CLAUDE.md — это файл, который Claude Code автоматически читает в начале каждой сессии. Именно здесь хранится всё, что агент должен знать о вашем проекте постоянно: стек, правила, что делать нельзя, как запускать тесты.

Создать стартовый CLAUDE.md автоматически:

/init

Команда анализирует структуру проекта, находит систему сборки, тестовые фреймворки и паттерны кода, и генерирует базовый файл. Его потом дорабатываете под себя.

Что включить в CLAUDE.md:

# Стек и технологии

• Next.js 14, TypeScript, Tailwind CSS
• PostgreSQL через Prisma ORM
• Тесты: Vitest

# Команды

• npm run dev — запустить dev-сервер
• npm run test — запустить тесты
• npm run build — проверить сборку (запускай после каждого изменения)

# Правила

• НИКОГДА не запускай npm run dev самостоятельно
• Всегда проверяй компиляцию через npm run build
• Используй conventional commits (feat:, fix:, chore:)
• Не удаляй комментарии в коде без явной просьбы
• При изменении схемы БД — сначала спроси

# Структура проекта
/src/app — страницы Next.js
/src/components — переиспользуемые компоненты
/src/lib — утилиты и хелперы
/prisma — схема базы данных

Главное правило по CLAUDE.md: файл не про то, кем является агент. Он про то, как устроен ваш мир. Структура проекта, конвенции, что трогать нельзя, где что лежит.

Два уровня CLAUDE.md:

~/.claude/CLAUDE.md        — глобальный, для всех проектов
ваш-проект/CLAUDE.md       — для конкретного проекта
ваш-проект/src/CLAUDE.md   — для конкретной папки (загружается по требованию)

Важный инсайт из опыта: если Claude Code делает что-то не то — не переформулируйте запрос. Исправьте CLAUDE.md. Проблема почти всегда в контексте, а не в промте.

Plan Mode: планируй перед тем как делать

Plan Mode — один из самых важных хаков при работе с Claude Code. Переключается через Shift+Tab.

В обычном режиме агент сразу начинает вносить изменения. В Plan Mode — сначала описывает, что собирается сделать, и ждет вашего подтверждения. Никакого кода, никаких правок файлов до вашего «ок».

Зачем это нужно:

• Видите план до того, как агент начал что-то ломать
• Можете исправить направление, пока не потрачены токены
• Снижает расход контекста — план mode уменьшает потребление токенов почти вдвое по сравнению с итеративным угадыванием

Когда использовать:

• Любая задача, затрагивающая несколько файлов
• Добавление новой фичи
• Рефакторинг
• Работа с базой данных

Хороший рабочий процесс: описать задачу -> Plan Mode -> проверить план -> внести правки словами -> подтвердить -> выполнение.

Слэш-команды: быстрые действия без промтов

Claude Code имеет встроенные команды. Вот самые полезные:

Кастомные слэш-команды создаются в папке .claude/commands/:

# .claude/commands/commit.md

Посмотри на `git diff --staged` и напиши хорошее сообщение коммита

в формате conventional commits. Определи тип (feat/fix/chore/docs),

напиши краткое описание на русском, закоммить.

После этого /commit работает как команда в любом проекте. Популярные кастомные команды: /commit, /review, /test, /deploy-check.

Управление контекстом: главная причина плохих результатов

Контекст — это ресурс. Когда он заполнен старыми данными, Claude Code начинает «тупить». Это не баг модели — это переполненный контейнер.

Правила управления контекстом:

Используйте /clear перед каждой новой задачей. Не продолжайте сессию от предыдущего разговора, если тема полностью изменилась — агент тащит с собой весь прошлый контекст.

Используйте /compact когда контекст заполнен наполовину, но задача ещё не закончена. Это сжимает историю разговора, сохраняя суть, но освобождая место.

Символ @ перед именем файла явно указывает агенту, что нужно посмотреть этот файл:

@src/components/Button.tsx перепиши стили под Tailwind v4

Без @ агент может угадывать, какой файл нужен, и терять время.

При очень большом контексте используйте /model и выберите модель с 1M токенов (Opus 4.6 в beta):

/model

# выбрать claude-opus-4-6 с 1M контекстом

MCP-серверы: как дать агенту доступ к внешнему миру

MCP (Model Context Protocol) позволяет Claude Code подключаться к внешним сервисам. Агент через MCP может читать таблицы в базе данных, работать с GitHub issues, управлять браузером, деплоить.

Добавить MCP-сервер:

claude mcp add context7 npx @context7/mcp

Конфигурация в .mcp.json:

{
"mcpServers": {
"supabase": {
"command": "npx",
"args": ["-y", "@supabase/mcp-server"],
"env": {
"SUPABASE_URL": "${SUPABASE_URL}",
"SUPABASE_SERVICE_KEY": "${SUPABASE_SERVICE_KEY}"
}
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}

Два уровня конфигурации MCP:

~/.mcp.json           — глобальный, доступен во всех проектах
проект/.mcp.json      — только для этого проекта, можно коммитить в git

Самые полезные MCP-серверы в 2026:

Важное правило по MCP: держите включенными не более 10 серверов. При большем количестве активных инструментов контекстное окно быстро заполняется, и производительность заметно падает. Храните 20-30 серверов в конфигурации, но включайте только нужные.

Новая фича в v2.1.7+: MCP Tool Search — динамическая подгрузка инструментов только когда нужны. Снижает потребление контекста до 95%. Включена по умолчанию.

Скилы: обучение агента под вашу специфику

Скилы — это .md-файлы в папке ~/.claude/skills/, которые дают агенту доменные знания и повторяемые воркфлоу. Никаких SDK, API и сборки — просто Markdown.

~/.claude/skills/frontend-design.md — правила дизайна

~/.claude/skills/api-conventions.md — конвенции API

~/.claude/skills/commit-style.md — стиль коммитов

Пример скила для работы с React:

# Frontend React Skill

Когда работаешь с React-компонентами, следуй этим правилам:

• Используй функциональные компоненты и хуки, никаких классовых
• TypeScript обязателен, никакого any
• Импорты группируй: React, внешние библиотеки, внутренние
• Названия компонентов — PascalCase, хуки — useXxx
• Каждый компонент в отдельном файле
• Props интерфейс называй XxxProps
• Используй React.FC<Props> как тип компонента

При создании нового компонента:
1. Создай файл в /src/components/[категория]/
2. Напиши тесты рядом — [ComponentName].test.tsx
3. Экспортируй из /src/components/index.ts

Разница между CLAUDE.md и скилами: CLAUDE.md — это контекст проекта, загружается всегда. Скилы — это тематические знания, подключаются когда тема релевантна. Скилы потребляют меньше токенов чем субагенты — если нужно просто дать инструкции, лучше использовать скилы.

Хуки: автоматизация без слов

Хуки — это скрипты, которые запускаются автоматически в определенные моменты работы агента. Ключевое отличие от CLAUDE.md: хуки детерминированы. CLAUDE.md — это советы, хуки — это гарантии.

Создать хук может сам Claude Code:

Напиши хук, который запускает eslint после каждого редактирования файла

Напиши хук, который блокирует коммиты файлов с расширением .env

Примеры полезных хуков:

# .claude/hooks/pre-commit.sh — блокировать коммиты чувствительных файлов
if git diff --cached --name-only | grep -qE '\.(env|key|pem)$'; then
echo "BLOCKED: Attempting to commit sensitive files"
exit 1
fi
# .claude/hooks/after-edit.sh — проверять сборку после изменений
npm run build 2>&1 | tail -5

Когда хуки особенно важны:

• Запуск агента без присмотра (headless mode)
• Защита от случайного пуша в main
• Блокировка rm -rf в продакшн-контексте
• Обязательный прогон тестов после правок

Субагенты: параллельная работа на сложных задачах

Claude Code может запустить до 10 параллельных субагентов. Каждый работает в своем контексте и имеет ограниченный набор инструментов.

Ключевой принцип из практики: давайте субагентам конкретные задачи, а не роли. «Напиши тесты для модуля аутентификации» работает лучше, чем «ты — тестировщик».

Трехступенчатый пайплайн для сложных фич:

Оркестратор (Claude Code)

├── Агент 1: spec-writer — читает задачу, пишет спецификацию

├── Агент 2: architect — проверяет спецификацию, пишет план

└── Агент 3: implementer — пишет код и тесты по плану

Каждый агент имеет только нужные инструменты: spec-writer — только Read/Write документов, implementer — Bash и Edit файлов.

Субагенты полезны для задач, которые вы делаете больше двух раз в неделю: code review, проверка перед деплоем, наполнение базы тестовыми данными.

Реальные хаки от людей с 500+ часами в Claude Code

Это не теория — конкретные приемы, собранные из опыта.

Хак 1: Открывайте новую сессию для проверки

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

Хак 2: --continue вместо повторного объяснения

claude --continue

Продолжает предыдущую сессию не перестраивая контекст с нуля. Экономит время когда нужно вернуться к прерванной задаче.

Хак 3: Всегда используйте Git

Claude Code имеет команду rewind для отката, но она не заменяет Git. Стандартный git revert надежнее и понятнее. Простое правило: git commit после каждой завершенной подзадачи.

Хак 4: Папка AI Docs для фундаментального контекста

Создайте папку /ai-docs/ в проекте и храните там:

• Архитектурные решения и почему они приняты
• Ключевые зависимости и их использование
• Особенности бизнес-логики, которые не видны из кода
• «Что нельзя трогать» и почему

При начале новой задачи явно указывайте агенту: прочитай /ai-docs/architecture.md перед тем как начинать.

Хак 5: Думайте в «Claude Day»

Раз в неделю или в конце большого блока работы — попросите агента собрать итоги по всем сессиям и создать документ с принятыми решениями, открытыми вопросами и следующими шагами. Это сохраняет знания между сессиями.

Хак 6: Dual review через вторую модель

Для важных задач: Claude Code пишет план и код, отправляет на независимую проверку в Gemini 3.1 Pro или GPT-5.4 через /agent, учитывает фидбек. Два AI проверяют друг друга.

Хак 7: Спрашивайте «почему»

Не принимайте код молча. Спрашивайте: «а почему здесь такой подход?», «какие альтернативы ты рассматривал?». Это и учит, и выявляет неочевидные допущения.

Максим: «Первые месяцы с Claude Code я просто принимал всё подряд. Потом понял: самые дорогостоящие ошибки случались именно когда я НЕ спрашивал “почему”. Теперь на любое неочевидное решение — сначала объяснение, потом принятие. Занимает 30 секунд, экономит часы.»

Типичные ошибки при работе с Claude Code

Ошибка 1: Слишком большая задача без декомпозиции. «Сделай весь бэкенд» — плохо. «Создай эндпоинт POST /api/users с валидацией и тестами» — хорошо. Claude Code лучше работает с четкими, ограниченными задачами.

Ошибка 2: Не обновлять CLAUDE.md. Архитектура изменилась, добавилась зависимость, поменялись правила — обновите файл. Агент работает с тем, что написано, а не с тем, что вы думаете.

Ошибка 3: Слишком много MCP одновременно. 10+ активных MCP-серверов убивают контекст. Держите включенными только то, что нужно прямо сейчас.

Ошибка 4: Не использовать Plan Mode для сложных задач. Принятие изменений без плана на сложных задачах — главная причина, почему «Claude что-то сломал». Shift+Tab перед любой нетривиальной задачей.

Ошибка 5: Работать в одной сессии весь день. Контекст накапливается. Старые инструкции конфликтуют с новыми. /clear между задачами — не перестраховка, а нормальная гигиена.

Итог: минимальный рабочий сетап

Если нужно стартовать быстро — вот минимум, который даст 80% результата:

1. Установить Claude Code, добавить API-ключ
2. Запустить /init в корне проекта, доработать CLAUDE.md
3. Подключить 2-3 MCP (Context7, Supabase или GitHub — под задачу)
4. Всегда использовать Plan Mode (Shift+Tab) перед сложными задачами
5. /clear перед каждой новой задачей
6. Git после каждой завершенной подзадачи

Остальное — Plan Mode, хуки, скилы, субагенты — добавляйте по мере того, как начнете чувствовать ограничения.

Полные материалы на VibeCoderz

Детальные обзоры инструментов:

• Полный обзор Claude Code — цены, возможности, тарифы
• Сравнение Claude Code и GitHub Copilot — честное сравнение
• Aider — бесплатная open-source альтернатива
• Cursor — IDE с AI
• Windsurf — бесплатный старт
• Весь каталог AI IDE и инструментов

Нужна помощь с настройкой рабочего процесса под ваш проект? Запишитесь на консультацию к Максиму.

FAQ

Чем Claude Code отличается от Cursor? Cursor — это IDE (редактор кода с AI внутри), у него графический интерфейс. Claude Code — чистый терминальный агент, без интерфейса, но с полным доступом к файловой системе и командной строке. Cursor для тех, кто хочет IDE-опыт. Claude Code — для тех, кто живет в терминале и хочет максимальную автономность.

Можно ли использовать Claude Code без подписки Anthropic? Да — через API-ключ. Тогда платите за токены по факту использования ($3/$15 за 1M токенов для Sonnet 4.6). Подписка Claude Pro ($20/мес) или Max ($100/$200/мес) дает фиксированную оплату с лимитами.

Что делать если агент начал делать что-то не то? Быстрый выход: Escape прерывает текущее действие. Затем /clear чтобы сбросить контекст. Если изменения уже внесены — git revert откатит их чисто.

Как управлять расходами на токены? Основные приемы: Plan Mode (снижает потребление вдвое), /clear между задачами, ограниченное количество активных MCP, правильный размер CLAUDE.md (коротко и по делу). Для простых задач используйте Sonnet 4.6, Opus 4.6 оставьте для сложных.

CLAUDE.md — это только для разработчиков? Нет. Если вы используете Claude Code для любых автоматизаций — контентных, аналитических, любых других — CLAUDE.md описывает контекст вашего проекта. Структура данных, правила именования, что можно и нельзя делать с файлами.

Можно ли использовать Claude Code в CI/CD? Да. Claude Code поддерживает headless mode через SDK для безголовой автоматизации. Полезно для автоматических code review, генерации commit messages, запуска тестов и деплоя. Хуки помогут защитить pipeline от нежелательных действий.

Что делать когда контекст заканчивается на большой задаче? Сначала попробуйте /compact — сжимает историю, сохраняя суть. Если не помогло — смените модель на claude-opus-4-6 с 1M токенами через /model. При ошибке компакции: выбрать 1M модель, потом снова /compact.

Глоссарий

CLI (Command Line Interface) — интерфейс командной строки, терминал. Claude Code работает только здесь.

CLAUDE.md — специальный файл, который агент читает автоматически при старте каждой сессии. Хранит постоянный контекст: стек, правила, структуру проекта.

MCP (Model Context Protocol) — протокол от Anthropic для подключения агента к внешним сервисам: базам данных, GitHub, браузеру, Slack и так далее.

Plan Mode — режим планирования (Shift+Tab). Агент сначала описывает план, потом ждет подтверждения перед выполнением.

Скилы (Skills) — .md-файлы с доменными знаниями для агента. Хранятся в ~/.claude/skills/. Подключаются когда тема релевантна.

Хуки (Hooks) — скрипты, которые запускаются автоматически в определенные моменты работы агента. В отличие от инструкций в CLAUDE.md, хуки гарантированно выполняются.

Субагенты — параллельные агенты, которые запускает главный Claude Code для выполнения отдельных частей задачи. До 10 параллельных в 2026 году.

Context window / Контекстное окно — сколько информации агент держит в памяти за одну сессию. У Claude Code — 200 000 токенов (в бета-режиме с Opus 4.6 — до 1 миллиона).

Headless mode — запуск Claude Code без интерактивного интерфейса, для автоматизации в CI/CD.

/clear — команда сброса контекста сессии. Использовать перед каждой новой задачей.

/compact — команда сжатия контекста. Сохраняет суть разговора, освобождает место для продолжения работы.

Статья подготовлена командой VibeCoderz — крупнейшей базы знаний по AI IDE и вайбкодингу в СНГ. Последнее обновление: март 2026.