Claude Code: подробный гайд по установке, работе и лимитам

Программирую я со студенческих лет — и всё это время исключительно как любитель. Ну, там, вики-бота сваять на Python или простенькую программу для подсчета статистики. Но с появлением агентов вроде Claude Code скромный нормис начал превращаться в Гигачада от вайбкодинга. Описываешь задачу обычными словами прямо в папке с проектом — и наблюдаешь, как агент сам читает файлы, пишет код, запускает тесты и чинит то, что сломал. «Мама, я сделяль программу». Ощущение, будто в терминале завелся джинн-джун, который не устает, не козлит и есть не просит.

Правда, у джинна есть характер, тарифы и лимиты, а в РФ — еще и отдельный квест с доступом. В этом гайде я собрал воедино свой опыт — всё, что нужно для старта. Вы узнаете, что такое Claude Code, как его установить, как им пользоваться и что делать, когда лимиты заканчиваются раньше рабочего дня.

Что такое Claude Code

Claude Code — агентный инструмент для программирования от Anthropic, компании-разработчика нейросети Claude. Ключевое слово здесь — «агентный». Обычный чат-бот отвечает на вопросы. Claude Code получает задачу и выполняет ее сам: изучает кодовую базу, правит файлы, запускает команды, смотрит на результат и повторяет цикл, пока не добьется своего или вы не скомандуете прекратить.

От привычных ИИ-помощников агента отличают три вещи.

1. Он видит не один открытый файл, а проект целиком.
2. Он не советует, а действует: сам создает ветки, прогоняет тесты, пишет коммиты.
3. Он работает там, где вам удобно, — движок один, а оболочек несколько.

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

• Терминал. Полнофункциональная консольная версия — CLI, с которой всё начиналось.
• Расширения для редакторов. VS Code и Cursor, а также плагин для IDE от JetBrains — IntelliJ IDEA, PyCharm, WebStorm.
• Десктопное приложение. Вкладка Code в приложении Claude для macOS и Windows, для Linux — в статусе беты.
• Веб-версия. Сессии в облаке на claude.ai/code — без локальной установки.
• Мобильное приложение. Claude для iOS и Android, откуда можно запускать облачные задачи и следить за ними.

Настройки проекта — файл CLAUDE.md, разрешения, подключенные инструменты — общие для всех оболочек. Так что вполне реально начать задачу, скажем, в терминале и продолжить в приложении.

Что умеет Claude Code

Типовые задачи для агента: написать функцию по описанию, найти и исправить баг по тексту ошибки, покрыть модуль тестами, обновить зависимости, разрешить конфликт слияния, составить описание релиза.

Через протокол MCP Claude Code подключается к внешним сервисам — трекерам задач, базам данных, Figma, Slack, — а через хуки и скиллы обрастает вашими собственными правилами и сценариями.

По умолчанию Claude Code работает на модели Opus 5.5, но командой /model можно переключиться на более экономную Sonnet 5.5, быструю Haiku 4.5 или флагманскую Fable 5.1. Однако будьте внимательны: последняя расходует уже не лимиты подписки, а отдельно оплачиваемые кредиты.

Бесплатного тарифа у Claude Code нет. Нужен либо платный план Claude, либо аккаунт в Claude Console с оплатой за токены.

Расклад по индивидуальным тарифам на момент написания гайда выглядит так.

Тариф	Цена	Что это дает в Claude Code
Pro	20 $ в месяц или 17 $ в месяц при оплате за год	Базовый объем: хватает на знакомство и небольшие проекты
Max 5x	100 $ в месяц	В пять раз больше использования, чем на Pro; приоритетный доступ в часы пик
Max 20x	200 $ в месяц	В двадцать раз больше, чем на Pro; приоритетный доступ в часы пик
API через Claude Console	По факту расхода токенов	Лимитов подписки нет, оплачивается каждый запрос

Claude Code в России: доступ и оплата

Если вы внимательно читаете наш сайт или просто следите за IT-новостями, то знаете, что официально Claude Code в России не работает. На практике это означает три ограничения сразу: при регистрации требуют номер телефона поддерживаемой страны, с российского IP-адреса вход и авторизация не проходят, а карты российских банков не принимаются к оплате.

