Как установить Claude Code на Mac и Windows и начать пользоваться

Claude Code ставится одной командой. На macOS и Linux вставьте в терминал curl -fsSL https://claude.ai/install.sh | bash, на Windows откройте PowerShell и выполните irm https://claude.ai/install.ps1 | iex. Потом откройте новое окно терминала, перейдите в папку проекта и наберите claude: откроется браузер, вы войдёте в аккаунт, и можно давать первую задачу. Нужна платная подписка Claude (Pro или выше) или ключ API: на бесплатном тарифе Claude Code не работает.

Я пользуюсь Claude Code каждый день. Этот сайт и мои Telegram-боты сделаны с его помощью, а Терминал по «Экранному времени» у меня наравне с Telegram: по 40 часов за 25 дней. Ниже весь путь от установки до первой рабочей задачи и то, что полезно знать в первый день, чтобы не наступать на типичные грабли.

Что такое Claude Code и чем он отличается от чата

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

Если слово «агент» звучит туманно, загляните в глоссарий ИИ: там короткое объяснение с демкой. Там же про контекстное окно, оно пригодится ниже, когда дойдём до лимитов.

Claude Code доступен в четырёх местах:

• Терминал (Claude Code CLI). Основной вариант: команда claude в любой папке, все команды и настройки под рукой.
• VS Code и Cursor. Официальное расширение: панель с чатом сбоку, а правки подсвечиваются прямо в файле. Ставится из магазина расширений по запросу «Claude Code».
• Приложение Claude для компьютера. Вкладка Code в приложении для macOS, Windows и Linux (бета). Терминал не нужен: выбираете папку и пишете задачу.
• Браузер. На claude.ai/code сессии идут в облаке и работают с репозиториями на GitHub.

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

Что нужно перед установкой

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

• Система: macOS 13 или новее, Windows 10 версии 1809 и новее, Ubuntu 20.04+, Debian 10+ или Alpine Linux 3.19+.
• Железо: от 4 ГБ оперативной памяти, процессор x64 или ARM64. Модель работает на серверах Anthropic, мощная видеокарта не нужна.
• Интернет обязателен: без него Claude Code не работает.
• Аккаунт: подписка Pro, Max, Team или Enterprise либо аккаунт Claude Console с оплатой за токены.
• Git желателен. На Windows Git for Windows не обязателен, но с ним Claude Code запускает команды в Bash, а без него пользуется PowerShell.

Подписка: сколько стоит Claude Code

Отдельной подписки на Claude Code нет, он входит в обычные тарифы Claude. Цены на октябрь 2026 года по данным claude.com/pricing:

• Free: бесплатно, Claude Code не входит.
• Pro: $20 в месяц или $17 в месяц при оплате за год. С него начинают почти все.
• Max 5x: $100 в месяц, лимиты в пять раз больше, чем у Pro.
• Max 20x: $200 в месяц, лимиты в двадцать раз больше.

Я бы начинал с Pro и переходил на Max, только когда лимиты начнут заканчиваться посреди работы. Оформить подписку можно на claude.ai: по этой ссылке-приглашению новым пользователям обычно доступна пробная неделя Pro вместе с Claude Code.

Можно ли пользоваться Claude Code бесплатно

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

Claude Code в России

Россия не входит в список стран, где Anthropic официально работает, и российские карты сервис не принимает. Поэтому вход или установка с российского адреса могут закончиться ошибкой или сообщением о недоступности региона. Как оформить подписку, я разобрал отдельно: как оплатить Claude из России.

Как установить Claude Code на macOS, Windows и Linux

Официальный способ для всех систем один: нативный установщик. Он скачивает готовую программу, прописывает её в системе и дальше сам обновляет в фоне. Node.js для него не нужен. Выберите систему и способ, скопируйте команду и посмотрите, что появится в терминале:

macOS

Откройте Терминал (Cmd + Пробел, наберите «Терминал») и вставьте команду установщика:

Если пользуетесь Homebrew, подойдёт brew install --cask claude-code. Разница в обновлениях: установщик обновляет Claude Code сам, а версию из Homebrew нужно обновлять командой brew upgrade claude-code.

Windows

Claude Code работает на Windows и без WSL. Откройте PowerShell (в меню «Пуск» наберите PowerShell) и выполните:

Права администратора не нужны. Если у вас открыта старая командная строка CMD, команда другая:

