Как установить Claude Code на Windows, macOS и Linux
12.09.2026 · обновлено 17.09.2026
Claude Code — оболочка Anthropic для работы в командной строке: она читает проект, правит файлы и выполняет команды по просьбе, написанной обычными словами. Установка занимает одну команду, а до неё стоит свериться с требованиями к системе и с условиями доступа. Разделы ниже собирают требования, команды под каждую систему, проверку после установки и первый проект, на котором инструмент опробуют.
Что нужно на компьютере
Список подходящих систем Anthropic задаёт точно на странице Advanced setup. В него входят macOS 13.0 и новее, Windows 10 сборки 1809 и новее или Windows Server 2019 и новее, Ubuntu 20.04 и новее, Debian 10 и новее, Alpine Linux 3.19 и новее. Требования к оборудованию там записаны одной строкой: «Hardware: 4 GB+ RAM, x64 or ARM64 processor». Перевод наш: «Оборудование: от 4 ГБ оперативной памяти, процессор x64 или ARM64». Отдельными пунктами стоят сеть и оболочка — «internet connection required» и «Bash, Zsh, PowerShell, or CMD», а последним в том же перечне идёт «Location: Anthropic supported countries». Перевод наш: «Место: страны, поддерживаемые Anthropic».
Условия доступа к учётной записи Anthropic называет отдельно от списка систем: «Claude Code requires a Pro, Max, Team, Enterprise, or Console account. The free Claude.ai plan does not include Claude Code access». Перевод наш: «Claude Code требует учётной записи Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai доступа к Claude Code не даёт». Что Anthropic пишет о поддерживаемых странах и какие учётные записи подходят, собрано на странице про работу Claude Code из России.
Node.js в требованиях к системе не значится: он нужен только тому, кто ставит программу пакетом npm. Для этого случая Anthropic пишет так: «As of v2.1.198, the npm package requires Node.js 22 or later. On an older Node.js version, npm prints an EBADENGINE warning during install rather than failing; the install completes and claude still runs, since the package downloads a native binary that doesn’t use your Node.js at runtime». Перевод наш: «Начиная с версии 2.1.198 пакет npm требует Node.js 22 или новее. На более старой версии Node.js npm при установке печатает предупреждение EBADENGINE, но не прекращает работу: установка доходит до конца, и claude запускается, потому что пакет скачивает собственный исполняемый файл, которому ваш Node.js при работе не нужен». Там же стоит запрет: «Do NOT use sudo npm install -g as this can lead to permission issues and security risks». Перевод наш: «НЕ используйте sudo npm install -g: это ведёт к проблемам с правами доступа и к рискам безопасности».
Установка Claude Code одной командой
Для macOS, Linux и подсистемы Windows для Linux Anthropic даёт общую команду:
curl -fsSL https://claude.ai/install.sh | bash
Читается она в два действия: curl забирает установщик по адресу claude.ai, а bash его выполняет. Подсистема Windows для Linux проходит здесь по разряду Linux — команда в ней та же, что на Ubuntu, Debian и Alpine.
Claude Code Windows: PowerShell и командная строка
Windows обходится и без подсистемы Linux, а команда зависит от того, в какой оболочке вы работаете. В PowerShell установка выглядит так:
irm https://claude.ai/install.ps1 | iex
Для командной строки команда длиннее:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Три её части соединены знаком && и выполняются подряд: файл install.cmd скачивается в текущий каталог, запускается и удаляется оттуда. Выбор между двумя командами определяется тем, какая оболочка у вас открыта, — обе они ставят Claude Code на Windows.
Понять, где вы находитесь, помогает сам текст ошибки, и Anthropic объясняет это прямо: «If you see The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you’re in CMD, not PowerShell». Перевод наш: «Если видите The token '&&' is not a valid statement separator, вы в PowerShell, а не в CMD. Если видите 'irm' is not recognized as an internal or external command, вы в CMD, а не в PowerShell».
Установка через менеджер программ: Homebrew и winget
Менеджер программ — второй путь, и он же решает вопрос с обновлением. На macOS Claude Code ставится из Homebrew командой brew install --cask claude-code, а поднимается до свежей версии командой brew upgrade claude-code.
На Windows ту же роль выполняет winget. Установка идёт командой winget install Anthropic.ClaudeCode, обновление — командой winget upgrade Anthropic.ClaudeCode.
Разница с установкой одной командой видна именно на обновлении, и Anthropic разводит эти случаи сама: «Native installations automatically update in the background». Перевод наш: «Установка одной командой обновляется сама в фоне». Про остальные пути сказано иначе: «Homebrew installations do not auto-update» и «WinGet installations do not auto-update». Перевод наш: «Установка через Homebrew сама не обновляется» и «Установка через WinGet сама не обновляется».
Claude Code в VS Code: установка расширения и вход в учётную запись
Командной строкой дело не ограничивается: у Claude Code есть расширение для редактора кода, и на странице Use Claude Code in VS Code Anthropic описывает его так: «The VS Code extension provides a native graphical interface for Claude Code, integrated directly into your IDE. This is the recommended way to use Claude Code in VS Code». Перевод наш: «Расширение VS Code даёт Claude Code собственный графический вид, встроенный прямо в вашу среду разработки. Это рекомендуемый способ работы с Claude Code в VS Code». Разговор в этом случае идёт в панели рядом с открытыми файлами, а правки агента показываются там же, где вы пишете код.
Требований к такой установке два, и они перечислены в разделе для подготовки: «VS Code 1.94.0 or higher» и «An Anthropic account: any paid Claude subscription (Pro, Max, Team, or Enterprise) or a Claude Console account works, and no API key is required». Перевод наш: «VS Code 1.94.0 или выше» и «учётная запись Anthropic: подойдёт любая платная подписка Claude — Pro, Max, Team или Enterprise — либо учётная запись Claude Console, а ключ API не нужен».
Как установить Claude в VS Code и войти
Как подключить Claude к VS Code — вопрос из двух шагов: сначала расширение, потом учётная запись.
Расширение ставится из самого редактора. Сочетание Cmd+Shift+X на Mac или Ctrl+Shift+X на Windows и Linux открывает представление расширений; дальше набирают «Claude Code» и нажимают «Установить». Про другие сборки на основе VS Code сказано отдельно: «The extension also installs in other VS Code forks like Devin Desktop or Kiro. Search for “Claude Code” in the editor’s Extensions view, or install from the Open VSX registry». Перевод наш: «Расширение ставится и в другие сборки на основе VS Code — например, Devin Desktop и Kiro. Найдите “Claude Code” в разделе расширений редактора или поставьте из реестра Open VSX». Когда после установки расширение не появилось, документация советует перезагрузить VS Code или выполнить «Developer: Reload Window» из палитры команд.
Вход происходит при первом открытии панели: появляется экран входа, вы нажимаете Sign in и завершаете подтверждение в браузере. Отдельно описан случай, когда в оболочке задана переменная ANTHROPIC_API_KEY, а приглашение войти всё равно показывается: «VS Code may not have inherited your shell environment. Launch VS Code from a terminal with code . so it inherits your environment variables, or sign in with your Claude account instead». Перевод наш: «VS Code мог не унаследовать окружение вашей оболочки. Запустите VS Code из терминала командой code ., чтобы переменные перешли к нему, либо войдите своей учётной записью Claude».
Открывают панель несколькими способами, и Anthropic перечисляет их по местам в окне. Самый быстрый — значок Spark на панели инструментов редактора в правом верхнем углу, но он виден только при открытом файле. Тот же значок на Activity Bar слева открывает список сеансов и не пропадает никогда. Третий путь — палитра команд, Cmd+Shift+P или Ctrl+Shift+P, с набранным «Claude Code». Четвёртый — строка состояния в нижнем правом углу окна, и он работает даже тогда, когда ни один файл не открыт. Саму панель перетаскивают, куда удобнее: в правую боковую панель, в левую или во вкладку рядом с файлами.
Чем работа в редакторе отличается от терминала
Второго помощника при этом не появляется: Claude AI в VS Code — тот же агент, который запускается командой claude, и работает он с теми же файлами вашего проекта. Часть возможностей, впрочем, остаётся только за командной строкой, и Anthropic сводит разницу в таблицу.
| Что | Командная строка | Расширение VS Code |
|---|---|---|
| Команды и навыки | все | часть; список открывается набором / |
| Настройка серверов MCP | есть | есть, через /mcp в панели чата |
| Контрольные точки | есть | есть |
Знак ! для команды оболочки |
есть | нет |
Дополнение по Tab |
есть | нет |
Правки в редакторе видны иначе, чем в терминале, и зависит это от режима разрешений. В режимах Auto и Edit automatically агент правит большинство файлов рабочего пространства, не спрашивая. В режиме Manual он показывает сравнение исходного содержимого с предложенным рядом и ждёт ответа: принять, отклонить или сказать, что сделать вместо этого. Когда вы правите предложенное прямо в этом сравнении, Claude получает об этом уведомление и дальше не исходит из того, что файл совпадает с его первым предложением.
Выделенный в файле текст расширение видит само. Сочетание Option+K на Mac или Alt+K на Windows и Linux добавляет в запрос ссылку на файл с диапазоном строк — она выглядит как @file.ts#5-10. Переключение между кодом и полем запроса идёт по Cmd+Esc или Ctrl+Esc. На вывод терминала ссылаются записью @terminal:имя, и тогда сообщение об ошибке не приходится копировать в запрос руками.
История разговоров у двух площадок общая. Начатый в панели разговор продолжают в терминале командой claude --resume, которая открывает выбор из сохранённых. Обратная сторона названа там же: видимость фоновых задач в расширении ограничена по сравнению с командной строкой, и на этот случай Anthropic советует попросить Claude показать команду, чтобы запустить её во встроенном терминале самому.
Почему команда claude не находится во встроенном терминале
Причина в устройстве расширения, и Anthropic объясняет её прямо: «The extension bundles its own copy of the CLI (command-line interface) for the chat panel. To run claude in VS Code’s integrated terminal, you also need the standalone CLI install». Перевод наш: «Расширение несёт собственную копию командной строки для панели разговора. Чтобы запускать claude во встроенном терминале VS Code, нужна ещё и отдельная установка командной строки». После неё в любом терминале работают и claude mcp add, и claude --resume. Когда вы работаете во внешнем терминале, связать сеанс с редактором помогает команда /ide, набранная внутри Claude Code.
Есть и обратный переключатель — для тех, кому графическая панель не нужна вовсе. Параметр Use Terminal в настройках VS Code (Cmd+, на Mac, Ctrl+, на Windows и Linux, раздел Extensions → Claude Code) открывает Claude Code интерфейсом в стиле командной строки прямо внутри редактора.
Проверка и первый запуск: как использовать Claude Code
Проверка после установки состоит из одной команды — claude --version. Что она должна ответить, Anthropic показывает примером: «A working installation prints a version number such as 2.1.211 (Claude Code)». Перевод наш: «Рабочая установка печатает номер версии, например 2.1.211 (Claude Code)». Для разбора более сложных случаев рядом стоит claude doctor: «claude doctor prints read-only installation and settings diagnostics without starting a session». Перевод наш: «claude doctor печатает диагностику установки и настроек, не запуская сеанс и ничего не меняя».
Запускает программу команда claude, и первый же запуск ведёт ко входу в учётную запись. В быстром старте это описано так: «Claude Code requires an account to use. Start an interactive session with the claude command and you’ll be prompted to log in on first use». Перевод наш: «Для работы Claude Code нужна учётная запись. Начните сеанс командой claude, и при первом запуске появится приглашение войти». Сменить учётную запись позже помогает команда /login, набранная внутри уже запущенного Claude Code. Дальше работа идёт обычными словами: задачу ставят так же, как объясняли бы её человеку, севшему за ваш проект, а разбираться с файлами будет агент. Весь первый сеанс целиком — вопрос к проекту, режимы разрешений, откат неудачной правки — показан в разборе работы над проектом в Claude Code.
Всё процитированное выше снято с документации Anthropic 15 сентября 2026 года.
Следующий шаг после первого запуска — понять, кому агент отдаёт работу и чем его дополняют. Про субагентов, ответвления разговора и Cowork есть отдельная статья про агентов Claude Code, а про подключение внешних программ со своим адресом — статья про MCP-серверы.
Установкой на свою машину дело не заканчивается там, где код лежит в общем репозитории. Приложение GitHub, секрет с учётными данными и файл рабочего процесса заводят на репозитории отдельно, и после этого агент отзывается прямо в обсуждениях. Чем различаются четыре продукта под общим именем и какими двумя путями их подключают, показано в статье Claude Code и GitHub.
Установка на Windows глазами тех, кто на ней работает
Порядок из документации подтверждается и разбором со стороны. В статье «Ставим Claude Code на Windows как профессионалы» от 14 апреля 2026 года автор под именем wmlab описывает установку на своей рабочей машине — по его словам, в команде из девяти человек один работает на macOS, шестеро на Linux и двое на Windows.
Что делает установщик, он перечисляет в одну строку: «Установщик скачает бинарник, пропишет PATH, настроит автообновление. Node.js и npm не нужны». Одно требование, которого нет в списке систем, он называет отдельно: «Claude Code использует Git Bash для запуска команд в терминале — без него установщик откажет (но обычно git уже установлен)».
Самую частую осечку после установки автор объясняет так: «Если claude не находится — установщик не прописал PATH или консоль не перезапущена». Отсюда и первое, что стоит попробовать при ошибке «команда не найдена»: закрыть терминал и открыть его заново. Условие доступа он повторяет тем же коротким предложением, что и документация: «Бесплатный план Claude не включает Claude Code».
Первый проект и где понадобится картинка
Первым проектом берут свой и небольшой — тот, где результат видно сразу. Удобный пример: попросить агента разобрать проект и привести README в порядок. Первый шаг он делает целиком сам — читает файлы, переписывает описание, раскладывает разделы по порядку.
Второй шаг упирается в картинку. README просит заставку, странице продукта нужен кадр в шапку, карточке товара — изображение. Такие кадры создают отдельные модели, и Claude Code к ним не относится: его работа — читать код и править файлы.
Умение обратиться к такой модели агенту добавляют навыком. У GEN202 это навык: фраза подключения целиком приведена на странице генерации изображений из Claude Code, агент открывает описание навыка и настраивает по нему вызовы GEN202 API. Значение ключа агент читает в переменной окружения GEN202_KEY. Когда значения там нет, первым делом он проводит вас через подключение по той же странице.
После этого кадры делаются в том же разговоре. Агент создаёт изображение по описанию словами, переделывает присланное, подбирает разрешение и форму кадра под место, куда картинка встанет, и отдаёт готовый файл ссылкой сроком на четырнадцать суток. Цена зависит от модели и разрешения: черновой кадр в невысоком разрешении на Nano Banana 2 обходится в 7,2 ₽.
Устройство файла навыка, места хранения и порядок проверки после подключения разобраны в статье про skills для Claude Code. Тот же навык подключают и во второй распространённой оболочке — что у неё общего с Claude Code, показано в статье Claude Code или Codex.
Частые вопросы
Нужна ли платная подписка Anthropic, чтобы установить Claude Code?
Да. Anthropic пишет об этом в разделе про вход: требуется учётная запись Pro, Max, Team, Enterprise или Console, а бесплатный план Claude.ai доступа к Claude Code не даёт. Для самой установки нужно то, что перечислено в требованиях к системе: подходящая операционная система, от 4 ГБ оперативной памяти, процессор x64 или ARM64, доступ в интернет и одна из оболочек Bash, Zsh, PowerShell или CMD. Команды при этом одни и те же для любой машины — curl -fsSL https://claude.ai/install.sh | bash на macOS и Linux, irm https://claude.ai/install.ps1 | iex в PowerShell на Windows. Какие платные планы Anthropic предлагает и что в каждый из них входит, разложено в статье про цену подписки Claude Code.
Работает ли Claude Code на Windows без подсистемы Linux?
Да, для Windows заготовлены отдельные команды. В PowerShell это irm https://claude.ai/install.ps1 | iex, в командной строке — curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd, а через менеджер программ — winget install Anthropic.ClaudeCode. Подсистема Windows для Linux остаётся третьим путём: в ней берут ту же команду, что на macOS и Linux. Требование к системе одно на все три способа — Windows 10 сборки 1809 и новее или Windows Server 2019 и новее.
Нужен ли Node.js, чтобы поставить Claude Code?
В требованиях к системе Node.js не назван, и разбор установки на Windows это подтверждает отдельной фразой: «Node.js и npm не нужны». Версия Node.js 22 или новее нужна только одному способу — установке пакетом npm. На более старой версии npm печатает предупреждение EBADENGINE, но установку не прекращает: она доходит до конца, и команда claude после неё работает, потому что пакет приносит собственный исполняемый файл, которому Node при работе не нужен.
Нужна ли отдельная установка, если стоит расширение Claude Code для VS Code?
Для работы в панели чата — нет: расширение несёт собственную копию командной строки и обходится ею. Отдельная установка нужна для другого — чтобы команда claude находилась во встроенном терминале редактора. После установки одной из команд выше в любом терминале работают и claude mcp add, и claude --resume, а разговор, начатый в панели, продолжается в терминале: история у расширения и командной строки общая. Само расширение требует VS Code версии 1.94.0 или выше и учётной записи Anthropic, а ключ API ему не нужен.
Как обновить Claude Code?
Установка одной командой обновляется сама в фоне, а Homebrew и WinGet Anthropic называет способами без самообновления. Поэтому у них есть своя команда: на macOS это brew upgrade claude-code, на Windows — winget upgrade Anthropic.ClaudeCode. Отсюда и довод в пользу такого способа установки: свежая версия ставится тем же инструментом, которым программа заводилась, и отдельного порядка запоминать не нужно. Какая версия стоит сейчас, показывает уже знакомая команда claude --version, а разбор установки и настроек целиком печатает claude doctor.