Как пользоваться Claude Code: первые шаги

Claude Code запускается командой claude из папки проекта. Первая задача должна быть на чтение, а не на правку: попросите объяснить незнакомый файл или найти, где обрабатывается конкретный случай — ошибка тогда ничего не стоит. Показывайте нужный файл и его зависимости, а не весь репозиторий.

Ниже — что делать в первый час, три режима работы с разрешениями и четыре ошибки, которые съедают деньги с первого дня.

Первый запуск

Откройте терминал в папке проекта и выполните:

claude

Откроется интерактивная сессия, привязанная к текущей директории. Агент видит файлы этой папки — не всей файловой системы.

Если команда не находится, установка не завершилась — проверка и диагностика в инструкции по установке. Быстрая проверка состояния:

claude doctor

Она печатает диагностику установки и настроек без запуска сессии.

Первая задача: читать, а не менять

Порядок, который экономит нервы и деньги.

Шаг 1. Попросите объяснить. «Что делает этот файл», «где обрабатывается случай, когда заказ отменён». Агент читает, вы проверяете ответ по коду. Ошибка стоит ноль, зато вы видите, насколько он понимает ваш проект.

Шаг 2. Попросите найти. «Найди все места, где вызывается эта функция». Проверяемо мгновенно.

Шаг 3. Попросите план. «Как бы ты добавил сюда обработку ошибок» — без правки, только план. Здесь становится видно, совпадают ли его представления с вашими соглашениями.

Шаг 4. Только потом правка. Одна маленькая, в файле, который не жалко.

Соблазн начать с четвёртого шага понятен, но первые три занимают пятнадцать минут и показывают, чего ждать.

Что показывать агенту

От этого зависит и качество, и счёт.

Нужный файл. Тот, с которым работаете.

Его прямые зависимости. Типы и функции, которые вызываются.

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

Тесты, если есть. Они показывают ожидаемое поведение лучше описаний.

Чего показывать не надо: весь репозиторий, конфигурацию сборки, историю. Лишний контекст разбавляет внимание и оплачивается при каждом шаге — подробно про формулировку задачи.

Режимы разрешений

Ключевая настройка, о которой стоит знать до первой правки.

Агент может читать файлы, изменять их и выполнять команды. Насколько свободно — решаете вы:

Спрашивать каждый раз. Медленно, зато вы видите каждое действие. Разумный режим для первой недели и для чужого проекта.

Разрешить чтение, спрашивать на запись. Рабочий компромисс: чтение безопасно, изменения подтверждаются.

Автоматический режим. Быстро и рискованно. Мы разбирали, что он делает по умолчанию — Claude Code auto mode.

Общее правило то же, что и для любого агента: необратимое подтверждает человек. Удаление файлов, изменение зависимостей, команды с сетью — какие права давать агенту.

Четыре ошибки первой недели

По частоте.

Длинная сессия на всё подряд. История переотправляется на каждом шаге, и к двадцатому вы платите за весь предыдущий разговор — включая отвергнутые варианты и промежуточные ошибки. Новая задача — новая сессия.

Показать весь проект «чтобы понял». Он не поймёт лучше, а счёт вырастет.

Просить сразу большой кусок. Модуль целиком получается хуже, чем три функции по очереди с проверкой между ними.

Принимать код без ревью. Сгенерированный фрагмент — обычный код: проверяйте существование вызываемых функций, отсутствие новых зависимостей и обработку ошибок.

Что проверять в результате

Четыре пункта, которые стоит сделать привычкой.

Существуют ли использованные функции. Агент уверенно вызывает методы, которых нет в вашей версии библиотеки. Самая частая ошибка.

Не появились ли новые зависимости. Каждая — ваше решение.

Обрабатываются ли ошибки. Сгенерированный код часто предполагает, что всё пройдёт удачно.

Совпадает ли со стилем проекта. Технически верный, но чужой по стилю код через полгода читать труднее.

Выбор модели

Практический вопрос, который влияет на счёт сильнее всего.

Claude Code работает по протоколу anthropic_messages, и в каталоге KeyDealer на 10 сентября 2026 года он открыт у всех восьми позиций Claude:

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

Прежде чем переходить на модель дороже, проверьте контекст: агент, которому показали нужные файлы, часто обходит более сильную модель, работающую вслепую.

Как понять, что расход в порядке

Три сигнала.

Расход на задачу, а не за месяц. Так видно, какие задачи дорогие.

Длина сессий. Если типичная сессия — сорок шагов, основной расход в истории, а не в задаче.

Доля правок после агента. Если правите почти всё, дело обычно в том, что ему мало показали.

Отдельный ключ под Claude Code даёт видимый расход именно по этому сценарию и предел на случай ошибки — как разводить ключи.

Что записать в память проекта

Приём, который экономит время на каждой следующей сессии.

Агент не помнит ничего между сессиями: соглашения проекта приходится объяснять заново. Решение — файл с описанием проекта в корне, который агент читает автоматически.

Что в него стоит положить:

Как запускать и тестировать. Команды сборки, тестов, линтера — то, что вы набираете руками каждый день.

Соглашения именования и структуры. Где что лежит и почему.

Чего делать нельзя. Не трогать сгенерированные файлы, не менять сигнатуры публичных функций, не добавлять зависимости без спроса.

Особенности, которые неочевидны. Почему здесь стоит странная проверка, какая библиотека используется вместо стандартной.

Правило наполнения простое: каждый раз, когда вы объясняете агенту одно и то же во второй раз, это идёт в файл. Через неделю он перестаёт спрашивать очевидное, а вы перестаёте платить за повторные объяснения в контексте.

Обратная сторона: файл уходит в модель при каждом обращении, поэтому держать его стоит коротким и вычищать устаревшее.

Чего мы не утверждаем

Не описываем весь интерфейс и команды. Они меняются с версиями; актуальное — в документации вендора.

Не сравниваем модели по качеству работы с кодом. Своих замеров мы не делали; проверять надо на своём стеке.

Не обещаем, что агент справится с вашей задачей. Многошаговость не добавляет знаний о вашем проекте.

Цифры каталога — на дату. 10 сентября 2026 года, 49 позиций в пятнадцати семействах.

Что нужно, чтобы начать

Ключ заводится за минуту на keydealer.ru/login — почта и пароль, без документов и без зарубежной карты. Оплата российской картой в рублях, один ключ на весь каталог: сменить модель — правка строки в конфигурации.

Платные текстовые модели доступны сразу на приветственном бонусе: пройти первые три шага из этой статьи — объяснить файл, найти вызовы, попросить план — можно без пополнения. Что выгоднее в долгую, подписка или ключ, — отдельный разбор.

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

Что держать в голове

Начинайте с чтения: три задачи на объяснение и поиск за пятнадцать минут показывают, чего ждать от агента на вашем проекте, и ничего не стоят при ошибке.

И держите сессии короткими. История переотправляется на каждом шаге — это главный источник неожиданного счёта в первую неделю, и лечится он новой сессией на новую задачу. Первый час стоит потратить на три задачи из начала статьи, а не на попытку сразу поручить агенту рабочую правку — так вы узнаете его поведение на своём проекте раньше, чем доверите ему что-то важное.

Как мы проверяем факты и что храним из запросов — на странице о проекте и в llms.txt. Завести ключ: keydealer.ru/login.