Claude Code: Up and Running, глава 2: Начало работы с Claude Code
Главная мысль: Claude Code ставится одной командой, а входить лучше по подписке. Файлы агент читает сам, но перед записью и shell-командами спрашивает разрешение.
О чём глава
Заголовок раздела «О чём глава»В главе 1 автор ввёл масштабы doghouse, cabin и skyscraper. Теперь он показывает установку, вход, первую сессию и цикл запроса, а затем создаёт с нуля первый doghouse.

Схема читается слева направо, а внизу показаны две частые проблемы.
Установка
Заголовок раздела «Установка»Автор советует native installer — родной установщик. Он сам обновляет программу в фоне. Это важно, ведь инструмент меняется очень часто:
# macOS, Linux, WSLcurl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShellirm https://claude.ai/install.ps1 | iex
# Windows CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdКоманды PowerShell и CMD нельзя путать: приглашение PS C:\ означает PowerShell. Установщик работает несколько минут и ничего не пишет на экран, так что не волнуйтесь. Затем откройте новый терминал и проверьте версию:
claude --version2.1.325 (Claude Code)Если команды нет, обычно папки ~/.local/bin нет в PATH: добавьте её в .zshrc или .bashrc. Если что-то работает не так, claude doctor проверит настройку окружения. А если инструкции устарели, автор советует попросить AI помочь с установкой.
Установить Claude Code через Homebrew, WinGet, apt, dnf и apk тоже можно, но обновлять версию придётся самим. Установка через npm осталась, но её больше не советуют по умолчанию. На Windows без WSL нужен Git for Windows, иначе Claude Code использует PowerShell вместо Bash.
При первом запуске команды claude агент просит выбрать стиль текста в терминале и спрашивает, доверяете ли вы папке, в которой он запущен. Затем он просит войти. С подпиской откроется браузер, и данные входа сохранятся локально.
Второй путь — API key от Anthropic в переменной окружения. Автор предупреждает, что это быстро становится дорого: агент снова и снова отправляет в модель большие куски кода. Весной 2026 года Anthropic объявила, что в каждую подписку войдёт некоторое число API-кредитов для такого входа. Как это будет работать на практике, пока неясно.
Обычно начинают с Pro. Max 5x даёт в 5 раз больше лимита, а Max 20x — в 20 раз. Бесплатного тарифа нет, но harness Claude Code можно запускать с открытыми моделями через Ollama. Аккаунт меняют командами /logout и /login. Длинные сессии, subagent и extended thinking расходуют лимит использования (quota) быстрее, чем обычный чат.
Первая сессия
Заголовок раздела «Первая сессия»Запускайте Claude Code из папки проекта:
cd /path/to/your/projectclaudeЭкран приветствия показывает данные сессии и недавние разговоры, а /help — список команд.
Своя statusline
Заголовок раздела «Своя statusline»Statusline — это строка внизу терминала с данными сессии. Про неё автора чаще всего спрашивают на курсах. Запустите /statusline и опишите словами, что хотите видеть:
/statusline Покажи папку, модель, ветку git и есть ли измененияClaude Code сам пишет небольшой скрипт и подключает его в ~/.claude/settings.json:
"statusLine": { "type": "command", "command": "bash ~/.claude/statusline-command.sh"}Скрипт лежит в домашней папке, поэтому работает во всех проектах. Он запускается при каждом обновлении строки, так что медленный код тормозит сессию. Ветка и модель берутся из локальных данных и почти ничего не стоят. Наш простой вариант — ch02_statusline.sh, а тест подаёт ему на вход такой же JSON, какой передаёт Claude Code:
bash scripts/claude-code-code/ch02_statusline_test.sh📁 lyrics-trainer | 🤖 Opus | 🌿 main (clean)📁 lyrics-trainer | 🤖 Opus | 🌿 main (dirty)Первый вопрос и цикл запроса
Заголовок раздела «Первый вопрос и цикл запроса»В готовом проекте начните с вопроса только на чтение: «Что делает этот проект?». Claude Code сам читает нужные файлы, и копировать код в чат не нужно. Это одно из первых отличий агента от обычного окна чата.
Каждый запрос проходит цикл запроса (request loop): Claude Code планирует шаги, читает проект и решает, что делать. Если нужно только чтение, ответ приходит сразу. Запись или shell-команда проходят через запрос разрешения (permission gate), и вы одобряете, отклоняете или меняете действие.

