Один файл, который делает
Claude Code полезным
Я каждый день работаю с Claude Code. Без CLAUDE.md он тупит, забывает контекст и выдумывает команды. С ним — знает проект, стек и мои привычки. Показываю как настроить.
Как это работает
Claude Code при запуске читает CLAUDE.md и делает то, что там написано. Ты один раз объяснил — он запомнил. Навсегда.
Без этого файла Claude каждый раз как новый стажёр. Не знает стек, не знает команды, угадывает стиль кода.
Без CLAUDE.md
- Не знает твой стек
- Придумывает команды сборки
- Пишет код как хочет
- Каждую сессию объясняешь заново
С CLAUDE.md
- Знает стек, архитектуру, паттерны
- Запускает правильные команды
- Пишет в твоём стиле
- Помнит правила между сессиями
Пишешь /init в Claude Code. Он сам смотрит проект и генерит стартовый CLAUDE.md. Дальше руками допиливаешь под себя.
Установка Claude Code
Два варианта. Выбирай что ближе:
Терминал (я использую так)
Работает везде: macOS, Linux, Windows (WSL). Самый гибкий вариант.
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
VS Code
Если живёшь в VS Code, можно не выходить из редактора.
Нужен Claude Pro ($20), Max ($100/$200), Teams или Enterprise. Бесплатно Claude Code не работает. Я на Max, потому что Opus жрёт лимиты быстро.
Где живёт CLAUDE.md
Файл можно положить в нескольких местах. Каждый уровень добавляет контекст. Жми на строку, покажу подробности.
Собери свой CLAUDE.md
Отмечай блоки, которые нужны твоему проекту. Превью обновляется сразу. Потом копируешь и вставляешь к себе.
Выберите блоки
Нажимайте, чтобы добавить/убрать
Что писать, а что нет
Простой тест для каждой строки: «Если убрать это, Claude начнёт косячить?» Нет? Удаляй.
Включать
- Команды, которые Claude сам не угадает
- Код-стайл, если он отличается от стандарта
- Как запускать тесты
- Архитектурные решения и почему так
- Quirks и gotchas, на которых ты сам горел
Не включать
- То, что Claude сам увидит в коде
- Стандартные конвенции языка
- API-доки (дай ссылку, он сходит сам)
- Описание каждого файла проекта
- Очевидное: «пиши чистый код»
CLAUDE.md поддерживает @путь/к/файлу для импорта. Я так разбиваю инструкции на модули, а не пихаю всё в один файл. Контекст экономится.
Почему размер файла решает
Контекстное окноПамять Claude на один разговор. Вмещает всё: твои сообщения, код, вывод команд. Когда заполняется, Claude «забывает» ранние инструкции. заполняется быстро. Раздутый CLAUDE.md ворует место у реальной работы.
Одна сессия дебага может сожрать десятки тысяч токенов. Когда контекст переполняется, Claude тихо забывает твои правила из CLAUDE.md. Поэтому файл должен быть компактным. У меня было 500 строк, сократил до 120 и стало лучше.
/clear
Новая задача? Чисти контекст. Не тащи мусор из прошлой работы.
/compact
Сжимает контекст, сохраняя важное. Можно указать что именно сохранить.
Esc + Esc
Откат к предыдущей точке. Как Ctrl+Z, но для всего разговора. Пользуюсь постоянно.
Субагенты
Делегируй тяжёлое исследование в отдельный контекст. Основная сессия остаётся чистой.
Исследуй → Планируй → Кодь
Главная ошибка: дать Claude задачу и ждать что он сразу напишет идеальный код. Не напишет. Сначала пусть разберётся.
Исследуй
Claude читает файлы и отвечает на вопросы. Ничего не трогает. Включи Plan Mode: Ctrl+G
Планируй
Попроси создать план. Поправь, если что-то не так. Только после твоего ок Claude начнёт кодить.
Кодь
Claude пишет код по плану. Дай тест или ожидаемый результат, чтобы он мог себя проверить. Без этого будет «выглядит правильно, но не работает».
Коммить
Попроси закоммитить. Claude сам напишет сообщение коммита и создаст PR если нужно.
Конкретнее = меньше правок
Одна конкретная просьба экономит три итерации переделок. Проверено на себе, раньше по 10 раз переделывал.
Расплывчато
«добавь тесты для foo.py»
«почини баг логина»
«добавь виджет»
Конкретно
«тест для foo.py: кейс разлогиненного юзера, без моков»
«логин падает после истечения сессии, проверь src/auth/»
«посмотри HotDogWidget.php, сделай по паттерну»
Дай тест или ожидаемый результат. Без критериев успеха Claude выдаст то, что выглядит правильным, но реально не работает. Я так потерял часы дебага, пока не начал давать тесты сразу.
Что ещё умеет Claude Code
CLAUDE.md это только начало. Вокруг него целая экосистема. Жми, чтобы раскрыть.
Permissions (разрешения)
По умолчанию Claude спрашивает разрешение на каждый чих. Три способа ускорить:
Auto mode — блокирует только опасные команды. Я работаю в нём 90% времени.
Allowlists — разреши конкретные: npm run lint, git commit
Sandboxing — изоляция на уровне ОС для параноиков (или продакшена)
CLI-инструменты
Поставь gh (GitHub), aws, gcloud. Claude сам разберётся через --help. На практике CLI часто надёжнее MCP-серверов: меньше зависимостей, проще дебажить. Я для GitHub использую gh, а не MCP.
MCP-серверы
Подключают внешние инструменты: Notion, Figma, браузер, базы данных. Мощная штука, но не для каждой задачи.
Claude сможет работать с ними напрямую.
Hooks (хуки)
Скрипты, которые гарантированно выполняются при событиях: после редактирования, перед коммитом. В отличие от CLAUDE.md, хуки нельзя «забыть». Это жёсткие правила, а не рекомендации.
"Write a hook that runs eslint after every file edit"
Skills (навыки)
Файлы SKILL.md в .claude/skills/ — готовые workflow. Грузятся только когда нужны, а не постоянно как CLAUDE.md.
Вызов: /skill-name или автоматически по описанию. У меня их 20+, под каждый тип задачи.
Progressive Disclosure
SKILL.md держите компактным: описание + шаги. Детали (чеклисты, шаблоны) выносите в references/. Так скилл не раздувает контекст.
Субагенты
Отдельные агенты в .claude/agents/. Работают в своём контексте и не засоряют основной. Идеальны когда надо прочитать кучу файлов или провести ревью.
name: security-reviewer
description: Reviews code for vulnerabilities
tools: Read, Grep, Glob, Bash
---
Ошибки, на которые я сам наступал
Жми на карточку, покажу как починить.
Всё в одной сессии
Фича + баг + рефакторинг в одном окне. Контекст умирает.
/clear между задачами. Это реально меняет качество.Бесконечные правки
«Не так, опять не то» x10. Контекст забит мусором правок.
CLAUDE.md на 500 строк
Энциклопедия, которую Claude физически не может удержать в контексте.
Доверие без проверки
Claude уверенно отвечает, ты не проверяешь. Баг в проде.
Бесконечное исследование
Claude часами читает файлы, но ничего не делает.
Копипаст всего в файл
README + API-доки + changelog. Бесполезный расход контекста.
Чеклист: твой первый CLAUDE.md
Отмечай пункты по мере выполнения. Когда все зелёные, ты готов.
/init для генерации стартового CLAUDE.md
Claude Code с нуля
Десять разделов: от установки до безопасности промптов и полной экосистемы 2026. Первый открыт всем. Остальные за подписку на канал и YouTube. Telegram я проверяю через API.
Установка и первый запуск
Claude Code, это CLI. Ставится одной командой, работает в терминале. Поддерживает macOS, Linux и Windows (через PowerShell/WSL).
Выбери свою ОС
Без sudo. Ставит в ~/.local/bin. Если claude не находится, добавь путь в ~/.zshrc или ~/.bashrc.
Для тех, у кого macOS и уже стоит Homebrew. Обновления, через brew upgrade.
PowerShell 5.1+. После установки перезапусти терминал, чтобы PATH подхватил claude.
Если работаешь из-под админского PowerShell. Ставит в стандартный Windows-путь.
Первый запуск, симулятор
Нажимай кнопку шаг за шагом, увидишь, что происходит на самом деле при первом claude.
Дальше, только подписчикам
Контент делаю бесплатно, но прошу минимальной отдачи. Подпишись на канал и на YouTube, и откроются разделы 02, 03, 04.
Как давать Claude контекст
Модель хороша настолько, насколько хорош твой промпт. Claude Code умеет читать файлы, картинки и вывод команд прямо в диалоге. Это главный навык.
- Почему «200к токенов» на практике оказываются сорока
- Файлы, скриншоты и вывод команд прямо в диалоге
- Паттерны промпта, которые экономят половину контекста
Opus 4.6 и Sonnet 4.6 держат миллион токенов, Haiku 4.5 — всего 200 тысяч. Но это не значит, что у тебя реально есть миллион: системный промпт, CLAUDE.md, auto-memory и вывод тулов съедают первые 20–40 тысяч ещё до твоего первого слова. В разделе — как не засорять остальное мусором и как включить prompt caching, который удешевляет повторное чтение в 10 раз.
| Opus 4.6 | 1M токенов · минимум для кэша 4096 |
|---|---|
| Sonnet 4.6 | 1M токенов · минимум для кэша 2048 |
| Haiku 4.5 | 200k токенов · минимум для кэша 4096 |
Slash-команды и режимы мышления
Claude Code, это не только чат. Это набор инструментов. Slash-команды управляют сессией, режимы, тем, как модель думает. Освоишь, экономишь часы.
- /clear, /compact, /teleport — когда каждый реально нужен
- think, think hard, ultrathink — что меняется под капотом
- План-мод и autopilot в одной сессии без конфликтов
Команд реально две категории: системные (/compact, /clear, /context, /rewind, /teleport) и встроенные скиллы (/batch, /simplify, /loop, /debug). Режим мышления ставится одной строкой: /effort max — максимальный бюджет, только Opus 4.6, только на текущую сессию. В разделе показываю когда /compact экономит сессию, а когда просто её убивает.
Как Claude Code растёт вместе с тобой
Из коробки Claude Code уже мощный. Но у него есть три «столпа роста»: разрешения (что можно трогать), MCP (чем расширить), скиллы (чему научить). Их настройка, это твой личный мультипликатор.
- Permissions и allowlist: что разрешать без подтверждения
- MCP-серверы — Playwright, Notion, и свой за вечер
- Скиллы и плагины: когда писать, когда брать чужое
Скилл — папка с SKILL.md под 500 строк, больше — и описание выкидывается из контекста. Плагин — связка skills/, agents/, hooks/ и .mcp.json в одном plugin.json. MCP-сервер ставится одной командой claude mcp add --transport http с тремя scope: local / project / user. В разделе — три MCP-сервера, которые у меня включены всегда, и скелет первого своего плагина.
Как разговаривать с моделью
Claude Code, это обёртка над моделью. А модели реагируют на приёмы промпт-инженерии одинаково, независимо от интерфейса. Вот техники, которые у меня дают разницу в 2-3 раза по качеству ответа.
- Как просить так, чтобы Claude не угадывал
- Шаблоны для фикса бага, рефакторинга и ревью
- Когда показывать примеры, когда — жёсткие правила
Claude 4.6 ломает старые «жёсткие» промпты: конструкции CRITICAL: You MUST… приводят к overtriggering — модель дёргает тулы лишний раз. Anthropic рекомендует XML-теги (<instructions>, <context>, <example>) и 3–5 few-shot примеров внутри <examples>. Prefill последнего assistant-turn в 4.6 вообще deprecated. В разделе пять шаблонов промптов, которые у меня дают разницу в 2–3 раза на одном и том же запросе.
База знаний на файлах
Контекстное окно модели, это оперативка. Рано или поздно хочется диск. Два рабочих паттерна: база знаний по-Карпатски и мост к NotebookLM. Использую оба.
- Почему knowledge/ бьёт Notion на уровне проекта
- Структура INDEX.md и автообновление после сессии
- Как делиться знанием между несколькими проектами
CLAUDE.md держи под 200 строк — всё, что больше, Claude просто игнорирует. Импорты @path/to/file.md работают на глубину до 5 ссылок — можно собирать модульную память. Плюс auto-memory: Claude Code v2.1.59+ сам ведёт MEMORY.md в ~/.claude/projects/<project>/memory/, в сессию грузятся первые 200 строк или 25KB. В разделе — структура knowledge/, которая у меня пережила семь проектов.
Managed Agents API
Для тех, кто строит своих агентов поверх Claude. Anthropic открыл платный API, где сессия, окружение и разрешения управляются на их стороне. Это не то же самое, что Claude Code, это готовый движок агента в облаке.
- Чем Managed Agents отличается от обычного API
- Цена, rate-limits, обязательный beta-заголовок
- Первый рабочий агент за 20 минут с нуля
Managed Agents запустили 9 апреля 2026, стоят $0.08 за час активной сессии плюс стандартные токены модели, плюс $10 за 1000 web-searches внутри. Idle не тарифицируется — это меняет экономику long-running агентов. Beta-header managed-agents-2026-04-01 обязательный, без него API отдаёт 400. Типовая сессия 4–6 часов выходит в $1.5–3.5 суммарно. В разделе — как подключить за 20 минут и когда это дешевле своего рантайма.
| Час активной сессии | $0.08 + токены модели |
|---|---|
| Web searches | $10 за 1000 запросов |
| Rate limits | 60 RPM create · 600 RPM read |
Семь ошибок, которые я совершил
Два месяца плотной работы с Claude Code каждый день. Сертификаты пройдены, проекты сданы. Вот семь вещей, на которых я потерял суммарно недели времени. Не повторяй.
- Слепое доверие, которое стоило мне прод-инцидента
- Копипаст в CLAUDE.md, который съел весь контекст
- Рефакторинг без тестов — потерянный день работы
Три ошибки, за которые я заплатил днями работы: (1) жёсткие инструкции CRITICAL: YOU MUST в 4.6 вызывают overtriggering — модель спамит тулами; (2) Claude 4.6 любит overengineering, делает лишние абстракции и defensive error handling, если явно не запретить; (3) test-gaming — подгоняет реализацию под тесты вместо решения задачи. В разделе семь конкретных кейсов с промптами, которые каждую из них починили.
Безопасность промптов
Промпт это программа, которую выполняет LLM. Любая программа, принимающая недоверенный ввод, уязвима. Я потрогал это на живых проектах, вот конкретные классы атак и что с ними делать.
- Prompt injection через файлы и веб-страницы
- Хуки, которые блокируют опасные команды
- Что никогда не класть в CLAUDE.md
Хуков в Claude Code теперь 27 лайфсайкл-событий. Один PreToolUse даёт полный контроль: возвращаешь exit code 2 — тул блокируется, stderr уходит Claude как объяснение. Или JSON с hookSpecificOutput.permissionDecision: "deny" — то же, только структурированно. В разделе три класса промпт-инъекций и рабочий шаблон хука, который ловит rm -rf, git push --force и @-импорты из недоверенных источников.
| exit code 2 | PreToolUse-скрипт → блок + stderr как причина |
|---|---|
| permissionDecision: "deny" | JSON-ответ, структурированный отказ |
| "disableAllHooks": true | Полное выключение в settings.json |
Экосистема 2026
Claude Code это ядро, но вокруг уже сложился набор инструментов, которые склеиваются с ним в один рабочий конвейер. Вот что у меня реально используется каждую неделю, плюс план обучения на месяц вперёд.
- Скиллы, плагины, marketplace — кто выживет
- Что реально стоит подсмотреть у других агентов
- Куда Claude Code едет через год и почему
В 2026 экосистема срослась: скиллы стали открытым стандартом (agentskills.io), кастомные команды мержатся в скиллы (/deploy теперь просто SKILL.md, а не отдельный файл), плагины умеют поставлять LSP через .lsp.json. Модели: Opus 4.6 ($5/$25 MTok), Sonnet 4.6 ($3/$15), Haiku 4.5 ($1/$5), output до 128k для Opus и 64k для остальных. В разделе мой план обучения на месяц вперёд.
Паттерны, которые реально работают
CLAUDE.md как оглавление
У меня в workspace 7 проектов. CLAUDE.md в корне работает как индекс: таблица проектов, ссылки через @-импорт. Каждый подпроект со своим CLAUDE.md. Claude грузит только то, что нужно прямо сейчас.
CLI вместо MCP для простых вещей
MCP хорош для Playwright и Notion. Но для GitHub я использую gh, а не GitHub MCP. Для HTTP-запросов curl. Меньше зависимостей, проще дебажить, реже ломается.
Усиление правил
Claude игнорирует правило? Добавь IMPORTANT или YOU MUST. Всё ещё игнорирует? Файл слишком длинный, правило тонет в контексте. Сокращай CLAUDE.md пока не начнёт работать.
Вывод такой: настрой Claude Code под себя
Пишу про AI-инструменты, скиллы и рабочие паттерны. На YouTube снимаю серию «История ИИ».
Хочешь остальные 9 разделов целиком?
Подпишись на канал, система проверит автоматически, страница перезагрузится с открытыми разделами.
К гейту ↑