Claude Code: Up and Running, глава 3: Как говорить с Claude Code
Главная мысль: Claude Code — это не окно поиска, а коллега внутри проекта. Поэтому задачу ему ставят как заявку на работу: какой нужен результат, что значит «готово» и какие есть границы. Перед правками стоит дать агенту задать вопросы и показать план.
О чём глава
Заголовок раздела «О чём глава»Во второй главе мы запустили Claude Code, а эта глава учит получать от него хорошую работу. В отличие от чата Claude, он читает файлы проекта, запускает команды и меняет код, поэтому автор сравнивает его с коллегой.
Темы: prompt и условие успеха, уточняющий проход, @-ссылки, slash-команды, уровень усилий (effort), вызовы инструментов, headless mode, сессии, plan mode, output style, context window и практика на lyrics-trainer.

Схема собирает советы главы в один порядок: сначала разобраться в задаче вместе с агентом, потом просить его менять код.
Prompt как заявка на работу
Заголовок раздела «Prompt как заявка на работу»Короткие вопросы вроде «Что делает этот проект?» хороши для знакомства с кодом. Но поручить работу — это другое. Размытая задача «fix this bug» оставляет агенту слишком много догадок, поэтому автор советует становиться точнее, как только вы просите что-то изменить. Даже простой вопрос «Какие варианты исправления ты предлагаешь?» вместо приказа заметно улучшает ответ.
Пишите prompt как письмо коллеге, который сейчас возьмётся за работу: контекст, хороший результат, ограничения и то, чего вы сами не знаете. Сравните (наш пример из мира данных):
почини багМодель @models/marts/orders_daily.sql даёт дубли: на 2026-11-01 две строкивместо одной. Нужна одна строка на дату (grain — день). Дедупликация в другихмоделях сделана через qualify, пример — @models/marts/customers.sql.Сделай так же. Другие модели не трогай.Второй вариант лучше не из-за длины: в нём есть симптом, нужное поведение, место в коде, стиль проекта и границы. Знак @ подтягивает файлы, и агент не тратит токены на поиск. Поэтому длинный prompt ещё и дешевле: размытая задача ведёт к лишним кругам разведки, а в главе 12 автор покажет, что токены уходят именно туда.
Условие успеха
Заголовок раздела «Условие успеха»Агент должен знать, что значит «готово»: маршрут возвращает 400, тест проходит, файл не тронут, у миграции есть путь отката. Условие описывает результат, а способ остаётся за агентом. Можно заранее сказать, что делать, если в задаче не хватает данных, чтобы выбрать между вариантами:
Если есть несколько разумных подходов, остановись и дай мне выбрать.Если текущее поведение неоднозначно, спроси до правок.Так агент получает право указать на неясность, а не угадывать путь, который вы не планировали.
Правило автора: с хорошим prompt внимательный коллега может начать работу или задать уточняющие вопросы. Если вопросов много, добавьте контекст. Если коллеге не нужно ничего решать самому, проверьте, нет ли лишней детализации — указаний, как писать код, вместо описания результата. Код по таким указаниям выполняет prompt буквально, но может не достичь цели.
Два приёма из руководства Anthropic помогают ограничениям работать:
| Приём | Слабо | Сильнее |
|---|---|---|
| Говорите, что нужно, а не что запрещено | «Не клади логику в обработчик» | «Держи обработчик тонким, логику вынеси в сервис» |
| Объясняйте причину | «Держи обработчик тонким» | «…чтобы тестировать логику без веб-слоя» |
Запрет можно выполнить и всё равно промахнуться. А зная причину, агент будет решать в том же духе и там, где prompt ничего не говорит.
Оговорка о новых моделях: Opus 4.8 понимает указания буквально и сам не переносит правку на другие случаи. Поэтому объём работы называйте явно: «во всех обработчиках, не только в этом».
Уточняющий проход
Заголовок раздела «Уточняющий проход»Спросить (ask) — когда цель — понять: «Где хранится состояние авторизации?». Попросить (request) — когда цель — действие: «Добавь проверку прав в эти маршруты». Новички просят слишком рано. Держите эти шаги в разных prompt: иначе вы получите уверенную правку, построенную на объяснении, которое не успели проверить. Если объяснение было неверным, правка тоже неверна.
Уточняющий проход (clarification pass) развивает ту же мысль. Перед заметной правкой дайте агенту задать встречные вопросы:
Есть ли у тебя вопросы ко мне?Я что-то упускаю?Какие варианты я не рассмотрел?Первый вопрос снимает неясность у агента, остальные добавляют забытый контекст и варианты. Если агент отвечает, что вопросов нет, просто идите дальше. Для «отформатируй файл» проход не нужен, а для «перенеси приложение с SQLite на PostgreSQL» нужен.
«Объясни мне как скептику»
Заголовок раздела ««Объясни мне как скептику»»«Объясни как пятилетнему» помогает в новой области. Но AI-инструменты, по словам автора, похожи на малышей, которые хотят вам понравиться. Если агент слишком легко соглашается, просите не более простое, а более обоснованное объяснение: «Объясни как скептику», «…так, будто мне защищать это перед недоверчивым руководителем», «…компромиссы как скептичный тех-лид». Это помогает оценить план и не поддаться излишней уверенности модели. Можно и прямо попросить доказать противоположное.
Назовите нужные файлы
Заголовок раздела «Назовите нужные файлы»Прямое указание файлов экономит токены на поиске. @-ссылка на файл подтягивает его в разговор и помечает как важный. После @ Claude Code сам предлагает пути и сужает список с каждой буквой.
Посмотри @models/staging/stg_orders.sql и @models/marts/orders_daily.sql.Дубли появляются после join с payments. Объясни самое маленькое исправлениедо правок.Найденный файл агент помнит до конца сессии, поэтому повторять @ не нужно.
Slash-команды без каталога
Заголовок раздела «Slash-команды без каталога»Команд много, и они меняются, поэтому полного списка в книге нет. Самая полезная — /help, а один символ / покажет все команды и skill сессии. Команды делятся на четыре группы:
| Группа | Откуда | Где в книге |
|---|---|---|
| Встроенные | /clear, /compact, /context, /goal, /help, /mcp, /plan, /resume | эта глава |
На основе skill | Ваши workflows. Старые свои команды из .claude/commands/ переносят в skill | глава 6 |
Из plugin | Plugin упаковывает skill, команды, MCP server и hooks | глава 7 |
| Из MCP | Команды от внешних систем | глава 9 |
Сразу полезны три встроенные команды: /clear начинает новый разговор, /compact сжимает длинный разговор в сводку, а /context показывает, на что уходит context window (подробно — в главе 4). В большом репозитории называйте нужные папки, вызывайте /clear при смене задачи, а /compact — с инструкцией, что сохранить:
/compact Сохрани текст падающего теста, имя текущей ветки, решение держатьхранение в src/storage.js и следующую команду для тестов.Ловушка: /focus не значит «читай только эти папки», а переключает вид экрана. Чтобы сузить работу, называйте пути в prompt или ограничьте доступ к файлам.
Ещё команды, которые выделяет автор:
/btw— вопрос в сторону, который не сбивает задачу («Почему ты выбрал эту библиотеку?»). Если побочный вопрос перерос в обсуждение,/branchвыносит его в отдельный разговор. Автор очень любит/btw./code-review— бывшая/simplify: проверяет последние изменения, ей можно передать уровень усилий. Полезна, когда всё заработало, но результат ещё не принят./copy— копирует ответ в буфер без мусора от переносов терминала./goal— записывает цель сессии, к ней книга вернётся позже./statusline— настраивает строку внизу терминала, а/usageпоказывает расход.
Уровень усилий под задачу
Заголовок раздела «Уровень усилий под задачу»Уровень усилий (effort) бывает low, medium, high, xhigh, max и auto, а ultracode — это xhigh плюс автоматическая оркестрация workflows. Чем выше уровень, тем дольше модель рассуждает и чаще вызывает инструменты. Чем ниже, тем быстрее и дешевле ответ. Anthropic советует xhigh для кода и агентов, не ниже high там, где нужна оценка, и medium или low для мелких и срочных задач.