Шаги 5–7 справа идут только с вашего согласия. Сессия показывает, какие файлы агент читает и какие правки предлагает, поэтому циклом легко управлять. Если агент пошёл не туда, нажмите ESC: это лучше, чем потом исправлять ущерб. Подробнее о правах — в главе 5.
Спросите Claude Code об экране приветствия
Заголовок раздела «Спросите Claude Code об экране приветствия»Автор спросил агента, зачем нужны данные на экране приветствия: папка (cwd), модель, ветка git и оболочка. Ответ был такой: эта сводка показывает главные настройки, с которыми работает сессия. Если запись пошла не в ту ветку или папку, первым делом проверьте эту сводку.
Lyrics-trainer: первый doghouse
Заголовок раздела «Lyrics-trainer: первый doghouse»Автору нужно было выучить слова песни, а запоминать ему теперь трудно: в детстве он схватывал всё сразу, а сейчас нужно много повторов. Ему хватило бы крошечного инструмента, который показывает строки по одной. Это классический doghouse. Из-за авторских прав вместо песни он берёт сонет 18 Шекспира. Позже тренажёр вырастет до cabin.
Начните с пустой папки: mkdir lyrics-trainer, cd lyrics-trainer, claude. Наш вариант prompt:
Сделай одностраничное веб-приложение, чтобы учить текст по одной строке.Возьми сонет 18 Шекспира. Показывай одну строку и кнопку «Дальше».После последней строки начинай с первой.Только HTML, CSS и JavaScript: без фреймворков, сборки и зависимостей.Если хватит одного файла index.html, сделай один файл.Автор признаётся, что составил свой prompt вместе с Claude Code. Агент попросил разрешения на запись и создал один файл index.html: строки лежат в массиве, а кнопка увеличивает номер текущей строки. Наша версия (полный файл):
let pos = 0; // номер текущей строки, с нуляfunction show() { lineBox.textContent = lines[pos]; counterBox.textContent = `Строка ${pos + 1} из ${lines.length}`;}document.getElementById("next").addEventListener("click", () => { pos = (pos + 1) % lines.length; // после последней строки снова первая show();});Проверка без браузера нажимает «Дальше» 5 раз:
node scripts/claude-code-code/ch02_check_trainer.mjsСтрока 1 из 4 | Shall I compare thee to a summer's day?Строка 2 из 4 | Thou art more lovely and more temperate:Строка 3 из 4 | Rough winds do shake the darling buds of May,Строка 4 из 4 | And summer's lease hath all too short a date;Строка 1 из 4 | Shall I compare thee to a summer's day?Строка 2 из 4 | Thou art more lovely and more temperate:Страницу можно открыть, не выходя из сессии: ! запускает shell-команду, например ! open index.html на macOS. Сервер здесь не нужен, а позже автор предупредит: можно забыть, что запущенный агентом сервер всё ещё работает.
Агент сам объяснил мелочь, о которой автор не подумал бы спросить: min-height у строки не даёт кнопке прыгать. Ещё он предложил режим, где строка скрыта, пока вы не вспомните её сами, но первая версия осталась простой. Модель недетерминированная, поэтому ваш результат будет другим.
Итоги главы
Заголовок раздела «Итоги главы»Native installerобновляет Claude Code сам, поэтому автор советует его.- Команды
claude --versionиclaude doctorпоказывают, всё ли установлено верно. - Подписка обычно выгоднее
API key, ведь агент отправляет в модель много токенов. - Чтение агент делает сам, а запись и shell-команды ждут вашего разрешения.
- ESC останавливает агента сразу, и это лучше, чем исправлять ошибку потом.
- Для
doghouseпервой версии хватает одного HTML-файла.
Ключевые термины
Заголовок раздела «Ключевые термины»| Термин | Значение |
|---|---|
native installer | Установщик, который сам обновляет Claude Code |
лимит использования (quota) | Сколько работы даёт подписка |
statusline | Строка с данными сессии внизу терминала |
цикл запроса (request loop) | План, чтение, решение, ответ или изменение |
запрос разрешения (permission gate) | Пауза перед записью или shell-командой до вашего согласия |
Что это значит на практике
Заголовок раздела «Что это значит на практике»- Знакомство с репозиторием dbt начните с вопросов только на чтение: «Какие модели строят витрину заказов?».
- Выведите ветку git в
statusline, чтобы не правитьpipelineне в той ветке. - Читайте каждый запрос разрешения, особенно для команд, которые пишут в базу или облако.
Вопросы для самопроверки
Заголовок раздела «Вопросы для самопроверки»- Почему автор советует
native installer, а не пакетный менеджер? - Почему работа по
API keyбыстро становится дорогой? - Какие действия Claude Code делает без разрешения и зачем это разделение?
- Когда стоит нажать ESC?
Предыдущая: Подъём Agent-Driven Development. Следующая: Как говорить с Claude Code.