Skip to content

Установка и использование ​

📚 Навигация по серии: В предыдущей статье 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 ​

Откройте терминал и вставьте эту строку:

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

Совет по сети (для пользователей в Китае и некоторых других странах): домены claude.ai и сервер скачивания downloads.claude.ai в большинстве случаев требуют использования VPN для стабильного доступа. Включите VPN во время установки, это избавит вас от большинства ошибок «зависание / таймаут».

Windows (нативно, без WSL) ​

Сначала убедитесь, в каком терминале вы находитесь — это самая частая ошибка пользователей Windows. Команды для PowerShell и CMD отличаются:

PowerShell (приглашение выглядит так: PS C:\>):

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

CMD (приглашение выглядит как C:\>, без PS спереди):

batch
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
npmnpm 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 Проверка успешности установки ​

После установки не спешите сразу использовать, потратьте десять секунд на проверку. Откройте новое окно терминала и введите:

bash
claude --version

Ожидаемый вывод — номер версии, например (у вас могут быть другие цифры, это нормально):

text
2.1.81 (Claude Code)

Видите номер версии = установка прошла успешно. Если появляется ошибка command not found: claude или 'claude' is not recognized в Windows, не спешите переустанавливать — в 90% случаев проблема в том, что переменная PATH не настроена (директория установки не добавлена в пути поиска системы). Как это исправить, описано в разделе 06.

Для более детальной проверки есть официальная команда диагностики:

bash
claude doctor

Она покажет статус установки, конфигурацию и результаты последнего обновления. При установке на новую машину или при странном поведении первым делом нужно запустить claude doctor — это гораздо быстрее, чем гадать вслепую.

💡 Краткий итог: Появление версии после claude --version означает успех; при любых странностях claude doctor — ваш первый диагностический инструмент.


04 Авторизация: чтобы он вас узнал ​

Установленный Claude Code — это всё еще «не знающая вас» пустышка, нужно авторизоваться и привязать аккаунт, чтобы начать работать. Запустите его в папке вашего проекта:

bash
claude

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

text
/login

Далее откроется окно браузера для авторизации. После подтверждения возвращайтесь в терминал — вы авторизованы. Учетные данные сохраняются локально, при следующем запуске авторизоваться не нужно. Чтобы сменить аккаунт, просто выполните /login еще раз.

Что делать, если авторизация зависла ​

Самый частый случай: браузер не открылся автоматически, или вы авторизуетесь на удаленном сервере / в WSL / через SSH — браузер может попытаться открыться на другой машине, и callback не вернется. Официальное решение очень простое:

Находясь на экране с запросом авторизации, нажмите c, скопируйте предоставленный OAuth URL, вставьте его в браузер вручную, авторизуйтесь. После этого появится код (code) — скопируйте его и вставьте обратно в терминал.

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

bash
claude auth login

Она читает вставленный вами код из стандартного ввода, что отлично подходит для терминалов, где интерактивный ввод глючит.

Скрытая ловушка при авторизации ​

Если после успешной авторизации вы видите сообщение This organization has been disabled, но ваша подписка точно активна — скорее всего, в конфигурации вашего shell'а застрял старый ключ ANTHROPIC_API_KEY, который переопределяет ваши учетные данные подписки.

Если в переменных окружения есть API-ключ, Claude Code будет использовать его, а не подписку. Решение — удалить его:

bash
unset ANTHROPIC_API_KEY
claude

Чтобы решить проблему навсегда, проверьте файлы ~/.zshrc, ~/.bashrc или ~/.profile и удалите строку export ANTHROPIC_API_KEY=.... Зайдя в Claude Code, вы можете ввести /status, чтобы проверить, какой тип авторизации сейчас используется.

💡 Краткий итог: Запуск claude автоматически предложит авторизоваться. В удаленных/WSL средах помните: нажмите c, скопируйте URL и откройте его вручную; если при авторизации пишет, что организация отключена, проверьте, нет ли старого API-ключа в переменных окружения.


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

Обновление ​

Если вы устанавливали через официальный скрипт, делать ничего не нужно — обновления происходят автоматически в фоне, при следующем запуске будет уже новая версия. Если хотите обновить прямо сейчас:

bash
claude update

Проверить, прошло ли обновление, можно командой claude doctor. Канал обновления можно выбрать (прописать в settings.json или использовать /config внутри Claude Code):

json
{
  "autoUpdatesChannel": "stable"
}
  • "latest" (по умолчанию): получаете новые функции сразу после релиза
  • "stable": используется версия примерно недельной давности, без критических багов — для стабильности выбирайте этот вариант

Если вам не нужны автообновления, установите в окружении (раздел env в settings.json) "DISABLE_AUTOUPDATER": "1" (это остановит только фоновые проверки, ручное обновление claude update по-прежнему будет работать). Версии, установленные через Homebrew / WinGet / apt, по умолчанию не обновляются автоматически, для них нужно вручную выполнять соответствующие команды обновления (как описано в разделе о подводных камнях).

Удаление ​

Удаление зависит от того, как вы его устанавливали. Если использовали официальный скрипт:

macOS / Linux / WSL:

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

Windows PowerShell:

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 / история сессий будут удалены):

bash
# Глобальные пользовательские настройки и состояние
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):

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

В большинстве систем Linux по умолчанию используется Bash, просто замените ~/.zshrc на ~/.bashrc. После внесения изменений проверьте:

bash
claude --version

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

Ловушка 2: Поиск конфликтующих установок ​

Если вы сначала устанавливали через npm, а потом еще раз через официальный скрипт, у вас может быть несколько claude одновременно. Версии не будут совпадать, а поведение станет странным. Сначала посмотрите, сколько их в PATH:

bash
which -a claude

Если выводится больше одного, оставьте только тот, что от официального скрипта (~/.local/bin/claude), а остальные удалите:

bash
# Удалить глобальную установку 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:

bash
mkdir claude-test && cd claude-test
claude

При первом запуске он предложит вам авторизоваться (как описано в разделе 04). После авторизации вы увидите экран приветствия.

Шаг второй, в поле ввода напечатайте /help, чтобы посмотреть доступные команды:

text
/help

Ожидание: появится список доступных команд и описание их функций. Если просто ввести /, появится автодополнение со всеми командами.

Шаг третий, поручите ему реальную задачу — дайте инструкцию простым языком (не нужно запоминать форматы команд):

text
Напиши функцию, печатающую hello world, в файле test.py

Ожидаемое поведение: Сначала Claude Code покажет вам изменения кода в виде diff (сравнения). И только после вашего подтверждения (выбора yes) он запишет изменения в файл. Это основа его рабочего процесса — сначала предлагает решение, ждет вашего одобрения, и только потом делает, не меняя ваши файлы втихаря.

После подтверждения в папке появится файл test.py. Выход:

text
exit

На этом этапе вы полностью прошли процесс «установка → авторизация → инструкция → изменение файла → ваше подтверждение». В первый раз, когда вы видите, как он сам пишет код и ждет вашего кивка, появляется реальное ощущение «эта штука действительно умеет работать» — это приносит немного радости.

Весь процесс первой сессии Claude Code

Этот рисунок связывает четыре описанных выше шага: от запуска 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, он сначала проверил, какие файлы есть в папке, или сразу начал писать? Эта разница и станет отправной точкой для следующей статьи.


Установка — это лишь получение инструмента, истинное мастерство — это понимание его «образа мыслей». Увидимся в следующей статье.


Рекомендуется к прочтению ​