0.3: Первые шаги

Время20 мин
УровеньС нуля
Команда/start-0-3

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

Обзор

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

Claude Code умеет 6 основных вещей с файлами:

ОперацияЧто делаетПример запроса
Read (Чтение)Читает файл«Прочитай readme.md»
Write (Запись)Создаёт новый файл«Создай файл plan.md с планом проекта»
Edit (Редактирование)Изменяет часть файла«Добавь раздел про конкурентов в market-brief.md»
Glob (Поиск файлов)Находит файлы по паттерну«Найди все markdown-файлы в проекте»
Grep (Поиск по содержимому)Ищет текст внутри файлов«Найди все упоминания SupportAI»
Bash (Команды)Запускает команды«Запусти npm install»

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

Самая частая операция. Просто попроси Claude прочитать файл:

Прочитай CLAUDE.md
Что написано в founder-context/COMPANY.md?
Покажи содержимое lesson-modules/0-getting-started/0.1-install/CLAUDE.md

Claude прочитает файл и покажет содержимое. Можешь сразу задавать вопросы о прочитанном:

Прочитай market-brief.md и расскажи основные выводы

@-упоминания

Это самая мощная фича для работы с файлами. Когда ты пишешь @filename, Claude автоматически читает этот файл и учитывает его содержимое.

Без @:

Проанализируй market brief

Claude может не знать, какой именно файл имеется в виду.

С @:

Проанализируй @market-brief.md

Claude гарантированно прочитает именно этот файл.

Несколько файлов

Сравни данные из @market-brief.md и @competitive-analysis.md.
Есть ли противоречия?

Файлы в подпапках

На основе @founder-context/COMPANY.md расскажи, что делает SupportAI

Когда использовать @

СитуацияИспользуй @
Анализ конкретного файлаПроанализируй @file.md
Сравнение файловСравни @a.md и @b.md
Создание на основе другого файлаНа основе @brief.md создай план
Обновление файлаОбнови @prd.md — добавь раздел X

💡 Правило: Если ты хочешь, чтобы Claude работал с конкретным файлом — используй @. Это как «прикрепить файл к письму».

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

Описываешь что хочешь — Claude создаёт:

Создай файл notes.md с заметками о встрече:
- Дата: 22 февраля
- Участники: Я, Клиент А
- Обсуждали: ценообразование и интеграции
- Следующие шаги: прислать proposal

Claude создаст файл с правильным форматированием. Ты увидишь содержимое и сможешь подтвердить или отменить.

Важно: Claude всегда спрашивает подтверждение перед созданием или изменением файлов. Ты контролируешь процесс.

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

Не нужно переписывать весь файл. Просто скажи, что изменить:

В @notes.md добавь в конец раздел "Открытые вопросы":
1. Какой бюджет у клиента?
2. Когда хотят запуститься?
В @market-brief.md замени "размер рынка: $500M" на "размер рынка: $750M"
Удали раздел "Риски" из @prd.md

Claude покажет, что именно изменится (диффы), и попросит подтверждение.

Поиск файлов

Когда не помнишь, как называется файл:

Найди все markdown-файлы в папке founder-context
Какие файлы есть в lesson-modules?
Найди файлы, в названии которых есть "brand"

Поиск по содержимому

Когда ищешь конкретную информацию:

В каких файлах упоминается "pricing"?
Найди все файлы, где есть слово "конкурент"
Где в проекте определяется целевая аудитория?

Практика: исследуй проект курса

Попробуй выполнить эти задания прямо сейчас в Claude Code:

Задание 1: Прочитай CLAUDE.md в корне проекта и расскажи, что это за курс.

Задание 2: Найди все файлы в папке founder-context/ и прочитай COMPANY.md.

Задание 3: Используя @-упоминания, попроси Claude сравнить @founder-context/COMPANY.md и @founder-context/PRODUCT.md.

Задание 4: Создай файл my-notes.md со своими заметками о курсе.

Задание 5: Найди все файлы, в которых упоминается «SupportAI».

Лучшие практики

  1. Используй @-упоминания — точнее, чем описывать файл словами
  2. Называй файлы понятноmarket-brief.md лучше, чем doc1.md
  3. Один файл = одна тема — не складывай всё в один огромный файл
  4. Проверяй изменения — Claude показывает, что изменит, перед применением
  5. Не бойся экспериментировать — всё можно откатить или переделать

Частые ошибки

ОшибкаРешение
«File not found»Проверь путь и название файла. Используй поиск: «Найди файлы с названием X»
Claude читает не тот файлИспользуй @ с полным путём: @folder/file.md
Изменения не те, что ожидалОткажись от изменений (нажми N) и переформулируй запрос
Слишком много файлов в выводеУточни запрос: «Только markdown-файлы в папке X»

Что дальше

Ты освоил основные операции с файлами. В следующем уроке — агенты, суб-агенты и память проекта. Это как перейти от работы в одиночку к управлению AI-командой.

Следующий урок: Агенты и память проекта →