Claude Code: Полное руководство по AI-ассистенту для разработчиков

Глава 3. Первые шаги с Claude Code

Итак, Claude Code установлен, аутентификация настроена, и вы готовы к работе. Откройте терминал и перейдите в каталог с проектом – или созданим новый:

mkdir -p ~/projects/my-first-project

cd ~/projects/my-first-project

claude

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

Интерфейс Claude Code состоит из нескольких элементов:

Строка приглашения (prompt) – символ >, за которым вы вводите свои запросы. Здесь вы общаетесь с AI на естественном языке: задаёте вопросы, ставите задачи, просите объяснить код.

Область вывода – пространство, где Claude Code отображает свои ответы, включая текст, код, визуализации прогресса и результаты выполнения инструментов.

Индикаторы инструментов – при выполнении операций (чтение файлов, запуск команд, запись в файлы) Claude Code показывает, какой инструмент используется и с какими параметрами. Это обеспечивает прозрачность: вы всегда видите, что именно делает AI.

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

Claude Code поддерживает несколько режимов работы:

Интерактивный режим (по умолчанию) – вы ведёте диалог с Claude Code, поочерёдно отправляя запросы и получая ответы. Это основной режим для повседневной работы.

claude # Запуск в интерактивном режиме

Однократный режим (print mode) – Claude Code обрабатывает один запрос и завершает работу. Удобно для скриптов и автоматизации.

claude –print "Объясни, что делает файл main.py"

Режим продолжения – возобновление предыдущего диалога:

claude –continue # Продолжить последний диалог

claude –resume # Выбрать из списка предыдущих диалогов

Pipe-режим – Claude Code принимает входные данные через стандартный ввод:

cat error.log | claude –print "Проанализируй эти логи ошибок"

git diff | claude –print "Проведи code review этих изменений"

Pipe-режим – невероятно мощная возможность, потому что он позволяет встраивать Claude Code в любой конвейер Unix-команд. Представьте:

grep -rn "TODO:" src/ | claude –print "Расставь приоритеты для этих задач"

git log –oneline -20 | claude –print "Напиши changelog из этих коммитов"

npm audit –json | claude –print "Объясни найденные уязвимости и предложи решения"

Каждое взаимодействие с Claude Code можно разложить на несколько фаз. Понимание этих фаз поможет строить более эффективные диалоги.

Вы вводите запрос на естественном языке. Claude Code принимает запрос, добавляет к нему системный контекст (содержимое CLAUDE.md, информацию о проекте, историю диалога) и отправляет на обработку.

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

> Добавь аутентификацию через JWT в наш API

Claude Code:

Для добавления JWT-аутентификации мне потребуется:

1. Установить необходимые зависимости (PyJWT, passlib)

2. Создать модель User

3. Написать функции хеширования паролей

4. Реализовать эндпоинты регистрации и входа

5. Создать middleware для проверки токенов

6. Обновить существующие эндпоинты

Начинаю с зависимостей…

Claude Code последовательно вызывает инструменты для реализации плана. Каждый вызов отображается в интерфейсе:

Tool: ReadFile

File: requirements.txt

Tool: Bash

Command: pip install PyJWT passlib[bcrypt]

Tool: WriteFile

File: app/models/user.py

[показ содержимого файла]

Tool: WriteFile

File: app/core/security.py

[показ содержимого файла]

Для потенциально опасных операций Claude Code запрашивает ваше подтверждение:

Tool: Bash

Command: pip install PyJWT passlib[bcrypt]

Allow? [Y/n/always]

Варианты ответа:

– Y или Enter – разрешить выполнение

– n – отклонить

– always – разрешить и запомнить для этого типа операций

После выполнения всех шагов Claude Code подводит итог:

Готово! Я добавил JWT-аутентификацию:

[+] Установлены PyJWT и passlib

[+] Создана модель User с хешированием пароля

[+] Реализованы эндпоинты /auth/register и /auth/login

[+] Создан middleware verify_token

[+] Обновлены защищённые маршруты

Для тестирования:

curl -X POST http://localhost:8000/auth/register \

-H "Content-Type: application/json" \

-d '{"email": "user@example.com", "password": "secret123"}'

Claude Code поддерживает набор слэш-команд для управления сессией. Разберём каждую подробно.

/help – Справка

> /help

Доступные команды:

/help Показать эту справку

/clear Очистить контекст диалога

/compact Сжать контекст (экономия токенов)

/status Информация о сессии

/cost Стоимость текущей сессии

/model Переключить модель

/permissions Управление разрешениями

/config Настройки

/bug Отправить отчёт об ошибке

/quit Выход

/clear – Сброс контекста

Команда /clear полностью сбрасывает контекст диалога. Используйте её, когда:

– Переключаетесь на совершенно другую задачу

– Контекст стал слишком большим и замедляет работу

