Как установить Claude Code: гайд 2026 для Windows, macOS и Linux

Что такое Claude Code

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

Если сравнивать с тем, что многие уже знают: GitHub Copilot видит открытый файл и несколько соседних, предлагает автодополнение построчно. Claude Code видит весь репозиторий целиком, получает задачу на естественном языке и сам решает, какие файлы открыть, что в них поменять и как проверить результат. Разница примерно такая же, как между подсказкой и полноценным выполнением работы. Подробнее о возможностях инструмента – в карточке Claude Code на нашем сайте.

Помимо терминального CLI, у Claude Code есть Desktop-приложение для macOS, Windows и Linux, расширения для VS Code и продуктов JetBrains, а также веб-версия внутри claude.com. Это важно: если терминал вам непривычен, можно начать с графического интерфейса и не трогать командную строку вообще.

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

Три вещи, которые нужно закрыть до запуска команд установки: система, подписка и, если вы в России, способ оплаты.

Системные требования

Планка по железу низкая. На macOS нужна версия 13.0 и выше. На Windows – версия 10 сборки 1809 или Windows Server 2019 и новее. Из Linux-дистрибутивов поддерживаются Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+. По железу минимальная планка – 4 ГБ оперативной памяти, процессор x64 или ARM64.

Из оболочек работают Bash, Zsh, PowerShell и CMD. Постоянное интернет-соединение обязательно: Claude Code не работает локально, все запросы уходят на серверы Anthropic. Утилита ripgrep, которая нужна для поиска по файлам, включена в поставку нативного установщика – отдельно её ставить не нужно.

Подписка или API-ключ

Claude Code не входит в бесплатный план – это первое, на что спотыкаются при первой попытке запуска. Нужна одна из платных подписок: Pro от $20 в месяц (или от $17 при годовой оплате) или Max, который стоит $100 или $200 в месяц в зависимости от лимитов. Claude Code включён в эти тарифы без доплаты, отдельно покупать его не нужно.

Альтернатива подписке – API-ключ Anthropic через Console. В этом случае вы платите за токены по факту использования, без фиксированной месячной суммы. Этот вариант удобен, если планируете использовать инструмент нерегулярно. Один нюанс: лимиты у Claude Code и веб-чата Claude общие – они делят одну квоту, которая обновляется каждые 5 часов. Посмотреть остаток можно командой /usage прямо внутри сессии. На тарифе Max лимиты значительно выше, чем на Pro.

Доступ из России

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

Если зарубежной карты нет, на нашем сайте есть отдельная страница с разобранными способами оплаты – Оплата зарубежных сервисов. Там собраны актуальные варианты для пользователей из России без лишних деталей.

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

Windows долгое время была самой неудобной платформой для Claude Code – инструмент требовал WSL и работал через прослойку. Теперь нативная установка идёт напрямую в PowerShell или CMD, WSL стал опциональным, и большинству пользователей он не понадобится.

PowerShell или CMD: в чём разница

Перед тем как копировать команды установки, нужно понять, в каком терминале вы находитесь. Это не мелочь: команды для PowerShell и CMD не взаимозаменяемы, и если перепутать – получите ошибку, которая выглядит как поломка, хотя на деле это просто несовпадение синтаксиса.

Определить просто: если строка приглашения начинается с PS C:\ – вы в PowerShell. Если просто C:\ без PS – это CMD. Самый частый признак путаницы – ошибка The token '&&' is not a valid statement separator: она появляется, когда CMD-команду запускают в PowerShell. В обратную сторону тоже работает: если в CMD написать irm, получите 'irm' is not recognized as an internal or external command, потому что irm – это псевдоним PowerShell-командлета Invoke-RestMethod, которого в CMD нет.

Команды установки

Для PowerShell команда установки выглядит так:

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

Права администратора не нужны. Установщик скачает бинарник, положит его в C:\Users\ВашеИмя\.local\bin и пропишет путь в переменную окружения PATH. Автоматические обновления включены по умолчанию – следить за новыми версиями вручную не придётся.

Если вы работаете в CMD, команда другая:

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