Обойти эту проблему можно двумя путями.

1. Официальная подписка

Тут потребуется зарубежный IP-адрес, рабочий телефонный номер поддерживаемой страны для заведения аккаунта и иностранная банковская карта. Счастливые обладатели этих трех даров цивилизации Claude Code доступен в полном объеме, со всеми интерфейсами и лимитами подписки.

Главный риск здесь — что вас вычислят и заблокируют аккаунт (использование сервиса в неподдерживаемом регионе нарушает условия Anthropic). И такое действительно случается: аккаунты закрывают за «скачущие» IP, за свежую учетную запись с дорогим тарифом, за смену способа оплаты.

Более устойчивый вариант, который часто советуют, — держать Claude Code на арендованном зарубежном сервере и подключаться к нему по SSH; десктопное приложение умеет работать с такими удаленными машинами штатно.

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

2. API через шлюз

Claude Code умеет работать не только с подпиской, но и через API — причем адрес API можно заменить. Для этого служат переменные окружения: в ANTHROPIC_BASE_URL указывается адрес шлюза, в ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY — ключ, выданный его владельцем.

Запустить Claude Code, чтобы он обращался не к серверам Anthropic, а к стороннему шлюзу, несложно. В bash и zsh (на macOS, Linux и WSL) это делается тремя последовательными командами:

В Windows синтаксис другой. Вот как это выглядит в PowerShell:

Лимиты подписки в такой схеме не действуют — вы платите за каждый токен по тарифу шлюза.

Обратите внимание на два момента.

• Во-первых, Anthropic сторонние шлюзы не проверяет и не поддерживает, а ваши запросы вместе с кодом проходят через посредника — закрытые коммерческие проекты так вести не стоит.
• Во-вторых, шлюз должен полностью поддерживать эндпоинт /v1/messages, включая потоковую передачу и вызов инструментов, иначе агентный режим будет работать с ошибками.

Из сервисов, с которыми работает наша редакция, Anthropic-совместимый режим имеется на агрегаторе GPTunnel. Совместимость именно с Claude Code я бы советовал проверить на небольшой сумме, прежде чем подключать рабочий проект. По промокоду AIMARKETCAP10 сервис дает скидку 10% на пополнение счета.

Как установить Claude Code

Системные требования:

• macOS 13.0 и новее;
• Windows 10 версии 1809 и новее или Windows Server 2019;
• Ubuntu 20.04, Debian 10, Alpine Linux 3.19 и новее;
• от 4 ГБ оперативной памяти, процессор x64 или ARM64;
• подключение к интернету и аккаунт с платным тарифом или API-ключом.

Сама установка Claude Code занимает пару минут и сводится буквально к одной команде.

Установка в терминале

Рекомендуемый способ — нативный установщик: он не требует Node.js и сам обновляется в фоне. Откройте терминал и выполните команду для своей системы.

macOS, Linux и WSL:

Windows, PowerShell:

Windows, командная строка CMD:

Не нужно даже запускать терминал от имени администратора.

На Windows разработчики советуют дополнительно поставить Git for Windows: тогда Claude Code получит полноценный Bash, а без него придется выполнять команды через PowerShell.

Есть и альтернативы — через менеджеры пакетов Homebrew, WinGet и npm. (Учтите, что установки из Homebrew и WinGet сами не обновляются).

Homebrew

WinGet

npm

Вариант с npm рассчитан на Node.js 22 или новее, и запускать его через sudo не следует — об это прямо предупреждают в документации.

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

Первая команда выведет номер версии, вторая — диагностику установки и настроек.

Если система отвечает, что команда claude не найдена, значит, папка установки не попала в переменную PATH. Это самая частая проблема, и ее решение описано в разделе документации по устранению неполадок.

Первый запуск и вход

Перейдите в папку проекта и запустите агента:

При первом запуске Claude Code откроет браузер для входа в аккаунт Claude или Claude Console. Данные сохраняются, повторять процедуру не придется.

Сменить аккаунт можно командой /login внутри сессии.

