Как установить Claude Code: Windows, Mac, VS Code

7 минут чтения
Claude Codeустановканейросети

Claude Code ставится одной командой из терминала. На Mac и Linux это curl -fsSL https://claude.ai/install.sh | bash, на Windows в PowerShell irm https://claude.ai/install.ps1 | iex. Отдельный файл для этого скачивать не нужно: установщик сам загрузит агента и дальше будет обновлять его в фоне. Без терминала есть два пути: расширение Claude Code от Anthropic для VS Code и Cursor или приложение Claude для компьютера, где агент открывается на вкладке Code. Войти можно с платной подпиской Claude (Pro, Max, Team, Enterprise) или с аккаунтом Console, на бесплатном тарифе Claude Code не работает.

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

Система: macOS 13 и новее, Windows 10 версии 1809 и новее, Ubuntu 20.04 или Debian 10 и новее. Оперативной памяти от 4 ГБ. Node.js не нужен: установщик ставит готовую программу. Права администратора и sudo не нужны, всё ложится в домашнюю папку.

На Windows заранее поставьте Git for Windows. Без него агент запускает команды в PowerShell, с ним в Bash. Если проекты живут в WSL (Linux внутри Windows), ставьте агента туда командой для Linux, и Git for Windows не понадобится.

Anthropic работает только в странах из своего списка, Беларуси и России в нём нет. Поэтому установщик может остановиться ещё на загрузке с сообщением о недоступном регионе. Что это значит для аккаунта, разобрано в статье работает ли Claude в Беларуси.

Команда установки для Mac, Windows и Linux

Откройте Терминал на Mac или PowerShell на Windows (в меню Пуск наберите PowerShell) и вставьте команду для своей системы.

Установка одной командой
macOS
curl -fsSL https://claude.ai/install.sh | bash
Через Homebrew: brew install --cask claude-code. Такая установка сама не обновляется, нужен brew upgrade claude-code.

Как прошла установка с нуля

1 октября мы поставили Claude Code на Мак в пустую временную домашнюю папку, как будто агента здесь никогда не было. Установка заняла 74 секунды и 215 МБ, встала версия 2.1.286. И сразу случилась ошибка: установщик положил программу в ~/.local/bin, а этой папки нет в списке мест, где терминал ищет команды. Этот список называется PATH. Предупреждение было в выводе, даже дважды, но среди строк об успехе его легко проскочить.

Вывод терминала: установка Claude Code 2.1.286, предупреждение про PATH, ошибка command not found и рабочая версия после правки ~/.zshrc
Вывод установки, сокращённо: агент встал, но терминал нашёл его только после строки в ~/.zshrc.

Лечится строкой в файле настроек терминала: ~/.zshrc на Mac, ~/.bashrc на Linux. На Windows программа лежит в .local\bin в папке пользователя. Если PowerShell отвечает, что команда не распознана, эту папку добавляют в PATH двумя командами.

Если терминал не находит claude
macOS
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
claude --version

Как проверить, что Claude Code установлен

Перейдите в папку проекта и наберите claude. Откроется браузер со входом в аккаунт Claude, потом сессия начнётся прямо в терминале. С версии 2.1.283 она стартует в автоматическом режиме: агент правит файлы и запускает команды без вопросов, а рискованные действия проверяет отдельная модель. Чтобы он спрашивал перед каждым шагом, переключите режим на ручной клавишами Shift+Tab. Проверить саму установку можно и без входа. Команда claude --version печатает номер версии, claude doctor показывает, какая копия запущена, включены ли автообновления и что не так с PATH.

claude doctor на свежей установке, фрагмент
Claude Code doctor

Running: native (2.1.286)
Platform: darwin-arm64
Config install method: native
Auto-updates: enabled
Auto-update channel: latest

- Native installation exists but ~/.local/bin is not in your PATH
  Fix: Run: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc then open a new terminal or run: source ~/.zshrc

Как поставить Claude Code в VS Code

