Claude Code 101: программирование с Claude

Кому подойдёт

Тем, кто уже пишет код или уверенно его читает и работает в терминале, но агента для разработки ещё не запускал. Опытным — готовый набор привычек вместо метода проб и ошибок.

Что понадобится

Терминал, git, Node.js 18 или новее и любой проект под рукой — годится учебный. Доступ платный: подписка Claude (Pro или Max) либо ключ API с балансом. Из России нужен VPN и для входа в аккаунт, и для работы агента, а российские карты не принимаются.

Агент и агентный цикл: чем это отличается от автодополнения

Автодополнение живёт внутри открытого файла: вы печатаете, оно предлагает продолжение. Агент получает задачу целиком и сам решает, что сделать: ему доступны чтение файлов, поиск по репозиторию, запуск команд, редактирование, git. Работает он циклом: инструмент, результат, оценка, следующий шаг. Просите починить падающий тест: агент запускает тест, читает трассировку, правит файл и запускает снова — пока не сойдётся или пока вы не нажмёте Esc.

Отсюда перемена в вашей работе: вы описываете результат и способ его проверить, а не последовательность шагов. Плата за это — агент может уйти в сторону или отрапортовать об успехе, ничего не запустив. Поэтому вокруг цикла нужны подтверждения, план-режим и git.

Установка и первый запуск

Ставится глобально через npm: npm install -g @anthropic-ai/claude-code. Нужен Node.js 18 или новее, проверьте командой node --version. Перейдите в каталог проекта и запустите claude: агент работает относительно текущего каталога и по умолчанию не видит того, что лежит в стороне. Первый запуск попросит войти — по подписке или по ключу API.

В Windows Claude Code работает нативно, но Git for Windows упрощает жизнь: часть команд идёт через POSIX-оболочку. Странное поведение разбирайте с /doctor, список команд показывает /help. Для VS Code и JetBrains есть расширение — правки видны привычными диффами.

Про доступ прямо: бесплатного режима нет. Либо платная подписка Claude — младший тариф Pro или более дорогой Max с большими лимитами, — либо оплата за токены по ключу API, и тогда держите под рукой /cost. Из России без VPN не откроются ни сайт, ни работа агента, и российской картой заплатить не выйдет.

Первый промпт и режимы подтверждения

Не начинайте с кода. Первая осмысленная задача: «Объясни устройство проекта: где точка входа, где бизнес-логика, чем собирается, чем тестируется. Файлы не меняй». Так вы проверяете доступ и видите, насколько адекватно агент читает вашу кодовую базу. Если объяснение мимо, дело обычно не в модели, а в том, что структура проекта не читается снаружи.

В промпте нужны три вещи: задача, границы, критерий готовности. Плохо: «сделай авторизацию лучше». Хорошо: «В src/auth/session.py время жизни сессии зашито числом 3600. Вынеси его в настройку SESSION_TTL, обнови tests/test_session.py, другие модули не трогай. Готово, когда проходит pytest tests/test_session.py». Первый вариант превратится в самодеятельность по репозиторию, второй выполняется предсказуемо.

Режимы подтверждения переключает Shift+Tab. По умолчанию агент спрашивает разрешение на каждую правку и каждую команду. Авто-принятие правок снимает вопросы по редактированию — годится для мелкой задачи в отдельной ветке. Полный пропуск разрешений (--dangerously-skip-permissions) — только в контейнере: это право выполнить что угодно от вашего имени. Отдельно стоит план-режим: агент исследует код, ничего не меняя, и выдаёт план, который вы правите словами до запуска.

Рабочий цикл: изучить, спланировать, написать, закоммитить

Изучить. Прежде чем менять, попросите найти нужное место и объяснить связи: «Найди, где формируется итоговая сумма заказа, и все места, где она пересчитывается». Часто здесь и выясняется, что править надо не то, что вы думали.

Спланировать. В план-режиме просите разбивку по шагам с файлами и проверяйте две вещи: не задевает ли план лишнего и чем подтвердить результат. Критерия нет — впишите сами, иначе успех оценит сам агент.

Написать. Идите короткими шагами и требуйте фактов: не «проверь, что всё работает», а «запусти тесты и покажи вывод команды полностью». Расползлась правка шире плана — останавливайте и формулируйте задачу узко.