Если в системе задана переменная ANTHROPIC_API_KEY, агент вместо браузера предложит использовать ключ — и тогда лимиты будут расходоваться уже по API, а не из подписки. Проверьте это заранее, чтобы не удивляться счетам.

Приложение Claude Code для компьютера

Тем, кому терминал не близок, подойдет Claude Code как приложение — точнее, как вкладка Code в десктопном клиенте Claude. Он выпускается для macOS и Windows, а в бета-версии — для Ubuntu и Debian; консольную версию и Node.js ставить отдельно не нужно.

Просто скачайте установщик с официального сайта, войдите в аккаунт, откройте вкладку Code и выберите папку проекта.

Возможности здесь те же, что и в терминале, но с графическим интерфейсом: правки показываются построчным сравнением «было — стало» с кнопками принятия и отклонения, несколько сессий идут параллельно в боковой панели, есть встроенный терминал и предпросмотр запущенного приложения. Сессию можно запустить локально, в облаке, на удаленной машине по SSH или внутри WSL.

Расширение для VS Code и Cursor ставится из каталога расширений по запросу «Claude Code».

Плагин для JetBrains берется из JetBrains Marketplace, но ему нужна установленная консольная версия.

Веб-версия и мобильное приложение Claude установки не требуют вовсе: код выполняется в облачной среде Anthropic.

Claude Code: как пользоваться

Самая частая ошибка новичка — обращаться с агентом как с поисковиком: короткий запрос, расплывчатая цель, ноль контекста. Как использовать Claude Code по уму? Разговаривайте с ним как с обычным программером, который видит проект впервые: объясните задачу, покажите нужные файлы и обрисуйте признаки, по которым вы поймете, что работа сделана.

Первая сессия

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

Если код уже есть

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

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

Затем выполните команду /init: она создаст файл CLAUDE.md с описанием проекта, который агент будет читать в начале каждой сессии. Допишите туда то, чего нельзя узнать непосредственно из кода: зачем проект нужен, какой командой запускаются тесты, что нельзя трогать.

После этого дайте небольшую настоящую задачу, например:

Если папка пустая

Допустим, у вас еще нет проекта как такового. Соответственно, читать агенту нечего, и роли меняются: теперь объясняете уже вы.

Пересказывать замысел целиком не обязательно — достаточно пары фраз и просьбы задать уточняющие вопросы. Агент спросит о том, о чем вы, возможно, еще не думали — например, где будут храниться данные, что делать при ошибке, какие есть варианты и чем они отличаются.

Пример промта:

В итоге вы получите письменную спецификацию — по сути, аналог ТЗ для фрилансера, только составленное в диалоге с Клодом, а не самостоятельно. Прочитайте ее и, если агент что-то понял не так, поправьте вручную.

Дальше можно начать новую сессию командой /clear, чтобы в контексте осталась только спецификация. Запросите у агента план работ:

Когда план вас устроит, попросите выполнить первый шаг. Лучше работать пошагово, а не требовать сделать всё сразу.

Как только в папке появится работающий каркас, выполните /init. С этого момента проект начнет функционировать.

Как работает Claude Code на проекте

Агент сам находит нужный код, вносит изменения и проверяет результат. В свежих версиях по умолчанию включен автоматический режим: отдельная модель-классификатор оценивает действия агента и останавливает только рискованные. Если хочется контролировать процесс самому, переключите режим сочетанием Shift+Tab.

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

• Auto — агент действует сам, рискованные операции блокирует классификатор;
• Manual — запрашивает подтверждение перед правкой файлов и запуском команд;
• Accept edits — автоматически принимает правки файлов, чтобы ускорить итерации;
• Plan — только читает код и предлагает план, ничего не меняя.

Команды и клавиши на каждый день

Полный список команд можно посмотреть, введя символ / внутри сессии. На практике чаще всего используется около десятка.

