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

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

Разберём установку по шагам — отдельно для Windows, отдельно для мака и Linux. И сразу с теми местами, где спотыкаются: их немного, но они одни и те же у всех.

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

• Терминал. На маке это программа «Терминал», она уже стоит. На Windows — PowerShell или командная строка, тоже уже стоят. Ставить ничего не нужно.
• Аккаунт. Подписка Claude (Pro, Max, Team или Enterprise) — либо аккаунт Claude Console с предоплаченными кредитами, если хочешь платить за фактический расход.
• Папка с проектом. Любая папка, с которой будешь работать. Хоть пустая — агент в ней и начнёт.

Про оплату из России — отдельная история, разбирал её в уроке как оплатить нейросети из России. Здесь считаем, что доступ уже есть.

Установка на macOS и Linux

Открываешь терминал и вставляешь одну строку:

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

Всё. Установщик скачается и сам себя выполнит. Тот же способ работает и в WSL — это Linux внутри Windows, если ты им пользуешься.

На маке есть альтернатива через Homebrew, если ты уже им пользуешься:

brew install --cask claude-code

У этого способа есть нюанс, о котором стоит знать сразу: через Homebrew обновления сами не приезжают. Придётся время от времени делать brew upgrade claude-code руками. Нативный установщик из первой команды обновляется в фоне сам — поэтому его и рекомендуют.

Установка на Windows

Здесь есть развилка, и именно на ней спотыкается большинство. На Windows два разных терминала, и команда для них разная. Вставишь не ту — получишь ошибку и решишь, что всё сломано.

Если у тебя PowerShell:

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

Если командная строка (CMD):

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

Есть ещё вариант через встроенный менеджер пакетов Windows: winget install Anthropic.ClaudeCode. Он тоже рабочий, но, как и Homebrew, сам не обновляется — обновлять придётся командой winget upgrade.

Как понять, в каком терминале ты сидишь

Самый простой способ — посмотреть на строчку, где мигает курсор.

• Видишь PS C:\> — буквы PS в начале — это PowerShell.
• Видишь просто C:\> без PS — это командная строка.

А если уже вставил команду и получил ошибку, она сама тебе всё скажет:

• «The token '&&' is not a valid statement separator» — ты вставил команду для CMD, а сидишь в PowerShell. Возьми команду с irm.
• «'irm' is not recognized as an internal or external command» — наоборот: ты в CMD, а вставил команду для PowerShell. Возьми длинную команду с curl.

Вот и вся магия. Это не поломка и не кривые руки — просто два разных терминала.

Проверь, что установилось

В том же окне набери:

claude --version

Если в ответ приехал номер версии и рядом надпись (Claude Code) — установка прошла. Если терминал говорит, что команда не найдена, закрой окно и открой заново: чаще всего дело в том, что он ещё не подхватил новую программу.

Вход в аккаунт

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

Если захочешь потом сменить аккаунт — уже внутри работающего Claude Code набери /login.

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

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

Переходишь в папку проекта и запускаешь:

cd путь/к/твоей/папке
claude

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

что делает этот проект?

Агент сам прочитает файлы и расскажет. Ничего добавлять в контекст руками не нужно — он берёт то, что ему нужно.

Пара команд, которые пригодятся сразу: /help — список всего, что умеет; /clear — очистить разговор и начать с чистого листа; /exit — выйти.

Терминал — не единственный вариант

Это стоит знать до того, как ты решишь, что чёрное окно не для тебя. Claude Code живёт не только в терминале. Он есть в браузере, отдельным приложением для компьютера, встроенным в редакторы кода — VS Code и среды JetBrains, — а ещё в Slack и в автоматических сборках на GitHub. Если из этого списка тебе ближе редактор — как устроен сам VS Code и как открыть в нём проект, разобрано отдельно.

Агент везде один и тот же, отличается только окно, в которое ты пишешь. Если терминал пока пугает — начни с браузера или приложения, а к терминалу вернёшься, когда перестанет казаться, что там всё сломается от одной опечатки. Не сломается.

Три режима разрешений — переключаются одной клавишей

Самый частый страх новичка: «а он мне сейчас всё удалит». Поэтому запомни одно сочетание — Shift+Tab. Оно переключает, насколько агенту позволено хозяйничать.

• Обычный режим. Перед каждой правкой файла агент спрашивает разрешение. Так он работает по умолчанию — начинай с этого.
• Режим правок. Правки файлов применяются без вопросов. Удобно, когда ты уже понял, что он делает, и надоело нажимать «да».
• Режим плана. Агент только предлагает, что сделал бы, но ничего не меняет. Лучший режим, чтобы посмотреть на его ход мысли, ничем не рискуя.

Начни с обычного и режима плана. Пока не привык — пусть спрашивает.

Нюанс для Windows, о котором молчат

На обычном Windows (не в WSL) стоит доставить Git for Windows. Причина не в гите как таковом: вместе с ним в системе появляется Bash — и Claude Code начинает использовать его для запуска команд. Без него агент работает через PowerShell.

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

Если что-то пошло не так

• Команда не найдена после установки. Закрой терминал и открой заново — почти всегда лечится этим.
• Ошибка про '&&' или про 'irm'. Перепутаны PowerShell и CMD, см. раздел выше.
• Установщик падает с ошибкой curl или 403. Это уже сетевая история: у Anthropic есть отдельная страница по разбору ошибок установки, где ошибка сопоставлена с решением и перечислены альтернативные способы поставить.
• Не пускает на вход. Проверь, что подписка активна и что ты входишь тем аккаунтом, на котором она оформлена.

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

Нужно ли уметь программировать, чтобы поставить?

Нет. Установка — это одна команда, скопированная в терминал. Всё остальное общение идёт обычными словами.

Обязательна ли подписка?

Нужен аккаунт: либо подписка Claude, либо Console с предоплаченными кредитами. Без доступа к моделям инструмент работать не будет.

Само обновляется или нет?

Смотря как поставил. Нативный установщик обновляется в фоне сам. Homebrew и WinGet — нет, там обновление руками.

Можно ли поставить на рабочий компьютер с ограничениями?

Если админ запрещает ставить программы — установщик не отработает. Это вопрос к политике компании, а не к инструменту.

Что дальше

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

Если пока не понимаешь, чем терминал лучше обычного чата и когда что удобнее — об этом отдельно: чат, Cowork и Code, чем они отличаются.

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