Откройте каталог расширений: Cmd+Shift+X на Mac, Ctrl+Shift+X на Windows. Найдите Claude Code от издателя Anthropic и установите. Нужен VS Code 1.94 или новее. Откройте любой файл: в правом верхнем углу редактора появится значок-искра, он открывает панель агента и при первом запуске просит войти в аккаунт Claude. Расширение ставится и в Cursor; чем Claude Code отличается от встроенного агента Cursor, разобрано в статье Claude Code или Cursor.

Внутри расширения своя копия агента, и в PATH она не попадает. Чтобы набирать claude во встроенном терминале VS Code, нужна ещё и установка одной командой из начала статьи.

Почему claude в терминале показывает старую версию

Перед статьёй мы проверили, сколько копий Claude Code стоит на нашем рабочем Маке:

Что нашлось на рабочем Маке 1 октября
$ which -a claude
/usr/local/node/node-v20.19.4/bin/claude
$ claude --version
2.1.121 (Claude Code)
$ ~/.local/bin/claude --version
2.1.119 (Claude Code)
$ <папка расширения VS Code>/resources/native-binary/claude --version
2.1.280 (Claude Code)

Команда claude в терминале запускала копию, поставленную старым способом, через npm. Копия от установщика лежала в ~/.local/bin, но этой папки не было в PATH: терминал её не видел, и она не обновлялась. Свежей в тот день была 2.1.286. 19 сентября копия 2.1.121 отказалась работать с моделью по умолчанию, и с тех пор скрипт наших автозадач берёт агента из расширения.

Держите на машине один способ установки. Копии из PATH покажет which -a claude на Mac и Linux или where.exe claude в PowerShell. Старую npm-копию убирает npm uninstall -g @anthropic-ai/claude-code. При нашей установке с нуля установщик снял её сам, хотя мы ставили агента во временную папку. Скрипты, которые вызывают агента из npm, после этого проверьте.

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

  • command not found: claude на Mac или 'claude' is not recognized на Windows: программа встала, но её папки нет в PATH. Лечение выше.
  • irm is not recognized, The token '&&' is not a valid statement separator или parameter name 'fsSL': команда вставлена не в то окно. irm работает в PowerShell, строка с && в CMD, curl на Mac.
  • syntax error near unexpected token '<' или 403 при загрузке: вместо установщика пришла веб-страница. Так бывает за корпоративным фильтром и в странах вне списка Anthropic.
  • EACCES при npm install -g: не добавляйте sudo, Anthropic прямо просит так не делать. Поставьте агента командой из начала статьи.
  • На Windows вместо агента открывается приложение Claude: так ведёт себя старая версия Claude Desktop, которая перехватывает команду claude. Обновите Claude Desktop.

Что делать после установки

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

Пройти установку и первую задачу вместе, на вашем проекте, можно на менторской сессии.

Частые вопросы

Скачать приложение Claude и поставить Claude Code можно без оплаты. Работать без подписки нельзя: нужен платный план Claude (Pro, Max, Team или Enterprise) или аккаунт Console с оплатой по запросам.
Нет. Установщик одной командой ставит готовую программу. Node.js 22 и новее нужен только для установки через npm, а этот способ теперь запасной.
Командой irm https://claude.ai/install.ps1 | iex в PowerShell, права администратора не нужны. Git for Windows желателен: с ним агент выполняет команды в Bash, без него в PowerShell.
Установка одной командой обновляется сама, вручную её обновляет claude update. Чтобы удалить её на Mac или Linux, сотрите файл ~/.local/bin/claude и папку ~/.local/share/claude, на Windows файл .local\bin\claude.exe и папку .local\share\claude в папке пользователя. Настройки и история сессий лежат отдельно, в папке .claude.

Новые посты на почту

Без спама. Отписка в один клик в любом письме.

Читайте также

Нейросеть для презентаций: слайды в HTML и PDF

Нейросеть для презентаций к выступлению: мой опыт с Claude Code, 14 слайдов и проверка PDF. Где потерялся текст и что пришлось исправить перед отправкой.

Что такое ИИ-агент и чем он отличается от чат-бота

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

Скилы для Claude: где взять готовые и что ставить

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