На прошлой неделе я попросил Claude Code переписать устаревший модуль авторизации в одном из своих проектов. Не «помоги написать» — а именно сделай: прочитай код, разберись с зависимостями, перепиши, напиши тесты, убедись что всё работает. Я пошёл пить кофе.
Вернулся через 20 минут. 400 строк legacy-кода переписаны, 12 тестов написаны, все проходят. PR готов.
Claude Code — это не обычный AI-ассистент, которому ты диктуешь код. Это агент, который действует сам: открывает файлы, запускает команды, коммитит изменения, запускает тесты. Это принципиально другой класс инструментов.
В этом гайде разберём всё с нуля: установка, первая сессия, настройка под проект, режимы работы и продвинутые возможности.
Что такое Claude Code и чем отличается от обычного Claude
Большинство людей знакомы с Claude через веб-интерфейс — заходишь на claude.ai, пишешь в чат, получаешь ответ. Полезно, но это как обсуждать ремонт квартиры с другом — советы даёт, но молоток в руки не берёт.
Claude Code — другое. Это CLI-агент, который живёт в терминале и имеет прямой доступ к вашему окружению.
| Параметр | Claude.ai | Claude Code | Cursor |
|---|---|---|---|
| Интерфейс | Веб-чат | Терминал (CLI) | Редактор кода |
| Видит файлы проекта | Нет (только что вставишь) | Да, всю файловую систему | Да (открытый проект) |
| Запускает команды | Нет | Да (npm, git, pytest...) | Ограниченно |
| Делает коммиты | Нет | Да | Нет |
| Автономность | Низкая | Высокая | Средняя |
| Нужен IDE | Нет | Нет | Да |
По сути, Claude Code — это AI-разработчик рядом с вами в терминале. Он читает код, понимает структуру проекта, запускает тесты и делает изменения. Не подсказывает — делает.
На GitHub у официального клиента 103k+ звёзд. Для продукта, которому меньше года, это показательно.
Для понимания того, как работает контекст и почему это важно для агентов — см. Контекст инжиниринг: промпт — это не строка, а система.
Установка за 5 минут: Mac, Windows, Linux
Единственное требование — Node.js версии 18 или выше. Проверить просто:
node --version
# Должно быть v18.x.x или вышеЕсли Node.js ещё нет — идёте на nodejs.org, скачиваете LTS-версию.
Установка Claude Code
npm install -g @anthropic-ai/claude-codeУстановка занимает примерно минуту. После — проверяем:
claude --versionДолжно вывести что-то вроде claude-code 1.x.x. Если вывело — всё хорошо.
Авторизация
claude loginОткроется браузер, попросит войти через аккаунт Anthropic и дать разрешение. Один раз — и всё, токен сохраняется локально.
Инфо
Claude Code входит в подписку Max ($100/мес) — там лимиты выше. Для начала достаточно Pro ($20/мес) или API-ключа с pay-as-you-go. При регистрации дают небольшой бесплатный кредит.
Если есть API-ключ (без подписки)
export ANTHROPIC_API_KEY=sk-ant-...
claude login --api-keyДля Windows — то же самое, только через PowerShell или WSL. На Linux всё идентично Mac.
Первая сессия: что делать сразу после установки
Лучший способ начать — взять реальный проект, а не «тестовый». Claude Code раскрывается именно на живом коде, где есть контекст.
cd /path/to/your/project
claudeЗапускается интерактивная сессия. Первый запрос, который я делаю в любом новом проекте:
Объясни мне структуру этого проекта. Что здесь происходит, какие основные части, как они связаны.
Claude Code пройдётся по файлам, прочитает package.json или requirements.txt, посмотрит структуру директорий — и выдаст реальный анализ. Не «типичный Node.js проект», а конкретно ваш.
Практические запросы для первой сессии
Найти проблему в коде:
Посмотри функцию processPayment в src/payments.ts — там что-то не так с обработкой ошибок. Что думаешь?
Написать тест:
Напиши unit-тест для функции calculateDiscount в utils/pricing.js. Используй Jest.
Рефакторинг:
Этот компонент стал слишком большим — src/components/Dashboard.tsx. Раздели на несколько маленьких, сохрани логику.
Найти баг:
Запусти тесты. Если есть падающие — разберись почему и почини.
Честно говоря, я был удивлён насколько точно он понимает контекст. Не нужно объяснять «у нас Next.js, мы используем TypeScript» — он сам читает конфигурационные файлы и понимает стек.
CLAUDE.md: один раз настроил — больше не объясняешь
Вот где начинается настоящая магия. CLAUDE.md — это файл в корне вашего проекта, который Claude Code читает при каждом запуске. Аналог .cursorrules, только мощнее.
Без CLAUDE.md вы каждый раз объясняете агенту: «у нас React, мы не используем классовые компоненты, eslint конфиг вот такой». С CLAUDE.md — он читает это один раз при старте.
Пример CLAUDE.md для TypeScript-проекта
# Проект: E-commerce Platform
## Стек
- Node.js 20 + TypeScript 5.x
- Next.js 14 (App Router)
- PostgreSQL + Prisma ORM
- Tailwind CSS
- Jest + Playwright для тестов
## Соглашения по коду
- Все компоненты — функциональные, без классов
- Именование: PascalCase для компонентов, camelCase для утилит
- Файлы: kebab-case (user-profile.tsx, not UserProfile.tsx)
- Экспорты: именованные, не дефолтные (кроме компонентов страниц)
- Типы: строгие, no `any`, prefer `unknown` над `any`
## Структура проекта
- /app — Next.js App Router страницы
- /components — переиспользуемые React-компоненты
- /lib — утилиты, хелперы, конфиги
- /prisma — схема БД и миграции
- /tests — unit и e2e тесты
## Что нельзя делать
- Не коммить в main напрямую — только через PR
- Не изменять файлы в /prisma/migrations вручную
- Не использовать .env напрямую — только через src/config.ts
- Не добавлять console.log в production код (только logger из /lib/logger)
## Запуск проекта
- Разработка: `npm run dev`
- Тесты: `npm test` (unit), `npm run test:e2e` (playwright)
- Билд: `npm run build`После добавления этого файла агент сразу знает контекст. Не нужно повторять «не используй console.log» каждый раз.
Совет
CLAUDE.md работает иерархически: есть глобальный (~/.claude/CLAUDE.md для настроек, которые применяются везде) и локальный (в корне проекта). Локальный переопределяет глобальный.
Подробнее о том, как устроены системные промпты и CLAUDE.md как форма контекст инжиниринга.
Режимы разрешений: как управлять автономией агента
Это один из вопросов, который задают чаще всего. Claude Code может быть очень автономным — но как настроить, насколько?
Есть три режима:
Default Mode (по умолчанию)
Каждое действие — подтверждение. Агент хочет создать файл? Спрашивает. Хочет запустить команду? Спрашивает.
Хорошо для: знакомства с инструментом, критичных проектов где нужен полный контроль.
claude
# каждый tool call потребует нажать Enter или "n"Auto Mode
Встроенный классификатор безопасности сам решает, какие действия разрешить автоматически. Безопасные операции (читать файл, писать код, запускать тесты) — без вопросов. Потенциально опасные (деплой, отправка данных наружу, изменение конфигурации CI) — запросит подтверждение.
claude --auto-modeЭто тот режим, который я использую для большинства задач. Агент работает быстро, но не делает ничего необратимого без моего ведома.
Про автономный режим есть отдельная подробная статья — там разобраны кейсы и ограничения.
--dangerously-skip-permissions
claude --dangerously-skip-permissionsВсё без вопросов. Именно то, что написано на банке — опасно. Не использовать на продакшн-окружении, с чувствительными данными или деплой-скриптами.
Когда это оправдано: автоматизированные CI-пайплайны в изолированной среде, одноразовые скрипты на тестовых данных. Для обычной разработки — слишком рискованно.
Продвинутые возможности: hooks, skills, multi-agent
Когда базовый сценарий освоен, начинается интересное.
Hooks — автоматические действия по событиям
Hooks позволяют выполнять команды автоматически при определённых событиях в работе агента. Например:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write",
"hooks": [
{
"type": "command",
"command": "prettier --write $CLAUDE_TOOL_RESULT_FILE_PATH"
}
]
}
]
}
}Теперь каждый раз, когда Claude Code пишет файл — prettier автоматически форматирует его. Не нужно просить агента «отформатируй код» — это происходит само.
Другие применения hooks: автозапуск линтера, обновление документации, отправка уведомлений в Slack о завершённых задачах.
Skills — переиспользуемые инструкции
Skills — это библиотека готовых инструкций для конкретных задач. Написал однажды промпт «как делать code review в нашем проекте» — и вызываешь его командой /review.
Фреймворк Superpowers выводит это на уровень выше: целые pipeline-ы задач, встроенные лучшие практики, автоматизация повторяющихся процессов.
Если скилл есть в ~/.claude/skills/ — он доступен в любом проекте:
claude
> /review src/payments.tsАгент запустит ваш кастомный процесс review с учётом всех стандартов проекта.
Multi-agent: несколько агентов параллельно
Самое мощное. Один агент может запускать других агентов для параллельного выполнения задач.
Практический пример: у вас монорепо с 5 микросервисами. Вместо того чтобы обновлять зависимости последовательно — запускаете 5 агентов параллельно, каждый обновляет свой сервис.
Обнови зависимости во всех микросервисах параллельно.
Для каждого: npm audit fix, обнови package.json, запусти тесты.
Про командную работу агентов — gstack для Claude Code: там разобрана архитектура многоагентных систем с реальными примерами.
MCP-серверы (Model Context Protocol) расширяют возможности ещё дальше — агент получает доступ к внешним инструментам, базам данных, API. Подробнее: MCP: что это такое и как настроить.
Claude Code vs Cursor vs Copilot: когда что выбрать
Честный взгляд без агитации. Все три инструмента хороши — просто для разных сценариев.
| Критерий | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|
| Философия | Агент в терминале | AI-редактор (VS Code fork) | AI-ассистент в IDE |
| Автономность | Высокая (действует сам) | Средняя (предлагает) | Низкая (дополняет) |
| Контекст проекта | Полный доступ к FS | Открытый проект | Открытые файлы |
| Запуск команд | Да, нативно | Ограниченно | Нет |
| Git-операции | Да | Нет | Нет |
| Нужен IDE | Нет | Да | Да |
| Цена | $20-100/мес | $20/мес | $10-19/мес |
| Оффлайн-работа | Нет | Частично | Нет |
Claude Code выигрывает когда: нужна реальная автономность, задачи типа «разберись и сделай», работа с несколькими файлами, запуск команд, CI-автоматизация.
Cursor лучше когда: хочется AI прямо в VS Code, нужна быстрая помощь при написании, важен визуальный интерфейс.
Copilot подходит когда: встроен в GitHub enterprise, нужны только подсказки при написании, бюджет ограничен.
Мой честный вывод: я использую Claude Code как основной инструмент для задач «разберись и реши», а Cursor — для быстрого написания с AI-подсказками. Они не конкурируют, они дополняют.
Детальное сравнение: Cursor vs Claude Code vs Codex: честное сравнение в 2026.
Ещё один интересный кейс — сравнение с Gemini CLI, который Google выпустил как прямой конкурент: Gemini CLI vs Claude Code: даю одну задачу двум AI-агентам.
С чего начать прямо сейчас
Если вы дочитали до этого момента и ещё не установили — вот минимальный путь:
npm install -g @anthropic-ai/claude-codeclaude login- Открываешь любой свой реальный проект
- Пишешь CLAUDE.md (15 минут, окупается сразу)
- Даёшь первую задачу: «объясни мне этот проект»
После первого часа работы вы поймёте разницу между «AI который советует» и «AI который делает».
Куда расти дальше: Auto Mode для более автономной работы, Superpowers-фреймворк для профессионального использования, multi-agent для масштабирования. Если интересна тема разработки с AI в целом — есть хорошая отправная точка: Вайб-кодинг с нуля: от идеи до деплоя.
Если есть вопросы по установке или столкнулись с проблемой — пишите в комментарии. По своему опыту знаю, что первые 30 минут могут быть непривычными. Потом привыкаешь быстро.
