В чём фокус
Claude Code — это не чат в браузере. Он живёт в терминале, видит папку проекта целиком, сам правит файлы и запускает команды. Отсюда и разница в работе: чату вы приносите кусок и вставляете ответ руками, агенту показываете проект и говорите, что должно получиться. Ниже — как поставить, как объяснить ему проект один раз, и почему набивать его навыками впрок вредно.
Что понадобится
- Node.js последней стабильной версии — без него агент не поставится
- Папка проекта. Одна папка равно один проект: агент читает то, что внутри
- Терминал. На Windows подойдёт встроенный, отдельный ставить не нужно
- Готовность разговаривать словами, а не командами: это главное умение здесь
Установка и первый запуск
Поставить Node.js
Берите стабильную версию с официального сайта. Проверить, что встало:
node -vв терминале должен показать номер.Поставить агента одной командой
В терминале:
npm install -g @anthropic-ai/claude-code. Установка глобальная, поэтому запускать его можно из любой папки.Открыть папку проекта и запустить
Перейдите в папку и наберите
claude. При первом запуске он попросит войти в аккаунт — это делается один раз.Сказать первую задачу словами
Не командой и не псевдокодом. «Посмотри, что в этой папке, и объясни, что тут вообще происходит» — нормальное начало.
Проверить, что всё встало, можно тремя короткими командами. Так это выглядит, когда установка прошла:
CLAUDE.md — главный файл проекта
Самая частая ошибка новичка — объяснять агенту одно и то же каждую сессию. Для этого
есть отдельное место, и у него есть имя: CLAUDE.md в корне проекта. Обычный
текстовый файл в формате разметки, который агент читает сам при каждом запуске.
Создать его можно руками, а можно командой /init — агент осмотрит проект и
предложит первую версию. Дальше вы её правите под себя: то, что он угадал, обычно
верно наполовину.
Вот как выглядит такой файл у небольшого проекта — это пример, а не мой рабочий:
Что имеет смысл писать:
- Что это за проект и для кого. Одним абзацем, без пафоса
- Стек и команды. Чем запускать, чем проверять, что нельзя ломать
- Правила, которые для вас важны. Язык комментариев, стиль, что делать нельзя
- Грабли этого проекта. Самое ценное. Всё, обо что вы уже спотыкались
Последний пункт объясню отдельно. Грабли — это не документация, а страховка от повторения. Один раз потратив час на выяснение, почему сборка падает без сообщения, вы записываете причину — и больше этот час не тратите ни вы, ни агент.
Команды и клавиши, которые нужны с первого дня
Команды набираются прямо в диалоге и начинаются с косой черты.
| Команда | Что делает | Когда нужна |
|---|---|---|
/init | Осматривает проект и предлагает первую версию CLAUDE.md | Один раз, в начале |
/clear | Стирает историю разговора, файл правил остаётся | Начали новую задачу — очистите |
/model | Переключает модель | Задача сложнее или проще обычной |
/help | Показывает всё остальное | Когда забыли команду |
Клавиши, которые экономят больше всего времени:
- Esc — прервать агента, не закрывая сессию. Понадобится в первый же день, когда он пойдёт делать не то
- Esc дважды — вернуться к прошлому сообщению и переписать его
- Shift+Tab — переключить режим разрешений на ходу
#в начале строки — записать правило прямо в память проекта, не открывая файл!в начале строки — выполнить команду в терминале как есть@— подставить путь к файлу с подсказками, чтобы не набирать руками
Про /clear отдельно. Разговор — это тоже расход: чем он длиннее, тем больше
места занимает и тем охотнее агент отвечает по памяти вместо того, чтобы перечитать
файлы. Правило простое: закончили задачу — очистили. Правила проекта при этом
никуда не денутся, они в файле.
Он читается целиком каждую сессию и занимает место, которого потом не хватит на работу. Держите его тонким: правила и карта, детали — в отдельных файлах.
Когда разговор разросся, агент опирается на то, что обсуждалось, а не на то, что сейчас в файлах. Если речь о состоянии дел — просите перечитать файл, а не пересказать.
Запуск из папки, где лежат три разных проекта, даёт агенту три контекста сразу и ни одного целиком.
Навыки: почему впрок ставить вредно
Навыки расширяют агента под конкретные задачи, и соблазн поставить сразу пачку понятен. Так делать не стоит, и у меня есть замер, а не ощущение.
Один чужой набор из сорока трёх навыков занял больше девяти тысяч токенов из десятитысячного бюджета. Описания навыков грузятся в каждую сессию, поэтому чужой набор почти целиком вытеснил описания моих собственных — они остались голыми именами, и выбор нужного навыка вслепую перестал работать. Набор при этом не пригодился ни разу: ставили под задачу, которой занимался другой инструмент.
Как правильно:
Нашли интересный набор — запишите, не ставьте
Сохраните команду установки и пометку, что оттуда полезно. Физически ставьте перед проектом, где это понадобится.
Прикиньте вес перед установкой
Каждое описание платится в каждой сессии. Вопрос не «полезно ли это», а «что оно вытеснит».
Ставьте частями
Из набора в сорок навыков обычно нужны два-три. Возьмите их, остальное оставьте в списке на будущее.
Разрешения: три режима и когда какой
Агент спрашивает разрешение перед тем, как менять файлы и запускать команды. Это не формальность: он работает в вашей папке по-настоящему.
- Спрашивать каждый раз — режим по умолчанию. Медленно, зато видно каждое действие. Так стоит начинать
- Разрешить заранее часть действий — среднее положение: рутина без вопросов, опасное с подтверждением
- Не спрашивать вовсе — быстро и уместно в песочнице, где не жалко. В рабочем проекте так запускать не стоит, пока не появилось чувство, чего от него ждать
Частые вопросы
- Чем это лучше обычного чата?
- Тем, что агент видит проект целиком и меняет его сам. В чате вы переносите куски туда-обратно руками и теряете контекст на каждом переносе.
- Нужно ли уметь программировать?
- Нет, но нужно уметь объяснить, что должно получиться, и проверить результат. Второе важнее первого: агент уверенно сообщает об успехе, а работает оно или нет — выясняется на живых данных.
- Он сломает мой проект?
- Может, поэтому первым делом заводится система контроля версий. С ней любое неудачное изменение откатывается одной командой, и страх пропадает.
- Какую модель выбирать?
- Начинайте с той, что стоит по умолчанию. Более мощную берите на сложные задачи, где качество важнее скорости, — она расходует лимит быстрее.