– Claude Code «запутался» и даёт неадекватные ответы

После /clear Claude Code забудет всё, что обсуждалось ранее, но сохранит конфигурацию проекта (CLAUDE.md, settings и т. д.).

/compact – Сжатие контекста

/compact – одна из наиболее полезных команд. Она заставляет Claude Code сжать историю диалога, сохранив ключевую информацию, но уменьшив объём контекста. Это экономит токены и деньги.

> /compact

Контекст сжат:

До: 45 832 токена

После: 12 447 токенов

Сэкономлено: 33 385 токенов (~73%)

Рекомендуется вызывать /compact после каждого крупного блока работы – например, после завершения реализации конкретной функции.

Вы также можете указать фокус при сжатии:

> /compact Сфокусируйся на работе с базой данных

Claude Code сожмёт контекст, но сохранит детали, связанные

с базой данных, и удалит менее релевантную информацию.

/status – Информация о сессии

> /status

Session Info:

Model: claude-sonnet-4-20250514

Context used: 23,451 / 200,000 tokens (12%)

Messages: 14

Files read: 8

Files written: 3

Commands executed: 5

Duration: 12m 34s

Cost: $0.47

/cost – Детализация стоимости

> /cost

Cost Breakdown:

Input tokens: 187,234 ($0.32)

Output tokens: 41,892 ($0.15)

Cached tokens: 124,891 ($0.04)

Total: $0.47

Claude Code поддерживает стандартные горячие клавиши терминала:

– Ctrl+C – отменить текущую операцию или выйти

– Ctrl+D – выйти из Claude Code

– Up/Down – навигация по истории запросов

– Tab – автодополнение слэш-команд

– Ctrl+L – очистить экран (без сброса контекста)

– Esc – отменить ввод текущего промпта

Для длинных промптов используйте многострочный ввод. Нажмите \ в конце строки для продолжения на следующей, или используйте Shift+Enter (в поддерживающих терминалах):

> Создай REST API со следующими эндпоинтами: \

GET /users – список пользователей, \

POST /users – создание пользователя, \

GET /users/:id – получение пользователя, \

PUT /users/:id – обновление, \

DELETE /users/:id – удаление. \

Используй Express.js и MongoDB.

Контекстное окно – это «рабочая память» Claude Code. Всё, что вы обсудили, все прочитанные файлы и результаты выполненных команд хранятся в этом окне. Когда окно заполняется, старая информация начинает вытесняться, что может привести к потере контекста.

В зависимости от модели, контекстное окно Claude Code составляет:

– Claude Sonnet: ~200 000 токенов

– Claude Opus: ~200 000 токенов

– Claude Haiku: ~200 000 токенов

Один токен – это примерно 4 символа для английского текста и 1-2 символа для русского. Файл на 1000 строк занимает примерно 10 000-20 000 токенов.

1. Будьте избирательны. Не просите Claude Code «прочитай все файлы в проекте». Вместо этого укажите конкретные файлы или каталоги:

> Проанализируй весь проект

> Проанализируй файлы в каталоге src/auth/ – мне нужно

понять текущую систему аутентификации

2. Используйте /compact регулярно. Как упоминалось ранее, сжатие контекста высвобождает место для новой информации.

3. Разбивайте задачи. Вместо одного длинного диалога ведите несколько коротких. Завершили реализацию одной функции – начните новый диалог для следующей.

4. Используйте CLAUDE.md. Информация из CLAUDE.md загружается автоматически и занимает меньше места, чем повторные объяснения в диалоге.

5. Следите за индикатором. Команда /status показывает, какой процент контекстного окна использован. При приближении к 70-80% подумайте об оптимизации.

Когда контекстное окно заполняется, Claude Code применяет алгоритм сжатия:

– Старые сообщения сжимаются в краткие резюме

– Результаты выполненных команд усекаются

– Содержимое прочитанных файлов может быть частично удалено

– Системные промпты и CLAUDE.md сохраняются в приоритете

Вы можете заметить, что Claude Code «забыл» что-то, что обсуждалось ранее. Это нормально – просто напомните ему нужный контекст.

Давайте создадим полноценный проект, чтобы увидеть Claude Code в действии. Мы построим простое, но функциональное веб-приложение – менеджер заметок.

> Создай новый проект – менеджер заметок.

Стек: Node.js, Express, SQLite, EJS для шаблонов.

Базовая функциональность: создание, чтение, редактирование,

удаление заметок. Каждая заметка имеет заголовок, содержимое

и дату создания/обновления.

Claude Code начнёт работу:

– Создаст package.json с зависимостями

– Инициализирует npm-проект

– Создаст структуру каталогов:

notes-app/

+– package.json

+– server.js

+– database.js

+– routes/

| +– notes.js

+– views/

| +– layout.ejs