Есть и третий вариант – через пакетный менеджер WinGet:

winget install Anthropic.ClaudeCode

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

Если у вас уже стоит Node.js 18 или новее и вы привыкли к npm, установка через него тоже работает:

npm install -g @anthropic-ai/claude-code

Нативный установщик предпочтительнее: он не зависит от Node.js, обновляется сам и не создаёт проблем с правами на файлы. npm-вариант имеет смысл, если Node.js уже есть в окружении и вы хотите держать всё в одном месте.

После установки закройте терминал и откройте новый – это обязательный шаг. Пока терминал не перезапущен, обновлённый PATH не подхватится, и команда claude будет выдавать ошибку «не найдена». Это не поломка, просто особенность работы с переменными окружения в Windows.

Отдельный вопрос – Git for Windows. Без него Claude Code на Windows будет использовать PowerShell как инструмент выполнения команд. С установленным Git for Windows появляется Bash-инструмент, что удобнее для большинства проектов. Установить Git можно с git-scm.com, все настройки по умолчанию подходят. Если Git стоит, но Claude Code его не находит, путь к bash.exe можно прописать вручную в файле %USERPROFILE%\.claude\settings.json:

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

WSL остаётся актуальным вариантом, если вы работаете с Linux-проектами, Docker-контейнерами или вам нужна изолированная среда выполнения команд. Внутри WSL установка идёт по той же схеме, что и на Linux, – командой curl. Важный момент: держите проект в файловой системе Linux (/home/username/projects/), а не на смонтированном Windows-диске (/mnt/c/), иначе скорость работы с файлами заметно упадёт.

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

На macOS и Linux установка проще, чем на Windows, – меньше нюансов с оболочками и переменными окружения. Рекомендованный способ – нативный установщик, одна команда в терминале:

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

Команда скачает и установит бинарник, пропишет путь в конфигурационный файл вашей оболочки (.bashrc, .zshrc или аналог) и включит автообновления. После завершения установки перезапустите терминал или выполните source ~/.bashrc (или source ~/.zshrc, если используете Zsh), чтобы PATH подхватился в текущей сессии.

Если вы на macOS и используете Homebrew, есть альтернативный вариант:

brew install --cask claude-code

Homebrew предлагает два канала: claude-code – стабильный, обновляется с задержкой около недели и пропускает релизы с серьёзными регрессиями; claude-code@latest – получает новые версии сразу после выхода. Homebrew-установки не обновляются автоматически, нужно запускать brew upgrade claude-code вручную. Если хочется всегда иметь свежую версию без ручного обновления, нативный установщик удобнее.

Для установки через npm (при наличии Node.js 18+) команда одинакова для всех платформ:

npm install -g @anthropic-ai/claude-code

Не запускайте эту команду с sudo – установка под рутом создаёт проблемы с правами на файлы, и потом инструмент не сможет корректно обновляться. Если npm требует прав суперпользователя для глобальной установки пакетов, это сигнал настроить директорию для глобальных пакетов в домашней папке пользователя.

На Alpine Linux и других дистрибутивах на основе musl нативный установщик требует дополнительных пакетов. Перед запуском команды установки нужно поставить libgcc, libstdc++ и ripgrep через apk, а затем добавить в settings.json параметр "USE_BUILTIN_RIPGREP": "0". На Ubuntu, Debian и стандартных сборках Linux ничего дополнительного не нужно.

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

claude --version

Вторая запускает диагностику – проверяет PATH, авторизацию, состояние Git и подключённые интеграции:

claude doctor

Если claude --version возвращает ошибку command not found, значит PATH не обновился. Перезапустите терминал или вручную добавьте ~/.local/bin в PATH текущей сессии командой export PATH="$HOME/.local/bin:$PATH".

Если терминал – не ваше: Desktop и IDE

Командная строка нужна не всем. У Claude Code есть несколько способов работы без терминала, причём полноценных – с теми же возможностями агента.

