Claude Code — это ИИ, который живёт в терминале и читает и правит ваш репозиторий напрямую. Вставить код в окно браузерного чата, а потом скопировать ответ обратно в редактор — этот круг исчезает.

В этой главе мы строим ментальную модель, на которой держатся все шесть оставшихся глав. Если пропустить её, в дальнейшем так и не станет понятно, почему всё устроено именно так.

Начнём с места на карте: где именно работает этот инструмент

Инструменты, которые дают ИИ писать код, делятся на три группы по тому, где они запускаются. Claude Code относится к первой.

TYPE 1
CLI-агенты

Работают в терминале и трогают файлы напрямую. Claude Code, Codex CLI и подобные. Сильны там, где нужно взять на себя целый кусок работы.

TYPE 2
ИИ-редакторы

Встроены в редактор и подсказывают прямо рядом с тем, что вы печатаете. Cursor, GitHub Copilot и подобные. Сильны в режиме писать и сразу видеть.

TYPE 3
Облачные конструкторы

Всё происходит в браузере, оттуда же можно и опубликовать. v0, Bolt, Lovable и подобные. Сильны тем, что не требуют настройки окружения.

Само сравнение трёх типов разобрано в главе 1 курса по ИИ-программированию. Этот курс сужается до первого типа и идёт вглубь.

Кстати, Claude Code не привязан к одному лишь терминалу. То же самое доступно как расширение для VS Code и JetBrains, как настольное приложение и из браузера. Но его логика родом из терминала, и, поняв её, вы не растеряетесь ни в одной из остальных точек входа.

Главное отличие от чат-инструментов

«Claude в браузере тоже пишет код — так в чём разница?» Этот вопрос возникает первым. Разница не в уме, а в длине рук.

Чат (Claude в браузере)

Видит только то, что вы вставили. Отдаёт текст. Применяете его вы. Если правка задевает 10 файлов, это 10 вставок и 10 переносов обратно.

Агент (Claude Code)

Сам ищет и читает. Отдаёт диф. Запускает тесты, а если они падают — правит и запускает снова. Эти 10 файлов он находит сам.

Разница проявляется там, где в работу входит «разобраться». «Найди все места, откуда вызывается эта функция, и почини их» в чате означает, что искать будете вы. Агент запускает поиск сам.

Обратная сторона: чем длиннее руки, тем шире ущерб от ошибки. Именно поэтому разрешения нужно проектировать (глава 5). «Умный» не значит «безопасный».

Цикл агента: сбор → действие → проверка

Пока Claude Code работает, внутри крутится один и тот же цикл.

STEP 1
Собрать контекст

Ищет файлы, читает их, при необходимости запускает поиск. Именно то, что вы даёте ему прочитать, определяет результат.

STEP 2
Действовать

Переписывает файлы и выполняет команды. Именно здесь стоит ворота разрешений.

STEP 3
Проверить результат

Читает вывод тестов и проверки типов. Если они упали, возвращается к STEP 1.

Важно само наличие STEP 3. Чат заканчивает на «скорее всего, так». Агент может запустить собственный результат и убедиться. Возможность править до тех пор, пока тесты не пройдут, берётся именно из этого цикла.

Верно и обратное: на задачах, которые нельзя проверить, это преимущество исчезает. У «наведи порядок в этом коде» нет определения успеха, поэтому цикл крутится вхолостую. Приём из главы 3 — сначала дать способ проверки — растёт отсюда.

Инструменты и разрешения: что он может и что можно остановить

То, что Claude Code способен сделать, задано набором выданных ему «инструментов». Прочитать файл, записать файл, выполнить команду, найти — каждое из этого отдельный инструмент.

И при каждом вызове инструмента срабатывает проверка разрешений. По умолчанию он спрашивает вашего согласия всякий раз, когда переписывает файл или запускает команду. Есть настройки, которые пропускают согласование, и о том, что с ними надо иметь в виду, — глава 5.

