Claude Code: установка, настройка и первые шаги

Claude Code — это официальный CLI-инструмент от Anthropic, который превращает терминал в полноценную среду разработки с AI-ассистентом. В отличие от веб-интерфейса, Claude Code работает напрямую с вашей файловой системой, git-репозиториями и командной строкой. Он может читать и редактировать файлы, запускать команды, анализировать кодовые базы из тысяч файлов и выполнять сложные многоэтапные задачи — всё в контексте вашего реального проекта.

Это не просто чат-бот, который генерирует код в вакууме. Claude Code понимает структуру вашего проекта, его зависимости, конфигурации и паттерны. Он может создать коммит, исправить баг, написать тесты или развернуть приложение — и всё это одной командой в терминале.

Claude Code устанавливается через npm как глобальный пакет. Перед установкой убедитесь, что у вас Node.js версии 18 или выше. Рекомендуется использовать nvm для управления версиями Node.js — это позволяет легко переключаться между версиями для разных проектов.

Шаг 1: Установка Node.js через nvm

Если у вас ещё нет nvm, установите его командой curl из официального репозитория. После установки перезагрузите терминал и установите последнюю LTS-версию Node.js. На момент написания статьи это Node.js 22. Проверить успешность установки можно командой node --version — должна отобразиться версия 22.x.x или выше.

Шаг 2: Глобальная установка Claude Code

Выполните npm install -g @anthropic-ai/claude-code. Установка занимает около минуты. После этого команда claude станет доступна в любом каталоге. При первом запуске Claude Code предложит авторизоваться через Anthropic Console — вам потребуется аккаунт с активной подпиской Max или Team.

Шаг 3: Первый запуск

Перейдите в каталог вашего проекта и выполните claude. Инструмент проанализирует структуру проекта: прочитает package.json, README, конфигурационные файлы, .gitignore и другие метаданные. На основе этого анализа Claude Code формирует понимание контекста — какой это стек, какие зависимости используются, какая структура каталогов принята в проекте.

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

• /help — вывести список всех доступных команд и краткую справку
• /clear — очистить контекст текущей сессии для экономии токенов
• /compact — сжать историю диалога, сохранив ключевые моменты
• /cost — посмотреть, сколько токенов было использовано в текущей сессии
• /doctor — диагностика конфигурации и подключений
• /init — создать файл CLAUDE.md для проекта с рекомендациями по работе
• /review — запустить ревью кода текущих изменений (git diff)
• /memory — просмотреть и управлять долгосрочной памятью Claude

Одна из мощнейших функций — возможность работать в headless-режиме. Команда claude -p "задача" выполнит задачу без интерактивного диалога и вернёт результат в stdout. Это идеально для CI/CD-пайплайнов, автоматических ревью и скриптов.

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

Что писать в CLAUDE.md

• Описание стека проекта: фреймворки, языки, основные библиотеки
• Правила кодстайла: именование переменных, структура файлов, форматирование
• Запреты: что категорически нельзя делать (удалять БД, force-push, коммитить секреты)
• Команды для сборки, тестирования, деплоя — чтобы Claude мог запускать их самостоятельно
• Описание архитектуры: как устроены модули, куда класть новые компоненты
• Список MCP-серверов и внешних интеграций проекта

Model Context Protocol (MCP) — это открытый стандарт, который позволяет подключать к Claude Code внешние инструменты. Через MCP Claude может управлять браузером, работать с базами данных, отправлять сообщения в Telegram, управлять Google Sheets и Calendar, взаимодействовать с API любых сервисов — всё это нативно, без написания промежуточного кода.

Как подключить MCP-сервер

MCP-серверы настраиваются в файле .mcp.json в корне проекта или глобально в ~/.claude/. Каждый сервер описывается как запись с командой запуска и параметрами. Claude Code автоматически обнаруживает доступные инструменты при подключении к серверу и может использовать их в ответ на ваши запросы.

Существуют десятки готовых MCP-серверов: для PostgreSQL, Supabase, GitHub, Slack, файловых систем, Docker, Kubernetes и многих других. Вы также можете написать собственный MCP-сервер — это TypeScript или Python приложение, реализующее протокол через stdio или HTTP.

Агенты — это специализированные конфигурации Claude Code для конкретных задач. Они хранятся в каталоге .claude/agents/ внутри проекта и представляют собой Markdown-файлы с инструкциями. Например, агент code-reviewer.md может содержать правила ревью, специфичные для вашего проекта: на какие паттерны обращать внимание, какие антипаттерны запрещены, какой уровень покрытия тестами считается приемлемым.

Skills (навыки) — это переиспользуемые действия, которые вызываются через слеш-команды. Они хранятся в .claude/skills/ и описывают пошаговые процедуры: как создать новый компонент, как выполнить миграцию базы данных, как подготовить релиз. Навык может включать шаблоны файлов, последовательности команд и проверочные шаги.

Пример создания агента

Создайте файл .claude/agents/debugger.md. Внутри опишите: какие логи проверять, как воспроизводить баги, в каком порядке искать причину ошибки, какие инструменты мониторинга использовать. Теперь при вызове /debugger Claude будет следовать этому алгоритму, а не действовать по общим принципам.

Хуки в Claude Code — это автоматические действия, которые срабатывают при определённых событиях. Они настраиваются в файле settings.json и могут перехватывать моменты до и после выполнения команд, создания файлов, внесения изменений. Это мощный механизм для обеспечения качества: можно автоматически запускать линтер после каждого редактирования файла, прогонять тесты после изменения логики или форматировать код по стандартам проекта.

• PreToolUse — срабатывает перед выполнением любого инструмента (команды, редактирования)
• PostToolUse — срабатывает после выполнения, позволяет проверить результат
• Notification — отправляет уведомления при завершении длительных задач
• Хуки могут блокировать действие, если проверка не прошла — например, запретить коммит без тестов

1. Начинайте с контекста

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

2. Используйте /compact для длинных сессий

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

3. Декомпозируйте задачи

Вместо "сделай мне полное приложение" разбивайте работу на этапы: сначала структура проекта, потом модели данных, потом API, потом фронтенд. Claude Code лучше работает с конкретными, хорошо определёнными задачами, чем с расплывчатыми мега-запросами.

4. Проверяйте и итерируйте

Всегда просматривайте изменения перед коммитом. Claude Code показывает diff после каждого редактирования — используйте это. Если что-то не так, скажите прямо: "это неправильно, потому что..." — чем конкретнее обратная связь, тем быстрее итерация.

5. Автоматизируйте рутину через навыки

Если вы замечаете, что часто повторяете одни и те же шаги — создайте навык. Деплой, создание компонентов, настройка тестов, генерация миграций — всё это кандидаты на автоматизацию через .claude/skills/. Один раз описали — используете в каждой сессии.

Claude Code — это не просто ещё один AI-инструмент. Это среда, в которой программист и AI работают в тандеме: вы задаёте направление, а Claude Code выполняет тяжёлую работу — от анализа тысяч файлов до рефакторинга, тестирования и деплоя. С правильной настройкой через CLAUDE.md, агентов, навыков и хуков, вы получаете ассистента, который знает ваш проект так же хорошо, как вы сами. Начните с установки, создайте первый CLAUDE.md — и через час вы уже не захотите работать по-старому.