Как пользоваться Claude Code: первый день + 6 ошибок

Установка Claude Code занимает пять минут, а бросают его обычно в тот же вечер — не потому что инструмент плохой, а потому что с ним работают как с чат-ботом. Ниже — что делать в первый день, чтобы получить пользу, и шесть ошибок, из-за которых её не получают.

Что понадобится

• Установленный Claude Code — одна команда на Windows, macOS или Linux.
• Вход — подписка Pro/Max или API-ключ. Что выгоднее — в разборе цен.
• Настоящий проект. Не «hello world», а репозиторий, с которым вы правда работаете. На пустом проекте не видно ничего из того, ради чего инструмент нужен.
• Час времени. Первый заход — это знакомство, а не работа.

Опыт программирования желателен, но не обязателен: агент объясняет свои действия, если попросить.

1. Запустить в папке проекта

Claude Code работает в текущем каталоге. Перейдите в проект и запустите:

claude

Открывается сессия. Всё, что агент делает, происходит в этой папке и её подпапках — не в системе целиком.

2. Первой командой дать /init

Не задавайте задачу сразу. Первая команда в новом проекте — всегда эта:

/init

Агент обойдёт репозиторий, разберётся в структуре и создаст файл CLAUDE.md с правилами проекта: чем собирается, чем тестируется, какие соглашения приняты. Дальше он читает этот файл в каждой сессии.

Это одна минута, которая экономит десятки объяснений «у нас так не пишут».

3. Начать с вопроса, а не с правки

Правильная первая задача — та, которая ничего не меняет:

объясни, как устроен этот проект и где что лежит

почему падает тест в файле users.test.ts?

Вы увидите, как агент работает: какие файлы читает, что находит, насколько ему можно верить. И ничего не сломаете.

4. Ставить задачу как коллеге, а не как поиску

Главная разница с чат-ботом. Агенту не нужно скармливать код — он сам его найдёт. Ему нужно понимать задачу и границы.

Плохо: «напиши функцию валидации». Хорошо: «добавь проверку телефона в форме заявки — российский формат, показывать ошибку под полем, тесты рядом с существующими в этой же папке».

Три вещи, которые стоит называть всегда: что сделать, где, и чего не трогать.

ПолезноЕсли задача большая, попросите сначала план: «покажи, что собираешься сделать, но пока не меняй файлы». Читать план дешевле, чем разбирать десять изменённых файлов.

5. Разобраться с разрешениями

Агент спрашивает разрешение перед изменением файлов и запуском команд. Это раздражает на третий раз и спасает на тридцатый.

Разумный порядок для первого дня: отвечать вручную. Вы увидите, что именно агент собирается делать, и поймёте, где он предлагает лишнее.

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

6. Научиться откатывать

Самое важное умение первого дня, и оно не про Claude Code.

Работайте только в проекте под контролем версий. Перед тем как дать агенту задачу, убедитесь, что текущее состояние закоммичено. Тогда любой результат — это обратимый эксперимент, а не риск.

Если что-то пошло не так, вариантов два: попросить агента исправить («это сломало сборку, верни как было») или откатиться средствами системы контроля версий. Второе надёжнее.

7. Закончить сессию осмысленно

Перед выходом посмотрите, что изменилось: git diff. Не обязательно вчитываться в каждую строку — важно понимать масштаб.

И запишите в CLAUDE.md то, что пришлось объяснять агенту по ходу дела. В следующий раз объяснять не придётся.

Шесть ошибок первого дня

1. Работать без системы контроля версий. Тогда единственный способ откатить — вспомнить, что было. Это и есть причина большинства историй «агент сломал проект».

2. Пропустить /init. Без файла с правилами агент каждый раз угадывает соглашения проекта заново — и угадывает по-своему.

3. Копировать код в чат. Привычка от чат-ботов. Агент читает файлы сам; вставленный кусок только тратит контекст.

4. Давать задачу из пяти пунктов сразу. Агент сделает все пять, и разбираться придётся во всех сразу. По одной — быстрее в сумме.

5. Разрешить всё на первой минуте. Режим без вопросов удобен, когда вы знаете, чего ожидать. В первый день вы не знаете.

6. Спорить с агентом в одной сессии до победы. Если три попытки не помогли, дело обычно в постановке. Начните заново с другой формулировкой — это дешевле и по времени, и по токенам.

Что дальше, когда основное понятно

• Команды — шесть слэш-команд, которыми делается почти вся работа, плюс неинтерактивный режим для скриптов.
• Скиллы — знания и правила, которые агент подхватывает сам, когда они нужны.
• MCP-серверы — доступ к базам, браузеру, внешним системам.
• Плагины — готовые наборы скиллов, команд и агентов одной командой.
• Работа в VS Code — если терминал не ваш формат.

Коротко о главном

• Запускайте в папке проекта, первой командой — /init.
• Первая задача — вопрос, а не правка: увидите, как агент думает, и ничего не сломаете.
• Формулируйте что, где и чего не трогать. Код в чат не копируйте.
• На большой задаче сначала просите план.
• Работайте только под контролем версий: это превращает любую ошибку в обратимую.
• Разрешения расширяйте по мере доверия, а не сразу.

Не работает команда claude или агент падает на входе — разбор частых ошибок. Что это вообще за инструмент и чем отличается от Cursor — в сравнении.