Установка и использование
📚 Навигация по серии: В предыдущей статье 01 · Введение в Claude Code мы разобрались, что это такое и что он умеет. Эта статья поможет вам по-настоящему установить его на свой компьютер, авторизоваться и запустить, а также разберет процессы обновления, удаления и решения проблем. В следующей статье 03 · Как работает Claude Code мы заглянем под капот и изучим цикл работы агента.
Расскажу о частой неловкой ситуации. Многие при первой установке Claude Code просто находят старое руководство в интернете и бездумно вводят npm install -g @anthropic-ai/claude-code, после чего сталкиваются с ошибкой прав доступа. В спешке они добавляют sudo — и вроде бы инструмент устанавливается, но потом автоматическое обновление постоянно дает сбой, а claude doctor выдает красные экраны ошибок. Потратив почти час на возню, они наконец понимают: официальные разработчики давно сделали нативные скрипты предпочтительными, а путь через npm полон подводных камней. То, что решается одной командой curl за 30 секунд, они превратили в самый длинный и проблемный путь.
Проще говоря, установить Claude Code несложно, сложно то, что никто не предупреждает, где скрываются проблемы. В этой статье мы обозначим правильный путь для каждой платформы, чтобы вы не повторяли чужих ошибок.
Прочитав эту статью, вы получите:
- Одну команду для установки Claude Code на Mac / Windows / Linux / WSL (с ожидаемым выводом, чтобы вы могли сами проверить, успешна ли установка)
- Сравнение трех способов установки (официальный скрипт / менеджеры пакетов / npm), чтобы вы знали, какой выбрать
- Полное руководство по авторизации, обновлению и удалению
- Шпаргалку по решению проблем «ошибка → как исправить», покрывающую 90% подводных камней, с которыми сталкиваются новички
01 Три вещи, которые нужно прояснить перед установкой
Не спешите вводить команды. Слишком многие на полпути к установке обнаруживают: «О, а этот аккаунт не подходит», и все усилия идут прахом. Сначала подтвердите три вещи.
Первое: Подходит ли ваш компьютер
Claude Code не требователен к железу, но есть несколько жестких условий (согласно официальным данным):
| Параметр | Требование |
|---|---|
| ОС | macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+ |
| Память | Не менее 4 ГБ доступной оперативной памяти (RAM) |
| Процессор | x64 или ARM64 |
| Сеть | Требуется подключение к интернету |
| Терминал | Bash, Zsh, PowerShell или CMD |
Пользователи macOS версий ниже 13.0, внимание: установить можно, но при запуске произойдет сбой, появится ошибка вроде dyld: cannot load — старая система не поддерживает инструкции, используемые бинарным файлом. Обойти это невозможно, поможет только обновление ОС (на машинах с macOS 12 он категорически не запускается, проблема исчезает при обновлении до 14).
Второе: У вас должен быть подходящий аккаунт
Самое частое упущение новичков: бесплатный аккаунт Claude.ai не работает с Claude Code.
Официальное требование: аккаунт Pro, Max, Team, Enterprise или Console (API). То, что вы радостно общаетесь в веб-версии Claude, не означает, что аккаунт потянет Claude Code — бесплатный тариф просто не подходит.
Если вы хотите сэкономить и использовать отечественные (китайские) модели (DeepSeek, GLM, Minimax), пропустите этот шаг с аккаунтом. В статье 05 будет отдельный рассказ о подключении сторонних моделей. В этой статье мы предполагаем, что вы используете официальный аккаунт.
Третье: Откуда вы планируете его использовать
У Claude Code есть три способа использования: CLI (командная строка) с самым полным функционалом и наиболее близкий к изначальной задумке; Десктопное приложение, где не нужно трогать терминал, скачал и пользуйся; Интеграция с редакторами (VS Code / JetBrains), внедряющаяся в существующий процесс разработки.
Мой совет: учитесь сразу работать с CLI. Эта статья также фокусируется на CLI — он самый стабильный и универсальный. Если вы освоите его, то разобраться с десктопным приложением и плагинами для редакторов будет делом нескольких минут (об этом в статьях 08-10). Если вы категорически против терминала, зайдите на https://claude.com/download, скачайте десктопное приложение и используйте его через графический интерфейс.
💡 Краткий итог: Перед установкой проверьте три вещи — версия системы подходит, аккаунт платный или Console, выбран способ использования CLI. Только когда все три пункта пройдены, вводите команды.
02 Установка: одна команда для каждой платформы
Сразу к выводу: на всех платформах предпочтительнее использовать официальный установочный скрипт (официально это называется «Нативная установка / Native Install», сейчас это самый рекомендуемый способ). Главное преимущество — после установки фоновое обновление происходит автоматически, и вам почти не нужно заботиться о версиях.
Аналогия: нативная установка похожа на установку приложения из App Store. Вы нажимаете «установить», оно само скачивается, устанавливается и в будущем само обновляется в фоне. Старый способ через npm больше похож на «скачать установщик и вручную нажимать Далее» — установить можно, но обновлять придется вручную, да и с правами доступа могут возникнуть проблемы.
macOS / Linux / WSL
Откройте терминал и вставьте эту строку:
curl -fsSL https://claude.ai/install.sh | bashСовет по сети (для пользователей в Китае и некоторых других странах): домены claude.ai и сервер скачивания downloads.claude.ai в большинстве случаев требуют использования VPN для стабильного доступа. Включите VPN во время установки, это избавит вас от большинства ошибок «зависание / таймаут».
Windows (нативно, без WSL)
Сначала убедитесь, в каком терминале вы находитесь — это самая частая ошибка пользователей Windows. Команды для PowerShell и CMD отличаются:
PowerShell (приглашение выглядит так: PS C:\>):
irm https://claude.ai/install.ps1 | iexCMD (приглашение выглядит как C:\>, без PS спереди):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdКак отличить? Посмотрите, есть ли в начале приглашения PS: если есть — это PowerShell, если нет — CMD. Если в PowerShell запустить команду для CMD с &&, появится ошибка The token '&&' is not a valid statement separator. И наоборот, если в CMD запустить irm, появится ошибка 'irm' is not recognized. Если видите эти ошибки, просто используйте команду для нужного терминала.
Кроме того, в нативной среде Windows рекомендуется попутно установить Git for Windows, он предоставляет Git Bash для Claude Code; если его не установить, команды будут выполняться через PowerShell (это работает, но возможности некоторых Bash-скриптов будут ограничены). Для WSL это не требуется.
Windows: выбрать WSL или нативный вариант?
Если вы разрабатываете инструменты для Linux или хотите использовать функцию песочницы (sandbox), выбирайте WSL. Официальная таблица сравнения:
| Вариант | Что нужно | Поддержка песочницы | Когда использовать |
|---|---|---|---|
| Нативный Windows | Ничего (Git for Windows опционально) | ❌ | Нативные проекты и инструменты Windows |
| WSL 2 | Включить WSL 2 | ✅ | Инструменты Linux или если нужна песочница |
| WSL 1 | Включить WSL 1 | ❌ | Резервный вариант, если WSL 2 не работает |
Если выбираете WSL, просто введите в терминале WSL команду curl для macOS/Linux, приведенную выше — устанавливать нужно внутри WSL, а не в PowerShell.
Не хотите трогать терминал? Есть другие пути
Помимо официального скрипта есть несколько альтернатив, вот таблица для выбора:
| Способ установки | Команда | Автообновление | Моя рекомендация |
|---|---|---|---|
| Официальный скрипт | curl ... | bash | ✅ Автоматически в фоне | Первый выбор, без хлопот |
| Homebrew (macOS) | brew install --cask claude-code | ❌ Вручную | Для тех, кто уже активно управляет ПО через brew |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | ❌ Вручную | Для тех, кто привык к WinGet |
| npm | npm install -g @anthropic-ai/claude-code | ❌ Вручную | Рассматривать в последнюю очередь, требует Node.js 18+ |
Сразу предупрежу о подводных камнях:
- В Homebrew есть два cask'а:
claude-code— стабильная версия (отстает на неделю, пропускает версии с серьезными багами),claude-code@latest— самая свежая версия. Обновление осуществляется командамиbrew upgrade claude-code/brew upgrade claude-code@latestсоответственно. - WinGet не обновляется автоматически: нужно регулярно вручную выполнять
winget upgrade Anthropic.ClaudeCode. - Ни в коем случае не используйте
sudoс npm. Официальная документация четко предупреждает, чтоsudo npm install -gприведет к проблемам с правами доступа и рискам безопасности — это именно та самая частая ошибка, упомянутая в начале. Если сталкиваетесь с ошибкой прав, правильное решение — использовать официальный скрипт. Для обновления через npm тоже нужно использоватьnpm install -g ...@latest, а неnpm update -g.
💡 Краткий итог: Выбирайте официальный скрипт с закрытыми глазами — одна команда
curl(илиirmдля Windows) решает все проблемы, к тому же есть фоновое автообновление; npm — худший вариант, и никогда не используйтеsudo.
03 Проверка успешности установки
После установки не спешите сразу использовать, потратьте десять секунд на проверку. Откройте новое окно терминала и введите:
claude --versionОжидаемый вывод — номер версии, например (у вас могут быть другие цифры, это нормально):
2.1.81 (Claude Code)Видите номер версии = установка прошла успешно. Если появляется ошибка command not found: claude или 'claude' is not recognized в Windows, не спешите переустанавливать — в 90% случаев проблема в том, что переменная PATH не настроена (директория установки не добавлена в пути поиска системы). Как это исправить, описано в разделе 06.
Для более детальной проверки есть официальная команда диагностики:
claude doctorОна покажет статус установки, конфигурацию и результаты последнего обновления. При установке на новую машину или при странном поведении первым делом нужно запустить claude doctor — это гораздо быстрее, чем гадать вслепую.
💡 Краткий итог: Появление версии после
claude --versionозначает успех; при любых странностяхclaude doctor— ваш первый диагностический инструмент.
04 Авторизация: чтобы он вас узнал
Установленный Claude Code — это всё еще «не знающая вас» пустышка, нужно авторизоваться и привязать аккаунт, чтобы начать работать. Запустите его в папке вашего проекта:
claudeПри первом запуске он автоматически предложит авторизоваться, либо вы можете запустить процесс вручную из интерфейса:
/loginДалее откроется окно браузера для авторизации. После подтверждения возвращайтесь в терминал — вы авторизованы. Учетные данные сохраняются локально, при следующем запуске авторизоваться не нужно. Чтобы сменить аккаунт, просто выполните /login еще раз.
Что делать, если авторизация зависла
Самый частый случай: браузер не открылся автоматически, или вы авторизуетесь на удаленном сервере / в WSL / через SSH — браузер может попытаться открыться на другой машине, и callback не вернется. Официальное решение очень простое:
Находясь на экране с запросом авторизации, нажмите c, скопируйте предоставленный OAuth URL, вставьте его в браузер вручную, авторизуйтесь. После этого появится код (code) — скопируйте его и вставьте обратно в терминал.
При настройке Claude Code на облачных серверах легко попасть в эту ловушку и долго ждать всплывающего окна браузера. В удаленной среде единственный выход — копировать URL и открывать вручную. Если даже вставка кода не работает, есть еще более надежная команда-резерв:
claude auth loginОна читает вставленный вами код из стандартного ввода, что отлично подходит для терминалов, где интерактивный ввод глючит.
Скрытая ловушка при авторизации
Если после успешной авторизации вы видите сообщение This organization has been disabled, но ваша подписка точно активна — скорее всего, в конфигурации вашего shell'а застрял старый ключ ANTHROPIC_API_KEY, который переопределяет ваши учетные данные подписки.
Если в переменных окружения есть API-ключ, Claude Code будет использовать его, а не подписку. Решение — удалить его:
unset ANTHROPIC_API_KEY
claudeЧтобы решить проблему навсегда, проверьте файлы ~/.zshrc, ~/.bashrc или ~/.profile и удалите строку export ANTHROPIC_API_KEY=.... Зайдя в Claude Code, вы можете ввести /status, чтобы проверить, какой тип авторизации сейчас используется.
💡 Краткий итог: Запуск
claudeавтоматически предложит авторизоваться. В удаленных/WSL средах помните: нажмитеc, скопируйте URL и откройте его вручную; если при авторизации пишет, что организация отключена, проверьте, нет ли старого API-ключа в переменных окружения.
05 Обновление и удаление
Обновление
Если вы устанавливали через официальный скрипт, делать ничего не нужно — обновления происходят автоматически в фоне, при следующем запуске будет уже новая версия. Если хотите обновить прямо сейчас:
claude updateПроверить, прошло ли обновление, можно командой claude doctor. Канал обновления можно выбрать (прописать в settings.json или использовать /config внутри Claude Code):
{
"autoUpdatesChannel": "stable"
}"latest"(по умолчанию): получаете новые функции сразу после релиза"stable": используется версия примерно недельной давности, без критических багов — для стабильности выбирайте этот вариант
Если вам не нужны автообновления, установите в окружении (раздел env в settings.json) "DISABLE_AUTOUPDATER": "1" (это остановит только фоновые проверки, ручное обновление claude update по-прежнему будет работать). Версии, установленные через Homebrew / WinGet / apt, по умолчанию не обновляются автоматически, для них нужно вручную выполнять соответствующие команды обновления (как описано в разделе о подводных камнях).
Удаление
Удаление зависит от того, как вы его устанавливали. Если использовали официальный скрипт:
macOS / Linux / WSL:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeWindows PowerShell:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -ForceДля других способов используйте соответствующие команды: Homebrew — brew uninstall --cask claude-code, WinGet — winget uninstall Anthropic.ClaudeCode, npm — npm uninstall -g @anthropic-ai/claude-code.
Внимание: Вышеуказанные команды удаляют только само приложение. Конфигурация, авторизация и история сессий остаются в папке ~/.claude/. Если после удаления команда claude всё еще работает, скорее всего, у вас есть вторая установка или псевдоним shell'а от старой версии (как это вычислить, описано в разделе 06).
Если вы хотите полностью очистить всё (этот шаг необратим, все настройки / авторизация / конфигурация MCP / история сессий будут удалены):
# Глобальные пользовательские настройки и состояние
rm -rf ~/.claude
rm ~/.claude.json
# Локальные настройки текущего проекта (выполнять в папке проекта)
rm -rf .claude
rm -f .mcp.jsonНапоминание: расширения VS Code, плагины JetBrains и десктопное приложение также пишут в ~/.claude/. Пока они установлены, папка будет создаваться заново. Чтобы удалить ее окончательно, сначала нужно удалить их.
💡 Краткий итог: Если устанавливали официальным скриптом — обновление автоматическое в фоне, поторопить можно через
claude update. Удаляйте тем же способом, которым устанавливали. Конфигурационные файлы нужно удалять отдельно, и это действие необратимо.
06 Шпаргалка по ошибкам: 90% ям, в которые падают новички
Ошибки при установке неизбежны, но для большинства из них есть стандартные решения. Вот сводная таблица самых частых ошибок из официальной документации — сначала найдите причину, потом применяйте решение, не спешите переустанавливать.
| Ошибка, которую вы видите | Истинная причина | Как исправить |
|---|---|---|
command not found: claude | Директория установки не в PATH | Добавьте ~/.local/bin в PATH (см. ниже) |
syntax error near unexpected token '<' | Установочный скрипт вернул HTML вместо скрипта | Проблема с сетью/регионом, используйте Homebrew/WinGet или попробуйте позже |
irm is not recognized | Вы запустили команду PowerShell в CMD | Используйте команду для CMD или откройте PowerShell |
'&&' is not valid | Вы запустили команду CMD в PowerShell | Используйте команду irm для PowerShell |
bash is not recognized | Вы запустили команду для Mac/Linux в Windows | Используйте команду irm для PowerShell |
Ошибка Killed при установке в Linux | Нехватка памяти (процесс убит OOM) | Добавьте swap-файл (см. ниже), Claude Code требует 4 ГБ+ RAM |
Error loading shared library | Установщик ошибся в определении типа libc системы и скачал не ту версию | Смотрите официальное руководство по устранению неполадок musl/glibc |
403 Forbidden после авторизации | Недействительная подписка / нет прав у аккаунта | Проверьте статус подписки или наличие нужной роли у аккаунта Console |
App unavailable in region | Ваш регион не поддерживается | Смотрите список поддерживаемых стран/регионов |
Подробно разберем две самые частые.
Ловушка 1: command not found: claude (самая частая)
Если при запуске claude пишет, что команда не найдена — это не значит, что он не установлен, просто директория установки не добавлена в системный путь поиска (PATH).
Аналогия: PATH — это список адресов системы. Программа установлена, как построенный дом, но система ищет только по адресам из списка. Дом claude построен по адресу ~/.local/bin/, а этого адреса в списке нет, поэтому система его и не находит.
Решение (в macOS по умолчанию используется Zsh):
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcВ большинстве систем Linux по умолчанию используется Bash, просто замените ~/.zshrc на ~/.bashrc. После внесения изменений проверьте:
claude --versionЕсли появился номер версии, значит всё исправлено. Пользователям Windows нужно добавить %USERPROFILE%\.local\bin в переменную среды PATH пользователя, а затем перезапустить терминал.
Ловушка 2: Поиск конфликтующих установок
Если вы сначала устанавливали через npm, а потом еще раз через официальный скрипт, у вас может быть несколько claude одновременно. Версии не будут совпадать, а поведение станет странным. Сначала посмотрите, сколько их в PATH:
which -a claudeЕсли выводится больше одного, оставьте только тот, что от официального скрипта (~/.local/bin/claude), а остальные удалите:
# Удалить глобальную установку npm
npm uninstall -g @anthropic-ai/claude-code
# Удалить локальную установку npm старой версии
rm -rf ~/.claude/localОчень часто после выполнения which -a claude выясняется, что установлены и npm-, и нативная версии. Удалив npm-версию и приведя в порядок PATH, вы сразу решите проблему.
💡 Краткий итог: При ошибке сначала ищите причину в таблице, не переустанавливайте рефлекторно. Если команда не найдена — скорее всего, проблема в PATH. Если поведение странное — скорее всего, конфликт нескольких установок,
which -a claudeвсё покажет.
07 Практика: запускаем первый пример с нуля
Просто установить — мало. Нужно на практике проверить весь процесс, чтобы убедиться, что всё работает. Этот минимальный сценарий не зависит от существующих проектов, просто создайте пустую папку.
Шаг первый, создайте тестовую директорию, перейдите в нее и запустите Claude Code:
mkdir claude-test && cd claude-test
claudeПри первом запуске он предложит вам авторизоваться (как описано в разделе 04). После авторизации вы увидите экран приветствия.
Шаг второй, в поле ввода напечатайте /help, чтобы посмотреть доступные команды:
/helpОжидание: появится список доступных команд и описание их функций. Если просто ввести /, появится автодополнение со всеми командами.
Шаг третий, поручите ему реальную задачу — дайте инструкцию простым языком (не нужно запоминать форматы команд):
Напиши функцию, печатающую hello world, в файле test.pyОжидаемое поведение: Сначала Claude Code покажет вам изменения кода в виде diff (сравнения). И только после вашего подтверждения (выбора yes) он запишет изменения в файл. Это основа его рабочего процесса — сначала предлагает решение, ждет вашего одобрения, и только потом делает, не меняя ваши файлы втихаря.
После подтверждения в папке появится файл test.py. Выход:
exitНа этом этапе вы полностью прошли процесс «установка → авторизация → инструкция → изменение файла → ваше подтверждение». В первый раз, когда вы видите, как он сам пишет код и ждет вашего кивка, появляется реальное ощущение «эта штука действительно умеет работать» — это приносит немного радости.
Этот рисунок связывает четыре описанных выше шага: от запуска claude и авторизации, просмотра команд через /help, отправки инструкции простым языком, до самого ключевого момента — он сначала показывает вам diff, ждет вашего кивка (yes) и только потом пишет файл. Если вы скажете нет (no), он не будет ничего писать, а скорректирует решение и предложит снова. Он никогда не изменяет ваши файлы втайне.
💡 Краткий итог: Создайте пустую папку и пройдите весь процесс — запуск и авторизация
claude,/helpдля команд, инструкция простым языком, просмотр diff и нажатие yes. Этот подход «сначала предложение, потом действие» — его главный принцип.
08 Заключение
В этой статье мы полностью разобрали процесс «как установить и начать пользоваться»:
- Три проверки перед установкой: версия системы, платный аккаунт или Console, способ использования CLI.
- Используйте официальный скрипт: для Mac/Linux/WSL это
curl, для Windows важно различать PowerShell (irm) и CMD. npm — худший вариант, никогда не используйтеsudo. - Проверка с помощью
claude --version, диагностика —claude doctor; если после авторизации пишет, что организация отключена, ищите забытыйANTHROPIC_API_KEY. - При ошибке ищите причину в таблице: не найдена команда — проблема с PATH, странное поведение — несколько установок.
Теперь вы должны уметь самостоятельно устанавливать Claude Code на свой компьютер, авторизоваться, запускать первый пример и знать, где искать решение в случае стандартных ошибок.
В следующей статье 03 · Как работает Claude Code мы заглянем внутрь: как ваша фраза «напиши функцию hello world» превратилась в точное изменение файла? За этим стоит механизм, называемый «циклом работы агента» (agent loop). Только поняв его, вы сможете по-настоящему эффективно использовать Claude Code, а не просто вводить команды.
Вопрос на засыпку: когда вы просили его написать
test.py, он сначала проверил, какие файлы есть в папке, или сразу начал писать? Эта разница и станет отправной точкой для следующей статьи.
Установка — это лишь получение инструмента, истинное мастерство — это понимание его «образа мыслей». Увидимся в следующей статье.