Claude Code — терминальный AI-агент Anthropic, вышедший в GA 24 мая 2024 и работающий на моделях Sonnet 4.5 и Opus 4. В отличие от автодополнения Copilot или чата в браузере, он читает весь репозиторий, редактирует файлы, запускает тесты и коммитит изменения через bash и git. Установка через npm install -g @anthropic-ai/claude-code требует Node.js 18+; на Windows работает только через WSL2. В этом гайде — установка, sub-agents, MCP-интеграции, реальные цены API и подписок на конец 2025, сравнение с Cursor и Copilot, а также способы оплаты из России через OpenRouter.

Что такое Claude Code и зачем он разработчику

Claude Code — терминальный агент, который читает репозиторий, делает точечные правки, запускает тесты и формирует коммиты через git. В отличие от чат-окна Claude.ai или IDE-плагина, он оперирует не одним файлом, а проектом целиком: индексирует структуру при первом запуске, держит в контексте CLAUDE.md (если он есть), историю изменений и текущие файлы. Под капотом по умолчанию Sonnet 4.5, при необходимости переключаешься на Opus 4 — Sonnet 4.5 держит топ-1 на SWE-bench Verified с результатом ~77.2%, что подтверждает его силу именно в multi-file задачах.

Установка Claude Code

Минимальные требования — Node.js 18+, git и доступ к API или подписке Claude.ai. На macOS и Linux установка штатная, на Windows прямой поддержки нет: Anthropic поддерживает только Linux, macOS и WSL2. В Windows ставь WSL2 (wsl --install), внутри разверни Ubuntu, и уже там ставь CLI.

node -v
git --version
npm install -g @anthropic-ai/claude-code

Авторизация и первый запуск

После установки выполни claude login — откроется браузер, в нём нужно залогиниться в Claude.ai и подтвердить scope для терминальной сессии. Если работаешь с API-ключом вместо подписки, экспортируй его в окружение:

export ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY}"
claude

CLI запросит подтвершение на чтение текущей директории, через /init предложит создать CLAUDE.md с конвенциями проекта. Дальше можно сразу давать задачи на естественном языке.

Slash-команды и sub-agents

Slash-команды (/compact, /clear, /model, /init) — встроенный интерфейс к состоянию сессии. Через /model переключаешься между Sonnet 4.5 и Opus 4 прямо во время работы. Через /compact сворачиваешь контекст без потери ключевых решений. Флаг --add-dir ограничивает область чтения — полезно в монорепах, чтобы агент не пытался индексировать всю историю.

Sub-agents — механизм делегирования подзадач. Вместо того чтобы держать в основном контексте полный трейс рефакторинга, ты просишь: «запусти три sub-агента параллельно — каждый переписывает свой модуль, потом сравни результаты». Основной контекст получает только сводку и не раздувается деталями — это снижает риск упереться в 200K токенов контекста Sonnet 4.5.

MCP: Model Context Protocol и интеграции

MCP (Model Context Protocol) — открытый стандарт интеграции внешних инструментов. С его помощью Claude Code подключается к GitHub Issues, Postgres, S3, Slack, любым HTTP API через универсальный интерфейс. Для добавления сервера используется команда claude mcp add:

claude mcp add github -- npx @modelcontextprotocol/server-github

Каждый MCP-сервер — маленький процесс, который агент вызывает по мере необходимости. Это превращает Claude Code из «LLM + grep по файлам» в полноценный CLI для работы с проектом и инфраструктурой.

Интеграция с IDE

Claude Code живёт в терминале, но есть мосты в IDE: расширение для VS Code и плагин для JetBrains. В обоих случаях горячая клавиша открывает встроенную терминальную панель прямо в редакторе — выделенный фрагмент автоматически передаётся в контекст. Zed поддерживается через собственный адаптер, синтаксис команд одинаковый.

Цены Claude Code в 2025 году: Pro, Max и API

