Перейти к содержимому
Код с AI

Первый проект с Claude Code: от планирования до Pull Request

Режим плана, файл CLAUDE.md и как проверять код, написанный AI.

Команда HTMLLAB · 7 мин чтения

Claude Code — AI-агент, который работает в терминале: читает файлы проекта, пишет код и запускает команды. А качество результата зависит от того, как поставлена задача. Давайте пройдём небольшую функцию от начала до конца.

Напиши CLAUDE.md для проекта

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

CLAUDE.md
# Проект
Next.js + TypeScript, тесты — Vitest.

# Команды
npm run dev, npm run test

# Правила
- Не использовать any
- К каждой новой функции писать тест

Сначала план, потом код

В режиме плана (Shift+Tab) агент не меняет файлы: он читает код и предлагает пошаговый план. Прочитай его, исправь неверные предположения и только после этого разреши выполнение.

Заметка
Чем меньше задача, тем проще проверить результат. Вместо «напиши весь кабинет» пиши «добавь валидацию в форму регистрации».

Проверь код

  • Запусти тесты и сам посмотри на результат
  • Прочитай каждое изменение через git diff
  • Попроси агента объяснить строку, которую не понял
  • Откати изменения, которых не было в задаче

Открой Pull Request

Когда изменение готово, сделай commit в отдельной ветке и открой Pull Request. Claude Code может написать описание PR, но автор — ты: на ревью каждую строку объясняешь сам. В HTMLLAB домашние задания сдаются именно так.

#claudecode#aiagent#git

Читай также