Вы: «Почини тесты вокруг аутентификации» ↓ [ПОИСК] найти файлы, связанные с аутентификацией ← чтение. по умолчанию без подтверждения ↓ [ЧТЕНИЕ] прочитать auth.test.ts ← чтение ↓ [ПРАВКА] переписать auth.test.ts ← запись. вот здесь придёт запрос ↓ [ЗАПУСК] выполнить npm test ← выполнение. и здесь тоже запрос ↓ прочитать ошибку и снова к [ПРАВКА]

Когда этот ход виден, понятно, почему он остановился именно там. Он не застрял. Он упёрся в ворота разрешений.

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

У того, сколько Claude Code способен «держать в голове» за раз, есть потолок. Этот потолок и есть контекстное окно. Чем дольше идёт разговор и чем больше файлов прочитано, тем полнее оно становится.

По мере заполнения происходят две вещи.

Ответы становятся вялыми

На каждом шаге перечитывается огромная история, поэтому всё замедляется и дорожает. Это напрямую связано с разговором о стоимости в главе 7.

Начало забывается

Условия, заданные в самом начале, вытесняются. «Я же вам это говорил» обычно про это.

Лекарство — свернуть разговор: либо сжать его в резюме, либо оборвать и начать заново. Понять, когда именно сворачивать, — вопрос суждения, и разбор критериев есть в статье Стоит ли запускать /compact вручную. Практические шаги — в главе 3.

Для чего подходит и для чего нет

Очертания инструмента становятся видны, когда узнаёшь, что ему даётся плохо.

Подходит

Правки, растянутые на несколько файлов / разбор существующего кода / повторы до тех пор, пока тесты не пройдут / рутинные миграции / поиск причины по тексту ошибки

Не подходит

Работа без определения правильного / области, которые нельзя запустить и проверить / деловые решения, которые знаете только вы / правка в одну строку (круг согласований обойдётся дороже)

Сторона «не подходит» — не про способности. Это про устройство: цикл проверки не проворачивается. Поэтому переход на более умную модель тут ничего не решает.

Карта этого курса

Вот как расположены оставшиеся шесть глав. По умолчанию читать стоит по порядку, но если вы уже застряли, начать с главы 4 вполне допустимо.

2. Установка и первый час

Поставить, подключить и довести до конца первое указание.

3. Ежедневный рабочий поток

Поставить работу на рельсы «разведка → план → реализация → коммит».

4. Как выбраться из тупика

Порядок действий, ведущий от симптома вниз к причине.

5. Разрешения и безопасность

Спроектировать, сколько отдавать и где ставить стоп.

6. Как его расширять

Когда браться за CLAUDE.md, hooks, subagents и MCP.

7. Стоимость и лимиты

Эксплуатационные тонкости для долгой работы.

Есть и официальная обучающая площадка. Anthropic держит бесплатную платформу Claude Academy, и там есть курс по Claude Code. Наш курс её не заменяет. Он смещён в сторону объяснений на русском языке и разбора, выстроенного от реальных случаев, где люди застревали. Пользоваться обоими должно быть быстрее.

Итоги

  • Claude Code — инструмент агентного типа, который работает в терминале и читает и правит репозиторий напрямую
  • Отрыв от чат-инструментов не в уме, а в длине рук. Он ищет сам, отдаёт дифы и запускает, чтобы проверить
  • Внутри — цикл сбор → действие → проверка. Благодаря STEP 3 он может править до тех пор, пока тесты не пройдут
  • Возможности заданы набором инструментов, и каждый вызов инструмента проходит через ворота разрешений
  • Когда контекстное окно заполняется, он вялеет и забывает начало. Нужно решать, когда сворачивать
  • Плохо подходят задачи, где цикл проверки не проворачивается. Смена модели этого не лечит

К этому моменту должно быть понятно, что за инструмент Claude Code. Дальше мы его запускаем. Переходите к главе 2 «Установка и первый час».