Установка Claude Code одной командой: macOS, Linux и Windows
На 2026-10-07 Anthropic рекомендует ставить Claude Code через Native Install: в macOS, Linux и WSL выполните curl -fsSL https://claude.ai/install.sh | bash, в Windows PowerShell — irm https://claude.ai/install.ps1 | iex; подходят также Homebrew, WinGet и npm. Для подключения к QCode хватит одной команды скрипта автонастройки QCode: он выбирает эндпоинт по задержке, записывает конфигурацию, при необходимости ставит Node.js и CLI и проверяет соединение. На этой странице — команды для обоих путей, проверка установки и частые ошибки.
Обновлено 2026-10-08
Четыре вещи, которые стоит знать заранее
Официальный установщик — своя команда для каждой оболочки
install.sh для macOS, Linux и WSL, install.ps1 для Windows PowerShell, install.cmd для Windows CMD. Anthropic называет этот способ рекомендуемым, после установки он обновляется в фоне.
Требование для установки через npm
В официальной документации сказано, что npm-пакету нужен Node.js 22 или новее; на более старой версии npm лишь выводит предупреждение EBADENGINE, а установка завершается. Через npm ставится тот же нативный бинарный файл, что и официальным установщиком.
Скрипт автонастройки QCode
В macOS и Linux: curl -fsSL https://qcode.cc/install/claude-code.sh | bash, в Windows PowerShell: irm https://qcode.cc/install/claude-code.ps1 | iex. Не нужны ни sudo, ни права администратора.
Первая проверка после установки
Рабочая установка выводит номер версии вроде 2.1.211 (Claude Code). Для подробной проверки есть claude doctor, а внутри сессии /status показывает, какой способ аутентификации активен.
Какие способы установки официальные
На 2026-10-07 на странице установки в документации Claude Code перечислены официальный установщик (Native Install, помечен как рекомендуемый), Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode) и npm (npm install -g @anthropic-ai/claude-code); для Debian, Fedora, RHEL и Alpine есть ещё подписанные репозитории apt, dnf и apk. Главное различие — обновления: официальный установщик обновляется в фоне, а установки через Homebrew и WinGet сами не обновляются. У Homebrew два cask: claude-code следует каналу stable (обычно примерно на неделю позади, релизы с серьёзными регрессиями пропускаются), claude-code@latest — каналу latest. Системные требования: macOS 13.0+, Windows 10 1809+ или Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+, от 4 ГБ ОЗУ, процессор x64 или ARM64.
Версии и документация на 2026-10-07
На 2026-10-07 последний релиз Claude Code на GitHub Releases — v2.1.292, опубликован 2026-10-06 (UTC); тег latest пакета @anthropic-ai/claude-code в npm тоже 2.1.292, а в метаданных пакета указано требование node >=22.0.0. Страницы документации QCode о скрипте автонастройки и об установке помечены как обновлённые 2026-09-25; руководство по установке начинается с рекомендации скрипта и говорит, что он одной командой выполняет все шаги этой страницы. В исходнике публичного скрипта claude-code.sh на qcode.cc указана версия 2026.10.07.1.
Хронология
Обновлены страницы документации QCode о скрипте автонастройки и об установке; на 2026-10-07 руководство по установке рекомендует скрипт.
Claude Code v2.1.292 опубликован на GitHub Releases (UTC) — последний релиз на 2026-10-07; тег latest в npm тоже 2.1.292.
В исходнике публичного скрипта claude-code.sh указана версия 2026.10.07.1; команды, тексты ошибок и поведение скрипта на этой странице сверены в этот день с официальными страницами и исходником скрипта.
Подтверждено vs не описано в документации
Подтверждено (дословно в документации)
Всё перечисленное дословно есть в документации Claude Code, на GitHub Releases, в метаданных npm-пакета или в документации QCode и исходнике публичного скрипта: три официальные команды установки и пометка Native Install как рекомендуемого; фоновые автообновления официального установщика и их отсутствие у Homebrew и WinGet; npm-пакету нужен Node.js 22 или новее, и он ставит тот же нативный бинарный файл; Anthropic прямо просит не использовать sudo npm install -g; для установки в Windows не нужен запуск от имени администратора; назначение claude --version, claude doctor и /status; команды скрипта QCode, его четыре шага (выбор эндпоинта, запись конфигурации, установка Node.js и CLI при необходимости, проверка соединения), резервные копии и откат; среди переменных, которые пишет скрипт, есть ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1.
Не описано или не проверено здесь
Три вещи эта страница не утверждает. Первое: npm-пакет требует Node.js 22 или новее, но Anthropic также пишет, что на старом Node.js появляется лишь предупреждение EBADENGINE, а установка завершается; скрипт QCode ставит LTS-версию, если Node.js нет, и о поведении на конкретных версиях Node.js мы не гадаем. Второе: установка не проверялась пошагово на каждой ОС; команды взяты из официальной документации и документации QCode, загруженных 2026-10-07, а решающее слово — за вашей системой и версией. Третье: 2.1.211 в официальной документации — лишь пример формата вывода, а не текущая последняя версия.
Официальный установщик, npm или скрипт QCode
Официальный установщик против npm
Anthropic помечает Native Install как рекомендуемый, и он обновляется в фоне; при ошибках прав, специфичных для npm, официальный совет — перейти на него. Через npm нужен Node.js 22 или новее, ставится тот же нативный бинарный файл; обновление — npm install -g @anthropic-ai/claude-code@latest, а от npm update -g и sudo npm install -g документация предостерегает. Homebrew и WinGet удобны тем, кто уже ими пользуется, но сами не обновляются.
Только Claude Code против скрипта QCode
Официальный установщик ставит только Claude Code; на официальном пути затем нужен вход с аккаунтом Pro, Max, Team, Enterprise или Console. Скрипт автонастройки QCode настраивает и подключение: выбирает эндпоинт по задержке, записывает ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN, при отсутствии Node.js ставит LTS через nvm или winget, затем CLI через npm, а в конце отправляет минимальный запрос с вашим ключом для проверки. Если Claude Code уже установлен и нужна только настройка QCode, добавьте --no-install.
Пошагово для обоих путей
Официальный путь: (1) Откройте терминал и выполните команду для своей системы: в macOS, Linux или WSL — curl -fsSL https://claude.ai/install.sh | bash; в Windows PowerShell — irm https://claude.ai/install.ps1 | iex; в Windows CMD — curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. (2) Откройте новое окно терминала и выполните claude --version — должен появиться номер версии. (3) Запустите claude в папке проекта. Путь через QCode: (1) Получите в панели QCode API-ключ, начинающийся с cr_. (2) В macOS или Linux выполните curl -fsSL https://qcode.cc/install/claude-code.sh | bash, в Windows — irm https://qcode.cc/install/claude-code.ps1 | iex в PowerShell, и вставьте ключ по запросу (ввод не отображается). (3) Откройте новый терминал, чтобы настройки вступили в силу (в Windows также один раз перезапустите редакторы вроде VS Code), выполните claude --version, затем запустите claude и проверьте способ аутентификации командой /status. Для ручной настройки руководство QCode задаёт две переменные: ANTHROPIC_BASE_URL=https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN с вашим ключом. Если команда установки падает с syntax error near unexpected token '<' или 403, то, по документации, адрес установки вернул веб-страницу или код ошибки вместо скрипта: поставьте Claude Code через Homebrew в macOS или через WinGet в Windows либо повторите через несколько минут.
В QCode
В QCode Claude Code работает через эндпоинт с протоколом Anthropic: ANTHROPIC_BASE_URL — https://api.qcode.cc/api (до /api, без завершающего слеша), ANTHROPIC_AUTH_TOKEN — ключ cr_, созданный в панели; Claude Code отправляет его в заголовке Authorization с префиксом Bearer. В macOS и Linux среди переменных, которые скрипт пишет в управляемый блок оболочки, есть и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1; руководство QCode по установке описывает её как отключение необязательных сетевых запросов, например телеметрии. По умолчанию скрипт не пишет ANTHROPIC_MODEL, и Claude Code использует встроенную модель по умолчанию, обновляясь вместе с ней; чтобы закрепить модель, передайте --model, например claude-sonnet-5-5 или claude-opus-5-5. Так же вызываются и другие модели Claude, например claude-sonnet-5. Оплата по токенам, цены по моделям — на /models; у моделей Claude нет отдельного тарифа для длинного контекста.
Частые вопросы
Как установить Claude Code в Windows?
В 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 install Anthropic.ClaudeCode. Поддерживаются Windows 10 1809+ и Windows Server 2019+. Git for Windows не обязателен: с ним Claude Code использует Git Bash, без него — PowerShell в качестве оболочки. Для WSL выполните команду для Linux в терминале WSL и запускайте claude там же. Чтобы подключиться к QCode, выполните в PowerShell irm https://qcode.cc/install/claude-code.ps1 | iex.
После установки появляется command not found: claude или 'claude' is not recognized?
Обычно папка установки ещё не попала в PATH, поэтому сначала откройте новое окно терминала и повторите: в документации сказано, что сессия, из которой ставили, сохраняет старый PATH. Официальный установщик кладёт claude в ~/.local/bin/claude в macOS и Linux и в %USERPROFILE%\.local\bin\claude.exe в Windows; в Zsh выполните echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, для Bash в Linux та же строка добавляется в ~/.bashrc. Если после скрипта QCode в Windows команда не находится, документация QCode советует то же: открыть новое окно PowerShell.
Ошибка irm is not recognized или The token '&&' is not a valid statement separator?
Команда не соответствует оболочке. По документации, 'irm' is not recognized значит, что вы в CMD: используйте команду для CMD или откройте PowerShell; The token '&&' is not a valid statement separator значит, что команду для CMD запустили в PowerShell. Если выполнить в PowerShell curl -fsSL ... | bash, появится ошибка о параметре fsSL, потому что curl в PowerShell — псевдоним Invoke-WebRequest. Для скрипта QCode в CMD выполните powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex".
PowerShell пишет running scripts is disabled on this system?
Политика выполнения блокирует .ps1-скрипты запуска, которые создаёт npm. Документация предлагает три решения: выполнить Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser и повторить; вызывать npm.cmd и claude.cmd; или отказаться от npm в пользу установщика для PowerShell, который ставит бинарный файл, а не .ps1-скрипт. Скрипт автонастройки QCode ослабляет политику только на время своего запуска и не меняет настройки пользователя и компьютера; чтобы новые сессии PowerShell тоже не блокировались, документация QCode даёт команду Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
npm падает с EACCES. Добавить sudo?
Нет. Anthropic прямо пишет, что sudo npm install -g использовать не следует: это ведёт к проблемам с правами и рискам безопасности; если вы ставили через npm и получаете ошибки прав, специфичные для npm, документация советует перейти на официальный установщик curl -fsSL https://claude.ai/install.sh | bash. Скрипту QCode sudo тоже не нужен: под sudo конфигурация запишется в домашнюю папку root, которую ваш терминал не читает, поэтому запустите скрипт заново без sudo.
Проверка скрипта QCode завершилась 401, 404 или таймаутом — что делать?
Смотрите на код ответа. По документации QCode, 401 — ключ недействителен или истёк: проверьте в панели, что префикс cr_ скопирован полностью, и запустите скрипт снова; 404 — неверный адрес: для Claude Code ANTHROPIC_BASE_URL должен иметь вид https://api.qcode.cc/api без завершающего слеша; при таймауте запустите снова с параметром --domain и выберите другой эндпоинт. Если скрипт сообщает, что конфигурация записана, но проверка не прошла, настройки уже на месте: устраните причину и запустите снова. Повторный запуск всегда безопасен: управляемый блок обновляется на месте, а файлы перед перезаписью копируются в резервную копию.
Источники
Способы установки, требования и обновления: страницы Advanced setup и Quickstart документации Claude Code (code.claude.com). Ошибки и решения: официальная страница Troubleshoot installation and login. Значение переменных: официальные страницы о переменных окружения и аутентификации. Версии: GitHub Releases и CHANGELOG репозитория anthropics/claude-code, метаданные пакета @anthropic-ai/claude-code в npm. Сторона QCode: страницы документации QCode о скрипте автонастройки и об установке (обе обновлены 2026-09-25) и исходник публичного скрипта claude-code.sh на qcode.cc (только чтение, не запускался). Всё загружено 2026-10-07.
Установить и подключить QCode одной командой
Подготовьте ключ cr_ и запустите скрипт автонастройки. Оплата по токенам, цены по моделям — на /models.
Читайте также
Руководство пользователя Claude Code
Полный курс от установки до уверенной работы.
Настройка ANTHROPIC_BASE_URL и AUTH_TOKEN
Как направить Claude Code на свой эндпоинт двумя переменными окружения.
Claude Code в Китае
Оплата через Alipay / WeChat Pay и шаги подключения.
Команды и цитаты на этой странице сверены 2026-10-07; приоритет у официальной документации Claude Code и документации QCode, изменения на стороне вендора возможны без предупреждения. Команды установки и тексты ошибок меняются от версии к версии, ориентируйтесь на свою версию; доступность моделей — по /models.