Desktop-приложение доступно для macOS, Windows и Linux. Скачать его можно с claude.com/download – отдельный установочный файл для каждой платформы. Приложение даёт графический интерфейс с поддержкой параллельных сессий, Git worktrees и возможностью переключаться между проектами без ручного перехода по директориям в терминале. Первый запуск открывает браузер для авторизации через аккаунт Claude – тот же процесс, что и в CLI.

Для тех, кто работает в VS Code, есть официальное расширение «Claude Code» от Anthropic – ставится из маркетплейса за пару кликов. Расширение добавляет панель агента прямо в редактор: можно выделить фрагмент кода, задать вопрос или поставить задачу, не переключаясь между окнами. Расширение работает также в Cursor и Windsurf. Для продуктов JetBrains – IntelliJ IDEA, PyCharm, WebStorm и других – есть отдельный плагин, который устанавливается через встроенный маркетплейс IDE.

Веб-версия Claude Code доступна прямо на claude.com в разделе Products → Code. Это самый быстрый способ попробовать инструмент без какой-либо установки: открываете браузер, переходите в раздел, указываете задачу. Ограничение веб-версии в том, что у неё нет прямого доступа к локальным файлам – для работы с реальным проектом на вашем компьютере всё равно понадобится либо CLI, либо Desktop-приложение.

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

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

Когда установка завершена и терминал перезапущен, дальнейший процесс одинаков на всех платформах. Переходите в папку с проектом, над которым собираетесь работать, и запускаете одну команду:

claude

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

При первом запуске Claude Code откроет браузер и попросит авторизоваться через аккаунт claude.ai. Это происходит один раз – токен сохраняется локально, и в следующий раз входить заново не придётся. Если браузер не открылся автоматически (такое бывает при работе по SSH или в некоторых конфигурациях WSL), введите в терминале /login – агент выведет ссылку, которую можно скопировать и открыть вручную.

После авторизации вы сразу попадаете в интерактивную сессию. Никаких дополнительных настроек для старта не нужно – можно сразу писать задачу обычным текстом. Если хотите убедиться, что аккаунт подключён корректно и лимиты доступны, введите /usage: увидите текущий остаток токенов и время до обновления квоты.

Файл CLAUDE.md

Команда /init создаёт в корне проекта файл CLAUDE.md – это памятка для агента, которую он читает при каждом запуске сессии в этой папке. Туда записывают всё, что важно знать о проекте: стек и версии зависимостей, команды для сборки и запуска тестов, соглашения по именованию, ограничения вроде «не трогай папку legacy» или «используй pnpm, не npm».

Без CLAUDE.md каждая новая сессия начинается с нуля: агент тратит токены на изучение структуры репозитория, которую он уже изучал в прошлый раз. С файлом этот процесс пропускается – Claude Code сразу знает контекст проекта и приступает к задаче. На практике это экономит и токены, и время: особенно заметно на больших кодовых базах, где автоматическое сканирование занимает несколько минут. Отредактировать CLAUDE.md в любой момент можно командой /memory.

Базовые команды

Внутри сессии Claude Code управляется слэш-командами. Их около двух десятков, но для ежедневной работы достаточно небольшого набора. Вот основные:

Команда	Что делает
/help	Показывает список всех доступных команд
/usage	Текущий остаток токенов и время до обновления лимита
/model	Показывает активную модель, позволяет переключиться на другую
/init	Создаёт файл CLAUDE.md в корне проекта
/memory	Открывает CLAUDE.md для редактирования
/clear	Очищает историю текущего разговора
/compact	Сжимает контекст, экономит токены в длинных сессиях
/status	Показывает активный метод аутентификации
/exit	Завершает сессию

Переключение между моделями через /model работает прямо внутри сессии: можно начать задачу на Fable 5, а если нужно сэкономить токены – переключиться на Sonnet 5 или Haiku 4.5 без перезапуска.

Ещё есть Shift+Tab – не слэш-команда, а сочетание клавиш для переключения режимов работы. По умолчанию агент сразу приступает к выполнению задачи. После нажатия Shift+Tab включается режим планирования: Claude Code сначала описывает, что именно собирается сделать и какие файлы затронет, и ждёт вашего подтверждения. Это полезно для крупных задач, где лучше сначала убедиться в правильности подхода, прежде чем агент начнёт вносить изменения.

