Блок 2: Рабочее пространствоРабота с файлами

Работа с файлами

Время: 20 мин | Уровень: Базовый

Цель урока

Научиться читать, создавать и редактировать файлы с помощью Claude Code.

Что вы узнаете

  • Как читать файлы и использовать @-ссылки
  • Как создавать новые файлы и папки
  • Как редактировать существующие файлы
  • Как работать с несколькими файлами одновременно

Реальный кейс: Martin Merschroth использует Claude Code для автоматического переименования и сортировки счетов — файловые операции, которые раньше занимали часы ручной работы. Источник

Чтение файлов

Главное преимущество Claude Code — вам не нужно копировать текст в чат. Просто укажите на файл, и Claude прочитает его сам.

Простой способ: просто попросите

Прочитай файл company-context/sample-brief.md

Claude откроет файл и покажет его содержимое.

@-ссылки: быстрый способ

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

Символ @ позволяет ссылаться на файлы прямо в сообщении:

Посмотри @company-context/sample-brief.md и скажи, что там главное

Автодополнение: Начните печатать @ и путь к файлу — Claude Code предложит варианты. Нажмите Tab для автодополнения.

Чтение нескольких файлов

Сравни @file1.md и @file2.md — какие ключевые отличия?
Прочитай все markdown-файлы в папке docs/

Создание файлов

Базовое создание

Создай файл meeting-notes.md с заметками о встрече:
- Участники: Анна, Борис
- Решение: запускаем MVP в марте

Claude создаст файл с указанным содержимым.

Создание в конкретной папке

Создай файл docs/requirements/auth-spec.md с описанием требований к авторизации

Если папки не существует, Claude создаст её автоматически.

Создание на основе другого файла

На основе @sample-brief.md создай PRD и сохрани как docs/prd-auth.md

Редактирование файлов

Точечные изменения

В файле @README.md замени "версия 1.0" на "версия 2.0"

Добавление контента

Добавь в конец @meeting-notes.md раздел "Следующие шаги"

Массовое редактирование

Во всех markdown-файлах в папке docs/ добавь автора "Команда продукта" в начало

Структурные изменения

Переформатируй @sample-document.md — сделай заголовки короче, добавь буллеты

Работа с папками

Просмотр структуры

Покажи структуру папки docs/

Claude выведет дерево файлов и папок.

Поиск файлов

Найди все файлы с расширением .csv в проекте
Найди файлы, содержащие слово "авторизация"

Создание папок

Создай папку research/interviews/

@-ссылки: детали

Синтаксис

СинтаксисЧто делает
@filename.mdСсылка на файл в текущей папке
@path/to/file.mdСсылка с относительным путём
@/absolute/path/file.mdСсылка с абсолютным путём
@folder/Ссылка на папку (покажет содержимое)

Несколько файлов в одном запросе

Объедини @intro.md, @chapter1.md и @chapter2.md в один документ

Drag and Drop

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

Практика

Легенда: Бехзод (аккаунт-менеджер) просит вас разобраться с брифом от клиента Sardor из UzTech. Бриф пришёл в хаотичном виде — нужно понять, что требуется.

Задание 1: Чтение

Бехзод: “Sardor прислал бриф на лендинг для CRM. Прочитай и выдели 3 ключевых требования.”

Задача: Прочитать бриф клиента и выделить ключевые требования.

Исходные данные: company-context/sample-brief.md

Ожидаемый результат: Список из 3 ключевых требований к лендингу.

Подсказка
Прочитай @company-context/sample-brief.md и выдели 3 ключевых требования к лендингу

Задание 2: Создание

Бехзод: “Отлично! Теперь заведи свои заметки по брифу — что понятно, что нет.”

Задача: Создать файл с вашими заметками по брифу.

Ожидаемый результат: Файл my-notes/first-day-notes.md с заметками: что понятно, какие вопросы возникли.

Подсказка
Создай файл my-notes/first-day-notes.md с моими заметками по брифу UzTech:
- Что понятно из брифа
- Какие вопросы возникли

Claude создаст папку my-notes/ автоматически.

Задание 3: Редактирование

Бехзод: “Добавь раздел с вопросами к клиенту — обсудим на созвоне.”

Задача: Добавить раздел “Вопросы к клиенту” в ваши заметки.

Исходные данные: Файл my-notes/first-day-notes.md из предыдущего задания

Ожидаемый результат: В файле появился раздел “Вопросы к клиенту” с 3 уточняющими вопросами по брифу.

Подсказка
Добавь в @my-notes/first-day-notes.md раздел "Вопросы к клиенту" с 3 уточняющими вопросами по брифу

Задание 4: Удаление

Бехзод: “Это были тренировочные заметки. Позже создадим нормальный PRD — пока удали.”

Задача: Удалить тестовые заметки.

Ожидаемый результат: Файл my-notes/first-day-notes.md удалён.

Подсказка
Удали файл my-notes/first-day-notes.md

Claude спросит подтверждение перед удалением.

Важные правила

Права доступа

При первом использовании Claude Code спросит разрешение на:

  • Чтение файлов
  • Запись файлов
  • Выполнение команд

Это защита — Claude не будет менять файлы без вашего согласия.

Резервные копии

Claude Code работает с реальными файлами. Рекомендации:

  • Используйте Git (система контроля версий — позволяет вернуться к любой предыдущей версии файла) для важных проектов
  • Перед массовым редактированием делайте резервную копию
  • Начинайте с тестовых файлов, пока не освоитесь

Типичные ошибки

”Файл не найден”

  • Проверьте, что Claude Code открыт в правильной папке (спросите: “В какой папке мы сейчас?”)
  • Проверьте правильность пути и имени файла

”Нет прав на запись”

  • Claude Code запросит разрешение — подтвердите его
  • Проверьте, что файл не открыт в другой программе

Резюме

  • Claude Code работает напрямую с файлами — не нужно копировать текст в чат
  • @-ссылки позволяют быстро указывать на файлы: @filename.md
  • Можно читать, создавать и редактировать файлы одним запросом
  • Drag and Drop работает — перетащите файл прямо в окно Claude Code

Следующий шаг

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

Тизер основного курса: В основном курсе вы создадите кастомные команды (Skills), которые автоматически генерируют документы по вашим шаблонам одной командой.

Запуск и клонирование курсаНавигация и режимы