Как установить Claude Code

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

Коротко: Claude Code ставится одной командой официального установщика, у каждой системы она своя. Потом перезапусти терминал, проверь claude --version и войди командой claude через браузер. Понадобится платная подписка Claude или аккаунт Console, бесплатный план доступа к агенту не даёт.

Как установить Claude Code: вставить в терминал команду установщика для своей системы, открыть терминал заново и войти командой claude.

Клауд код, клод код и Claude Code в поисковой строке - одна программа, Claude Code от Anthropic.

Версию и список команд я прогнал на своём Mac: claude --version там отвечает 2.1.278 (Claude Code). Остальное сверено с документацией Anthropic в день публикации, 21 сентября 2026 года, а разделы про Windows и Linux написаны по ней, без проверки руками.

Установкой дело не кончается: под твои задачи агента подстраивают правила проекта и готовые скиллы. Мои лежат в ClaudeBase в готовом виде.

Где ты сейчас

Коротко: у четырёх типичных ситуаций разный первый шаг. Кто не открывал терминал, начинает с разбора терминала или с приложения. На Windows хватит короткого раздела здесь, подробности вынесены отдельно. Из России сначала решается вопрос страны и сети. Если агент уже стоит, но не запускается, иди сразу к ошибкам.

• Окно команд ни разу не открывал. Сначала разбор терминала: как его открыть и перейти в папку проекта. Либо поставь приложение, раздел про него ниже.
• У тебя Windows. Команды есть здесь, а WSL, PATH и ошибки PowerShell разобраны отдельно.
• Ты в России. Что упирается в страну и сеть, разобрано в статье про Россию, а подписку из России оплачивают зарубежной картой. Что делать сразу после оплаты - в статье оплатил Claude: что дальше.
• Уже ставил, но не работает. Открой раздел «Частые ошибки установки и входа»: заголовки там совпадают с текстом, который печатает терминал.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить карту

Реклама. ООО «КАПИБАРА», ИНН 9703231520. erid: 2W5zFGnh2G9

Какие система и аккаунт подойдут?

Коротко: подходящая система, 4 ГБ памяти, интернет и платный аккаунт. Подходят macOS с 13-й версии, Windows 10 с обновления 1809 и свежие Linux. Node.js для основного пути не нужен. Отдельное условие - страна: агент работает только там, где Anthropic предоставляет свои сервисы.

Требования по документации Anthropic:

Отдельно про аккаунт. Claude Code требует подписку Pro, Max, Team или Enterprise либо аккаунт Claude Console. Бесплатный план claude.ai доступа не даёт: поставить программу можно, а работать в ней с таким аккаунтом нельзя. Во сколько это обходится и как растягивать запас, разобрано в статьях про лимиты и про то, можно ли пользоваться им бесплатно.

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

Какой способ установки выбрать?

Коротко: бери официальный установщик. Он обновляет программу сам (npm тоже, если его папка пакетов доступна на запись), а Homebrew, WinGet и пакетные менеджеры Linux по умолчанию требуют обновлять вручную. Программа во всех случаях одна и та же. Главное правило - один способ на компьютер: две установки дают две команды claude, и дальше непонятно, какая из них запускается.

Статус способов на 21 сентября 2026 года:

У Homebrew два варианта пакета. claude-code идёт по стабильному каналу: документация пишет, что он обычно отстаёт примерно на неделю и пропускает выпуски с крупными поломками. claude-code@latest получает новые версии сразу. В день проверки стабильный канал раздавал 2.1.267, свежий 2.1.278.

Про npm в инструкциях пишут противоположное: одни требуют Node.js 18, другие зовут способ устаревшим. По документации он работает, с версии 2.1.198 пакету нужен Node.js 22 или новее, а ставит он ту же программу. sudo с ним документация запрещает: ломаются права на файлы.

Как поставить Claude Code на Mac и Linux?

Коротко: открой Терминал и вставь одну строку официального установщика, на Linux она та же самая. Скрипт скачает программу, положит её в домашнюю папку и настроит обновления. Если все программы у тебя идут через Homebrew или пакеты Linux, как установить Claude Code этим путём, показано тут же.

Команда для macOS, Linux и WSL:

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

Скрипт скачивается с сайта Anthropic и сразу выполняется, без sudo: запись нужна только в папки ~/.local/bin и ~/.claude в домашнем каталоге. На моём Mac команда ~/.local/bin/claude - ссылка на файл 2.1.278 в папке ~/.local/share/claude/versions/, туда же ложатся новые версии.

Через Homebrew:

brew install --cask claude-code

Самую свежую версию даёт пакет claude-code@latest.

Для Linux есть подписанные репозитории apt, dnf и apk: команды с проверкой ключа подписи безопаснее копировать прямо из документации Anthropic. На Alpine установщику нужны заранее поставленные bash и curl.

Установка на маленьком облачном сервере может оборваться словом Killed: ей нужно около 512 МБ свободной памяти.

А если у тебя Windows?

