Знакомство с Claude Code в 2026: от установки до первого коммита

Что такое Claude Code на самом деле

Claude Code — это не чат-интерфейс. Это агент командной строки, который читает Вашу файловую систему, выполняет bash-команды, редактирует файлы и итерирует поверх собственного вывода до тех пор, пока не достигнет описанной Вами цели. Вы запускаете его в каталоге проекта, ставите задачу — и он шаг за шагом её решает: читает существующий код, вносит изменения, запускает тесты и возвращается на круг при сбое.

Практическое следствие: Claude Code лучше всего работает с реальными, чётко очерченными задачами в реальных кодовых базах. Запрос «помоги с моим проектом» порождает дрейф. Запрос «добавь валидацию ввода в функцию createUser в файле src/api/users.ts и обнови соответствующие тесты» порождает результат.

Шаг 1 — Установка

npm install -g @anthropic-ai/claude-code

Убедитесь, что установка прошла успешно:

claude --version
# → claude-code 1.x.x

Если на macOS или Linux появляется ошибка прав доступа, стандартное решение — поправить владение глобальной директорией npm, а не запускать npm под sudo. В документации Anthropic это разобрано в разделе предварительных требований. На Windows запуск терминала от имени администратора закрывает большинство проблем с правами, но для тяжёлой агентной работы надёжнее путь через WSL2.

Шаг 2 — Аутентификация

claude login

Команда открывает браузер для прохождения OAuth. После завершения учётные данные сохраняются в ~/.claude/, и повторять шаг не нужно — кроме случая смены аккаунта.

Если Вы используете API-ключ напрямую — например, в CI-окружении или на машине без браузера — задайте переменную окружения:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Подписка Claude Pro включает месячную квоту токенов, покрывающую умеренное индивидуальное использование. Если Вы запускаете Claude Code на крупных кодовых базах, пишете обширные тесты или гоняете его в циклах — Вы, скорее всего, упрётесь в лимит Pro и придётся доплачивать кредитами API. Консоль Anthropic показывает потребление в реальном времени — после первых сессий загляните туда, чтобы откалибровать ожидания.

Шаг 3 — Напишите свой CLAUDE.md

Минимальный, но рабочий CLAUDE.md покрывает пять вещей:

# Проект: [название]

## Стек
- Среда выполнения: Node 20, TypeScript 5.3
- Фреймворк: Next.js 14 (App Router)
- БД: PostgreSQL через Prisma
- Тесты: Vitest, запуск через `npm test`

## Команды
- Dev-сервер: `npm run dev`
- Сборка: `npm run build`
- Линт: `npm run lint` — исправлять до коммита
- Миграции: `npx prisma migrate dev`

## Правила
- Все новые API-маршруты — в src/app/api/
- Zod для всей валидации ввода — без прямого доступа к req.body
- Никогда не трогать каталог /legacy/
- Не убирать вызовы console.error в обработчиках ошибок

## Запрещено
- Устанавливать пакеты через npm install без согласования
- Менять файлы .env
- Запускать миграции БД без подтверждения

Раздел «Запрещено» — тот, что большинство разработчиков пропускают на первом проходе, и тот, что предотвращает дорогие ошибки. Если есть файлы, которые Claude никогда не должен трогать, — назовите их. Если есть команды, которые он не должен запускать автономно, — скажите это явным образом.

Подробное руководство по структуре CLAUDE.md есть в нашем материале о том, как писать CLAUDE.md, который действительно работает. Пакет Septim Starter ($9) включает обкатанные шаблоны для пяти типичных типов проектов — Next.js, Python Flask, Rails, Go и обычный Node — чтобы Вы не начинали с пустого файла.

Шаг 4 — Поставьте реальную задачу

cd ~/projects/my-app
claude

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

• Добавить лимитер запросов к маршруту /api/login — 5 попыток в минуту с одного IP, 429 при превышении
• Написать юнит-тесты для каждой функции в src/lib/date-utils.ts — целевое покрытие веток 90%
• Отрефакторить src/components/UserTable.tsx на React Query вместо чистых fetch-вызовов