Отличить их просто: в PowerShell строка начинается с PS C:\, в CMD буквы PS нет. Есть и вариант через менеджер пакетов: winget install Anthropic.ClaudeCode. Такую версию придётся обновлять вручную командой winget upgrade Anthropic.ClaudeCode.

WSL нужен, если ваши проекты живут в Linux-окружении или вам нужна песочница для команд: она есть только в WSL 2. Тогда команду для Linux вводите внутри окна WSL и claude запускаете там же. Для обычной Windows советую поставить Git for Windows: с ним Claude Code запускает команды в Bash, как на маке.

Linux

Команда та же, что для macOS: curl -fsSL https://claude.ai/install.sh | bash. Для Debian, Ubuntu, Fedora, RHEL и Alpine есть официальные репозитории apt, dnf и apk, если вам привычнее ставить программы так. На Alpine сначала поставьте bash и curl: по умолчанию их там нет.

Через npm

Старый способ тоже работает: npm install -g @anthropic-ai/claude-code. Нужен Node.js 22 или новее. Не запускайте эту команду через sudo: документация прямо предупреждает, что так появляются проблемы с правами. Если вы не знаете, что такое npm, этот способ вам не нужен.

Проверка установки

Закройте терминал, откройте новое окно и наберите:

В ответ появится номер версии с припиской «(Claude Code)». Если терминал пишет «command not found» или «не является внутренней или внешней командой», путь к программе ещё не подхватился: откройте новое окно или перезагрузите компьютер. Подробную проверку делает claude doctor: показывает состояние установки и подсказывает, что исправить.

Claude Code без терминала: приложение и VS Code

Если терминал пугает, скачайте приложение Claude для компьютера с claude.com/download и откройте вкладку Code. Claude Code уже внутри, ничего дополнительно ставить не нужно. В VS Code нажмите Cmd+Shift+X (на Windows Ctrl+Shift+X), найдите «Claude Code» и установите расширение от Anthropic, нужна VS Code версии 1.94 или новее. То же расширение ставится в Cursor.

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

При первом запуске Claude Code попросит войти. Создайте папку для проекта, зайдите в неё и запустите программу:

Откроется браузер со страницей входа. Войдите тем аккаунтом, где оформлена подписка, и вернитесь в терминал. Вход сохранится, повторять его каждый раз не придётся. Сменить аккаунт можно командой /login прямо в сессии, а проверить, под кем вы вошли и какая модель выбрана, командой /status.

Claude Code с ключом API

Если вместо подписки у вас аккаунт Claude Console, выберите его при входе: каждый токен будет списываться с предоплаченного баланса. Другой вариант: положить ключ в переменную окружения ANTHROPIC_API_KEY. Тогда Claude Code один раз спросит, использовать ли этот ключ, и браузер открывать не станет.

Для личной работы подписка обычно выгоднее. По данным Anthropic, в компаниях Claude Code через API обходится в среднем примерно в $13 на разработчика за рабочий день, а Pro стоит $20 за месяц.

Как пользоваться Claude Code: первая задача по шагам

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

Шаг 1. Включите git

До первой задачи сделайте папку репозиторием. Тогда любую правку Claude можно посмотреть и откатить. На Windows git ставится с сайта git-scm.com, на маке система сама предложит установить его при первом вызове.

Шаг 2. Опишите задачу

Пишите как подрядчику: что сделать, для кого, как должно выглядеть и чего не делать. Чем конкретнее, тем меньше переделок. Например:

Как собирать такие описания, я подробно разбирал в статье как писать промпты: роль, контекст, задача, формат и ограничения работают и здесь. Длинные задачи я не печатаю, а надиктовываю через Wispr Flow: он превращает речь в аккуратный текст в любом окне, включая терминал.

Шаг 3. Смотрите, что он делает

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

Шаг 4. Правьте словами

Что-то не нравится? Скажите, что поменять: «кнопку сделай больше и синей», «добавь блок с ценами», «на телефоне заголовок наезжает на текст, поправь». Если Claude пошёл не туда, нажмите Esc, и он остановится. Двойное нажатие Esc или команда /rewind вернут разговор и код к прошлой точке.

Шаг 5. Сохраните результат

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

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

Режимы разрешений: когда Claude спрашивает, а когда делает сам

