← все статьи

Claude Code: как работать с ИИ-агентом в существующем проекте

Claude Code: как работать с ИИ-агентом в существующем проекте

Claude Code помогает работать с существующим проектом: читать файлы, искать связи между модулями, менять код и запускать команды через доступные инструменты. Польза появляется там, где задачу можно объяснить и проверить. Агент способен подготовить исправление, но решение о его принятии требует понимания проекта.

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

Что отличается от обычного чата

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

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

Установка и доступ: что проверить сначала

В актуальной документации Anthropic рекомендует нативную установку. Для macOS, Linux и WSL используется команда ниже. Она загружает и выполняет официальный установщик; перед запуском проверьте адрес и требования своей системы. Другие способы, включая Windows, описаны на странице установки Claude Code.

Промпт
curl -fsSL https://claude.ai/install.sh | bash
claude --version

После установки откройте терминал в папке проекта и запустите claude. Пройдите вход выбранным способом. Бесплатный тариф claude.ai не включает Claude Code: официальный список вариантов доступа включает Pro, Max, Team, Enterprise и Console. Нужны интернет и доступность сервиса в вашей стране; установка программы сама по себе этого не обеспечивает.

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

Какие задачи удобно поручать

ЗадачаЧто дать агентуКак принять результат
Исправить форму заявкиШаги воспроизведения, ожидаемый ответ, место получения заявкиПроверить ошибки ввода, успешную отправку и фактическую доставку
Обновить название брендаНовое название и исключения для исторических упоминанийИзучить список замен и поиск остатков
Разобраться с модулемВопрос о конкретном поведении и точка входаПолучить объяснение со ссылками на файлы и проверяемую гипотезу
Исправить мобильную вёрсткуПроблемный экран, размеры и ожидаемое положение элементовСравнить страницу на нескольких экранах и проверить нажатия

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

Контекст проекта: короткий CLAUDE.md

Claude Code поддерживает инструкции проекта в CLAUDE.md. Запишите стек, команды проверки, важные ограничения и особенности публикации. Как подключаются такие файлы, объясняет официальная документация о памяти проекта. Инструкции помогают передать договорённости, но не заменяют ограничения доступа и проверку.

Промпт
Project: a PHP website with file-based article storage.
Keep existing public URLs unchanged.
Preserve article content unless the task explicitly includes editing it.
Before changes, identify the relevant templates and describe the plan.
After changes, report the files modified and the checks performed.
Do not deploy, modify production data, or access credentials without
an explicit task that authorizes those actions.

Дополните пример фактическими командами своего проекта. Не записывайте пароли в этот файл. И не превращайте его в архив всех решений: длинные устаревшие инструкции создают противоречия. Полезнее поддерживать короткие проверяемые правила и отдельно хранить описание архитектуры.

Разрешения и режим планирования

В Claude Code есть несколько режимов разрешений. Режим plan предназначен для исследования без редактирования исходных файлов, однако может запускать команды согласно действующим правилам. Режим acceptEdits автоматически разрешает редактирование и часть файловых операций. Поведение зависит от режима, настроек и версии: не считайте каждое действие обязательно подтверждаемым.

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

Пример: переименование бренда без слепой замены

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

Промпт
Find all occurrences of the old brand name in this project.
Classify them as current public copy, historical references,
configuration, or technical identifiers.
Do not edit anything yet. Propose the smallest change set and
explain which occurrences should remain unchanged.
After approval, apply the agreed edits and verify remaining matches.

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

Как проверять код и вёрстку

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

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

Просите итоговый отчёт: что изменилось, что проверено, какие проверки не выполнялись и что остаётся неопределённым. Фраза «должно работать» не заменяет результат теста. При этом зелёная проверка сборки не подтверждает доставку заявки или корректность бизнес-правила.

Стоимость и оценка пользы

Разделяйте подписку и использование API. У подписчиков действуют условия и лимиты плана; при API-доступе расходы зависят от использования. Актуальные варианты смотрите в тарифах Claude, правила учёта — в документации Claude Code о расходах. Сложная задача включает чтение файлов, вызовы инструментов и повторные попытки, поэтому считать только один ответ недостаточно.

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

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

Можно ли работать сразу на хостинге? Технически это зависит от подключений и разрешений. Для первого знакомства удобнее копия проекта. Публикацию выделите в отдельный шаг с проверкой исходного состояния и способом восстановления.

Можно ли доверить весь проект без знания кода? Нужен человек, который способен принять результат и обнаружить существенные ошибки. Для важных функций договоритесь о независимой проверке специалистом.

Что делать, если агент расширяет задачу? Остановитесь на конкретном наблюдаемом результате. Попросите объяснить, зачем нужны дополнительные изменения, и вынести их отдельно. Большой diff сложнее проверить и восстановить.

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

35 0 0
Все статьи

Комментарии

Пока нет комментариев - будьте первым.