Claude Code Basics

Ставим Claude Code, настраиваем рабочее окружение. Что лежит в папке .claude/, как писать CLAUDE.md, какие режимы доступа бывают. Проект: создаём репозиторий дайджеста, деплоим шаблон на Vercel, пишем CLAUDE.md с редполитикой.

• Установка и проверка. VS Code, Claude Code, GLM5, альтернативные провайдеры. Команда claude doctor — убедиться, что всё работает до начала занятий.
• Структура .claude/. Папка, в которой живут настройки, правила, навыки и агенты. Что за что отвечает.
• CLAUDE.md. Файл, который Claude читает при каждом запуске. Четыре уровня приоритета: managed → global → project → local. Структура ЗАЧЕМ / ЧТО / КАК — зачем проект существует, что он делает, как с ним работать.
• Что включать в CLAUDE.md, а что нет. Принцип: не посылай LLM делать работу линтера. Правила — в CLAUDE.md, проверку синтаксиса и форматирование — инструментам.
• Режимы доступа. Пять уровней: Default, Accept Edits, Plan, Don't Ask, Bypass Permissions. Shift+Tab для переключения. Паттерн-правила Allow/Ask/Deny для тонкой настройки.
• Команды на каждый день. /clear, /compact, /memory, /cost, /model, /config, /permissions.
• Сессии. --continue для продолжения последнего разговора, --resume для выбора из списка, /rename для именования.

Домашнее задание: написать глобальный и проектный CLAUDE.md.

Как формулировать задачи для кодового агента. Структура промпта, типичные ошибки, антипаттерны и Git как страховка. Проект: пишем промпты для поиска и написания статей, экспериментируем со стилем в отдельных ветках.

• Промпт для агента ≠ промпт для чатбота. Чатботу достаточно вопроса. Агенту нужна структура: контекст → ссылки на файлы → задача → формат → ограничения. Порядок имеет значение.
• Сначала контекст, потом задача. Начинать с «зачем», а не с «что делать». Claude принимает десятки решений по ходу работы — без контекста будет додумывать.
• Спектр конкретности. Три уровня запросов: исследование (покажи варианты), направление (сделай примерно так), спецификация (сделай точно так). Каждому типу задачи — свой уровень детализации.
• Сначала ограничения. Описать, чего делать не нужно, часто важнее, чем описать задачу. «Не создавай новых файлов» или «не трогай стили» экономит часы отката.
• Промпты с проверкой. Давать Claude способ себя проверить: тестовые данные, ожидаемый результат, команду для запуска.
• Расширенное мышление. Управление глубиной размышлений через Alt+T. Ключевое слово ultrathink для максимальной глубины анализа.
• Git как страховка. Ветки, атомарные коммиты, откат. Проверка кода перед пушем — Claude ревьюит собственные изменения.
• Антипаттерны. Мега-промпт на 500 слов, который Claude не может переварить. «Сессия-свалка» — всё в одном разговоре, пока контекст не переполнится. Цикл исправлений — бесконечное исправление ошибок по кругу. Перегруженный CLAUDE.md — инструкция длиннее, чем код проекта.

Домашнее задание: три задачи на переформулирование промптов + коммит, ветка, откат через Claude.

Plan Mode для задач, где нельзя ошибиться с направлением. Интеграции с IDE для работы с Claude в редакторе. Удалённый доступ к сессии с телефона. Проект: Plan Mode проектирует структуру сайта и пайплайн публикации.

• Агентный цикл. Как Claude работает под капотом: получает промпт → выбирает инструмент → выполняет → анализирует результат → решает, что дальше. Цикл повторяется, пока задача не решена.
• Режим планирования (Plan Mode). Режим анализа без изменений в коде. Claude исследует кодовую базу, задаёт вопросы и предлагает план. Shift+Tab для включения, Ctrl+G для редактирования.
• Когда Plan Mode нужен. Незнакомая кодовая база, рефакторинг 3+ файлов, архитектурные решения. Когда лишний — однофайловые правки, быстрые фиксы. Ошибка в плане дешевле, чем ошибка в коде.
• VS Code. @-упоминания файлов, папок и строк для точного контекста. Параллельные диалоги. Горячие клавиши.
• Контрольные точки и откат. Откат кода и разговора к любой точке. Можно откатить и попробовать другой подход, не теряя предыдущую работу.
• JetBrains. Плагин с автопередачей диагностики компилятора и нативным diff. IntelliJ, PyCharm, WebStorm.
• Удалённое управление. Доступ к сессии с телефона через QR-код. Можно управлять агентом с планшета, пока он работает на десктопе.

Домашнее задание: полный цикл Plan Mode → план → реализация → коммит. @-упоминания в IDE.

