Освоение Claude Code

Агент хорош ровно настолько, насколько хороши вводные, которые вы ему даёте

Модель отвечает на основе того, что она может видеть. Дайте ей правильные факты, достаточное время на обдумывание, способ доказать свою работу и чёткие ограничения, и она выдаст результат. Упустите что-то одно, и она будет уверенно гадать.

Через весь воркшоп проходят четыре вопроса:

• Контекст. Есть ли у агента нужные факты?
• Рассуждение. Стоит ли эта задача более крупной модели или больших усилий?
• Доказательства. Что доказывает, что результат корректен?
• Автономность. Дают ли ваши проверки и ограничения право отойти в сторону?

Вы научитесь отвечать на них с помощью Claude Code, в четыре шага. Каждый шаг, это пояс, и каждый пояс заканчивается чем-то, что работает.

Четыре пояса

• Белый пояс, основы. Что такое модель, что делает оболочка вокруг неё, ваш первый разговор с Claude Code.
• Синий пояс, сборка CLASH. От спецификации к работающему приложению: сначала план, затем работа небольшими шагами, Claude смотрит на страницу, проверка как будто вы видите это впервые.
• Коричневый пояс, управление контекстом. Написание CLAUDE.md на основе реальных правил, упаковка привычки в skill, аудит с помощью subagents, превращение истории в спецификацию, ограничение правил по путям.
• Чёрный пояс, оркестрация и отпускание контроля. Тесты как ориентир, команды агентов и динамические workflows, hooks, браузер как проверка, worktrees и CI, Agent SDK, работа по расписанию и в фоне, собственный MCP server.

Одно реальное приложение

Вы создадите CLASH, приложение с картой для спонтанных встреч в Берлине. Clash, это активность в определённом месте и в определённое время. Люди присоединяются, организаторы принимают или отклоняют, затем следуют уведомления. Вы начинаете со спецификации и пустого репозитория. CLASH работает онлайн и бесплатен, поэтому вы можете попробовать его, прежде чем создавать свой.

В реальном коде бывают реальные ошибки: Server Action, который пропускает проверку владения, карта, которая падает на сервере, avatar, который замедляет каждую страницу. Вы находите их и исправляете на основе доказательств.

К концу у вас будут:

• CLASH, созданный вами с помощью Claude Code и сравнённый с эталонной версией
• CLAUDE.md на основе реальных правил, повторно используемый skill и набор hooks
• аудит авторизации, выполненный тремя способами, с уже влитым исправлением
• набор browser tests и измеренное исправление производительности
• аудит, работающий в CI, процесс с worktree и небольшая программа на Agent SDK
• Claude Code, работающий без человека за клавиатурой: стиль вывода, цель, цикл, фоновая сессия и рутина
• собственный MCP server для CLASH, а также второе приложение, которое публикует свои доклады как clash-события через него

Как проходит обучение

Тренер объясняет идею, показывает её вживую, а затем вы делаете это на своей машине. У каждой задачи есть reset branch, поэтому никто не застревает и никто не ждёт группу. Слайды, файлы задач и ответы остаются у вас.

Для кого это

Для всех, кто пишет код и хочет хорошо использовать Claude Code. Достаточно базовых навыков программирования на любом распространённом языке и основ git. Приложение, которое вы создадите, CLASH, написано на TypeScript. Знать его не нужно: если вы умеете читать код на другом языке, вы сможете следовать за курсом, а Claude Code объяснит то, что вам незнакомо. Опыт работы с Claude Code не требуется.

Что вам понадобится

Ноутбук с Node.js 20.19 или новее, git и GitHub CLI. Учётная запись Claude с доступом к Claude Code: подойдёт Pro, более высокий план оставит больше пространства для задачи с командой агентов. Учётная запись GitHub. Полный чеклист настройки ждёт вас на странице воркшопа после регистрации.

Белый пояс: основы

Вы узнаете, что такое модель, что делает оболочка вокруг неё и как удерживать разговор в нужном русле.

1. Как работает модель. Tokens, вероятности, отсутствие памяти и ограниченное окно контекста: что такое языковая модель, почему она гадает и почему Claude Code показывает ей файлы.
2. Оболочка и ваш первый разговор. Что Claude Code добавляет вокруг модели: цикл, prompt, tools и permissions. Затем вы запускаете его в проекте и задаёте вопрос о файле.
   Задание: Настройте Claude Code и задайте свой первый вопрос.

Синий пояс: сборка CLASH

Вы переходите от спецификации к работающему приложению, по одному маленькому шагу за раз.