Коротко: ниже три команды: для PowerShell, для CMD и через WinGet, ни одной из них права администратора не нужны. Всё остальное про эту систему, от Git и WSL до PATH, вынесено в отдельную статью.

PowerShell:

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

CMD:

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

WinGet:

winget install Anthropic.ClaudeCode

Git и WSL для старта не обязательны. Когда они всё же нужны и как чинить PATH, разобрано в соседней инструкции.

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

Коротко: хватит двух команд. Первая, claude --version, печатает номер версии и отвечает на вопрос «встал ли агент». Вторая, claude doctor, без запуска сессии показывает состояние установки и файлов настроек. Если версия печатается, а поведение странное, проверь, нет ли на компьютере второй установки, оставшейся от другого способа.

Сначала открой новое окно терминала: в старом PATH ещё прежний, и новой команды там нет. Потом:

claude --version

Рабочая установка отвечает номером версии и пометкой в скобках. На моём Mac 21 сентября это выглядело так:

2.1.278 (Claude Code)

Вторая проверка подробнее:

claude doctor

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

Последнее - лишние копии. Ставил когда-то через npm, а теперь через установщик - в системе может оказаться два claude. Все копии показывает which -a claude на Mac и Linux и where.exe claude на Windows, документация советует оставить одну, нативную. Путаницу из двух установок хорошо видно по обращению 3172: команда пропадала после npm-установки на Mac с Homebrew, обращение открыто с июля 2025 года.

Как войти: подписка или ключ?

Коротко: запусти claude, откроется браузер, войди в аккаунт Claude, и терминал напишет Login successful. Так входят с подпиской Pro, Max, Team или Enterprise. Второй вариант - аккаунт Console с оплатой за расход. Ключ API в переменной окружения перебивает подписку, об этом стоит знать до первого входа.

Перейди в папку проекта и запусти агента:

cd путь/к/папке/проекта
claude

При первом запуске агент сам откроет страницу входа в браузере. После входа терминал пишет Login successful и просит нажать Enter. Данные входа сохраняются (на Mac в Связке ключей), второй раз входить не придётся.

Какие аккаунты подходят:

Вход через Console можно выбрать и из терминала: команда claude auth login --console. Где взять ключ и чем он отличается от подписки, разобрано в статье про Claude Code API.

Теперь ловушка. Если задана переменная ANTHROPIC_API_KEY, агент при запуске предложит взять ключ вместо входа через браузер. Согласишься - запросы пойдут по ключу, даже при оплаченной подписке.

Справка Anthropic предупреждает: расход тогда списывается по тарифам API, в лимиты подписки он не идёт. Какой способ входа сейчас действует, показывает команда /status внутри сессии.

Если браузер не открылся сам, нажми c: ссылка для входа скопируется. В WSL, по SSH и в контейнерах браузер часто не может вернуть ответ в терминал и показывает код, его вставляют в строку Paste code here if prompted.

Вход и первые настройки разобраны и в курсе ClaudeBase. Урок «Четыре способа работать с Claude: сайт, приложение, терминал, VS Code» показывает, где кончается чат и начинается агент. Материал «Аккаунт Claude из России, оплата и установка» ведёт от живого аккаунта и оплаты подписки до VS Code с агентом.

Можно ли обойтись без терминала?

Коротко: да, у Claude есть настольное приложение для всех трёх систем, версия для Linux пока в бете. Агент работает в нём во вкладке Code, Node.js и консольная версия не нужны. Подписка нужна та же. Команду claude в терминале приложение не добавляет, так что для работы в терминале её ставят отдельно.

В приложении три вкладки: Chat, Cowork и Code, с файлами проекта работает Code. Просит повысить тариф при нажатии - нужна платная подписка. Сборка для Mac одна на Intel и Apple Silicon, для Windows есть установщики под x64 и ARM64, на Ubuntu и Debian приложение ставится через apt или пакетом .deb.

Путают две вещи. Внутри расширения для VS Code лежит своя копия агента, в PATH она не попадает, поэтому с одним расширением команда claude в терминале не найдётся. Работа прямо в редакторе разобрана в статье про VS Code. А старая версия приложения Claude на Windows могла перехватывать команду claude и открывать себя, это лечится обновлением приложения.

Как обновить Claude Code?

Коротко: если ставил официальным установщиком, программа обновляется сама: проверяет новые версии при запуске и во время работы, а новая включается при следующем старте. Чтобы не ждать, есть команда claude update. Homebrew, WinGet и пакетные менеджеры Linux по умолчанию обновляются только вручную, у каждого своя команда.

Обновить сразу:

claude update

Когда вышла версия новее, команда пишет Successfully updated from <old version> to version <new version>, а при уже свежей - Claude Code is up to date (<version>).

Каналов два. latest стоит по умолчанию и получает всё сразу, stable раздаёт версию примерно недельной давности без выпусков с крупными поломками. Переключается в /config, пункт Auto-update channel. Если свежие функции не горят, стабильный канал спокойнее.

Команды для остальных способов:

brew upgrade claude-code
winget upgrade Anthropic.ClaudeCode
npm install -g @anthropic-ai/claude-code@latest