Режим разрешений решает, что Claude может сделать без вашего «да». Переключается он клавишами Shift+Tab, текущий режим написан под строкой ввода. Выберите режим и задачу, отправьте её и посмотрите, сколько раз вас спросят:

Вот четыре режима, которые вы встретите сразу:

• Auto. В свежих версиях (начиная с 2.1.283) сессии в терминале стартуют именно в нём. Claude делает всё сам, а вторая модель-проверяющий смотрит каждое действие и блокирует рискованные: принудительную отправку на GitHub с перезаписью истории, удаление файлов, которые были до начала сессии, выкладку на рабочий сервер, отправку секретов наружу.
• Manual (в настройках называется default). Спрашивает перед каждой правкой и каждой командой, сам только читает. Хорош в первые дни и для проектов, где цена ошибки высока.
• Accept edits. Файлы правит без вопросов, простые файловые команды вроде mkdir и mv тоже выполняет сам, а остальные команды подтверждаете вы.
• Plan. Только изучает проект и пишет план, ничего не меняя. Вы читаете план, просите поправить или одобряете, и тогда начинается работа. Включается ещё и командой /plan перед задачей.

Мой совет новичку: первую неделю работайте в Manual или Accept edits и читайте, что Claude собирается сделать. Так вы быстро поймёте, как он рассуждает, и потом спокойно перейдёте на Auto. Большие задачи начинайте с Plan: поправить план дешевле, чем переделывать код.

Если подтверждать действия приходится часто, на маке выручает Vibe Island: программа показывает запросы Claude Code в вырезе экрана, и их можно одобрять, не переключаясь в терминал. Она платная, покупка разовая.

Команды, CLAUDE.md, skills и MCP

Команды внутри сессии начинаются с косой черты: наберите /, и появится список. С первого дня нужны эти:

• /init создаёт CLAUDE.md с описанием проекта.
• /clear начинает разговор с чистого листа. Делайте так при переходе к новой задаче.
• /compact сжимает длинный разговор в краткое изложение, чтобы продолжить ту же задачу. Можно подсказать, что сохранить: /compact оставь решения по дизайну.
• /context показывает, чем занято контекстное окно.
• /usage показывает, сколько лимита подписки потрачено.
• /model переключает модель.
• /resume возвращает к прошлому разговору, /rewind откатывает разговор и код.
• /mcp и /skills показывают подключённые серверы и навыки.

Из обычного терминала пригодятся ещё две: claude -c продолжает последний разговор в этой папке, а claude -p "вопрос" отвечает один раз и выходит.

CLAUDE.md: память проекта

CLAUDE.md это текстовый файл в корне проекта. В него пишут то, что Claude должен помнить всегда: как запускать проект, какой стиль у кода, что нельзя трогать. Правила для всех проектов сразу кладут в ~/.claude/CLAUDE.md. Держите файл коротким, документация советует до 200 строк: он загружается в каждую сессию и тратит лимит.

Skills в Claude Code

Skill (навык) это папка с файлом SKILL.md, в котором лежит инструкция под определённую работу: как вы публикуете статьи, как проверяете код перед выкладкой. Личные навыки лежат в ~/.claude/skills/, навыки проекта в .claude/skills/. Claude сам решает по описанию, когда подключить навык, а вручную его вызывают командой /имя-навыка. В отличие от CLAUDE.md, навык не занимает место, пока не понадобился.

MCP

MCP подключает к Claude Code внешние сервисы: браузер, базу данных, Figma, трекер задач. Подключённые серверы видны в /mcp. Начинать с них не обязательно: сначала освойте обычную работу, а сервер добавляйте под конкретную задачу. Если у сервиса есть программа для терминала, Claude часто справится через неё, и это экономнее для контекста.

Какие модели есть в Claude Code

На Pro и Max по умолчанию сейчас работает Opus 5.5. В /model можно выбрать Sonnet 5.5: она быстрее, медленнее расходует лимит и хорошо справляется с большинством задач в коде. Haiku подходит для совсем простых поручений. Есть и комбинированный вариант opusplan: план пишет Opus, а выполняет Sonnet.

Лимиты и токены: как не сжечь подписку за вечер

Лимит подписки считается в двух окнах: сессионное обновляется каждые пять часов, недельное раз в неделю. И он общий с чатом Claude: если днём вы много переписывались на claude.ai, вечером на Claude Code останется меньше.

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