Задачи ставятся обычным текстом – никакого специального синтаксиса не нужно. Чем конкретнее описание, тем точнее результат: вместо «сделай рефакторинг» лучше написать «вынеси логику валидации из UserController в отдельный класс UserValidator, сохрани существующие тесты рабочими». Агент сам разберётся, какие файлы открыть и что в них изменить.

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

Нативный установщик обновляет Claude Code автоматически в фоновом режиме – при каждом запуске проверяется наличие новой версии, и если она есть, загружается и устанавливается незаметно. Обновление вступает в силу при следующем запуске агента. Принудительно запустить обновление можно командой:

claude update

Посмотреть текущую версию:

claude --version

Если хотите получать обновления сразу после выхода, а не через неделю по стабильному каналу, переключитесь на канал latest в настройках. Если, наоборот, нужно зафиксировать конкретную версию и отключить автообновления – это тоже настраивается. Для установок через Homebrew и WinGet автообновлений нет по умолчанию: Homebrew обновляется командой brew upgrade claude-code, WinGet – командой winget upgrade Anthropic.ClaudeCode.

Для удаления нативной установки на macOS и Linux достаточно убрать бинарник из ~/.local/bin/ и директорию ~/.local/share/claude/. На Windows нативный установщик добавляет запись в список программ, откуда его можно удалить стандартным способом через «Параметры» → «Приложения». Если устанавливали через npm, удаление одной командой:

npm uninstall -g @anthropic-ai/claude-code

После удаления стоит вручную проверить, что строка с путём к Claude Code убрана из переменной PATH – особенно на Windows, где %USERPROFILE%\.local\bin мог остаться в пользовательских переменных окружения.

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

Большинство проблем при установке Claude Code решаются за несколько минут, если понимать, что именно пошло не так. Ниже – четыре ситуации, с которыми сталкиваются чаще всего.

npm или Node.js не найден

Если при попытке установить через npm терминал выдаёт npm: command not found или node: command not found, значит Node.js на машине не стоит или стоит версия ниже 18. Проверить версию: node --version. Если команда не работает вообще – Node.js нет.

Решение: скачать Node.js 18 или новее с nodejs.org и установить. После установки перезапустить терминал и повторить команду npm. Если не хочется возиться с Node.js – используйте нативный установщик, он не требует никаких предварительных зависимостей.

Команда claude не находится после установки

Установка завершилась без ошибок, но при вводе claude терминал отвечает command not found или 'claude' is not recognized. Причина почти всегда одна: PATH не обновился в текущей сессии терминала.

Первый шаг – закрыть терминал и открыть новый. В большинстве случаев этого достаточно. Если не помогло, проверьте, что путь к бинарнику вообще прописан: на macOS и Linux выполните echo $PATH и убедитесь, что там есть ~/.local/bin. Если строки нет, добавьте её вручную в ~/.bashrc или ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

На Windows нативный установщик прописывает путь %USERPROFILE%\.local\bin в пользовательские переменные окружения. Если команда всё равно не находится, откройте «Параметры» → «Система» → «Дополнительные параметры системы» → «Переменные среды» и убедитесь, что эта строка есть в разделе пользовательских переменных Path.

PowerShell vs CMD на Windows

Эту ошибку уже упоминали в разделе установки, но она встречается так часто, что стоит повторить отдельно. Если в PowerShell запускаете CMD-команду с && – получаете The token '&&' is not a valid statement separator. Если в CMD пишете irm – получаете 'irm' is not recognized.

Правило простое: команда с irm идёт в PowerShell, команда с curl ... && install.cmd && del install.cmd – в CMD. Строка приглашения PS C:\ означает PowerShell, C:\ без PS – CMD. Если не уверены, какой терминал открыт, проще всего закрыть его и открыть PowerShell явно через меню «Пуск».

Проблемы с путём Git Bash на Windows

