Claude Code: Up and Running — конспект книги

Claude Code: Up and Running: Harness the Power of Agentic Coding — книга Ken Kousen (O’Reilly). Она о том, как меняется работа разработчика, когда в терминале работает агент, который сам читает код, правит файлы и запускает команды. Сейчас книга вышла в формате Early Release: автор публикует главы по мере написания, а первое полное издание запланировано на ноябрь 2026 года. Пока доступны 4 главы из 12, и наш конспект охватывает все четыре.

Это подробный пересказ на русском, а не перевод. За полным текстом идите в оригинал.

📥 Скачать конспект в EPUB — для телефона и электронной книги.

Как читать карту. Цветные блоки — главы, которые уже вышли: они идут от идеи Agent-Driven Development к первому приложению, к хорошим prompt и к тестам. Серые блоки — следующие главы из черновика оглавления. С каждой главой проект растёт, а требования к дисциплине становятся строже, но названия глав ещё могут измениться.

О чём книга простыми словами

Это не справочник по командам Claude Code: документация обновляется быстрее любой книги. Автор пишет о другом: как меняется сама работа, когда агент может читать, менять и проверять проект. Агент пишет код очень быстро, поэтому легко решить, что любая задача решается одним prompt. Автор считает наоборот: чем сильнее агент, тем важнее оценка разработчика: годится ли результат.

Для этого он вводит Agent-Driven Development (AgDD). В этом подходе агент делает production-работу, а человек задаёт направление, условия успеха и проверку, а затем решает, хорош ли результат. Книга пригодится тем, кто уже умеет писать код и хочет понять, как работать с агентом в настоящем проекте.

Главная модель книги — три масштаба проекта. Самый маленький из них, doghouse, — это проект на выходные, где хватает vibe coding. Следующий, cabin, тоже скромный, но от него уже зависят люди, поэтому ему нужны тесты, границы и память проекта. А skyscraper — это большая система с командой, CI/CD и ревью безопасности. Опасно смешивать режимы: doghouse с процессами skyscraper не выйдет никогда, а skyscraper, собранный как doghouse, дорого ломается.

Что нужно знать заранее

• Программирование. Нужно уметь читать код. Примеры написаны на JavaScript, но знать его глубоко не нужно: агент сам объясняет незнакомый синтаксис.
• Терминал и git. Если с ними трудно, начните с практики по командной строке и по git.
• Тесты и структура проекта на базовом уровне: что такое unit test и зачем делить код на модули.
• Опыт с агентами не нужен. Короткое введение есть на странице Claude Code 101. Как устроены сами LLM, объясняет конспект AI Engineering.

Зачем читать

• Чтобы понять, что остаётся за человеком, когда код пишет агент.
• Чтобы выбирать дисциплину по ставкам проекта, а не по числу строк кода.
• Чтобы ставить агенту задачу как заявку на работу: результат, условие успеха, файлы и границы.
• Чтобы знать главные приёмы Claude Code: plan mode, уровень усилий (effort), headless mode, output style.
• Чтобы превратить демо в проект с тестами и CLAUDE.md, который переживёт конец сессии.
• Чтобы беречь context window и понимать, почему агент «забывает» детали.

Как устроена книга

В черновике оглавления 12 глав. Они идут по масштабам проекта: от маленького к большому.

Часть	Главы	О чём
Doghouse (вышли)	1–4	Идея Agent-Driven Development, установка, первое приложение, разговор с агентом, тесты и память проекта
Cabin (ещё не вышла)	5	Права, безопасность и границы доверия на примере веб-приложения на Python
Skyscraper (ещё не вышли)	6–12	Skills и hooks, subagent и agent teams, чужой код, MCP, путь от prompt до pull request, ревью и отладка, другие инструменты

Книга нарочно накопительная. Решение, которое в doghouse выглядит лишним, в cabin становится нужным, а в skyscraper — обязательным. Через главы 2–4 проходит один пример: маленькое приложение lyrics-trainer для заучивания текста песни. Оно начинается с одного HTML-файла и к главе 4 получает тесты и CLAUDE.md. Конспект обновим, когда выйдут новые главы.

Главные идеи

Идея	Глава
Агент делает работу, а человек отвечает за направление, проверку и оценку	1
Дисциплину задают ставки проекта: doghouse, cabin, skyscraper	1
Claude Code — это harness вокруг модели: контекст, инструменты, права и цикл запроса	1
Чтение агент делает сам, а запись и shell-команды ждут разрешения	2
Prompt — это заявка на работу с условием успеха, а не поисковый запрос	3
Сначала спросите и дайте агенту задать вопросы, потом просите менять код	3
Запросы к модели не помнят друг друга, поэтому история съедает context window	3
Демо проверяет приложение один раз, а тесты — каждый раз	4
Память — это контекст, а не enforcement, и контекст — это бюджет	4

Как читать

• Новичок: читайте по порядку и повторяйте шаги в своём терминале. Автор так и советует: книга накопительная.
• Analytics engineer: главное — глава 3 о том, как ставить задачу агенту, и глава 4 о CLAUDE.md. Эти приёмы сразу пригодятся в проекте dbt.
• Дата-инженер: прочтите главу 1 о масштабах проекта, затем главы 3 и 4. Тесты, тестируемое ядро и бюджет контекста напрямую относятся к pipeline.
• Руководитель: глава 1 целиком. Она объясняет, что меняется в роли разработчика и почему дисциплину выбирают по ставкам проекта.

Как работать с практикой

Практика здесь — не SQL, а работа с Claude Code и небольшой код к главам.

• Prompt-ы и команды даны на страницах как текст. Чтобы их запустить, нужны установленный Claude Code и подписка. Ответы агента у вас будут другими: модель недетерминированная.
• Код к главам лежит в scripts/claude-code-code. Там есть lyrics-trainer из глав 2 и 4, скрипт statusline и пример на Python о том, что модель не помнит прошлые запросы.
• Платные API не нужны: вместо Anthropic API в примере стоит модель-заглушка. Тесты главы 4 запускаются командой npm test в папке ch04_lyrics_trainer.

Разбор по главам

Глава	О чём
1. Подъём Agent-Driven Development	Что меняется в разработке, когда в проекте работает агент, и как выбрать дисциплину по масштабу проекта
2. Начало работы	Как установить Claude Code, войти, провести первую сессию и собрать первый doghouse
3. Как говорить с Claude Code	Как ставить задачу агенту и какие приёмы помогают: уточняющий проход, plan mode, effort, output style
4. Когда vibe coding недостаточно	Как превратить демо в cabin: тесты, рефакторинг, CLAUDE.md, auto memory и бюджет контекста

Следующая: Подъём Agent-Driven Development.