Claude Code: как начать работу над своим проектом

Claude Code работает с файлами проекта и может предложить правку кода. Начните с небольшой задачи, где итог можно увидеть глазами: исправить один экран или добавить проверку формы. До запуска сохраните текущее состояние проекта и сформулируйте, какие файлы разрешено менять. После ответа смотрите diff и проверяйте страницу; сообщение «готово» само по себе ничего не подтверждает. Я веду свои проекты именно короткими проверяемыми шагами.

Проверено в октябре 2026 по официальной инструкции Anthropic и списку поддерживаемых регионов. Документация показывает варианты установки и входа, а Россия в опубликованном списке регионов не указана. Перед регистрацией проверьте действующие условия и доступ для своего местоположения. Цены и лимиты зависят от плана и меняются; смотрите их в кабинете и официальных условиях. Для следующего шага пригодится материал о том, как создать сайт с помощью ИИ.

Как подготовить проект перед первым запросом

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

Как установить и проверить Claude Code

Проверку версии и установку из npm проводите только там, где сервис доступен по официальным условиям. Команды ниже оставляют версию актуальной на день установки:

npm view @anthropic-ai/claude-code version
npm install -g @anthropic-ai/claude-code@latest
claude doctor

Официальная инструкция Anthropic описывает установку и варианты входа. Перед командами проверьте версию Node.js и доступность сервиса в своём регионе. Для npm‑способа используйте актуальный пакет, затем запустите диагностику из документации. Не вставляйте команды из случайного видео с правами администратора. Если установка предлагает изменить системные папки или открыть неизвестный скрипт, остановитесь и прочитайте его назначение.

Как это выглядит в работе

Экран проекта Deyvo показывает результат работы над приложением. Он не служит доказательством функций Claude Code.

Как сформулировать первую задачу

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

Как читать diff после ответа агента

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

Как проверить страницу и не потерять готовое

Запустите сборку и откройте страницу на телефоне и широком экране. Пройдите основной сценарий, затем ввод с ошибкой и пустое поле. Если есть база, проверьте сохранение и чтение одной тестовой записи. Заранее записанная исходная проверка должна проходить и после правки. При ошибке возвращайтесь к конкретному шагу и укажите агенту, что именно сломалось. Это уменьшает риск случайно переписать соседний код.

Экран калькулятора Каратау показывает тип результата, который стоит проверить вручную: измените входное число и сверьте сумму. Скриншот иллюстрирует проверку приложения и не подтверждает, каким инструментом написан код.

Когда переходить к следующей задаче

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

Какие правила записать в CLAUDE.md

Создайте CLAUDE.md в корне проекта. Запишите там цель, команды сборки и проверки, источник данных и запрет на правку готовых частей без согласования. Пароли в этот файл не записывайте. Например, правило «цены читаются из базы, не копировать их в компоненты» помогает при следующей задаче. Для секретов нужен отдельный .env, который не входит в репозиторий.

# CLAUDE.md
Проект: сайт записи. Данные услуг и цен хранятся в базе.
Перед правкой общей функции найди все вызовы.
После правки запусти npm run build и проверь форму записи.
Не читай .env и не вставляй ключи в ответы или коммиты.

Запрет на чтение файла продублируйте в разрешениях Claude Code, например в .claude/settings.json через permissions.deny. Правило в тексте само по себе не закрывает доступ инструменту. После настройки дайте агенту безопасную тестовую задачу и проверьте, что запрос на чтение .env блокируется. Перед первым коммитом посмотрите git status --short и git diff, чтобы заметить случайно созданные файлы.

В инструкции Anthropic по установке описаны варианты установки и сказано, что sudo npm install -g использовать не следует. Для npm сначала проверьте путь установки и настройте права пользователя. Настройки разрешений описаны в официальной документации.

Когда агент закончил, попросите объяснить изменённые файлы и сверьте ответ с git diff --stat и полным diff. На живых встречах по сборке проекта я прохожу такой цикл вместе с владельцем: задача, правка, проверка на экране и разбор ошибки.

Что сохранить после первой правки

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

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

Нужно ли уметь программировать?

Знать весь синтаксис не обязательно, но нужно понимать результат, данные и способ проверки.

Можно ли запускать Claude Code в России?

Список поддерживаемых регионов Anthropic следует проверить перед регистрацией. В проверенном списке Россия не указана.

Сколько стоит работа?

Цена и лимиты зависят от официального плана и меняются. Перед оплатой сверяйте текущие условия в кабинете.

Что делать после первой правки?

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

Можно ли дать агенту весь проект?

Можно открыть проект, но права и границы конкретной задачи нужно описать заранее.

Что сделать дальше

Для первой сессии выберите изменение, которое видно на экране и легко вернуть. Сохраните исходный diff, проверьте разрешения и только затем расширяйте задачу. Если нужен разбор по вашим файлам, приходите на обучение.