Закоммитить. «Покажи git diff, потом закоммить одним коммитом, сообщение по делу». Работайте в отдельной ветке: git позволяет откатить любой заход агента целиком.

Контекст — исчерпаемый ресурс

Окно контекста — объём текста, который модель держит перед глазами. Туда попадает всё: ваши сообщения, прочитанные файлы, вывод команд, системные инструкции. Окно конечно, и при заполнении диалог автоматически сжимается: разговор пересказывается кратко, часть деталей теряется безвозвратно.

Между задачами делайте /clear. На длинной задаче зовите /compact и говорите, что сохранить: «оставь решения по схеме БД и список оставшихся шагов». Не просите «прочитать весь репозиторий» — указывайте файлы через @путь/к/файлу, а длинные логи кладите в файл.

Протухший контекст узнаётся легко: агент предлагает то, что вы уже отвергли, путает имена файлов, теряет принятое решение. Уговорами это не лечится — только новой сессией с брифом на пять строк.

CLAUDE.md: память проекта

CLAUDE.md — файл в корне репозитория, который подгружается в начало каждой сессии. Заготовку создаёт /init, но принимать её как есть не стоит: черновик обычно пересказывает README. Туда пишут то, что агент не выведет из кода: точные команды сборки и тестов, соглашения команды, неочевидные решения, явные запреты.

Строка «пиши качественный код» не значит ничего; строка «тесты запускаем только через make test, напрямую pytest не работает» избавляет от повторных объяснений. Секретам и ключам тут не место — файл попадает и в git, и в контекст модели. Уровни: ~/.claude/CLAUDE.md — личные привычки, ./CLAUDE.md — командный файл, файлы в подкаталогах — правила модуля. Начните сообщение с #, и агент предложит дописать сказанное в файл.

Команды сборки, тестов, линтера и локального запуска — точными строками
Структура: где что лежит, если это неочевидно из имён каталогов
Соглашения: стиль коммитов, именование, оформление миграций
Запреты: какие каталоги и файлы не трогать без явной просьбы
Грабли окружения, из-за которых ломается сборка

Расширения: субагенты, навыки, MCP, хуки

Субагенты — отдельные агенты со своим окном контекста и своей инструкцией; файлы лежат в .claude/agents, управление через /agents. Смысл в изоляции: поиск всех вызовов устаревшего метода пусть ведёт субагент, а в основную сессию вернётся результат. Обратная сторона — он не видит вашего диалога, задание ему пишется целиком.

Навыки — папки в .claude/skills с файлом SKILL.md: в заголовке сказано, когда навык применять, в теле лежит процедура. В контексте висит только короткое описание, полный текст подтягивается по делу. Так один раз записывается регламент вроде «как мы готовим релиз» — вместе со вспомогательными скриптами.

MCP (Model Context Protocol) — протокол, которым агент подключается к внешним источникам: трекеру задач, базе данных, браузеру. Серверы добавляет команда claude mcp add, список проекта лежит в .mcp.json, состояние показывает /mcp. Всё, что приходит извне, — данные, а не команды: текст в чужой задаче может содержать инструкции для агента, поэтому подключайте только доверенные серверы.

Хуки — ваши скрипты на события агента, описанные в .claude/settings.json: PreToolUse (перед вызовом инструмента, может его заблокировать), PostToolUse, UserPromptSubmit, Stop. Типичное: форматтер после правки Python-файла, запрет записи в .env, уведомление в конце. Отличие от просьбы в промпте принципиальное — хук выполняется всегда.

Типичные ошибки новичка

Самая частая — гигантская задача одним промптом вроде «перепиши бэкенд на новую архитектуру». Агент возьмётся, что-то сделает, и разбирать результат вы будете дольше, чем писали бы сами. Задача должна помещаться в один коммит и иметь проверяемый критерий готовности.

Вторая — доверие без проверки. «Готово, тесты проходят» не означает, что тесты запускались: просите вывод команды. Диффы читайте даже на рутинной правке — именно там прячутся удалённая проверка на null и переименованное поле, о котором вы не просили. Авто-принятие правок без git-ветки — прямой способ потерять полдня.

