Onboardingв чужой проект

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

Часть 1 · Зачем

Почему Claude Code сильнее именно тут

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

Важно понимать границу. Агент отлично отвечает на «как тут что устроено» и «где лежит логика вот этой штуки». Он не заменяет понимание бизнес-смысла — зачем эта фича вообще нужна и какие у неё подводные камни в продукте. Но как инструмент быстрого знакомства с устройством кода он экономит дни.

Часть 2 · Обзор

Шаг 1. Получить карту проекта

Не лезь сразу в код. Сначала попроси агента обойти репозиторий и объяснить его сверху. Хороший стартовый промт выглядит так:

Я первый день в этом проекте. Обойди репозиторий и объясни:
1. Какой стек и фреймворки используются.
2. Из каких основных частей состоит проект и за что отвечает каждая папка.
3. Где точка входа — откуда всё стартует.
4. Как проект запустить и собрать локально.
Покажи структуру верхнего уровня и не углубляйся в детали.

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

Часть 3 · Память

Шаг 2. Закрепить картину через /init

Карта из головы испаряется к завтрашнему дню, а у агента контекст обнуляется в новой сессии. Лекарство — команда /init: она обходит проект и складывает результат в файл CLAUDE.md в корне репозитория.

# Агент обойдёт проект и создаст CLAUDE.md:
#   стек, структура, команды запуска и сборки, соглашения
/init

# Дальше CLAUDE.md подгружается в каждую сессию автоматически —
# и тебе как описание проекта, и Claude как постоянная память

Двойная польза. Для тебя CLAUDE.md — это готовое введение в проект, написанное по реальному коду, а не по устаревшей вики. Для агента — память, которая подгружается в каждый новый разговор, поэтому в следующей сессии он уже «знает» проект и не разбирается заново. Как вести этот файл дальше — в гайде про настройку памяти проекта.

Часть 4 · Глубина

Шаг 3. Трассировать конкретную фичу

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

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

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

Часть 5 · Доверие

Шаг 4. Проверять, а не верить на слово

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

Агент — это быстрый экскурсовод по коду, а не оракул. Проверяй маршрут по табличке на стене.

Вопросы

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

Читать дальше

Соседние гайды