Три способа платить за Claude Code — подписка Claude.ai, консольный API и корпоративные площадки. Разница не только в цене, но и в лимитах.

Подписка: Pro, Max 5x, Max 20x

Pro за $20/мес даёт около 45 сообщений каждые 5 часов — хватает для повседневной работы с небольшими правками, но при активном рефакторинге лимит выгорает быстро.

Max 5x ($100/мес) и Max 20x ($200/мес) расширяют квоту пропорционально названию. Разница ощутима, если гоняешь sub-agents параллельно или работаешь весь день в терминале.

Подписка привязывается через claude login — авторизация идёт через Claude.ai, а не через ключ API. Для подписчиков Claude.ai данные не используются для обучения моделей с 2024 года — это отдельный контур от API-политики.

API: платишь за токены напрямую

Если подписка не подходит — например, нужен CI без интерактивного логина — работаешь через API-ключ Anthropic Console. Тарифы на конец 2025:

Модель	Input ($/1M)	Output ($/1M)
Sonnet 4.5	$3	$15
Opus 4	$15	$75

Opus 4 дороже Sonnet 4.5 в 5 раз — для рутинных задач переключение на него бессмысленно, разницу в качестве заметишь только на сложных multi-file рефакторингах.

Автоматизация через -p (print mode) считается по тем же тарифам — CI-пайплайн с частыми запусками может съесть бюджет быстрее, чем кажется.

Оплата из России

Карты российских банков не проходят напрямую ни на подписку, ни на API. Рабочий вариант — прокладка через посредника: карты других юрисдикций, виртуальные карты у платёжных сервисов или прокси-биллинг через OpenRouter, который принимает разные способы оплаты и даёт доступ к моделям Claude по своему API-ключу.

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

Enterprise: Bedrock и Vertex AI

Для компаний, которым нужен zero-retention по умолчанию, Anthropic предлагает Claude Code on AWS Bedrock и GCP Vertex AI. Данные не уходят в публичный API, тарификация идёт через облачного провайдера — обычно дороже прямого API, но с гарантиями по хранению данных, которые требует compliance.

Что выбрать

Для соло-разработчика — Pro, пока не начинаешь упираться в лимиты. Для команды с активным CI — API с жёстким контролем через --allowed-tools. Для проприетарного кода без облака вообще — смотри Aider с Ollama. Сравнение по деньгам с конкурентами, включая Cursor, — в следующем разделе.

Claude Code vs Cursor vs GitHub Copilot: честное сравнение

Три инструмента решают разные задачи, хотя маркетинг пытается убедить, что это прямые конкуренты. Claude Code — CLI-агент, живущий в терминале. Cursor — форк VS Code с инлайн-редактированием. GitHub Copilot — автодополнение, доросшее до agent mode в 2025.

По цене

Инструмент	Тариф	Цена/мес
Claude Code	Pro	$20
Claude Code	Max 5x	$100
Cursor	Pro	$20
Cursor	Business	$40
GitHub Copilot	Individual	$10
GitHub Copilot	Business	$19
GitHub Copilot	Enterprise	$39

Cursor Pro и Claude Pro формально стоят одинаково, но по факту не равны: Cursor жёстко лимитирует число запросов к premium-моделям в месяц, а Claude Code Pro даёт ~45 сообщений каждые 5 часов — предсказуемый rate limit без скрытых квот на конкретные модели. GitHub Copilot дешевле всех, но и возможности агента там появились позже и работают более осторожно — фокус исторически был на автодополнении строк, а не на multi-file рефакторингах.

По задачам

Claude Code выигрывает там, где нужно менять много файлов согласованно: миграция API, замена библиотеки логирования по всему проекту, рефакторинг слоя доступа к данным. Модель видит структуру проекта целиком (за счёт индексации при старте и CLAUDE.md), а sub-agents позволяют делегировать подзадачи без раздувания основного контекста. На SWE-bench Verified Claude Sonnet 4.5 держит топ-1 с результатом ~77.2% — заметный отрыв именно на задачах, где нужно понять чужой код и правильно его изменить.