Вести все задачи в одной бесконечной сессии вместо /clear между ними
Копировать в чат многотысячные логи вместо файла и нужного фрагмента
Спорить с агентом, который уже потерял контекст, вместо перезапуска
Держать в CLAUDE.md инструкции, которые давно перестали быть правдой
Включать пропуск разрешений на рабочей машине «чтобы не отвлекало»
Складывать секреты туда, куда дотягивается агент или подключённый MCP

Практика

Установите пакет: npm install -g @anthropic-ai/claude-code, зайдите в каталог тренировочного проекта и запустите claude. Не заработало — начните с /doctor.
Создайте отдельную ветку и убедитесь, что git status чист: это страховка на всё занятие.
Первый промпт без правок кода: «Объясни устройство проекта: точка входа, бизнес-логика, сборка, тесты. Файлы не меняй». Сверьте ответ с тем, что знаете сами.
Выполните /init и перепишите CLAUDE.md руками: команды сборки и тестов, две-три договорённости, один явный запрет.
В план-режиме (Shift+Tab) поставьте задачу вынести захардкоженное значение в конфиг и обновить тест; правьте план словами до запуска.
Дайте выполнить план, попросите вывод тестов целиком и просмотрите каждый дифф перед подтверждением.
Попросите: «Покажи git diff, затем один коммит с сообщением по делу» — и сверьте git log.
Сделайте /clear и поставьте следующую задачу с нуля: почувствуйте разницу на чистом контексте.

Проверьте себя

Запустил Claude Code в своём проекте и понимаю, какой режим подтверждений активен (Shift+Tab)
Формулирую задачу с границами (какие файлы трогать) и критерием готовности (какая команда должна пройти)
Прогнал полный цикл: разобрал код в план-режиме, утвердил план, проверил дифф, закоммитил
В проекте есть CLAUDE.md с командами сборки и тестов, и я знаю, как дописать туда правило через #
Управляю контекстом: /clear между задачами, файлы через @, без «прочитай весь репозиторий»
Могу объяснить, чем субагент отличается от навыка и зачем нужны хуки

Частые вопросы

Нужен ли платный тариф или можно попробовать бесплатно?

Бесплатного режима нет: либо платная подписка Claude (младший тариф Pro, более дорогой Max с большими лимитами), либо ключ API с оплатой за потраченные токены. Второй вариант гибче, но требует следить за расходом — /cost показывает стоимость сессии. Цены и лимиты меняются — сверяйте перед оплатой.

Я из России — что с доступом и оплатой?

Сервисы Anthropic из России не открываются: и вход в аккаунт, и работа агента требуют VPN. Российские карты для подписки и пополнения баланса API не принимаются. Решить это стоит до установки: иначе упрётесь в ошибку авторизации на первом же запуске.

Заменит ли это программиста?

Нет, но меняет распределение усилий. Агент быстро делает то, что вы можете точно описать и проверить: рефакторинг по образцу, тесты, миграции, разбор чужого кода, черновую реализацию. На вас остаётся постановка задачи, архитектура и ревью — и ревью становится больше, потому что кода больше.

Насколько это безопасно для рабочего репозитория?

Агент запускает команды и меняет файлы с вашими правами, поэтому базовая защита — git и подтверждения по умолчанию. Работайте в отдельной ветке, не включайте пропуск разрешений вне изолированного окружения, держите секреты в .env вне контекста. Опасные команды закрываются через /permissions и хук на PreToolUse.

Чем это отличается от автодополнения в редакторе?

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

Что делать, если агент упорно делает не то?

Почти всегда причина одна: задача сформулирована широко или контекст засорён предыдущим обсуждением. Остановите выполнение, начните новую сессию, дайте короткий бриф с конкретными файлами и критерием готовности. Если ошибка повторяется из раза в раз, это уже не проблема промпта, а кандидат в CLAUDE.md.

Чтобы пройти практику, нужен рабочий доступ

Подключим подписку на ваш аккаунт: оплата картой РФ, по СБП или криптой, пароль от аккаунта не нужен. Обычно за 15 минут в рабочее время.

Подключить Claude Pro — 2 490 ₽ Все уроки