7 мин · +100 баллов
Если установка не получилась
Типичные сообщения об ошибках и что делать с каждой.
К концу этого урока
Ты сможешь по тексту ошибки найти нужное исправление, а не гадать.
Большинство проблем с установкой сводятся к нескольким известным ошибкам. Найди свою по точному тексту на экране и сделай то, что написано под ней. Сначала скопируй полный текст ошибки: он может понадобиться для поиска или обращения в поддержку.
claude doctor
Запускай в терминале, когда claude --version уже работает. Команда только читает и показывает проверки установки и настроек с советами по исправлению. Внутри запущенной сессии /doctor проводит проверку и может исправить найденное после твоего подтверждения.
"command not found: claude" или "'claude' is not recognized"
Установка прошла, но терминал не знает, где лежит программа. Сначала закрой терминал и открой новое окно. Если не помогло, установщик в конце вывода, в разделе Setup notes, напечатал готовое исправление; выполни его или строку для своей системы ниже.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
Если всё в порядке, ничего не печатает. Потом открой новое окно и попробуй claude --version.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc
Если всё в порядке, ничего не печатает. Потом открой новое окно и попробуй claude --version.
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')Закрой PowerShell, открой новое окно и снова попробуй claude.
Windows: "'irm' is not recognized"
Windows: ты в CMD, а не в PowerShell. Либо открой PowerShell из меню «Пуск» и выполни строку для PowerShell, либо оставайся в CMD и используй строку для CMD из прошлого урока. Если видишь "The token '&&' is not a valid statement separator", всё наоборот: ты в PowerShell со строкой для CMD.
Windows: "A parameter cannot be found that matches parameter name 'fsSL'"
Windows: в PowerShell вставлена строка для Mac и Linux. Используй вместо неё irm https://claude.ai/install.ps1 | iex.
"syntax error near unexpected token '<'"
Установщик получил веб-страницу вместо скрипта установки; в PowerShell та же беда выглядит как ошибки с кусками HTML или System.Xml.XmlDocument. Если в тексте есть "App unavailable in region", смотри следующую ошибку. Иначе подожди несколько минут и повтори или поставь через brew install --cask claude-code (Mac) либо winget install Anthropic.ClaudeCode (Windows).
"App unavailable in region"
Claude Code недоступен в твоей стране. Список стран — на anthropic.com/supported-countries. Способов обойти это ограничение в курсе нет.
Рабочий компьютер не даёт установить
Компьютеры компаний часто блокируют загрузки через прокси или файрвол; обычные признаки — ошибка 403, "unable to get local issuer certificate" или полное отсутствие соединения. Обратись в IT-отдел: там могут разрешить downloads.claude.ai или дать настройки прокси. Не пытайся обходить защиту компании, а если IT отказывает, проходи курс на личном компьютере.
Старая система
Claude Code нужна macOS 13.0 или новее либо Windows 10 версии 1809 или новее, и не меньше 4 ГБ памяти. На старом Mac появляются ошибки вроде "dyld: cannot load" или "built for Mac OS X 13.0"; обнови macOS через «Обновление ПО», если твой Mac это позволяет.
Windows: "Could not create SSL/TLS secure channel"
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Так бывает на старых системах Windows 10. Первая строка включает в PowerShell более новое защищённое соединение, вторая заново запускает установщик.
Windows: "Claude Code does not support 32-bit Windows"
Windows: на 64-битном компьютере это значит, что открыт Windows PowerShell (x86). Закрой его, открой в меню «Пуск» пункт без (x86) в названии и запусти установку снова.
Полный список ошибок — на code.claude.com/docs/ru/troubleshoot-install. Ещё можно вставить текст ошибки в приложение Claude или на claude.ai и спросить, что он значит. Если терминал так и не поддаётся, начать можно с приложения для компьютера.
«Я устанавливаю Claude Code и получаю такую ошибку: [вставь полный текст ошибки]. У меня [Mac / Windows / Linux]. Что она значит и что именно мне вставить или нажать, чтобы её исправить?»
Спрашивай в приложении Claude или на claude.ai: сам Claude Code ещё не запущен. Замени части в квадратных скобках.
Когда claude запускается, чинить что-то руками больше не нужно. Спроси сам Claude Code.
«Проверь, всё ли в порядке с моей установкой Claude Code: запусти проверки, объясни, что выглядит не так, и исправь с моего разрешения.»
Claude запустит проверки, объяснит находки и спросит, прежде чем менять настройки.
В Windows появилось "'irm' is not recognized as an internal or external command". В чём дело?
Установщик напечатал "Claude Code successfully installed!", но claude не находится. Что попробовать первым?
Факты проверены по официальной документации Claude Code 24 октября 2026 г. · источник
Автор
Евгений Арсентьев
PhD · CEO, digital health