Как установить Claude Code на Windows, Mac и Linux
Пошаговая установка Claude Code по официальной документации: команды для Windows, macOS и Linux, первый запуск и вход, первая задача, файл CLAUDE.md через /init и разбор частых ошибок установки.

Как установить Claude Code, если вы ни разу не открывали терминал? Хорошая новость: это одна команда и пара минут. Плохая: в интернете много устаревших инструкций, где ставят через npm, правят пути вручную и копируют команды из чужих блогов. Ниже — только официальные команды из документации Anthropic на ноябрь 2026 года для Windows, Mac и Linux, первый запуск, первая задача, файл CLAUDE.md и ошибки, которые встречаются чаще всего.
Коротко:
- Claude Code ставится одной командой:
curlна Mac и Linux,irmв PowerShell на Windows. Есть Homebrew и WinGet. - Для работы нужен план Pro, Max, Ultra, Team или Enterprise либо аккаунт Console с оплатой по API. В бесплатном плане Claude Code нет.
- После установки:
claude --versionдля проверки,claudeв папке проекта для запуска,/initдля создания CLAUDE.md. - Не хотите терминал — есть десктоп-приложение, в нём Claude Code уже встроен.
- Anthropic официально не обслуживает Россию, поэтому в конце — что делать командам без легального доступа.
Перед установкой: что нужно
По официальным системным требованиям:
- Операционная система: macOS 13.0+, Windows 10 1809+ или Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+.
- Железо: от 4 ГБ оперативной памяти, процессор x64 или ARM64.
- Интернет: нужен постоянно.
- Аккаунт: Pro, Max, Ultra, Team, Enterprise или Console. Бесплатный план claude.ai доступа к Claude Code не даёт.
- Регион: в требованиях прямо указано, что Claude Code работает в странах из списка Anthropic Supported Countries. России в нём нет — об этом подробнее ниже.
Git ставить не обязательно, но на Windows он полезен (объясню в разделе про Windows).
Как установить Claude Code на Mac и Linux
Откройте терминал (на Mac — приложение «Терминал») и вставьте команду:
curl -fsSL https://claude.ai/install.sh | bash
Эта же команда работает внутри WSL на Windows. Установщик ничего не показывает, пока скачивает файлы, это нормально. Когда он закончит, откройте новое окно терминала.
На Mac можно поставить через Homebrew:
brew install --cask claude-code
Разница важная: обычная установка обновляется сама в фоне, а версия из Homebrew — нет. Её нужно обновлять вручную командой brew upgrade claude-code.
Как установить Claude Code на Windows
На Windows есть два пути: запускать Claude Code прямо в Windows или внутри WSL (подсистемы Linux). Если вы не разработчик и не знаете, что такое WSL, выбирайте обычный Windows.
PowerShell (строка начинается с PS C:\):
irm https://claude.ai/install.ps1 | iex
Командная строка CMD (строка начинается с C:\ без PS):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGet:
winget install Anthropic.ClaudeCode
Права администратора не нужны. Версия из WinGet, как и из Homebrew, сама не обновляется: периодически запускайте winget upgrade Anthropic.ClaudeCode.
Про Git. Документация рекомендует поставить Git for Windows: тогда Claude Code использует Git Bash для команд. Без него он работает через PowerShell. Работать будет в обоих случаях.
Самая частая ошибка на Windows — перепутать оболочку. Если видите The token '&&' is not a valid statement separator, вы в PowerShell, а вставили команду для CMD. Если 'irm' is not recognized — наоборот, вы в CMD.
Без терминала: десктоп-приложение
Если терминал пугает, есть официальное десктоп-приложение Claude для macOS и Windows (на Ubuntu и Debian — в бете). Claude Code в него уже встроен, отдельно ставить CLI не нужно: входите в аккаунт и открываете вкладку Code. Для работы нужна платная подписка.
Собственникам и менеджерам я часто советую начинать именно с него: видно изменения в файлах, можно держать несколько сессий рядом и настраивать задачи по расписанию.
Проверка и первый запуск
Проверьте, что всё встало:
claude --version
Должен появиться номер версии. Если терминал пишет, что команда не найдена, смотрите раздел про ошибки ниже. Для подробной диагностики есть claude doctor: она показывает состояние установки и настроек, не запуская сессию.
Теперь перейдите в папку проекта и запустите Claude Code:
cd your-project
claude
Вместо your-project — путь к вашей папке. При первом запуске Claude Code попросит войти: откроется браузер, вы входите в аккаунт Claude и подтверждаете доступ. Если браузер не открылся сам, нажмите c, чтобы скопировать ссылку, и вставьте её в браузер вручную.
Первая задача: с чего начать
Не начинайте с «перепиши весь проект». Хорошая первая задача — та, где агент ничего не ломает, а вы видите, как он думает:
- Попросите объяснить проект. «Расскажи, как устроен этот проект: из чего состоит, как запускается, где что лежит». Агент сам прочитает файлы.
- Попросите план, а не правки. Нажмите Shift+Tab, чтобы переключиться в режим плана: агент изучит код и предложит подход, но не будет менять файлы, пока вы не одобрите.
- Дайте маленькую конкретную задачу. «Добавь на страницу контактов ссылку на Telegram» лучше, чем «улучши сайт». Конкретные задачи — меньше лишних действий и токенов.
- Проверьте результат. Агент спрашивает разрешение перед правками файлов и командами — читайте, что он собирается сделать.
Если агент пошёл не туда, нажмите Escape: он остановится. Команда /rewind возвращает разговор и код к предыдущей точке.
CLAUDE.md и команда /init
CLAUDE.md — файл с правилами проекта, который Claude Code читает в начале каждой сессии. Без него агент каждый раз изучает проект заново и не знает ваших договорённостей.
Создать первую версию просто — наберите в сессии:
/init
Claude проанализирует проект и создаст CLAUDE.md с командами сборки, инструкциями по тестам и найденными соглашениями. Если файл уже есть, /init предложит улучшения, а не перезапишет его.
Дальше допишите то, чего агент сам не узнает: что нельзя трогать, как у вас принято называть файлы, кто принимает изменения. Документация советует держать файл до 200 строк: длинный файл съедает контекст и хуже соблюдается. Как превратить CLAUDE.md, правила и хуки в полноценное окружение для команды, разберу в отдельной статье про harness.
Частые проблемы при установке
Только то, что описано в официальной документации по устранению неполадок.
| Что видите | Что это значит и что делать |
|---|---|
command not found: claude или 'claude' is not recognized | Папка установки не добавлена в PATH. Установщик кладёт программу в ~/.local/bin (Mac и Linux) или %USERPROFILE%\.local\bin (Windows) и подсказывает исправление в своём выводе. Добавьте папку в PATH и откройте новый терминал |
syntax error near unexpected token '<', curl: (22) ... 403 | Вместо скрипта пришла веб-страница. Если в тексте ошибки есть «App unavailable in region», Claude Code недоступен в вашей стране. Иначе причина — сеть, корпоративный прокси или временный сбой |
Killed при установке на Linux | Не хватило памяти. Для установки нужно около 512 МБ свободной памяти; на маленьких серверах помогает swap |
The token '&&' is not a valid statement separator | Вы в PowerShell, а команда для CMD. Возьмите команду с irm |
OAuth error: Invalid code | Код входа истёк или скопировался не целиком. Повторите вход быстрее или скопируйте ссылку клавишей c |
API Error: 403 Request not allowed после входа | Проверьте, что подписка активна. Для аккаунтов Console нужна роль «Claude Code» или «Developer» |
| Вход не проходит, причина неясна | /logout, закрыть Claude Code, снова claude и войти заново |
Для macOS с оболочкой Zsh PATH добавляется так (команда из документации):
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Обновить Claude Code вручную можно командой claude update. Обычная установка делает это сама в фоне.
Если у вас нет доступа к Claude Code
Честно: Anthropic официально не обслуживает Россию — ни приложения, ни API, ни компании, которые базируются в России. Ошибка «App unavailable in region» из таблицы выше — как раз об этом. Обходы я не советую: процесс, который зависит от нестабильного доступа, однажды встанет.
Для команд без легального доступа тот же подход переносится на другие агенты, у которых официальная установка такая же простая:
- OpenCode — открытый агент с поддержкой многих провайдеров:
curl -fsSL https://opencode.ai/v2/install | bash. Подробно — в статье про OpenCode. - Kimi Code от Moonshot AI:
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bashна Mac и Linux,irm https://code.kimi.com/kimi-code/install.ps1 | iexв PowerShell. Про возможности Kimi — в статье Kimi для бизнеса. - DeepSeek Harness — открытый агент от DeepSeek в статусе preview, разбор в отдельной статье.
Важно: у DeepSeek, Kimi и OpenCode нет официальных списков поддерживаемых стран, поэтому доступность из России я не обещаю. Предсказуемые пути и легальные варианты — в статье Когда режут VPN: на чём работать с ИИ-агентами в России.
Установили — что дальше
Установка — 5% дела. Дальше начинается то, от чего зависит, будет ли Claude Code работать на бизнес: правила проекта, доступы к нужным сервисам, готовые сценарии для повторяющихся задач и привычка команды ставить задачи агенту, а не делать руками. Что вообще умеет Claude Code и чем он отличается от чата, я разбирал в статье Что такое Claude Code.
Частые вопросы
Нужен ли npm или Node.js, чтобы установить Claude Code?
Нет. Рекомендуемая установка — одной командой curl или irm, без Node.js. Установка через npm тоже есть, но она не основная.
Как установить Claude Code на Windows без WSL?
Запустите в PowerShell команду irm https://claude.ai/install.ps1 | iex. WSL не нужен, Git for Windows желателен, но не обязателен.
Можно ли пользоваться Claude Code бесплатно? Нет. Нужен план Pro, Max, Ultra, Team или Enterprise либо аккаунт Console с оплатой по токенам.
Как обновить Claude Code?
Обычная установка обновляется сама. Вручную — claude update. Для Homebrew — brew upgrade claude-code, для WinGet — winget upgrade Anthropic.ClaudeCode.
Что делать, если пишет «App unavailable in region»? Это значит, что Claude Code недоступен в вашей стране. Посмотрите легальные альтернативы: OpenCode, Kimi Code, DeepSeek Harness и модели через российские облака.
Не хотите разбираться с установкой и настройкой сами? Я ставлю Claude Code или альтернативу в компании, настраиваю правила и доступы и учу команду работать на её задачах. Напишите в Telegram, что хотите автоматизировать, — обсудим на 30-минутном созвоне.
Похожие статьи: Что такое Claude Code и чем он отличается от Claude · OpenCode: открытая альтернатива Claude Code