AI-гайд

Claude Code для не-программистов

Claude Code — это не «ещё один чат». Это инструмент, который читает файлы проекта, запускает команды в терминале и вносит изменения сам. Официальная документация предполагает базовый опыт разработки: она идёт через ключевые слова вроде «Bash», «CI», «hooks». Эта статья — нейтральный мост для тех, кто подходит к Claude Code со стороны Claude Chat.

Чем Claude Code отличается от Chat

	Claude Chat	Claude Code
Работает с	диалогом, прикреплёнными файлами	файлами проекта целиком + диалогом
Может запускать команды	нет	да (bash, тесты, серверы)
Может менять файлы на диске	нет	да
Среда	браузер / Claude Desktop	терминал или IDE
Спрашивает разрешения	не нужно	перед изменениями

Что вы даёте — что получаете

Вы даёте Claude Code:

• доступ к папке с проектом (он читает оттуда файлы);
• описание задачи на естественном языке;
• разрешения на нужные действия (писать в файлы, запускать тесты).

Получаете:

• измененные файлы;
• запущенные тесты с результатами;
• комментарий «что сделал и почему».

Первый запуск: шаги

1. Открыть терминал в папке проекта.
2. Запустить claude (после установки Claude Code CLI).
3. Начать с простой команды: «почитай файлы, скажи, из чего состоит проект».
4. Попросить что-то маленькое: «добавь комментарий в README.md». Когда Claude попросит разрешения — согласиться.
5. Посмотреть результат. Если всё ок — двигаться к реальной задаче.

Plan mode: думать, прежде чем делать

Claude Code умеет «режим плана»: модель читает, отвечает на вопросы, но файлы не трогает. Включается Shift+Tab (или командой в меню). Используйте его, когда:

• задача новая, непонятно, с какого конца подойти;
• вы боитесь, что модель сломает что-то важное;
• нужно согласовать план до того, как начнутся правки.

Сценарий: «войдите в plan mode. Прочитай проект. Составь план, как добавить страницу X. Файлы не правь, только план». Получив план — правите его на словах, только потом выходите из plan mode и даёте реализовать.

CLAUDE.md: память проекта

Это файл в корне проекта, который Claude Code читает в начале каждой сессии. Туда стоит класть правила, которые должны соблюдаться всегда:

• стиль (табы / пробелы, названия переменных);
• команды запуска тестов, линтеров;
• «особенности» проекта, которые неочевидны из кода;
• соглашения по коммитам, именам веток.

Держите его коротким. Длинный CLAUDE.md модель «разжижает» — правила теряются на фоне шума. 20–40 строк — хороший ориентир. Для старта запустите /init, Claude сгенерирует первый черновик на основе проекта.

Как давать контекст

Один из самых частых провалов: вы даёте общую команду, модель понимает её шире, чем надо, и ломает что-то соседнее. Лекарство — конкретика:

• Указывайте файлы. «@src/auth.ts добавь логгирование в функцию login». Символ @ делает Claude файл видимым.
• Показывайте пример. «Сделай как в HotDogWidget.php, только для календаря».
• Говорите, как проверить. «Добавь тест, который проверяет, что функция возвращает 400 при пустом email».

Самопроверка

Claude Code умеет проверять себя сам — но только если вы об этом попросите. Стандартная связка:

1. Попросить сделать изменение.
2. Попросить запустить тесты / линтер / билд.
3. Если что-то упало — попросить починить и повторить проверку.

Формулировка «после этого запусти тесты, если что-то упало — почини и повтори» превращает одну задачу в замкнутый цикл. Часто этого хватает, чтобы модель решила задачу полностью, без вашего участия между шагами.

Откат и «переиграть заново»

• Esc — остановить Claude в середине действия.
• Esc Esc или /rewind — откатить состояние на любую предыдущую точку.
• /clear — сбросить контекст разговора, начать заново с той же папкой.

Поскольку Claude Code делает checkpoints автоматически, можно смело говорить «попробуй вот этот подход». Если не получилось — rewind и другой подход.

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

• Слишком абстрактные задачи. «Сделай красиво» — не задача. «Сделай кнопку зелёной, по ховеру темнее на 10%» — задача.
• Не проверять результат. Если вы ни разу не запустили код — вы не знаете, что он работает.
• Смешивать задачи в одной сессии. Контекст переполняется, модель начинает «забывать» правила из CLAUDE.md.
• Игнорировать запросы на разрешение. Claude Code спрашивает перед опасными действиями. Если вы кликаете «да» не читая — рано или поздно вы согласитесь на что-то ненужное.