Claude Code прочитает релевантные файлы, предложит изменения и спросит разрешение перед записью на диск или запуском команд. В стандартной конфигурации он подтверждает каждую операцию записи — это правильный режим для обучения. Когда поведение инструмента станет понятным, разрешения можно ослабить или ужесточить в ~/.claude/settings.json.

Что происходит во время агентного цикла

Типовая задача в Claude Code проходит такой цикл:

1. Чтение релевантных исходников для понимания текущей структуры
2. Предложение плана реализации и список файлов, которые будут затронуты
3. Внесение изменений по файлам с пояснениями
4. Запуск тестов (если они описаны в CLAUDE.md) и итерация по падениям
5. Отчёт о завершении и список всех изменённых файлов

На простых задачах — добавление поля в форму, написание небольшой утилиты, исправление ошибки типизации — это занимает меньше двух минут. На крупных (рефакторинг модуля, фича от и до) — закладывайте 5–15 минут и несколько раундов итераций.

Шаг 5 — Проверьте расходы

Консоль Anthropic по адресу console.anthropic.com показывает расход токенов с разбивкой по моделям и датам. После двух-трёх первых сессий загляните на дашборд, чтобы понять скорость сжигания токенов прежде, чем браться за более длинные задачи.

Три паттерна, ведущих к неожиданным расходам:

• Крупные файлы в контексте. Если Claude Code прочитает файл на 10 000 строк ради ответа об одной функции — Вы заплатили за 10 000 строк входных токенов. Указывайте на конкретные файлы, а не задавайте широкие вопросы по всей кодовой базе.
• Повторное наращивание контекста. Каждое новое сообщение в сессии заново отправляет всю историю разговора. Длинные сессии становятся дорогими. Под несвязанные задачи начинайте новые сессии, а не тяните одну на весь день.
• Порождение субагентов. Claude Code умеет запускать субагентов для параллельной работы. У каждого субагента собственный контекст. Несколько одновременных агентов — пропорциональный рост стоимости. Гайд про Токеналипсис разбирает это подробно — см. разбор стоимости субагентов.

Одна хорошо очерченная задача обычно обходится в $0.05–$0.40 кредитов API в зависимости от размера файлов и сложности. Сессия, в которой Вы просите Claude Code сначала разобраться во всей кодовой базе, может стоить несколько долларов. CLAUDE.md, написанный на шаге 3, существенно сокращает этот второй паттерн — заранее предоставленный контекст замещает токены, которые иначе ушли бы на разведку.

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

Просьба «посмотреть на проект и сказать, что не так»

Это сжигает окно контекста на рыбалку. На выходе — общее ревью кода, в котором, возможно, найдутся реальные проблемы, но ценой существенных токенных затрат. Используйте Septim Drills ($29) для структурированных упражнений по ревью кода или направляйте Claude Code на конкретный файл с конкретным вопросом.

Не читать план перед его утверждением

Claude Code сначала предлагает план, а уже потом исполняет. Читайте его. На сложных задачах в плане иногда оказываются шаги, которые Вы бы не санкционировали — удаление таблицы, снятие слоя кэша, правка специально исключённого файла. Поймать это на стадии плана — бесплатно. Поймать после записи — это git revert.

Запуск без системы контроля версий

Claude Code пишет на диск. Запускайте его только в репозиториях с чистым рабочим деревом, чтобы можно было сделать git diff по любым изменениям и git checkout . для всего, с чем Вы не согласны. Если Вы ещё не используете git — инициализируйте репозиторий до первой сессии.

Пропуск CLAUDE.md

Без CLAUDE.md Claude Code выводит контекст проекта из обхода файлов. Этот вывод стоит токенов и часто ошибается насчёт принятых соглашений, запрещённых команд и тестового раннера. Двадцать минут, потраченные на CLAUDE.md в шаге 3, окупятся за первую же неделю работы.

Куда двигаться дальше

Когда у Вас за плечами несколько успешно решённых задач, естественный следующий шаг — расширение Claude Code MCP-серверами: интеграциями, дающими ему доступ к внешним инструментам — Вашей БД, GitHub, браузеру. Практическое прохождение — в туториале по MCP-серверам.

Если Вы используете Claude Code в команде и хотите автоматизировать ревью пул-реквестов — руководство по настройке PR-ревью покрывает конфигурацию GitHub Action от и до.

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