Контекстное окно — рабочая память агента. У Opus 4.6 — миллион токенов, это ~50 000 строк кода. При активной работе заполняется за 10–15 минут, и тогда Claude начинает путать детали. Покажем, как этим управлять. Проект: обрабатываем 10–15 новостей за раз, не засоряя контекст. Редполитику выносим в MEMORY.md.

• Анатомия контекстного окна. Команда /context показывает раскладку: системный промпт, описания инструментов, агенты, память, история сообщений, свободное место. 500 строк кода — это 3–5 тысяч токенов.
• Протухание контекста. Чем длиннее контекст, тем хуже Claude работает. Путает детали, теряет фокус, повторяется. Больше информации — не всегда лучше.
• Раздувание контекста. Перегруженный CLAUDE.md, десяток MCP-серверов, нечищеная история — всё это занимает место. Аудит и чистка контекста как привычка.
• Автокомпрессия. Срабатывает при ~75% заполнения. Система оставляет резерв свободного места для генерации ответа.
• Команды управления. /compact [фокус] — сжать историю, сохранив важное. /clear — полная очистка. /rewind — откат к предыдущему шагу. /model — сменить модель на лету.
• Правило 70%. При работе с несколькими файлами сжимать историю или начинать новую сессию, не дожидаясь автокомпрессии.
• Память. /memory для быстрых заметок. auto-memory — Claude сам запоминает важное. MEMORY.md — индексный файл, первые 200 строк загружаются при каждом запуске.
• Постепенное раскрытие. Короткий CLAUDE.md с импортами вместо монолита. Детальные правила — в .claude/rules/ по темам. Ссылки через @path вместо копирования документации.

Домашнее задание: оптимизировать свой CLAUDE.md, вынести правила в .claude/rules/.

MCP (Model Context Protocol) — открытый протокол для подключения Claude к внешним сервисам. GitHub, Notion, Slack, Figma, базы данных — агент получает доступ и работает с ними напрямую. Проект: подключаем Tavily (поиск новостей), Replicate (генерация обложек) и GitHub (коммиты и деплой). Первый автоматический выпуск дайджеста.

• Архитектура MCP. Хост → клиент → сервер. Три типа возможностей: инструменты (действия), ресурсы (данные), промпты (шаблоны). Каждый сервер расширяет набор инструментов агента.
• Три типа подключения. HTTP — рекомендуемый для удалённых серверов. SSE — потоковая передача. stdio — для локальных программ, которые запускаются вместе с Claude.
• Подключение. Команда claude mcp add или JSON-конфиг в .mcp.json. Три области видимости: local (по умолчанию), project (для команды), user (для всех проектов).
• Безопасность. Ключи — только в переменных окружения: ${TAVILY_API_KEY} в .mcp.json, чтобы секреты не попали в Git.
• Поиск инструментов. Когда описания инструментов занимают больше 10% контекста, Claude подгружает только те, которые нужны для текущей задачи.
• Каталог серверов. PulseMCP (9 000+), mcp.so (18 000+), MCP Registry (официальный). Серверы для GitHub, GitLab, Notion, Slack, Figma, Supabase, PostgreSQL, Sentry, Brave Search, Zapier.
• MCP Inspector. Инструмент для отладки: npx @modelcontextprotocol/inspector. Видно, какие инструменты доступны, какие параметры принимают и как отвечают.
• Когда MCP не нужен. Пайплайны на 100K+ строк, задачи, где нужна проверка каждого шага, ситуации, когда подключение не окупается.

Домашнее задание: подключить 2–3 сервера и решить задачу с внешними данными. Сравнить результат с MCP и без.

Навыки, хуки и тесты. Навык говорит, что делать. Хук — когда проверять. Тест — прошло ли. Проект: навык /digest собирает выпуск за одну команду. Навык /cover генерирует обложку через Replicate. Хук проверяет, что у каждой статьи есть заголовок, описание, обложка и ссылка на источник.

• Пользовательские навыки. Markdown-файлы в .claude/skills/ с YAML-шапкой. Два способа запуска: ручной через /имя и автоматический — Claude сам решает, когда навык подходит к задаче.
• YAML-шапка навыка. Настройки: allowed-tools (какие инструменты разрешены), context: fork (изолированный контекст), model (выбор модели), hooks (действия при запуске).
• Аргументы и расписание. $ARGUMENTS для передачи параметров. /loop для повторного запуска с заданным интервалом (например, каждые 5 минут). Встроенные навыки: /batch, /debug, /simplify.
• Хуки. Автоматические действия на 18 типов событий. PreToolUse — перехват и блокировка опасных команд (exit code 2). PostToolUse — автоформатирование после каждого изменения. Stop — проверка перед завершением работы.
• Четыре типа хуков. command — shell-скрипт. http — POST-запрос. prompt — LLM оценивает результат. agent — субагент с полным доступом к инструментам.
• Разработка через тестирование (TDD). RED → GREEN → REFACTOR. Вертикальные срезы — один тест, одна реализация, повтор. Не горизонтально (все тесты, потом весь код), а вертикально, один срез за раз. Так контекст не раздувается.
• Хуки для тестов. PostToolUse запускает тесты после каждого изменения файла. Stop не даёт Claude закончить, пока все тесты не прошли. Нюанс: Claude может «починить» тест вместо кода — покажем, как этого избежать.