/effort без аргумента показывает ползунок, на схеме он нарисован как шкала. Слишком низкий и слишком высокий уровни ошибаются по-разному. Мало усилий на трудной задаче — и агент сужает её и рано бросает. Много усилий на простой — и он обсуждает правку одной строки как архитектурный обзор, тратит токены и усложняет код. Автор советует прогнать один запрос на low и high и сравнить. Поведение effort может меняться от версии к версии, поэтому проверяйте его в своей.
Что считается инструментом
Заголовок раздела «Что считается инструментом»Function calling и tool support — это одно и то же: модель вызывает функцию вне себя. Вызов инструмента (tool use) в Claude Code — это не только Git или Docker, но и чтение или запись файла, список файлов, shell-команда, MCP-инструмент, загрузка веб-страницы. Каждый раз агент просит harness сделать что-то в рабочей среде и читает результат.

Это важно для прав доступа (глава 5) и во время работы агента. Долгая задача — это цикл, поэтому указание можно дописать на ходу: агент подхватит его перед следующим вызовом инструмента. В desktop-приложении это называется steer.
Headless mode
Заголовок раздела «Headless mode»Headless mode — это запуск без диалога: агент получает prompt, печатает результат и выходит. В CLI это флаг -p (--print):
claude -p "объясни эту функцию"git diff -- models | claude -p "найди вероятные ошибки в этом diff"claude -c -p "проверь, исправила ли последняя правка ошибку типов"Режим нужен, когда Claude Code — часть скрипта или процесса. Автор так проверяет код, написанный Codex или Antigravity. Флаг -c продолжает последний разговор, а глава 10 применит приём в pull request.
Как продолжить разговор
Заголовок раздела «Как продолжить разговор»Сессия — это сохранённый разговор, привязанный к папке проекта, вместе с вызовами инструментов:
claude -c # последний разговор в этой папкеclaude -r # выбрать разговор из спискаclaude --resume <session-id> # по IDclaude -n "orders-dedup" # новая сессия с именемclaude --resume "orders-dedup" # вернуться по имениID сессий случайные, поэтому имя помогает, когда в репозитории идут несколько задач. /rename меняет имя, а /resume внутри Claude Code переключает на другой сохранённый разговор без выхода из программы. Внимание: claude "текст" без флагов открывает обычный диалог с этим текстом как первым prompt. Двойной Esc открывает список checkpoint для отката, и это лучше, чем уговаривать агента выбраться из неверного пути.
Plan mode
Заголовок раздела «Plan mode»Ранние агенты рвались сразу править файлы. Plan mode не даёт перейти к правкам без вашего согласия: агент предлагает файлы, шаги, команды и риски, а диск не меняется, пока вы не примете план. Включить режим можно двойным Shift+Tab, командой /plan или просьбой «Давай составим план, прежде чем править».
Режим окупается при правках в нескольких файлах, в незнакомом коде, при миграциях и большом рефакторинге, а также там, где неверное понимание даст правдоподобный, но ошибочный код. Такие изменения лучше вести в отдельной git-ветке.
Спросите о других подходах
Заголовок раздела «Спросите о других подходах»Допустим, план предлагает сменить тип колонки через ALTER TABLE ... USING. Спросите: «Какие ещё есть подходы и когда каждый уместен?». В книге агент отвечает, что подходы различаются временем блокировки таблицы и возможностью отката.
| Подход | Как работает | Когда уместен |
|---|---|---|
ALTER TABLE на месте | Эксклюзивная блокировка, таблица переписывается | Маленькая таблица или окно обслуживания |
expand-contract | Новая колонка, backfill порциями, запись в обе колонки, переключение чтения, удаление старой | Большая таблица под нагрузкой. Откат возможен на любом шаге, но нужно несколько релизов |
Теневая таблица (shadow table) | Создать новую таблицу, скопировать данные, переименовать | Много изменений сразу |
Output style
Заголовок раздела «Output style»Output style — это системное сообщение для сессии: оно задаёт тон, роль и формат ответов, но не меняет проект и принятые решения. Встроенные стили:
| Стиль | Поведение |
|---|---|
| Default | Обычный инженерный режим |
| Proactive | Сразу действует, реже прерывает, предпочитает действие планированию |
| Explanatory | Больше объясняет, почему код написан так |
| Learning | Совместная работа: может попросить вас написать небольшие куски самому |
Стиль выбирают в /config (пункт Output style). Свой стиль — это Markdown-файл в ~/.claude/output-styles или в .claude/output-styles проекта. Главное для кода — флаг keep-coding-instructions: true: без него свой стиль заменит встроенные инструкции Claude Code по разработке.
Стиль «скептичный старший инженер»
Заголовок раздела «Стиль «скептичный старший инженер»»Идею «объясни как скептику» можно закрепить в стиле. Он не ворчит ради забавы, а оспаривает допущения, просит доказательств и отличает «работает» от «готово». Наша версия для дата-инженера (файл):
---name: skeptical-data-engineerdescription: Спорит с допущениями, просит доказательства и называет риски, но пишет код как обычноkeep-coding-instructions: true---
Веди себя как скептичный старший дата-инженер, который проверяет чужую работу.
Позиция по умолчанию:
* Оспаривай рискованные допущения, прежде чем их принять.* Различай «работает у меня» и «можно на это опираться».* Проси доказательства, если вывод зависит от тестов, логов, backfill, миграций, прав доступа или поведения в production.* Называй вероятные сбои и самую маленькую проверку, которая их покажет.* Если план хороший, скажи это коротко и объясни почему.
Когда предлагаешь или проверяешь код:
* Оцени, что сломается, если изменение неверно.* Проверь grain таблиц, идемпотентность и повторный запуск.* Ищи пропущенные тесты, путь отката и скрытые зависимости.* Отдели блокеры от пожеланий.* В конце скажи, что нужно, чтобы ты спокойно выкатил это в production.Настройка действует с новой сессии. Автор берёт такой стиль для обзора дизайна, рискованной миграции или когда агент объявил, что всё работает. Для обычной работы хорош Default.
Разговор и context window
Заголовок раздела «Разговор и context window»Запрос к API не помнит прошлых запросов (stateless): скажите модели «Меня зовут Иниго Монтойя», и следующим запросом она имени не назовёт. В книге это показано на Python с Anthropic API, а наша версия заменяет API бесплатной заглушкой:
for p in prompts: history.append({"role": "user", "content": p}) answer = fake_model(history) # модель получает всю историю history.append({"role": "assistant", "content": answer})Полный скрипт: ch03_stateless.py. Его настоящий вывод:
Без истории (как голый API): 'My name is Inigo Montoya.' -> 'Nice to meet you!' 'What is my name?' -> "I don't know your name."С историей (как Claude Code): 'My name is Inigo Montoya.' -> 'Nice to meet you!' (отправлено слов: 5) 'What is my name?' -> 'Your name is Inigo Montoya.' (отправлено слов: 13)С настоящим API (нужен платный API key, блок не запускали) каждый вызов ask — новый запрос без истории:
# pip install anthropic python-dotenv; ключ в .env: ANTHROPIC_API_KEY=...import osfrom anthropic import Anthropicfrom dotenv import load_dotenv
load_dotenv()client = Anthropic()MODEL = os.getenv("ANTHROPIC_MODEL", "claude-fable-5")
def ask(prompt: str) -> str: response = client.messages.create( model=MODEL, max_tokens=200, messages=[{"role": "user", "content": prompt}], ) return response.content[0].text
print(ask("My name is Inigo Montoya."))print(ask("What is my name?")) # модель не знает имени
Claude Code сам добавляет всю историю к каждому новому запросу. Поэтому каждый запрос длиннее и дороже прошлого, зато разговор связный. Предел — context window: у старых моделей около 100–200 тысяч токенов, у новых — до миллиона и больше, хотя спорят, хорошо ли модель находит нужное после первых сотен тысяч. Ограничение окна — одна из причин появления RAG: в контекст кладут только нужные куски документов.
У предела Claude Code сам включает сжатие контекста. Кто хочет больше контроля, вызывает /clear после важного решения или /compact после задачи. Автор думает, что однажды о пределе забудут, но пока за ним нужно следить.
Практика: lyrics-trainer запоминает строку
Заголовок раздела «Практика: lyrics-trainer запоминает строку»Lyrics-trainer — учебное приложение книги из одного HTML-файла: оно показывает текст строка за строкой. Автор хотел учить текст с телефона, и возврат на первую строку при каждой перезагрузке мешал. Prompt из книги в нашем пересказе:
Добавь в lyrics-trainer сохранение позиции. Когда пользователь переходит нановую строку, сохраняй её индекс в localStorage. При загрузке страницы читайlocalStorage и продолжай с сохранённой строки, если она есть. Если индекс внедиапазона текущего текста, начинай со строки 0.
Условие успеха: после нескольких строк и перезагрузки приложение открывает ту жестроку. Испорченное или слишком большое значение безопасно ведёт к первой строке.
Сохрани структуру из одного файла. Добавь логику там, где ей место, но невыделяй модули и не добавляй шаг сборки.
Прежде чем начать: есть ли у тебя вопросы? Я что-то упускаю? Какие вариантыя не рассмотрел?Пояснение:
localStorage— это хранилище «ключ — значение» в браузере. Оно переживает перезагрузку страницы и хранит всё как строки.
Prompt описывает поведение, крайний случай, условие успеха и прямо требует сохранить простую структуру doghouse: без этого агент может начать улучшать архитектуру раньше времени. Агент сначала спросил, переходить ли с последней строки на первую. Он заметил, что значение может отсутствовать, быть не числом, дробным, отрицательным или слишком большим, и предложил во всех случаях начинать с начала. Ещё он отметил, что после замены текста старый индекс будет выглядеть верным.
Результат — функция loadIndex() вместо let currentIndex = 0 и строка localStorage.setItem(STORAGE_KEY, currentIndex) в обработчике Next. Мы проверили её в Node с Map вместо localStorage (ch03_load_index.js):
const STORAGE_KEY = "lyricsTrainer.lineIndex";
function loadIndex() { const stored = Number(localStorage.getItem(STORAGE_KEY)); if (!Number.isInteger(stored) || stored < 0 || stored >= lines.length) { return 0; } return stored;}Результат для разных значений при 14 строках:
null -> 0"5" -> 5"13" -> 13"14" -> 0"99" -> 0"-1" -> 0"2.5" -> 0"abc" -> 0В браузере нажмите Next несколько раз, запомните счётчик «Line N of 14» и перезагрузите страницу. Успех выглядит так, будто ничего не произошло, и только счётчик это подтверждает. Значение можно подменить в консоли:
localStorage.getItem("lyricsTrainer.lineIndex")localStorage.setItem("lyricsTrainer.lineIndex", "99")С "99" или "abc" страница после перезагрузки возвращается к первой строке.
Спросите о решении в коде
Заголовок раздела «Спросите о решении в коде»Почему setItem стоит прямо в обработчике, а не в функции saveState()? Агент отвечает: функция оправдана, если есть второе место вызова, нетривиальная логика или имя, которое объясняет код. У сохранения этого нет, а у загрузки есть разбор значения, проверка и возврат к первой строке. Выносить код нужно по сложности, а не ради симметрии: появится кнопка Previous — появится и saveState().
Когда функция заработала, попросите взглянуть на всё приложение:
Изменение готово. Отойди на шаг и снова посмотри на всё приложение. Найдипроблемы, которые эта правка внесла или показала: состояние, крайние случаи,устройство кода. Ничего не меняй, только опиши, что нашёл.Агент, как и разработчик, во время работы тонет в деталях, поэтому взгляд на всю картину полезен. Такой обзор шире, чем /code-review, которая смотрит только последние изменения.
Итоги главы
Заголовок раздела «Итоги главы»- Задачу Claude Code ставят как заявку коллеге, а не как поисковый запрос.
- Хороший
promptназывает результат, условие успеха, файлы и границы, но не диктует, как писать код. - Ограничение сильнее, если сказать, что нужно, и объяснить причину.
- Новые модели понимают указания буквально, поэтому объём работы называют явно.
- Сначала спрашивайте, потом просите, а перед правками дайте агенту задать вопросы.
- Просьба «объясни как скептику» борется со склонностью модели соглашаться.
- Мало
effortдаёт поверхностный ответ, а много — лишние токены и усложнение. - Любое действие агента в среде — это вызов инструмента, и между вызовами можно добавлять указания.
- Запросы к модели не помнят друг друга, а Claude Code пересылает историю, поэтому
context windowнужно беречь.
Ключевые термины
Заголовок раздела «Ключевые термины»| Термин | Значение |
|---|---|
| Условие успеха | Как понять, что задача сделана |
| Лишняя детализация | Указания, как писать код, вместо результата |
Уточняющий проход (clarification pass) | Вопросы агенту перед правками |
@-ссылка на файл | Подтягивает файл в разговор |
Уровень усилий (effort) | Сколько модель рассуждает: от low до ultracode |
Вызов инструмента (tool use) | Действие агента в среде: файл, shell, MCP |
Headless mode | Запуск без диалога через claude -p |
Plan mode | План без изменений до вашего согласия |
Output style | Манера ответов, системное сообщение |
Context window | Сколько токенов модель видит за раз |
Что это значит на практике
Заголовок раздела «Что это значит на практике»- В задаче по dbt-модели называйте
grain, файлы через@и условие успеха: «одна строка на дату, тест unique проходит». - Перед миграцией большой таблицы спросите о других подходах:
expand-contractбезопаснееALTER TABLE. - Включайте
plan modeдля правок в нескольких моделях и для backfill. - Запускайте
claude -pв CI, чтобы агент проверял diff SQL-моделей. - Скептичный стиль полезен перед выкаткой: он спросит про идемпотентность и откат.
Вопросы для самопроверки
Заголовок раздела «Вопросы для самопроверки»- Почему подробный
promptчасто дешевле короткого «почини баг»? - Чем условие успеха отличается от лишней детализации? Приведите пример каждого.
- Почему вопрос и правку лучше разносить по разным
prompt? - Когда стоит поднять уровень
effort, а когда опустить? Что идёт не так на каждом краю? - Почему указание посреди работы агент подхватывает не сразу, а перед следующим вызовом инструмента?
- Почему Claude Code помнит ваше имя, а голый API — нет, и чем за это приходится платить?
Предыдущая: Начало работы с Claude Code. Следующая: Когда vibe coding недостаточно.