Claude Code на нативном Windows использует Git Bash для выполнения команд, если Git for Windows установлен. Иногда установщик не может найти bash.exe автоматически – особенно если Git установлен не в стандартную директорию C:\Program Files\Git\. В таком случае агент либо выдаёт ошибку при попытке выполнить команду, либо молча переключается на PowerShell-инструмент.

Исправляется вручную: найдите, куда установлен Git (обычно это C:\Program Files\Git\bin\bash.exe), и пропишите путь в файле настроек %USERPROFILE%\.claude\settings.json. Если файла нет – создайте его:

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

После сохранения файла перезапустите сессию Claude Code. Команда claude doctor покажет, подхватился ли Git Bash корректно.

Вопросы и ответы

Можно ли пользоваться Claude Code бесплатно?

Нет. В бесплатный план Claude.ai агент не входит, пробного периода тоже нет: при входе с бесплатным аккаунтом Claude Code сообщит, что текущий тариф его не включает.

Минимальный вариант для доступа – подписка Pro от $20 в месяц. Альтернатива – API-ключ через Anthropic Console с оплатой за токены, без фиксированной месячной суммы. Подробнее об обоих вариантах – в разделе «Подписка или API-ключ» выше.

Работает ли Claude Code из России?

Россия не входит в список поддерживаемых Anthropic стран, поэтому оплатить подписку российской картой не получится. Для регистрации и оплаты нужна зарубежная карта. Если её нет, актуальные варианты собраны на странице Оплата зарубежных сервисов.

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

Какая модель работает внутри Claude Code?

По умолчанию используется Fable 5 – флагманская модель Anthropic. Внутри сессии доступны также Opus 5, Sonnet 5 и Haiku 4.5. Переключиться между ними можно командой /model прямо во время работы, без перезапуска сессии. Haiku 4.5 расходует меньше токенов, что удобно для простых задач вроде объяснения кода или небольших правок. Fable 5 и Opus 5 лучше справляются с архитектурными решениями и задачами, где важен широкий контекст проекта.

Чем Claude Code отличается от Cursor?

Cursor – это редактор кода, построенный поверх VS Code, с интегрированным ИИ-ассистентом. Claude Code – это агент, который работает поверх терминала или существующего редактора и не привязан к конкретной IDE. Cursor хорошо работает как замена VS Code для тех, кто хочет ИИ прямо в редакторе. Claude Code удобнее, когда нужно работать с несколькими проектами одновременно, запускать команды в терминале, делать коммиты или автоматизировать задачи, которые выходят за пределы редактирования файлов. Оба инструмента можно использовать параллельно: расширение Claude Code устанавливается в тот же VS Code или Cursor, на котором вы уже работаете. Подробное сравнение с другими инструментами для кодинга с ИИ – в отдельном разделе сайта.

⚠️

Instagram*, Facebook*, Meta* и другие сервисы компании Meta Platforms Inc. запрещены на территории Российской Федерации.

* Meta Platforms Inc. признана экстремистской организацией и запрещена на территории РФ.

Смотрите также

• 
  Инструменты разработчика· 27.08.2026

  Claude + Obsidian: как собрать второй мозг на своих заметках

• 
  Инструменты разработчика· 24.08.2026

  MCP в Claude Code: как подключить серверы и зачем нужны агенты

• 
  Новости· 21.08.2026

  Водяной знак Claude в тексте: что он на самом деле доказывает

• 
  Инструменты разработчика· 20.08.2026

  Что такое MCP (Model Context Protocol): открытый протокол для подключения ИИ к внешнему миру

• 
  Инструменты разработчика· 17.08.2026

  Claude Skills: что это, как работают и как создать свой навык

• 
  Инструменты разработчика· 16.08.2026

  Optima: собственный бенчмарк для моделей на своих же данных

• 
  Инструменты разработчика· 13.08.2026

  Claude Code vs Cursor vs Codex: сравнение и что выбрать в 2026

• 
  Инструменты разработчика· 11.08.2026

  YOLO-режим в Codex: как отключить подтверждения и не потерять при этом проект

• 
  ИИ-агент· 08.08.2026

  ИИ-браузеры в 2026 году: сравнение Comet, Dia, Aside и ego lite – и почему закрылся ChatGPT Atlas