• /clear между задачами. Закончили с формой заявки и переходите к дизайну: очистите разговор. Старый контекст тратит токены на каждом шаге.
• Конкретные задачи. «Улучши проект» заставит Claude читать всё подряд. «Добавь проверку номера телефона в форму в файле contact.html» обойдётся в разы дешевле.
• Sonnet для обычной работы. Opus оставьте для сложных решений.
• Plan для больших задач. Ошибку в направлении, замеченную на этапе плана, исправить почти ничего не стоит.
• Короткий CLAUDE.md и только нужные MCP-серверы. Всё это загружается в каждую сессию.
• Новая сессия после долгого перерыва. Если старый разговор не нужен, не продолжайте его: после паузы дольше часа модель заново обрабатывает всю историю.

Сколько осталось, видно в /usage. Когда лимит закончился, можно дождаться сброса, включить докупку сверх лимита (usage credits) или перейти на Max. Без вашего согласия деньги сверх подписки не спишутся.

Claude Code или Codex, и при чём тут Cursor

Все три инструмента делают похожую работу: ИИ пишет и правит код в ваших файлах. Разница в том, где вы работаете и за какую подписку уже платите.

• Claude Code от Anthropic: терминал, расширение для VS Code и Cursor, приложение Claude, браузер. Входит в подписки Claude начиная с Pro.
• Codex от OpenAI: тоже есть терминал, расширение для редактора, приложение и облако. Входит в подписки ChatGPT. По данным OpenAI на октябрь 2026 года, терминал и расширение доступны с тарифа Plus ($20 в месяц), а на Free и Go Codex работает только в приложении.
• Cursor: отдельный редактор кода на основе VS Code со своим агентом и моделями разных компаний. Есть бесплатный тариф Hobby с ограниченным числом запросов, платный стоит от $20 в месяц. Внутрь Cursor можно поставить и расширение Claude Code.

Ответьте на три вопроса, и подборщик подскажет, с чего начать:

Если у вас уже есть ChatGPT Plus, логично сначала попробовать Codex: он входит в подписку. Если выбираете с нуля и хотите один инструмент и для текстов, и для кода, берите Claude. Я сам пишу и тексты, и код в Claude, поэтому работаю в Claude Code. Cursor стоит выбрать, если вам важно видеть каждую строку и вы готовы разбираться в коде. Есть и другие аналоги Claude Code, но для старта этих трёх хватит с запасом.

Частые ошибки новичков

Почти все проблемы новичков связаны не с установкой, а с привычками: секреты в коде, работа без git и слишком широкие разрешения. Вот что встречается чаще всего:

• Ключи и пароли прямо в коде. Токен бота или ключ API, вписанный в файл, рано или поздно окажется на GitHub. Храните их в файле .env и попросите Claude добавить его в .gitignore. Что ещё не стоит отдавать нейросети, я собрал в статье что нельзя отправлять в нейросеть.
• Работа без git. Без него неудачную правку не откатить. git init в первой же папке и коммит после каждого удачного шага.
• «Разрешить всё» на рабочем компьютере. Режим без проверок нужен только в изолированной среде.
• Одна сессия на весь день. Контекст разрастается, Claude начинает путаться и быстрее тратит лимит. Новая задача, новый /clear.
• Команда не для того терминала. Команда для CMD в PowerShell (и наоборот) падает с ошибкой. Смотрите на буквы PS в начале строки.
• Не открыли новое окно после установки. Отсюда большинство ошибок «command not found».
• Принимать результат на веру. Откройте страницу, понажимайте кнопки, проверьте на телефоне. Claude пишет быстро, но проверка всё равно на вас.

Что дальше: от первой страницы к своему проекту

Установить Claude Code и сделать страницу можно за вечер по этой инструкции и официальной документации. Сложности начинаются, когда проект должен жить сам: Telegram-бот, который работает круглосуточно, сайт на своём домене, приём оплаты, база с заявками. Появляются сервер, переменные окружения, выкладка и вечный вопрос «почему у меня работает, а на сервере нет».

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

Для выкладки понадобится виртуальный сервер. Мой сайт работает на VDSka, для старта подойдёт и Timeweb Cloud. Claude Code умеет сам настроить сервер по SSH, но понимать, что он там делает, всё равно придётся вам.

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