Команда	Что делает
claude	Запускает интерактивную сессию в текущей папке
claude «задача»	Запускает сессию сразу с первым запросом
claude -p «запрос»	Выполняет разовый запрос и завершает работу — удобно для скриптов
claude -c	Продолжает последний диалог в этой папке
claude -r	Открывает список прошлых сессий для возобновления
/init	Создает стартовый файл CLAUDE.md по структуре проекта
/clear	Очищает историю диалога и начинает с чистого контекста
/compact	Сжимает историю до краткого пересказа
/model	Переключает модель
/usage	Показывает расход и остаток лимитов
/context	Показывает, чем занято контекстное окно
/rewind	Откатывает диалог и код к предыдущей точке
/help	Выводит справку по командам

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

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

Можно вставлять скриншоты прямо из буфера обмена — агент понимает изображения.

Рабочий процесс: исследуй, планируй, делай

Для эффективной работы лучше не заставлять агента кодить «от забора до обеда», а разделить процесс на стадии, например — исследование и реализацию. Для умеренно сложных задач цепочка выглядит так:

1. Исследование. В режиме Plan попросите агента изучить нужную часть кода: он читает файлы и отвечает на вопросы, ничего не меняя.
2. План. Попросите составить пошаговый план изменений и поправьте его, пока это дешево.
3. Реализация. Выйдите из режима планирования и дайте агенту выполнить план вместе с тестами.
4. Фиксация. Попросите сделать коммит с внятным описанием и при необходимости открыть пул-реквест.

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

Четыре полезные привычки при работе с Claude Code

Давайте агенту способ проверить себя. Тесты, сборка, скриншот для сравнения — всё, что возвращает однозначное «прошло» или «не прошло». Без этого единственным контролером остаетесь вы. Без обид, но риск не заметить ошибку в этом случае выше.

Формулируйте конкретно. Запрос «почини баг с логином» заставит агента перечитывать половину проекта. Лучше быть максимально точным: «после истечения сессии вход завершается ошибкой, проверь обновление токена в src/auth, напиши падающий тест и исправь».

Ведите CLAUDE.md. Этот файл агент читает в начале каждой сессии. Туда идут команды сборки и тестов, принятый стиль кода, договоренности по веткам — то, чего не вывести из самого кода. Не перегружайте файл: документация советует укладываться в 200 строк, иначе в шуме потонут важные правила.

Не забывайте о подстраховке. Перед каждой правкой Claude Code делает контрольную точку, и командой /rewind можно вернуть назад и код, и диалог. Но отслеживаются только изменения, сделанные инструментами редактирования самого агента. То, что он натворил через команды оболочки, откат не вернет. Git это не заменяет — работайте в отдельной ветке и коммитьте чаще.

Лимиты Claude Code и как с ними работать

Лимиты — главная тема любого разговора о Claude Code и вечная головная боль. Агент потребляет ресурсы совсем не так, как чат. Один запрос «исправь баг» оборачивается десятками действий — обращений к модели, чтением файлов и прогоном команд, — и каждое жрет токены.

Как устроены лимиты подписки

На тарифах Pro и Max действуют два счетчика одновременно. Первый — сессионный лимит, который обнуляется каждые 5 часов. Второй — недельный, с общим потолком запросов на 7 дней. Оба расходуются сразу и для всех продуктов: переписка на сайте Claude, задачи в десктопном приложении и сессии Claude Code тратят один и тот же запас.

Поверх этого бывают отдельные лимиты на семейства моделей — Opus и Sonnet.

Точных цифр в токенах Anthropic не публикует. К тому же, правила в 2026 году менялись несколько раз: в мае удвоили пятичасовые лимиты, летом действовала временная надбавка к недельным, а с 14 сентября ее заменило постоянное повышение недельного лимита на 25% от исходного уровня. В общем, морочат голову как хотят. К тому же, реальный расход зависит от модели, размера проекта и длины диалога: Opus выбирает квоту быстрее, чем Sonnet.

Токены в Claude Code: на что уходит запас

И лимиты подписки, и счета по API измеряются в токенах — единицы информации, которыми оперирует модель. Это совсем не то, что биты и байты. Одно русское слово вмещает, как правило, 2-3 токена.

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

Выручает кэширование: повторно отправляемая часть диалога тарифицируется во много раз дешевле. Но кэш живет ограниченное время — на подписке около часа, — и после долгого перерыва первый же запрос пересчитывает весь контекст по полной цене.

