Длительность
55 мин
Ты уже пользуешься AI как чатом — спросил, получил ответ, скопировал в работу. Этот модуль начинается с развилки: рядом с чатом выросла другая категория — агент, который не отвечает, а действует. Сначала разберёмся, чем они отличаются и почему это меняет твою работу, — а в конце ты напишешь свой первый CLAUDE.md и проверишь его руками.
cd и ls — этого достаточно, чтобы начать. Остальное подберёшь по ходу.Чат ты уже знаешь — это ChatGPT или Claude.ai в браузере. Пишешь вопрос — получаешь ответ. Что полезно — копируешь к себе в работу руками. Чат — это собеседник: умный, но «за стеклом». Сам в твои файлы не лезет и про твой проект ничего не знает, пока ты заново не расскажешь.
Рядом выросла вторая категория — агент. Ему даёшь задачу — и он сам действует: открывает твои файлы, правит их, запускает команды в терминале, смотрит на результат и идёт дальше. Не «подскажет, что набрать», а делает и показывает, что получилось. Это уже не собеседник, а исполнитель с руками.
Открываешь ChatGPT. Копируешь функцию. «Почини баг». Получаешь код. Вставляешь в редактор. Не работает. Копируешь ошибку обратно. Так пять раз. Контекст живёт в твоей голове, не у модели.
В папке проекта пишешь claude. Агент сам читает 7 файлов, находит баг, чинит, запускает тесты. Ты смотришь diff и говоришь «merge».
Один и тот же ты, один и тот же баг. Разница — в том, что во втором случае агент уже знал твой проект: язык, стек, твои правила. Эту постоянную память ему даёт один файл — CLAUDE.md. С него и начнём.
Дальше в модуле: как агент работает внутри, demo «до и после» на реальной группе, и твой первый CLAUDE.md — на user-уровне и в проекте — чтобы перестать каждую сессию объяснять агенту, кто ты и для кого пишешь код.
/memory, что нужные CLAUDE.md действительно подгрузились.~/.claude/CLAUDE.md (про тебя как ментора) и ./CLAUDE.md в одной учебной репе (про эту группу).Ты уже понял разницу: чат отвечает, агент действует. Теперь — как именно он действует, чтобы это не выглядело магией.
Внутри — цикл из действий, а не одна реплика. Ты пишешь задачу. Агент решает «сначала прочитаю файл» — и читает. Видит содержимое, думает дальше: «теперь правлю» — и правит. Потом сам запускает тесты. И так по кругу, пока задача не закроется или он не упрётся в вопрос к тебе.
Каждая стрелка вниз — это новый вызов модели. На больших задачах их десятки. Ты видишь это как полупрозрачный поток в TUI: Reading src/auth.py, Editing tests/test_login.py, Running pytest.
Claude Code не привязан к одному окну. Одна и та же настройка (твой CLAUDE.md) работает в терминале, в редакторе и в браузере. Выбираешь, где удобнее под задачу.
MarsCode — наш собственный инструмент той же категории, что Claude Code. Он ходит к моделям через Mars, поэтому для тебя бесплатен — баланс выдаёт школа. Тебе тут важно одно: платить за модели не надо.
В курсе учим на Claude Code — на нём всё работает «из коробки» и есть полная документация. MarsCode подключим в Модуле 5, когда будем строить свои Skills и экономить.
Codex (OpenAI) и Antigravity (Google) — то же самое, другие вендоры. В курсе их не трогаем; если ученик спросит — это такой же агент, просто от другой компании.
Кейс: ментор Зухра, точка Yunusobod, группа Python 7-9 лет, 6 детей. Открывает Claude Code в репе со стартер-проектами. Просит одно и то же. Сначала без контракта, потом — с ним.
$ cd ~/mars-lessons/python-7-9 && claude# агент стартует с чистого листа > помоги добавить ещё одну игру про математику для моих учеников Claude: Я готов помочь. Пара вопросов, чтобы понять контекст: 1. Какой возраст учеников? 2. На каком языке объяснения в комментариях? 3. Какие библиотеки разрешены? 4. Насколько подробно комментировать? 5. ООП можно или процедурный стиль? # 3 минуты пинг-понга на каждой сессии.
$ cd ~/mars-lessons/python-7-9 && claude# агент читает ./CLAUDE.md автоматом > помоги добавить ещё одну игру про математику для моих учеников Claude: Сделаю стартер «Угадай число» в стиле проекта: • pygame + random, без f-strings • переменные русско-латиницей • комментарий на каждые 2 строки • короткий заголовок «Что эта программа делает» Прочитал 01-circle.py для стиля. Создаю 06-guess-number.py. Edit: 06-guess-number.py (+38) Bash: python3 -m py_compile ✓ # 40 секунд до результата.
Вот файл, который лежит в репе Зухры. Скопируй как стартер — это один из трёх готовых шаблонов pre-build:
./CLAUDE.md · mars-lessons/python-7-9# Mars IT School — Python для группы 7-9 лет # точка Yunusobod, ментор Зухра ## Кто читает этот код - Дети 7-9 лет, четверо первый раз видят программирование. - Язык объяснений: русский. Узбекская латиница допустима в именах переменных, если это помогает (`tugma` вместо `button`). - Терминология: не использовать "функция", "класс", "цикл" без объяснения через бытовую аналогию в комментарии. ## Конвенции кода - **Каждая строка комментируется на русском.** Это не код для прода, это код для урока. - Имена переменных — простые слова или транслит (`schyot`, не `score_counter`). - Только `pygame` и `random`. Не использовать f-strings, list comprehensions, dataclasses. - Файл всегда начинается с короткого комментария «Что эта программа делает» в 1 строку. ## Workflow - Каждый файл должен запускаться через `python3 file.py` без аргументов. - Перед коммитом — `python3 -m py_compile file.py` (проверка синтаксиса). - Не редактировать `.solutions/` — там готовые решения для следующих групп.
Тот же шаблон «кто читает / конвенции / workflow» — но другая аудитория. Тимур, точка Чиланзар, второй год Python, готовит олимпиадников 12-14. Сравни с Зухриным:
./CLAUDE.md · mars-lessons/python-olymp-12-14# Mars IT School — Python олимп для группы 12-14 # точка Чиланзар, ментор Тимур ## Кто читает этот код - Дети 12-14, второй год Python, готовятся к Республиканской олимпиаде по информатике. - Язык объяснений: русский. Имена переменных — английские (олимпиада на английском, нет смысла учить иначе). - Знают: функции, циклы, словари, генераторы. НЕ знают: классы, dataclasses, async. ## Конвенции кода - Полная типизация: `def solve(n: int) -> list[int]:` — учим читать сигнатуры. - Сложные алгоритмы — обязательно `doctest` или `assert` с примером из условия задачи. - Решение должно проходить tests в `./tests/` (`pytest`). - Каждый файл начинается с docstring: задача, ограничения, сложность по времени/памяти. - НЕ использовать сторонних библиотек кроме `math`, `collections`, `itertools`, `heapq`, `bisect` — олимпиадный набор. ## Workflow - Перед коммитом — `pytest -q` (всё зелёное). - Решения в `./solutions/`, тесты в `./tests/`.
У Зухры — запрет на типизацию и list comprehensions, у Тимура — обязательная типизация. Один шаблон, два разных контракта. Третий шаблон — Шахзод, Sergeli, React/TypeScript 15-17 — лежит рядом в файле starters.md. Возьми один как образец и подгони под свою группу.
CLAUDE.md живёт на двух уровнях, и для старта тебе нужны именно эти два. Оба грузятся автоматически в начале каждой сессии — объяснять заново не нужно.
~/.claude/CLAUDE.md · один на все проекты. Кто ты, на каком языке говорить, как ты любишь работать с агентом. Пишешь один раз../CLAUDE.md в репе · возраст детей, стек, конвенции, запреты. Лежит в git — общий для команды. Самый важный файл для ментора.Есть ещё два уровня, которые сейчас можно пропустить: managed (правило для всей школы, ставит IT — у нас пока пусто) и local (./CLAUDE.local.md — личные заметки по проекту, в .gitignore). Понадобятся позже — не сегодня.
Кроме твоего CLAUDE.md агент сам записывает то, что заметил по ходу: какие команды собирают проект, где были баги, какие паттерны у тебя в коде. Команда /memory показывает все файлы памяти и даёт их открыть. Это дополнение, не замена: CLAUDE.md — что ты хочешь, чтобы он всегда знал; авто-память — что он сам понял и запомнил.
Четыре части. Сделай руками в терминале, не читай как теорию. После этого у тебя будет рабочая user+project пара CLAUDE.md и проверенный /memory.
На Mac/Linux: curl -fsSL https://claude.ai/install.sh | bash. На Windows PowerShell: irm https://claude.ai/install.ps1 | iex. Проверить: claude --version. Первый запуск попросит войти в аккаунт Anthropic — карта не нужна, для старта хватает бесплатного тарифа. Если что-то не ставится или просит оплату — пиши в чат менторов, разрулим. Это не твоя проблема.
Создай файл, скопируй шаблон ниже и подгони под себя. Это то, что Claude знает про тебя в любом проекте.
~/.claude/CLAUDE.md# О себе Я ментор Mars IT School, точка <X>, веду <стек> для возраста <Y>. Язык работы: русский. Английский для технических терминов. # Стиль работы с агентом - Объясняй мне план до того как редактировать файлы (используй plan mode когда уместно) - Если не уверен в API/библиотеке — спрашивай, не выдумывай - Когда пишешь код, который пойдёт детям — короткие строки, простые имена, комментарии на русском - Перед коммитом всегда покажи git diff, не коммить сам # Что я обычно делаю - Готовлю стартер-проекты к занятиям - Проверяю код учеников - Пишу внутренние скрипты для Mars~ 10 мин
Выбери одну учебную репу. Возьми один из трёх готовых шаблонов в starters.md (Зухра-Python-7-9, Тимур-Python-олимп-12-14, Шахзод-React-15-17) как образец — copy-paste и подгони под свою группу. Минимум три секции: «кто читает этот код», «конвенции», «workflow». Размер — до 200 строк, иначе адекватность падает.
Альтернатива — команда /init в репе: Claude Code сам пройдётся по коду и сгенерирует первичный CLAUDE.md, а ты подправишь под группу.
Запусти claude в той же папке. В сессии набери /memory — должен увидеть оба файла в списке. Если user-файл не появился — проверь путь (он именно ~/.claude/CLAUDE.md, не ~/.claude/Claude.md).
Дай простой запрос: «добавь функцию приветствия». Убедись, что агент пишет в духе CLAUDE.md (язык, стиль, запреты). Если нет — сделай /memory, открой файлы, посмотри что туда попало.
.claude/rules/ (path-scoped) или в Agent Skill (Модуль 5).
В твоём ~/.claude/CLAUDE.md написано «пиши на английском». В ./CLAUDE.md учебной репы — «пиши на русском, объясняем детям». Запускаешь claude в этой папке и просишь добавить функцию. На каком языке агент напишет комментарии?
/memory и посмотри, что загрузилось.Две недели назад ты сделал в учебной репе ./CLAUDE.md с правилом «не использовать f-strings». Открываешь репу заново, набираешь claude. Какой файл с твоими конвенциями загрузится автоматически в начале сессии?
~/.claude/CLAUDE.md — project-файл подтягивается по запросу.~/.claude/CLAUDE.md и ./CLAUDE.md — они конкатенируются в стартовый контекст сессии./memory в сессии показывает, что именно загрузилось — это первый чек если кажется, что агент «забыл» твои правила.Ты ведёшь две группы: Python 8-9 лет и React 15-17. Хочешь, чтобы агент везде говорил с тобой по-русски и знал, что ты ментор — а в Python-репе ещё и писал простой код без f-strings. Куда что положить?
~/.claude/CLAUDE.md (про тебя). «Дети 8-9, без f-strings» — в ./CLAUDE.md Python-репы (про группу).~/.claude/CLAUDE.md — так короче и не запутаешься../CLAUDE.md каждой репы — user-файл вообще не нужен._lib/claude-code-cheatsheet.md.
У тебя теперь есть постоянная подпись — агент в любом проекте Mars знает, кто ты и для кого пишешь. Следующий обязательный модуль — четвёртый (модули 2-3 идут после фидбэка): про working memory и context engineering. Что такое /compact, почему agent «тупеет» к вечеру долгой сессии, как пользоваться sub-agent'ами как способом изоляции контекста. Это модуль, ради которого курс существует.
Модули 2-3 (Delegation × NTP, Description × Knowledge) и Модуль 5 (свои Sub-agents и Agent Skills) — после пилотного фидбэка от первых менторов.