как установить claude code на windows и mac: все способы по шагам

как установить claude code: на mac открой терминал и выполни curl -fsSL https://claude.ai/install.sh | bash, на windows открой powershell и выполни irm https://claude.ai/install.ps1 | iex. потом открой новое окно терминала, проверь claude --version, зайди в папку проекта, набери claude и войди в аккаунт через браузер. ниже все официальные способы, windows нативно и через wsl, расширения для редакторов, обновление, удаление и разбор ошибок. всё сверено с документацией anthropic на 14 октября 2026.

я делаю через claude code сайты, ботов и seo, а этот сайт arturr_city целиком собран ии в claude code. если ты только знакомишься с подходом, начни со статьи вайбкодинг — что это и как он работает, а здесь будет только установка.

перед установкой: требования и аккаунт

по документации claude code работает на таких системах и железе:

• macos 13.0 и новее;
• windows 10 версии 1809 и новее или windows server 2019 и новее;
• ubuntu 20.04+, debian 10+, alpine linux 3.19+;
• от 4 гб оперативной памяти, процессор x64 или arm64;
• подключение к интернету и оболочка bash, zsh, powershell или cmd.

второе условие — аккаунт. нужен платный план claude (pro, max, team или enterprise) либо аккаунт claude console. бесплатный план claude.ai доступа к claude code не даёт. для компаний есть ещё вход через amazon bedrock, google cloud и microsoft foundry, но для одиночной работы это лишнее.

node.js в системных требованиях нет. он нужен только для установки через npm, и тогда версии 22 или новее. в части русскоязычных инструкций до сих пор пишут про node.js 18 и обязательный git for windows: по текущей документации оба пункта устарели.

claude code установка: какой способ выбрать

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

если у тебя уже стоит версия из npm и хочется перейти на нативную, сначала удали старую командой npm uninstall -g @anthropic-ai/claude-code, потом запускай установщик. документация прямо советует держать одну установку: несколько копий дают путаницу с версиями.

без терминала: приложение claude desktop

если ты искал «claude code скачать» и ждал обычный установщик с кнопкой «далее», он тоже есть. приложение claude desktop включает claude code во вкладке code, и для неё не нужны ни node.js, ни отдельный cli. в документации есть сборки для macos (одна на intel и apple silicon), для windows x64 и arm64, а для ubuntu и debian бета через apt или .deb. нужен платный план pro, max, team или enterprise. чтобы запускать claude в терминале, cli всё равно ставится отдельно.

как установить claude code на mac

открой терминал (если ни разу этого не делал, в документации есть отдельный гайд по терминалу), вставь команду и нажми enter:

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

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

claude --version

программа ложится в ~/.local/bin/claude, это ссылка на папку с версиями ~/.local/share/claude/versions/. если терминал отвечает zsh: command not found: claude, папка не попала в path, исправление в разделе про ошибки ниже.

через homebrew

brew install --cask claude-code

у homebrew два варианта. claude-code идёт по стабильному каналу: обычно отстаёт примерно на неделю и пропускает релизы с серьёзными регрессиями. claude-code@latest получает новые версии сразу. сам по себе такой вариант не обновляется, поэтому периодически запускай brew upgrade claude-code (или brew upgrade claude-code@latest), а старые версии убирай через brew cleanup. если brew пишет, что такого cask нет, сначала выполни brew update.

claude code windows: нативно или через wsl

документация даёт два пути: ставить прямо в windows или внутрь wsl. выбор зависит от того, где лежат проекты и нужна ли песочница для команд.

если слово wsl тебе ничего не говорит, начинай с нативной установки: ей ничего дополнительно не нужно.

нативно: powershell или cmd

сначала пойми, где ты находишься. в powershell строка начинается с PS C:\Users\..., в cmd просто с C:\Users\.... запускать терминал от имени администратора не нужно.

команда для powershell:

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

команда для cmd:

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

или через winget, но тогда обновлять придётся самому командой winget upgrade Anthropic.ClaudeCode:

winget install Anthropic.ClaudeCode

нативный установщик кладёт программу в %USERPROFILE%\.local\bin\claude.exe. после установки открой новое окно и проверь claude --version.

git for windows ставить не обязательно. с ним claude code выполняет команды через git bash, без него через powershell. если git стоит, а claude code его не находит, укажи путь к bash в файле настроек settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

внутри wsl

открой свой дистрибутив wsl и выполни ту же команду, что и для mac:

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

ставить и запускать claude нужно в терминале wsl, а не из powershell или cmd. git for windows для wsl не нужен. при входе в аккаунт из wsl 2 браузер часто не может вернуть тебя в терминал и вместо этого показывает код. его вставляют в терминал на строке Paste code here if prompted.

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

сначала убедись, что программа на месте. claude --version в рабочей установке печатает номер версии, в документации пример такой: 2.1.211 (Claude Code). у тебя цифры будут свои. для подробной проверки есть отдельная команда:

claude doctor

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

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

cd /path/to/your/project
claude

при первом запуске откроется браузер со входом. если не открылся, нажми c: ссылка скопируется, и её можно вставить в браузер вручную. когда вход прошёл, терминал напишет Login successful и попросит нажать enter. войти можно аккаунтом pro или max, командным аккаунтом team или enterprise, либо аккаунтом claude console.