Тем, кто работает через API, пригодятся официальные цены за миллион токенов.

Модель	Входные токены	Выходные токены
Fable 5.1	10 $	50 $
Opus 5.5	4 $	20 $
Sonnet 5.5	2 $	10 $
Haiku 4.5	1 $	5 $

По данным самой Anthropic, в корпоративных внедрениях Claude Code обходится в среднем примерно в 13 $ на разработчика за активный день и в 150–250 $ в месяц, а у 90% пользователей расход не превышает 30 $ в день.

Короче говоря, при плотной ежедневной работе подписка обычно выгоднее оплаты по API. При эпизодических задачах — наоборот.

Как следить за расходом лимитов

Команда /usage вам в помощь. Она показывает шкалы пятичасового и недельного лимитов, время сброса и разбивку: какую долю расхода дали скиллы, субагенты, плагины и подключенные MCP-серверы.

Есть и другие инструменты:

• клавиши d и w переключают период между сутками и неделей;
• команда /context отвечает на другой вопрос — чем занято контекстное окно прямо сейчас;
• в десктопном приложении остаток виден в кольцевом индикаторе рядом с выбором модели.

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

Что делать, когда лимит исчерпан

Когда запас заканчивается, агент останавливается и показывает время сброса. Дальше есть несколько вариантов:

• Подождать. В актуальных версиях Claude Code сам продолжит прерванную задачу после сброса лимита — просто не закрывайте сессию.
• Сменить модель. Если отработал лимит конкретного семейства — Opus или Sonnet, — команда /model позволяет продолжить на другом; на общий сессионный и недельный лимиты это не действует.
• Докупить кредиты. Команда /usage-credits открывает настройки дополнительного использования: работа сверх лимита оплачивается по тарифам API, а потолок трат можно ограничить.
• Перейти на более дорогой тариф. План Max дает объем в 5 или 20 раз больше, чем Pro.

Как экономить лимиты

Почти все приемы экономии сводятся к одному принципу: не раздувайте контекст. Вот несколько полезных правил:

• Одна задача — одна сессия. Между несвязанными задачами выполняйте /clear: старый контекст оплачивается при каждом новом запросе.
• Сжимайте с умом. Команде /compact можно указать, что сохранить, — например, изменения кода и результаты тестов.
• Подбирайте модель под задачу. Sonnet справляется с большинством рутинных задач и расходует квоту медленнее, Opus имеет смысл оставить для архитектурных решений, а простую работу субагентов отдать Haiku.
• Не переключайте модель посреди длинной сессии. У каждой модели свой кэш, и после смены весь диалог перечитывается заново.
• Сокращайте CLAUDE.md. Файл загружается в каждую сессию; узкие инструкции лучше вынести в скиллы, которые подгружаются по требованию.
• Отключайте лишние MCP-серверы. Проверить список можно командой /mcp; там, где есть консольная утилита вроде gh, она экономнее.
• Планируйте сложное заранее. Режим Plan дешевле, чем переделка после неверно понятой задачи.
• Выносите шумные операции в субагенты. Прогон тестов или разбор логов останется в их отдельном контексте, а в основной диалог вернется только итог.
• Не держите сессию открытой сутками. После долгой паузы кэш остывает, а запланированные задачи и циклы продолжают тратить лимит в фоне.

Отдельно скажу про «команды агентов». Это экспериментальный режим, в котором параллельно запускаются несколько экземпляров Claude Code. В режиме планирования они расходуют примерно в 7 раз больше токенов, чем обычная сессия. Инструмент мощный, но лимиты выносит со свистом.

Заключение

Claude Code на сегодня — один из сильнейших агентов для программирования. Он позволяет без особых навыков собирать работающие вещи — ботов, скрипты, небольшие сервисы и сайты, — описывая задачу обычными словами. То, под что раньше приходилось искать исполнителя, теперь начинается с пары фраз в терминале.

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

Но не стоит забывать, что ИИ может быть убедительным даже тогда, когда ошибается. Замысел и проверка остаются за вами. Чем точнее поставлена задача и чем честнее вы смотрите на результат, тем меньше сюрпризов.