Claude Code — агент для работы с кодом проекта через командную строку. Он отличается от обычного диалога в Claude тем, что может исследовать контекст кодовой базы и предлагать действия с файлами. Точный набор доступных команд и подтверждений зависит от конфигурации; не начинай с режима, который отключает проверку разрешений.
Начни с узкой задачи
Открой терминал в папке проекта и убедись, что это нужный репозиторий: проверь путь, текущую ветку и git status. Прочитай README и инструкции проекта. Сначала попроси Claude Code объяснить структуру и найти функцию, не меняя файлы. Затем поручай изменение одного ограниченного поведения и попроси назвать файлы, которые планирует затронуть.
Подходящий первый пример: «В компоненте списка добавь состояние пустой выдачи. Не меняй запрос к API и авторизацию. Покажи план, обнови компонент и добавь проверку, если в проекте уже есть тестовая среда». Цель — увидеть, как агент понимает контекст, а не проверить его на широком запросе вроде «переделай приложение».
Разрешения — часть процесса
Официальное руководство содержит режим планирования и отдельные параметры подтверждения. Оставь безопасные запросы подтверждений включёнными, пока не понимаешь, какие действия может выполнять инструмент. Не включай флаг пропуска всех разрешений ради удобства: он устраняет контрольный шаг. Доступ агента к файлам и командам может быть шире, чем у конкретной задачи.
Не добавляй ключи в запросы и не проси агента печатать содержимое .env. Для обычной работы секреты должны быть вынесены из кода, а их значения недоступны логам и истории. Перед командой установки или миграцией посмотри, что она меняет и где запускается.
Принимай diff, а не обещание
После изменения прочитай git diff по каждому файлу: совпадает ли поведение с задачей, нет ли посторонних форматирований, удаления проверок и неизвестных зависимостей. Запусти тесты проекта и посмотри их полный вывод. Если агент говорит «готово», но не запускал тест, считай тест незапущенным. Для неоднозначного изменения попроси объяснить его с привязкой к конкретному участку кода.
Практический цикл: понять → спланировать → изменить → просмотреть diff → выполнить проверку. Отдели правку документации от изменения поведения и зафиксируй рабочий коммит до следующей крупной задачи. Для нового репозитория сначала сохрани чистую исходную точку.
Claude Code продолжает развиваться, поэтому проверяй действующие инструкции установки, разрешений и безопасности по актуальной документации Anthropic. Приведённый процесс — руководство по работе, а не утверждение, что команды запускались на твоём компьютере.
Источники: Claude Code — начало работы, использование CLI, общие рабочие сценарии.
Чёткий первый маршрут
- Открой проект, запусти
git statusи убедись, что нет чужих незаписанных изменений. - Попроси краткую карту папок, основных команд и подходящего файла для изменения.
- Попроси план без изменений, если задача затрагивает данные, доступ или инфраструктуру.
- Поручи одну небольшую правку и открой diff.
- Запусти существующую команду проверки; сохрани вывод и отметь, если команда не запускалась.
Если команда предлагает создать или удалить данные, сперва спроси, в каком окружении она выполнится. Для добавления зависимости проверь пакет и версию. Для миграции узнай, как она откатывается и использует ли production connection string. Claude Code может предложить команды, но сам факт их появления в чате не означает, что они безопасны для твоей среды.
При работе в многоэтапном проекте сохраняй progress в самом issue/ветке: что сделано, какие тесты запускались, что ещё не решено. Это помогает восстановить контекст без повторной загрузки всех обсуждений. Но не помещай в сводку токены, приватные данные или секретные настройки.
Ограничь задачу файлами и поведением
Фраза «исправь форму профиля» оставляет слишком много открытых вариантов. Уточни поля, валидацию, ожидаемое серверное состояние и запрет менять соседние маршруты. Для неясной задачи попроси изучить проект, привести найденный компонент и предложить план, не меняя код. Затем выбери план или поправь его. Такой двухшаговый процесс особенно полезен для схемы БД, разрешений или настроек deploy.
Если инструмент предлагает команду запуска, проверь, безопасна ли она для текущей базы и directory. Предпочитай локальную тестовую базу; проверь connection string до применения миграций. Не отключай подтверждение или sandbox restrictions только для того, чтобы агент не задавал вопросы. Если нужна автоматизация без интерактивного контроля, определяй конкретные права и отдельную тестовую среду.
После теста сравни statement «тест прошёл» с командой и выводом. Запиши непроверенные сценарии: например, браузерный тест не запускался, так как требуется локальный OAuth callback. Это не отменяет полезность сделанной правки, но обозначает границы приёмки для следующего шага.