Домашнее задание: создать навык + хук. Запустить TDD-цикл на простой задаче.

Один Claude — ассистент. Несколько — команда. Субагенты для быстрых задач, Agent Teams для сложных, worktrees для изоляции. Проект: четыре агента работают параллельно — один ищет новости, другой пишет статьи, третий генерирует обложки через Replicate, четвёртый верстает страницы. Agent Teams координирует выпуск.

• Субагенты. Три встроенных типа: Explore (быстрый, на Haiku, только чтение), Plan (анализ без изменений), General-purpose (полный доступ). Каждый работает в своём контекстном окне и не засоряет основное.
• Свои агенты. Markdown-файлы в .claude/agents/ с YAML-шапкой. Настройки: модель, инструменты, режим доступа, MCP-серверы, навыки. Память субагентов — агент запоминает контекст между вызовами.
• Передний план и фон. Ctrl+B отправляет задачу в фон. /tasks показывает статус. Правило 30 секунд: если задача займёт больше — отправляй в фон и работай дальше.
• Agent Teams. Несколько экземпляров Claude с общим списком задач и обменом сообщениями. Ведущий координирует, участники выполняют. Жизненный цикл задачи: pending → in_progress → completed.
• Делегирование. Без явных указаний ведущий агент часто делает всё сам. Как формулировать задачи, чтобы работа действительно распределялась.
• Коммуникация. message — личное сообщение. broadcast — всей команде. /btw — быстрый вопрос, который не попадает в историю и не тратит контекст. Shift+Down для переключения между участниками.
• Worktrees. claude --worktree — каждый агент работает в своей копии репозитория. Изменения не конфликтуют, пока не объединены. Субагенты + worktrees через isolation: worktree.
• Рефакторинг в масштабе. Пять фаз: план → фундамент → распространение (по 3–5 файлов за итерацию) → проверка → очистка. Никогда не смешивать изменение типов и логики в одном коммите.

Домашнее задание: Agent Teams с делегированием. Параллельная работа в worktrees.

Собираем всё вместе. CLAUDE.md + права доступа + навыки + хуки + MCP + агенты = агентная обвязка. Инфраструктура, в которой модель работает сама и проверяет себя сама. Проект: /loop запускает полный цикл — поиск, написание, публикация — автоматически. Дайджест обновляется без участия человека.

• Что такое Agent Harness. Обвязка вокруг модели: что она видит, какие инструменты получает, как восстанавливается после ошибок. Принцип: чем мощнее модель, тем проще обвязка.
• Три способа проверки. На правилах — линтеры и проверка типов ловят ошибки автоматически. Визуальная — скриншоты через Playwright MCP, сравнение с макетом. Оценка другой моделью — вторая LLM проверяет результат первой.
• Отладка. Claude ошибается не из-за глупости, а из-за нехватки данных — он читает код, но не видит runtime. Полный контекст ошибки — копировать стек-трейс целиком, не пересказывать. Работа с логами: попросить Claude добавить логи → запустить → отдать логи Claude → он решает с первой попытки.
• Цикл исправлений. Claude чинит одно и ломает другое по кругу — значит, проблема не в коде, а в неясных требованиях. Как распознать цикл: остановиться, уточнить задачу, начать заново.
• Headless-режим. claude -p "задача" — выполнить и выйти. Флаги: --output-format json, --max-turns, --allowedTools. Для скриптов и автоматизации без участия человека.
• GitHub Actions. anthropics/claude-code-action@v1 — Claude реагирует на issues, pull requests и комментарии. Проверка безопасности — автоматическая блокировка деплоя при обнаружении проблем.
• SDK. query() для разовых задач. ClaudeSDKClient для постоянных сессий с сохранением контекста. Свои MCP-инструменты через декораторы. Python и TypeScript.
• Автоматизация. /loop запускает навык с заданным интервалом прямо в Claude Code — без cron и внешних планировщиков. Для задач вне текущей сессии: claude -p + cron / n8n.
• Финал. Собираем обвязку из компонентов курса. Принцип: меньше инструментов — лучше результат. Задача → минимальный набор → CLAUDE.md → навыки → хуки → агенты.