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».
Лучшие практики
- Используй @-упоминания — точнее, чем описывать файл словами
- Называй файлы понятно —
market-brief.mdлучше, чемdoc1.md - Один файл = одна тема — не складывай всё в один огромный файл
- Проверяй изменения — Claude показывает, что изменит, перед применением
- Не бойся экспериментировать — всё можно откатить или переделать
Частые ошибки
| Ошибка | Решение |
|---|---|
| «File not found» | Проверь путь и название файла. Используй поиск: «Найди файлы с названием X» |
| Claude читает не тот файл | Используй @ с полным путём: @folder/file.md |
| Изменения не те, что ожидал | Откажись от изменений (нажми N) и переформулируй запрос |
| Слишком много файлов в выводе | Уточни запрос: «Только markdown-файлы в папке X» |
Что дальше
Ты освоил основные операции с файлами. В следующем уроке — агенты, суб-агенты и память проекта. Это как перейти от работы в одиночку к управлению AI-командой.