Для npm документация предупреждает: npm update -g может оставить старую версию. Homebrew хранит прошлые версии на диске, место освобождает brew cleanup.

Как удалить Claude Code полностью?

Коротко: удаление зависит от способа установки, у каждого своя команда. Настройки и история сессий лежат отдельно, в папке .claude домашнего каталога и в файле .claude.json рядом с ней. Их удаляют последним шагом и только если нужен чистый лист: вместе с ними пропадают разрешения, подключения MCP и история.

Официальный установщик на Mac, Linux и в WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

В PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Другие способы:

brew uninstall --cask claude-code
winget uninstall Anthropic.ClaudeCode
npm uninstall -g @anthropic-ai/claude-code

Настройки и историю на Mac и Linux стирают две строки, это последний шаг:

rm -rf ~/.claude
rm ~/.claude.json

rm -rf удаляет без корзины: копируй строки целиком и ничего в них не меняй. Расширение VS Code, плагин JetBrains и приложение Claude тоже пишут в папку .claude, пока они стоят, она появится снова, так что сначала удали их.

Частые ошибки установки и входа

Коротко: шесть сообщений закрывают большую часть случаев, заголовки ниже совпадают с тем, что печатает терминал. Почти все они про три вещи: папка с программой не попала в PATH, команда скопирована не для той оболочки, сеть или страна не пропускают запросы к серверам Anthropic.

zsh: command not found: claude

Так отвечает терминал Mac. На Linux та же беда выглядит как bash: claude: command not found, в CMD - как 'claude' is not recognized as an internal or external command. Установка прошла, но папка ~/.local/bin не попала в PATH, то есть в список мест, где терминал ищет программы.

Сначала закрой окно и открой новое. Не помогло - проверь и допиши путь (для Linux замени ~/.zshrc на ~/.bashrc):

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Если первая строка ничего не напечатала, папки в PATH нет, и две следующие её добавят. У PowerShell команды свои, их разбирает соседняя статья.

syntax error near unexpected token ‘<’

Вместо скрипта пришла веб-страница, и Bash пытается выполнить HTML. Такой случай на Mac с процессором M1 описан в обращении 17813. Надпись App unavailable in region на странице означает страну, голый ответ 403 бывает и из-за страны, и из-за прокси. Документация советует проверить связь с downloads.claude.ai, а при временном сбое повторить команду через несколько минут.

‘irm’ is not recognized as an internal or external command

Команда для PowerShell запущена в CMD. Обратная ситуация даёт The token '&&' is not a valid statement separator: строка для CMD вставлена в PowerShell. Посмотри на начало строки ввода (PS C:\ означает PowerShell) и возьми команду для своего окна.

Unable to connect to Anthropic services

При первом запуске программа проверяет связь с api.anthropic.com и platform.claude.com и без неё до входа не доходит. Причина - сеть, прокси или страна. Если в сообщении упомянута переменная HTTPS_PROXY, проверь адрес прокси. Для России порядок действий разобран в статье про Россию.

Not logged in · Please run /login

Для этой сессии нет действующего входа. Выполни /login внутри сессии. Если вставка кода в строку входа не срабатывает, есть запасной путь из терминала: команда claude auth login читает вставленный код напрямую.

This organization has been disabled

Подписка оплачена, а агент выдаёт ошибку про отключённую организацию. Документация объясняет это так: подписку перебивает переменная ANTHROPIC_API_KEY, и чаще всего это старый ключ от прошлой работы или проекта. Убери переменную и её строку из ~/.zshrc или ~/.bashrc, потом проверь способ входа через /status:

unset ANTHROPIC_API_KEY
claude

Чек-лист

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

• Аккаунт платный: Pro, Max, Team, Enterprise или Console.
• На компьютере один способ установки, which -a claude или where.exe claude показывает одну строку.
• В новом окне терминала claude --version печатает номер версии с пометкой (Claude Code).
• claude doctor отработал, и его предупреждения прочитаны.
• После команды claude терминал написал Login successful.
• /status в сессии показывает тот способ входа, за который ты платишь.

Куда идти после установки?

Коротко: дальше три шага. Первая сессия в папке проекта, понимание, что агент умеет и чего не умеет, и правила проекта, чтобы договорённости жили в файле, а не в твоей голове. На каждый шаг есть отдельная статья, а готовые настройки лежат в базе, которую агент читает сам.

1. Первая сессия. Что напечатать первым, как читать запросы разрешений и как выйти, разобрано в статье про терминал.
2. Что умеет агент. Чем он отличается от чата и какие задачи берёт человек без опыта в коде, рассказано в статье что такое Claude Code.
3. Правила проекта. Файл, с которого агент начинает каждую сессию, описан в статье про CLAUDE.md, а весь порядок настройки - в статье про настройку с нуля.

Всё это настраивается руками по статьям. Есть путь короче: вместе с доступом к базе приходит код подключения по MCP, и дальше нужные материалы агент ищет в ней сам. Уроки, настройки, агенты и скиллы собраны в ClaudeBase.