| +– index.ejs

| +– note.ejs

| +– edit.ejs

+– public/

| +– style.css

+– README.md

– Напишет код сервера, маршруты, модели и шаблоны

– Установит зависимости

– Проверит работоспособность

После генерации проверим, что всё работает:

> Запусти приложение и проверь, что главная страница открывается

Claude Code выполнит:

node server.js

И проверит доступность через curl или встроенный инструмент.

Теперь добавим функциональность:

> Добавь поиск по заметкам: поле поиска на главной странице,

которое фильтрует заметки по заголовку и содержимому.

Поиск должен быть нечувствительным к регистру.

Claude Code изменит несколько файлов:

– Добавит маршрут /search в routes/notes.js

– Добавит SQL-запрос с LIKE в database.js

– Обновит шаблон index.ejs, добавив форму поиска

– Обновит стили в style.css

Этот процесс можно продолжать сколько угодно:

> Добавь категории для заметок

> Добавь markdown-рендеринг в содержимом заметки

> Добавь экспорт заметок в PDF

> Добавь тёмную тему

Каждый запрос – это итерация, которая наращивает функциональность проекта. Claude Code помнит контекст предыдущих шагов и строит новые функции на существующей основе.

Работа с файлами – одна из основных возможностей Claude Code. Разберём ключевые операции.

Claude Code может читать файлы различными способами:

> Покажи содержимое файла server.js

> Прочитай все файлы в каталоге src/

> Что находится в package.json?

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

> Создай файл config.js с настройками приложения:

порт, строка подключения к БД, секретный ключ для JWT

Claude Code создаст файл с осмысленным содержимым:

// config.js

const config = {

port: process.env.PORT || 3000,

database: {

url: process.env.DATABASE_URL || 'sqlite:./data/app.db',

},

jwt: {

secret: process.env.JWT_SECRET || 'change-me-in-production',

expiresIn: '24h',

},

app: {

name: 'Notes Manager',

version: '1.0.0',

},

};

module.exports = config;

Claude Code может вносить точечные изменения, не перезаписывая весь файл:

> В файле server.js добавь middleware для логирования

запросов с помощью morgan

Claude Code прочитает файл, определит нужное место для вставки и внесёт минимальные изменения:

// Добавлено:

const morgan = require('morgan');

// …

app.use(morgan('dev'));

> Удали файл temp.js – он больше не нужен

Claude Code запросит подтверждение перед удалением.

> Переименуй database.js в db/connection.js

Claude Code создаст каталог, переместит файл и обновит все import/require-ссылки в проекте.

Одно из преимуществ агентного подхода – способность выполнять массовые операции:

> Добавь JSDoc-комментарии ко всем экспортируемым функциям

в каталоге src/utils/

Claude Code последовательно прочитает каждый файл, проанализирует функции, добавит документацию и сохранит изменения.

Claude Code может выполнять команды в терминале – это даёт ему возможность непосредственно взаимодействовать с операционной системой, инструментами разработки и инфраструктурой.

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

– Безопасные команды (чтение файлов, ls, cat, find, grep) – выполняются без подтверждения

– Команды разработки (npm run, pytest, go build) – зависят от настроек

– Потенциально опасные (установка пакетов, изменение конфигурации) – требуют подтверждения

– Опасные (rm, sudo, curl | bash) – всегда требуют подтверждения

Вы можете настроить уровень доверия через разрешения в .claude/settings.json.

Установка зависимостей:

> Установи необходимые зависимости для проекта

Claude Code: Для этого мне нужно выполнить:

npm install express ejs better-sqlite3 morgan

Allow? [Y/n/always]

Запуск тестов:

> Запусти тесты и исправь падающие

Claude Code выполнит `npm test`, проанализирует вывод,

найдёт причины ошибок и исправит код.

Сборка проекта:

> Собери проект для продакшена

Claude Code выполнит `npm run build`, проверит результат,

исправит проблемы при необходимости.

Работа с Git:

> Создай коммит с осмысленным сообщением

Claude Code проанализирует diff, сформулирует сообщение

и выполнит `git add` + `git commit`.

Анализ системы:

> Покажи использование дискового пространства в проекте

> Какие процессы занимают порт 3000?

> Проверь, запущен ли Docker

Claude Code может строить сложные конвейеры команд и анализировать их результаты:

> Найди все TypeScript файлы с неиспользуемыми импортами

Claude Code может выполнить:

npx ts-prune | head -50

И затем проанализировать результат, показав вам список

файлов с неиспользуемыми экспортами.

Одна из мощных возможностей Claude Code – способность самостоятельно навигировать по проекту. Вы не обязаны указывать точные имена файлов и пути – Claude Code найдёт нужное самостоятельно.

> Где определена функция calculateDiscount?

Claude Code использует grep/ripgrep для поиска:

