Как установить Claude Code: Windows, макось и связка с редактором

Коротко: Claude Code ставится одной командой, и на чистой системе это занимает минуты три. Проблемы начинаются не при установке, а сразу после нее, и почти все они сводятся к четырем вещам: команда не находится, терминал не тот, права не те, страна не та

Ниже все четыре способа установки с разницей между ними, проверка, что все встало, подключение к редактору и разбор поломок с текстом ошибки на экране

Что именно вы ставите

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

В чате вы работаете курьером. Копируете кусок кода туда, копируете ответ обратно, объясняете, что лежит в соседнем файле. На третьем файле это перестает быть работой и становится перекладыванием текста

Запрос «claude code» это 61 142 показа в месяц, и большая часть уточнений к нему про установку: «claude code скачать», «как установить claude code», «vs code claude», «claude code установка на windows». Спрос есть, внятной инструкции в выдаче почти нет: половина результатов это перепечатки документации, вторая половина продает подписку

Источник: Yandex Wordstat, регион Россия, замер 24 августа 2026

Что нужно до установки

Три вещи, и только одна из них техническая

Система. macOS от 13 версии, Windows 10 сборки 1809 и новее, Ubuntu от 20.04, Debian от 10, Alpine от 3.19. Оперативной памяти от четырех гигабайт. Ноутбук 2018 года это проходит

Платный аккаунт. Бесплатный тариф Claude.ai доступа к Claude Code не дает, это написано в документации прямым текстом. Подходят Pro, Max, Team, Enterprise или аккаунт Console с оплатой по токенам

Страна из списка поддерживаемых. Это отдельный разговор, и он в конце статьи, потому что для читателя из России это главный пункт, а не третий

Источник: Документация Claude Code, System requirements

Установка одной командой

Это способ по умолчанию, и для большинства он правильный

На макоси и линуксе откройте терминал и выполните:

curl -fsSL https://claude.ai/install.sh | bash

На Windows в PowerShell:

irm https://claude.ai/install.ps1 | iex

На Windows в обычной командной строке:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Команда скачивает установщик и запускает его. На чистой системе это две-три минуты, из которых полторы уходят на скачивание

Три других способа и чем они отличаются

Способов установки четыре, и разница между ними ровно одна: обновляется установка сама или нет

Через менеджер пакетов. На макоси brew install --cask claude-code, на Windows winget install Anthropic.ClaudeCode, на линуксе пакеты apt, dnf и apk. Удобно, если вы уже живете в менеджере пакетов и обновляете все разом

Глобальным пакетом npm. npm install -g @anthropic-ai/claude-code. Работает, но требует установленного Node, а Node на Windows умеет ставиться в место, куда потом нужны права администратора

Одной командой. Тот способ, что выше

Общая особенность первых двух: установка через Homebrew, WinGet и системные пакеты не обновляется сама. Установка одной командой обновляется в фоне. Модели и сам агент меняются часто, и версия трехмесячной давности начинает вести себя иначе, чем описано в свежей документации. Если не собираетесь следить за обновлениями руками, берите способ с одной командой

Проверка, что все встало

Закройте терминал целиком и откройте заново. Это не суеверие: установщик дописывает путь к программе в файл настроек оболочки, а уже открытый терминал этот файл не перечитывает

Теперь:

claude --version

Должна напечататься версия. Если напечаталась, дальше:

claude doctor

Эта команда проверяет окружение сама и говорит, чего не хватает. Начинать разбор поломки стоит с нее, а не с поиска текста ошибки в интернете

Подключение к редактору

Запрос «vs code claude» это 2 071 показ в месяц, и за ним стоит понятное желание: не переключаться между окнами

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

claude

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

То же самое работает в редакторах на основе IntelliJ: PyCharm, WebStorm, IDEA

Первый запуск

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

cd путь/к/проекту
claude

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

Первый вопрос лучше задать не про код, а про проект: «что это за проект и из чего он состоит». Ответ покажет, видит ли агент файлы и понимает ли, что перед ним

Что тут ломается

Это самый полезный раздел, и написан он по настоящим поломкам, а не по списку возможных

command not found: claude

Самая частая. Означает, что программа встала, но терминал не знает, где ее искать

Сначала закройте и откройте терминал заново. Помогает в большинстве случаев

Если не помогло, посмотрите, куда встал агент:

ls ~/.local/bin/claude

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

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

На макоси по умолчанию оболочка zsh, и файл ~/.zshrc. На большинстве линуксов bash, и файл ~/.bashrc. Перепутать легко, а ошибка выглядит одинаково: команда так и не находится. Проверить, какая у вас оболочка: echo $SHELL

На Windows команда работает не везде

Windows это три разных терминала: командная строка, PowerShell и WSL. Установка в одном из них не делает команду доступной в двух других

Определитесь заранее, где будете работать. Если планируете идти дальше в разработку, берите WSL: это настоящий линукс внутри Windows, и все инструкции из интернета в нем работают как написано. Если WSL пока не нужен, ставьте в PowerShell и работайте в PowerShell

Ошибка про права при установке через npm

Выглядит как EACCES: permission denied. Означает, что npm пытается писать в системную папку

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

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