повторно логиниться не придётся. на mac данные входа хранятся в связке ключей (keychain), на windows в %USERPROFILE%\.claude\.credentials.json, на linux в ~/.claude/.credentials.json. сменить аккаунт можно командой /login внутри сессии, выйти командой /logout, а /status покажет, каким способом ты сейчас вошёл.

одна ловушка: если в системе задана переменная ANTHROPIC_API_KEY и ты разрешил её использовать, claude code берёт этот ключ вместо подписки. что делать с агентом после входа, я разобрал в статье claude code: как использовать и с чего начать.

как установить claude code в vs code и jetbrains

vs code и cursor

нужен vs code 1.94.0 или новее. открой панель расширений (Cmd+Shift+X на mac, Ctrl+Shift+X на windows и linux), найди «claude code» и нажми install. то же расширение ставится в cursor и другие форки vs code, оно есть и в реестре open vsx. если расширение не появилось, перезапусти редактор или выполни «developer: reload window» из палитры команд.

панель открывается иконкой-искрой в правом верхнем углу редактора (видна, только когда открыт файл) или кнопкой «✻ claude code» в строке состояния справа внизу. при первом открытии нажми sign in и подтверди вход в браузере. важная деталь: расширение несёт свою копию cli для панели чата, но в path её не добавляет. чтобы набирать claude во встроенном терминале, cli ставится отдельно любым способом выше.

intellij idea, pycharm, webstorm и другие

плагин работает в intellij idea, pycharm, android studio, webstorm, phpstorm и goland. своей копии cli у него нет, поэтому порядок такой: сначала ставишь cli, потом плагин claude code [beta] из jetbrains marketplace и перезапускаешь ide. дальше запускаешь claude во встроенном терминале ide, а из внешнего терминала подключаешься к ide командой /ide. быстрый запуск из редактора: Cmd+Esc на mac, Ctrl+Esc на windows и linux.

если claude code стоит в wsl, в настройках плагина (settings → tools → claude code [beta]) укажи команду wsl -d Ubuntu -- bash -lic "claude", заменив ubuntu на имя своего дистрибутива.

обновление и удаление

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

claude update

канал обновлений выбирается в /config, пункт auto-update channel. latest стоит по умолчанию и даёт новые версии сразу, stable даёт версию примерно недельной давности без релизов с серьёзными регрессиями. поставить сразу стабильную или конкретную версию можно так:

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

остальные способы обновляются вручную: brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode, для npm npm install -g @anthropic-ai/claude-code@latest. команду npm update -g документация не советует: она может не довести до последней версии.

удаление нативной версии на mac, linux и в wsl:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

на windows в powershell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

для других способов: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode, npm uninstall -g @anthropic-ai/claude-code. настройки, разрешения, подключённые mcp-серверы и история сессий живут в ~/.claude и ~/.claude.json. удаляй их, только если хочешь начать с чистого листа, и помни: расширение vs code, плагин jetbrains и desktop-приложение создают ~/.claude/ заново, пока они установлены.

типовые ошибки при установке

большая часть проблем сводится к двум вещам: команда не для той оболочки или папка установки не попала в path. вот что встречается чаще всего и что советует документация.

как добавить папку в path на mac, где оболочка по умолчанию zsh:

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

на windows в powershell, после чего нужно открыть новое окно терминала:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

если claude не находится только внутри vs code или другого редактора, перезапусти сам редактор: встроенный терминал берёт path у него. а если подозреваешь, что установок несколько, посмотри, какие видит система: which -a claude на mac и linux, where.exe claude на windows. оставь одну.

вопросы

как установить клод код, если я ни разу не открывал терминал?

есть два пути. в документации есть отдельный гайд по терминалу: как его открыть и куда вставить команду. второй вариант: поставить приложение claude desktop и работать во вкладке code вообще без командной строки.

claude code можно поставить на бесплатный аккаунт?

сама установка аккаунта не требует, но войти и работать без платного доступа не получится: нужен аккаунт pro, max, team, enterprise или claude console. бесплатный план claude.ai доступа к claude code не включает.

нужен ли node.js?

в системных требованиях его нет. node.js 22 или новее нужен только для установки через npm. на более старой версии npm выдаст предупреждение EBADENGINE, но установка завершится и claude будет работать.

что выбрать на windows: wsl или нативно?

нативно, если проекты и инструменты под windows и ничего лишнего ставить не хочется. wsl 2, если работаешь с linux-инструментами или нужна песочница для команд: в нативной windows и в wsl 1 её нет.

можно ли поставить конкретную версию?

да. нативному установщику передаётся номер версии или канал stable, примеры в разделе про обновление. у homebrew канал выбирается именем cask: claude-code или claude-code@latest.

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

источники

• advanced setup — code.claude.com
• quickstart — code.claude.com
• troubleshoot installation and login — code.claude.com
• authentication — code.claude.com
• use claude code in vs code — code.claude.com
• jetbrains ides — code.claude.com
• get started with the desktop app — code.claude.com