Claude Code: терминальный ИИ-агент для разработки

Что такое Claude Code

Claude Code - это терминальный ИИ-агент для разработки от Anthropic. Вы пишете задачу текстом, он сам разбирается в кодовой базе, вносит правки, запускает тесты и коммитит результат.

Ключевое: это не автокомплит и не чат-бот для вопросов по коду. Это агент, который работает в цикле. Получил задачу, прочитал нужные файлы, внёс изменения, запустил тесты, увидел ошибку, исправил, запустил снова. Без вашего участия на каждом шаге.

Под капотом - модели Claude (Opus 4, Sonnet 4) с доступом к инструментам: файловая система, bash, git, grep, поиск по проекту. По архитектуре это Jarvis Pattern в чистом виде: LLM + инструменты + цикл принятия решений.

Как Claude Code работает изнутри

Это не чёрный ящик. Вот что происходит когда вы даёте задачу:

1. Claude Code читает CLAUDE.md (инструкции проекта) и индексирует структуру
2. LLM получает вашу задачу + контекст проекта
3. Модель решает какой инструмент вызвать (Read, Edit, Bash, Grep)
4. Выполняет действие, получает результат
5. Оценивает: задача решена? Нет - ещё цикл
6. Готово: показывает изменения, предлагает коммит

Средний цикл для типовой задачи: 5-15 шагов. Сложный рефакторинг: 30-50 шагов.

Установка Claude Code

Claude Code - это CLI-инструмент (command line interface). Скачать Claude Code как отдельное приложение нельзя, установка через npm:

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

Требования: Node.js 18+, подписка Anthropic (Pro $20/мес, Team $30/мес, Enterprise). Claude Code работает на Windows, macOS и Linux.

Запуск в любой директории:

cd my-project
claude

Claude Code проиндексирует проект. Первый запуск на большом репозитории (100K+ файлов) - 1-2 минуты. После этого индекс кэшируется.

CLAUDE.md - инструкции для агента

Это ключевая вещь, которую многие пропускают. CLAUDE.md - файл в корне проекта, который Claude Code читает при каждом запуске. Это ваш "контракт" с агентом.

Что писать:

# Архитектура
- Monorepo: /apps/web (SvelteKit), /apps/api (Fastify), /packages/shared
- БД: PostgreSQL через Drizzle ORM
- Тесты: Vitest для unit, Playwright для e2e

# Правила
- Typescript strict mode, никаких any
- Все новые эндпоинты покрываются тестами
- Коммиты на английском, conventional commits
- Не трогать /legacy/ - там код на поддержке

# Стиль
- Prefer composition over inheritance
- Error handling через Result type, не throw

Без CLAUDE.md агент работает как разработчик, которого наняли вчера и не дали документацию. С CLAUDE.md - как разработчик, который прочитал wiki и знает правила.

Инсайт из нашего опыта: хороший CLAUDE.md сокращает количество циклов агента на 30-40%. Модель реже ходит не туда и реже приходится переделывать.

Что Claude Code реально умеет

Навигация по кодовой базе. Не просто "читать файл", а понимать связи. "Найди все места где вызывается getUserById и покажи какие из них не обрабатывают ошибку" - это один промпт.

Точечные правки. Меняет конкретные строки, не переписывая весь файл. Важно для больших файлов - агент отправляет diff, а не полное содержимое.

Мультифайловый рефакторинг. "Переименуй UserService в AuthService и обнови все импорты" - Claude Code найдёт все файлы, обновит импорты, переименует тесты и обновит конфигурации.

Запуск и исправление тестов. Написал код, запустил тесты, увидел ошибку, исправил. Без вашего участия. Цикл повторяется пока тесты не пройдут (или не исчерпается лимит).

Git workflow. Создаёт ветки, коммитит с осмысленными сообщениями, может создать PR через gh CLI. Commit message генерируется из реальных изменений, а не из промпта.

Субагенты. Claude Code может запустить подзадачи параллельно. Например, пока один субагент ищет файлы, другой читает документацию. Это ускоряет сложные задачи в 2-3 раза.

Claude Code vs Cursor: когда что использовать

Инсайт: в нашей команде 80% кода пишется в Cursor (там быстрее для мелких правок и нового кода), а 20% задач отдаётся Claude Code (мультифайловый рефакторинг, добавление фич через 5+ файлов, разбор незнакомой кодовой базы). Это не конкуренты, а два инструмента для разных задач.

Сколько это стоит

Стоимость зависит от модели и количества шагов. Ниже - оценки на основе прайсинга Anthropic API и нашего опыта работы с этим сайтом (агент пишет статьи, работает с БД, деплоит):

Разброс большой, потому что стоимость зависит от размера контекста. Чем больше файлов агент читает, тем дороже каждый шаг. CLAUDE.md помогает: агент реже ходит не туда и тратит меньше циклов.

Ошибки при работе с Claude Code: что НЕ делать

Не давайте абстрактные задачи. "Сделай код лучше" - плохо. "Замени все var на const/let в src/utils/" - хорошо. Чем конкретнее промпт, тем меньше циклов, тем дешевле.

Не используйте auto mode на незнакомом проекте. Auto mode отключает подтверждения. Агент может удалить файл, переписать конфигурацию, запустить деструктивную команду. Сначала узнайте проект в обычном режиме.

Не игнорируйте CLAUDE.md. Каждый проект без CLAUDE.md - это агент без инструкции. Он будет тратить циклы на то, чтобы понять что можно, а что нельзя.

Не ожидайте идеального кода с первого раза. Claude Code - это не волшебство. Он ошибается, галлюцинирует, иногда уходит не в ту сторону. Ценность в том, что он делает 80% работы, а вы проверяете и доводите до ума.

Расширенные возможности Claude Code

Hooks. Скрипты, которые запускаются до или после определённых действий агента. Например: pre-commit hook который проверяет что агент не трогал запрещённые файлы.

MCP (Model Context Protocol). Подключение внешних инструментов. Claude Code из коробки работает с файлами и bash, но через MCP можно добавить Jira, Confluence, базы данных, любые API.

Plan mode. Для сложных задач: агент сначала составляет план, показывает какие файлы затронет и что изменит. Вы одобряете - он выполняет. Дешевле чем разгребать последствия.

Skills. Claude Code skills - это переиспользуемые команды для типовых задач. Например, skill для code review, генерации тестов или деплоя. Создаются через slash-команды (/) и хранятся в .claude/skills/ проекта.

Перспективы Claude Code в 2026 году

Claude Code сейчас в точке, где был VS Code в 2016 - уже рабочий инструмент, но экосистема только формируется. Anthropic добавляет remote triggers (агент запускается по событию), teams (несколько агентов на одной задаче), улучшает работу с контекстом. Через год это будет совсем другой продукт.

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

Мы сделали бесплатный курс по Claude Code на Stepik - от установки до реальных задач с упражнениями. Если предпочитаете разбираться сами - начните с CLAUDE.md, это даст агенту контекст вашего проекта и сразу поднимет качество.

Дальше по теме: что такое ИИ-агент и как он работает если хотите понять механику, как создать своего ИИ-агента если хотите пойти дальше готовых инструментов, метрики ИИ-агента в продакшне когда дойдёте до прода.