После этого повторите установку

Агент запускается, но сразу ругается на аккаунт

Два варианта. Либо тариф бесплатный, и тогда доступа нет вовсе, либо вход не завершился в браузере. Второе лечится командой claude и повторным входом, первое не лечится ничем, кроме платного тарифа

Установка проходит, а обновлений нет

Проверьте, каким способом ставили. Через Homebrew и WinGet обновление руками: brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode. Через одну команду обновляется само

Источник: Документация Claude Code, Troubleshoot installation

Про страну, коротко и без продажи

У Anthropic есть опубликованный список стран, где компания продает доступ. России и Беларуси в нем нет ни в списке для API, ни в списке для Claude.ai

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

Мы разобрали это отдельно, вместе с тем, что работает вместо схем из поиска, и чем именно рискует человек, который платит посреднику

Источник: Anthropic, Supported countries

Сколько это стоит в месяц

Тариф Pro это двадцать долларов в месяц, Max начинается со ста. Разница не в модели, а в лимитах: сколько запросов в пять часов вы успеваете сделать до того, как агент скажет подождать

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

Отдельно считайте плату за модель, если работаете через Console по токенам: там платите за объем, и счет зависит от того, сколько файлов агент прочитал

Что делать дальше

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

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

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

Файл настроек проекта: то, что стоит сделать сразу

Агент читает файл CLAUDE.md в корне проекта в начале каждой сессии. Без него вы объясняете одно и то же в каждом новом разговоре: чем запускается проект, где лежит что, чего трогать нельзя

Создайте его сразу после установки. Минимальный рабочий вариант выглядит так:

# Название проекта

Что это: короткая витрина услуг с формой заявки

## Запуск

npm run dev, порт 3000

## Что нельзя трогать

Файл .env.local, там ключи. Папка public/photos, там фотографии клиента

## Как я хочу, чтобы ты работал

Сначала показываешь план, потом правишь. Не переписываешь соседние
файлы без спроса

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

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

Разрешения: что агент может без спроса

При первом запуске агент спрашивает разрешение на папку. Дальше он спрашивает почти на каждое действие: прочитать файл, записать файл, выполнить команду

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

Разумная середина: разрешать чтение и правку файлов внутри проекта без вопросов, а выполнение команд оставить с подтверждением. Настраивается это в файле настроек внутри папки .claude в проекте, и один раз сделанная настройка переносится в следующие проекты копированием

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

Windows: ставить в WSL или нет

Если вы на Windows и планируете идти дальше поверхностного знакомства, ответ: в WSL

WSL это настоящий линукс внутри Windows. Ставится одной командой в PowerShell от администратора:

wsl --install

Дальше перезагрузка, придумываете имя пользователя и пароль, и у вас появляется терминал Ubuntu. Claude Code ставится в него той же командой, что на линуксе

Зачем это нужно. Девять из десяти инструкций в интернете написаны для макоси или линукса. В WSL они работают как написано, в PowerShell половина команд не существует или называется иначе. Вы экономите не время установки, а часы разбирательств на каждом следующем шаге

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

Claude Code, Cursor или Codex: что чем отличается

Вопрос возникает сразу после установки, и в выдаче на него отвечают сравнением таблиц с галочками. Разница на практике другая

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

Cursor это редактор целиком, форк VS Code со встроенной моделью. Сильная сторона: правки в открытом файле, когда вы видите код и хотите поменять кусок на глазах. Слабая: своя программа, свои настройки, свой аккаунт

Codex это агент от OpenAI, устроенный ближе к Claude Code. Разница в модели и в лимитах, а не в подходе

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

Первый час после установки

Порядок, который экономит вечер

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

Второе: попросите собрать одну страницу с заголовком и кнопкой. Одну, а не сайт. Задача должна быть такой, чтобы вы сами видели, получилось или нет

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

Четвертое: сломайте что-нибудь нарочно. Удалите строку, посмотрите на ошибку, покажите ее агенту. Это единственный способ понять, как он ведет себя при поломке, а поломки будут занимать половину вашего времени

Пятое: только теперь заводите настоящий проект

Как понять, что установка удалась

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

• claude --version печатает версию, а не ошибку
• claude doctor не находит проблем
• агент открывается из папки проекта и отвечает на вопрос о том, что это за проект
• расширение в редакторе показывает правки построчно, а не сплошным текстом
• вы собрали страницу, открыли ее в браузере и увидели свой заголовок

Если сорвалось на первом пункте, это путь. На втором, это окружение, и doctor скажет, что именно. На третьем, это разрешения на папку. На четвертом, расширение не встало, запустите агента из терминала внутри редактора еще раз. На пятом, это уже не установка, а работа, и она начинается здесь

Коротко

• Ставить одной командой: она единственная обновляется сама
• После установки закрыть и открыть терминал, иначе команда не найдется
• claude doctor разбирает поломку быстрее, чем поиск текста ошибки
• Расширение для редактора ставится из самого агента, при первом запуске внутри него
• На Windows определитесь с терминалом заранее: три терминала это три разные установки
• Бесплатный тариф доступа не дает, и это не обходится настройками