rg "function calculateDiscount|calculateDiscount =" src/

И найдёт: src/utils/pricing.js:42

> Какие файлы импортируют модуль database.js?

Claude Code найдёт все файлы, которые используют

require('./database') или import from './database'.

> Опиши архитектуру проекта

Claude Code прочитает ключевые файлы (package.json,

структуру каталогов, основные модули) и составит

описание архитектуры.

> Найди все места, где используется deprecated API

из библиотеки axios

Claude Code выполнит поиск по шаблонам и покажет

результаты с контекстом.

Claude Code (через модели Claude) поддерживает мультимодальность – он может анализировать изображения. Это полезно в нескольких сценариях:

Если у вас есть макет интерфейса в виде изображения, вы можете передать его Claude Code:

> Вот макет главной страницы [скриншот].

Реализуй этот дизайн в HTML/CSS.

Claude Code проанализирует изображение и создаст HTML/CSS-код, максимально приближенный к макету.

> Вот скриншот ошибки в браузере [изображение].

Что может быть причиной?

Claude Code прочитает текст ошибки с изображения и предложит решение.

> Вот диаграмма архитектуры [изображение].

Создай Docker Compose файл на основе этой схемы.

За время работы с Claude Code сообщество выработало ряд паттернов, которые значительно повышают эффективность.

Структурируйте запросы в три блока:

> [Контекст] Мы разрабатываем e-commerce платформу на Django.

Сейчас работаем над модулем корзины покупок.

[Задача] Нужно реализовать функцию применения промокодов.

Промокод может давать процентную скидку (10%, 20%) или

фиксированную (500 руб, 1000 руб). Один промокод на заказ.

[Ограничения] Используй существующую модель CartItem.

Промокоды хранятся в таблице Promo. Валидацию делай на

уровне сервиса, не в модели.

Для сложных задач разбивайте работу на три этапа:

> Предложи архитектуру системы уведомлений.

Поддержка: email, push, SMS, in-app.

> Отлично, давай детализируем вариант с очередями.

Как будет выглядеть интерфейс NotificationService?

> Реализуй NotificationService согласно обсуждённому плану.

Перед внесением изменений в критический код попросите Claude Code показать план:

> Покажи, как ты собираешься изменить auth middleware,

но пока не меняй файлы. Я хочу посмотреть план.

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

После каждого блока изменений просите запустить проверку:

> Исправь ошибку в парсере и запусти тесты,

чтобы убедиться, что ничего не сломалось.

Этот паттерн помогает ловить регрессии на ранней стадии.

Когда вы хотите не просто получить код, но и понять решение:

> Реализуй алгоритм LRU-кэша и объясни каждый шаг,

как будто я джуниор-разработчик. Почему именно

такая структура данных? Какие альтернативы?

Claude Code поддерживает сохранение и возобновление диалогов, что позволяет продолжить работу с того места, где вы остановились.

claude –continue

claude -c

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

claude –resume

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

Для организации работы рекомендуется:

– Один диалог – одна задача (фича, баг, рефакторинг)

– Используйте /clear перед началом совершенно новой задачи

– Используйте --continue для продолжения незавершённой работы

– Делайте /compact перед сохранением длинного диалога

Закрепим полученные знания комплексным упражнением. Мы создадим, настроим и подготовим к деплою веб-приложение за один диалог.

Создайте приложение «Книжная полка» – каталог книг с возможностью добавления, редактирования, удаления, поиска и фильтрации по жанрам.

1. > Создай приложение "Книжная полка" на Express.js + SQLite + EJS.

Модель книги: название, автор, жанр, год, рейтинг, обложка (URL).

CRUD для книг, поиск, фильтрация по жанру.

Красивый, современный интерфейс.

2. > Запусти приложение и проверь, что всё работает.

3. > Добавь 10 тестовых книг из русской классики с реальными данными.

4. > Добейся, чтобы приложение красиво выглядело на мобильных устройствах.

Используй responsive дизайн.

5. > Добавь пагинацию: по 6 книг на страницу.

6. > Напиши тесты для API-эндпоинтов.

7. > Создай Dockerfile для деплоя.

8. > Напиши README.md с инструкциями по запуску и деплою.

После выполнения этого упражнения у вас будет полноценное приложение, готовое к развёртыванию, – и глубокое понимание рабочего процесса с Claude Code.

В этой главе мы:

– Освоили запуск Claude Code и интерфейс командной строки

– Изучили режимы работы: интерактивный, однократный, продолжение и pipe

– Поняли анатомию диалога: от запроса через планирование и выполнение к итогам

– Разобрали базовые слэш-команды: /help, /clear, /compact, /status, /cost

– Научились управлять контекстным окном для оптимальной работы

– Создали первый проект – менеджер заметок

– Освоили работу с файлами: чтение, создание, редактирование, удаление