Зачем это нужно#

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

В этом уроке мы научимся направлять внимание Claude на нужные файлы и работать с большими проектами.

Контекст проекта — что Claude видит#

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

1. Читает CLAUDE.md файлы (правила проекта)
2. Загружает авто-память (свои заметки о проекте)
3. Дальше читает файлы по мере необходимости — когда вы о них спрашиваете или они нужны для задачи

💡 Думайте об этом так: Claude — как новый сотрудник. Он знает общие правила (CLAUDE.md), но конкретные файлы открывает, когда нужно.

@-упоминания файлов#

Самый простой способ указать Claude на нужный файл — использовать символ @ перед именем файла.

Как это работает#

Вы: Посмотри @src/app.js и добавь обработку ошибок

Claude сразу откроет именно этот файл и будет с ним работать.

Можно упоминать несколько файлов#

Вы: Сравни @src/old-utils.js и @src/new-utils.js — 
    какие функции были удалены?

Можно упоминать папки#

Вы: Проанализируй все файлы в @src/components/ 
    и найди неиспользуемые компоненты

Примеры использования @-упоминаний#

Работа с большими кодовыми базами#

Стратегия 1: Начните с обзора#

Если проект большой и незнакомый, попросите Claude сначала разобраться в структуре:

Вы: Посмотри структуру проекта и объясни:
    - Какие основные папки и за что отвечают
    - Где точка входа (главный файл)
    - Какие технологии используются

Стратегия 2: Работайте по частям#

Не просите Claude «переписать весь проект». Разбивайте на задачи:

--- Шаг 1 ---
Вы: Расскажи, как устроена авторизация в проекте. 
    Какие файлы задействованы?

--- Шаг 2 ---
Вы: Теперь добавь возможность входа через Google 
    в @src/auth/login.js

--- Шаг 3 ---
Вы: Обнови @src/auth/config.js для поддержки Google OAuth

Стратегия 3: Давайте контекст через CLAUDE.md#

Для больших проектов опишите структуру в CLAUDE.md:

# Структура проекта

## Основные папки
- src/api/ — серверная часть (API-эндпоинты)
- src/components/ — React-компоненты интерфейса
- src/models/ — модели базы данных
- src/utils/ — вспомогательные функции

## Ключевые файлы
- src/app.js — точка входа
- src/routes.js — маршрутизация
- src/database.js — подключение к базе данных

## Зависимости между модулями
- Компоненты используют API-функции из src/api/
- API использует модели из src/models/

Дополнительные директории#

Если ваш проект состоит из нескольких папок (например, фронтенд и бэкенд в разных местах), вы можете подключить дополнительные папки:

claude --add-dir /путь/к/другой/папке

Теперь Claude видит и основной проект, и дополнительную папку.

Практический пример: добавление новой страницы#

Допустим, у вас есть веб-сайт и нужно добавить страницу «О нас».

--- Шаг 1: Узнаём, как устроены другие страницы ---
Вы: Покажи структуру файлов для главной страницы. 
    Какие файлы задействованы?

Claude: Главная страница состоит из:
        - src/pages/Home.js (компонент)
        - src/styles/Home.css (стили)
        - src/routes.js (маршрут)

--- Шаг 2: Создаём по аналогии ---
Вы: Создай страницу «О нас» по аналогии с @src/pages/Home.js. 
    Контент: история компании, команда, контакты.

Claude: [создаёт src/pages/About.js и src/styles/About.css]

--- Шаг 3: Подключаем ---
Вы: Добавь маршрут для страницы «О нас» в @src/routes.js 
    и ссылку в меню навигации в @src/components/Navbar.js.

Claude: [обновляет оба файла]

Советы#

• ✅ Используйте @ для точного указания файлов — это быстрее, чем ждать, пока Claude сам найдёт нужный
• ✅ Описывайте структуру проекта в CLAUDE.md — особенно для больших проектов
• ✅ Работайте пошагово: обзор → изменение конкретных файлов → проверка
• ✅ При работе с незнакомым проектом начните с просьбы «объясни структуру»
• ⚠️ Не пытайтесь изменить слишком много файлов за один запрос — лучше разбить на части

Итоги урока#

• Claude Code не читает все файлы сразу — он открывает их по мере необходимости
• @-упоминания (@src/file.js) — самый быстрый способ указать Claude на нужный файл
• Для больших проектов описывайте структуру в CLAUDE.md
• Работайте пошагово: сначала обзор, потом конкретные изменения
• Можно подключить дополнительные папки через --add-dir