3. Планируйте до начала сборки. Напишите краткое описание с целью, правилами и финишной чертой, затем используйте режим plan, чтобы проверить изменение, которое трудно отменить, прежде чем Claude запишет хотя бы один файл.
   Задание: Подготовьте каркас приложения и спланируйте его модель данных.
4. Маленькие шаги и момент безопасности. Создавайте приложение маленькими шагами, которые можно проверить, отмените один из них с помощью /rewind, следите за окном контекста и поймите, почему каждому Server Action нужна собственная проверка владения.
   Задание: Постройте login и clash-события маленькими шагами.
5. Пусть Claude увидит результат. Повторно используйте шаблон, указав на него, дайте Claude ошибку или живую страницу вместо описания бага и добавьте quality gates в CLAUDE.md.
   Задание: Создайте venues, карту и notifications.
6. Параллельные задачи, память и проверка. Объедините независимые задачи в одном brief, запускайте работу в фоне, сохраните правило в memory, просмотрите собственный diff как будто вы видите его впервые и выполните выпуск через Claude.
   Задание: Завершите приложение, проверьте его и выпустите.

Коричневый пояс: управление контекстом

Вы решаете, что именно знает Claude, когда он это загружает и кто проверяет работу.

7. Контекст и CLAUDE.md. Используйте /context, напишите CLAUDE.md на основе шести реальных правил CLASH и проверьте план в режиме plan до любых изменений кода.
   Задание: Напишите CLAUDE.md на основе реальных правил и проверьте план.
8. Skills и плагины. Напишите skill для рецепта, который вы повторяете, проверьте, сколько skills стоят в контексте, и упакуйте его как plugin, которым можно делиться.
   Задание: Напишите skill clash-feature и выпустите избранные venues с его помощью.
9. Subagents для аудитов. Передайте аудит subagent только для чтения, чтобы ваш собственный контекст почти не изменился, и научитесь отличать свежий subagent от fork.
   Задание: Проведите аудит Server Actions с помощью subagent только для чтения.
10. От истории к спецификации. Превратите расплывчатую историю в согласованную спецификацию с помощью Example Mapping, запущенного как skill, который сначала проводит с вами интервью, а затем делает черновик.
    Задание: Создайте skill discover и сохраните согласованную спецификацию.
11. Правила, ограниченные путями. Ограничьте правило проекта для app/actions/** с помощью paths: frontmatter и проверьте в /context, что оно загружается только при чтении совпадающего пути.
    Задание: Напишите правило с ограничением по пути для Server Actions.

Чёрный пояс: оркестрация и отпускание контроля

Вы добавляете тесты, команды, hooks и браузер как средства проверки, а затем осознанно отходите в сторону.

12. Внутренний цикл, управляемый тестами. Ведите код от сохранённой спецификации по одному правилу за раз и упакуйте цикл red-green-refactor как skill, который сам себя останавливает.
    Задание: Реализуйте правила вместимости с помощью TDD skill.
13. Команды агентов и динамические workflows. Опишите команду агентов и динамический workflow простыми словами, прочитайте сгенерированный script и выберите правильную стратегию для задачи.
    Задание: Запустите аудит владения как команду и как workflow.
14. Hooks и безопасность. Превратите повторяющееся правило в hook, который блокирует, предупреждает или удерживает ход открытым, и узнайте, где заканчивается доступ Claude к вашим файлам.
    Задание: Создайте четыре Claude Code hooks.
15. Браузер замыкает цикл. Позвольте Claude управлять реальным браузером через MCP, напишите тест после того, как сценарий заработает, и докажите исправление измеримым сравнением до и после.
    Задание: Протестируйте сценарий присоединения и исправьте payload avatar.
16. Worktrees, batch и CI. Запускайте агентов параллельно в отдельных worktrees, понимайте, когда подходит /batch, и выполняйте тот же аудит в CI для каждого pull request.
    Задание: Запустите два worktrees и проверяйте каждый pull request.
17. Agent SDK. Запустите цикл агента Claude Code внутри собственной программы с tools только для чтения, hook и ограничением по числу ходов.
    Задание: Разместите цикл агента в собственной программе.
18. Capstone. Выпустите одну возможность в эталонный CLASH как pull request, используя вместе все инструменты из воркшопа.
    Задание: Выпустите одну возможность с использованием всех инструментов воркшопа.
19. Никого за клавиатурой. Настройте стиль вывода, ограничьте запуск с помощью /goal, зациклите проверку, запустите аудит в фоне и посмотрите на облачную рутину.
    Задание: Запустите Claude Code без человека за клавиатурой.
20. Создайте собственный MCP server. Спроектируйте MCP server с четырьмя tools поверх базы данных CLASH, избирательно доверьте ему доступ и вызывайте его из второго приложения.
    Задание: Спроектируйте MCP server для CLASH.