Cursor сильнее в быстром итеративном редактировании: inline diff показывает предложенное изменение прямо в редакторе, ты принимаешь или отклоняешь построчно. Для рефакторинга одного файла или написания фичи с нуля в UI это часто быстрее, чем ждать, пока агент в терминале завершит проход по всему репозиторию. GitHub Copilot встроен туда, где ты уже работаешь — VS Code, JetBrains, Visual Studio — и не требует отдельной установки CLI. Но глубина понимания контекста проекта заметно ниже: он не читает package.json и структуру репозитория так системно, как Claude Code через /init.

По интеграции в рабочий процесс

Claude Code — это агент, которого можно встроить в CI через флаг -p и ограничить набор инструментов через --allowed-tools. Ни Cursor, ни Copilot такого нативного pipeline-режима не предлагают — оба заточены под интерактивную работу в редакторе. Если тебе нужен агент, который триггерится на pull request и сам проверяет соответствие CLAUDE.md, вариантов кроме Claude Code по сути нет. С другой стороны, Cursor удобнее для команд, где важен единый редактор с интеграцией AI на уровне UI без отдельного обучения CLI-командам. Порог входа ниже — открыл проект, увидел подсказки.

Что выбрать

Если ты много работаешь с большими рефакторингами, автоматизируешь ревью через CI, хочешь гибкость подключения MCP-серверов и не против терминала — Claude Code окупается быстрее. Если тебе важен визуальный inline-опыт и команда уже привыкла к интерфейсу VS Code — Cursor логичнее. GitHub Copilot — разумный дефолт, если бюджет ограничен и задачи в основном про автодополнение, а не про агентские сценарии. Комбинировать инструменты — нормальная практика: многие держат Cursor для повседневного редактирования и подключают Claude Code точечно для крупных задач через оплату API-запросов, если прямая оплата картой РФ не проходит. Про модели и токены — в разделе про (/pillar/claude-models/).

Claude Code в CI/CD и enterprise-сценариях

bash\nclaude -p “запусти тесты, исправь падающие, закоммить фикс” \\n —allowed-tools “Bash,Edit” \\n —permission-mode acceptEdits\n

Безопасность и приватность: что Anthropic делает с твоим кодом

Когда claude читает твой репозиторий и отправляет фрагменты кода в API, логично спросить — куда это уходит и не учится ли модель на твоём проприетарном коде.

Политика данных Anthropic

По умолчанию Anthropic не использует данные API-клиентов для обучения моделей — только при явном opt-in через настройки аккаунта. Для подписчиков Claude.ai (Pro/Max) данные не используются для тренировки с 2024 года — это зафиксировано в политике конфиденциальности.

Если работаешь через Claude Code с обычной подпиской или API-ключом, код физически покидает твою машину и обрабатывается на серверах Anthropic. Для большинства проектов это приемлемо, но для чувствительного enterprise-кода нужны дополнительные гарантии.

Enterprise: Bedrock и Vertex AI

Anthropic предлагает Claude Code через AWS Bedrock и GCP Vertex AI — в этом случае данные не уходят в публичный API Anthropic, а остаются в инфраструктуре AWS или Google, привязанной к аккаунту компании. Enterprise-клиенты на этих платформах получают zero-retention по умолчанию — запросы и ответы не сохраняются после обработки.

Это закрывает главный вопрос security-отделов: код не индексируется третьей стороной, не попадает в логи для дебага модели, не смешивается с чужими данными. Если у тебя compliance-требования (SOC2, HIPAA, финансовый сектор) — это единственный вариант работать с Claude Code легально.

Подробнее про настройку и лимиты доступа разбирали в разделе про Claude Code в CI/CD — там же флаги --allowed-tools для ограничения инструментов агента.

Если нельзя отправлять код в облако вообще

Есть категория задач, где облако не вариант ни при каких гарантиях — гостайна, банковские core-системы, код с NDA без права передачи третьим лицам. Для таких случаев остаётся локальный стек: Aider + Ollama с моделями Llama 3.3 70B или Qwen 2.5 Coder 32B. Качество ниже, чем у Sonnet 4.5, но данные не выходят за пределы твоей инфраструктуры вообще. Хочешь разобраться в архитектуре моделей Claude и понять, что происходит с данными на уровне API — есть официальные курсы Anthropic, где это объясняют разработчики самой компании. Для прямого доступа к API с нужными лимитами удержания данных — оформляется через Anthropic API.

Выбор между публичным API, Bedrock/Vertex и локальным стеком — это не вопрос удобства, а вопрос того, что твой юридический отдел готов подписать.

Частые ошибки и как их избежать

Большинство проблем с claude-code — не баги агента, а ошибки настройки окружения и рабочего процесса.

Забыли git commit перед массовой правкой

У агента нет undo. Если claude переписал 15 файлов и результат не понравился, откатывать можно только через git checkout. Правило простое: коммит перед любой задачей, которая трогает больше одного файла. git commit -am "before refactor" занимает пять секунд, а спасает часы.

context window exceeded на большом репо

Sonnet 4.5 держит 200K токенов контекста, Opus 4 в beta-режиме — до 1M, но даже этого мало для монорепы с сотнями тысяч строк. Если видишь ошибку context window exceeded — не значит, что модель “сломалась”, значит агент пытается прочитать слишком много. Сузь область через --add-dir на конкретную папку или сбрось накопленный контекст командой /clear между задачами.

Нет CLAUDE.md — агент угадывает конвенции

Без CLAUDE.md в корне репозитория claude каждый раз заново пытается понять, как у тебя запускаются тесты и какие правила линтинга. Команда /init создаёт файл автоматически, но полезнее заполнить его руками: тестовые команды, запреты (“не трогать migrations/”), стиль коммитов. Файл читается автоматически при каждом запуске — это дешевле, чем повторять инструкции в каждом промпте.

Путают модели по цене и задаче

Opus 4 в 5 раз дороже Sonnet 4.5 ($15/$75 против $3/$15 за 1M токенов), а прирост качества на типовых задачах небольшой. Sonnet 4.5 держит топ-1 на SWE-bench Verified (~77.2%) и справляется с большинством рефакторингов. Opus стоит держать для редких сложных архитектурных решений, не для рутины — иначе счёт по API удивит. Как оплачивать без сюрпризов и без гемора с российскими картами — отдельный вопрос: карты РФ-банков не проходят напрямую, и часть команд предпочитает получить доступ к Anthropic API через посредника заранее, а не разбираться с этим в момент, когда счётчик токенов уже тикает.

Запускают -p без ограничения инструментов в CI

Флаг -p удобен для скриптов, но без --allowed-tools и --permission-mode агент в CI получает те же права, что и в интерактивном режиме — включая запись в файлы и выполнение shell-команд. Для pipeline это риск: явно ограничивай набор инструментов, иначе один неудачный промпт может что-то удалить в чужой ветке.

Подробнее про запуск в неинтерактивном режиме — в отдельном гайде по CI/CD.

Заключение

Начни с малого: поставь Claude Code на тестовый репозиторий, создай CLAUDE.md с конвенциями проекта и попробуй одну sub-agent задачу на рефакторинг. Дальше — настрой MCP-сервер под свою инфраструктуру (GitHub Issues или БД) и оцени, сколько сообщений реально уходит за 5 часов на твоём тарифе. Если работаешь с чувствительным кодом — проверь Bedrock/Vertex AI или подними Aider с локальной моделью через Ollama, прежде чем пускать прод-репозиторий через публичный API.