Как проходит для Claude Code установка Ubuntu и других систем?

Что такое Claude Code и зачем он нужен в терминале?#

Для тех, кто пришёл в вайб-кодинг не из разработки, терминал часто выглядит непривычно. В действительности это окно со строкой для ввода команд. Claude Code использует её, чтобы просматривать и менять файлы, а также выполнять команды, пока вы описываете задачу словами.

Anthropic представляет продукт так:

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

Если работать в терминале не хочется, Anthropic предлагает приложение для компьютера с графическим интерфейсом и веб-версию на claude.ai/code. Наиболее гибкий вариант — Claude Code в терминале; ему и посвящена эта статья.

Где для Claude Code скачать установщик и нужно ли делать это вручную?#

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

Здесь нет привычной кнопки для скачивания установочного файла: нужная версия загружается самой командой установки с учётом операционной системы. Команды для Mac, Windows и Linux приведены ниже.

Название продукта часто вводят с опечатками: clode code, clade code, слод код, clode design. Правильное написание — Claude Code, с au. При поиске учитывайте, что похожие домены могут не принадлежать Anthropic.

Важно также правильно указывать имя пакета npm. Каноническое имя — @anthropic-ai/claude-code с префиксом @anthropic-ai/. Короткое имя claude-code без префикса Anthropic использует как указатель на тот же пакет. При установке проверяйте издателя Anthropic; в командах этой статьи указано полное имя пакета.

Что нужно, чтобы для Claude Code установка и настройка прошли успешно?#

Требования к компьютеру невысоки: запросы обрабатываются на серверах Anthropic, а устройство отправляет их и получает ответы.

Отдельно стоит разобраться с Node.js. Для рекомендуемого Anthropic нативного установщика он не нужен: устанавливается автономный файл. Node.js требуется при установке через npm, и нужна версия 22 или новее. Указание «Node 18 и выше» в старых инструкциях устарело — ориентируйтесь на 22+.

Терминал необходим для основной версии Claude Code. Если он вам не подходит, используйте приложение для компьютера с графическим интерфейсом или веб-версию claude.ai/code. Вариант для терминала предлагает наиболее широкий набор возможностей, поэтому далее рассматривается именно он.

Как проходит для Claude Code установка на Мак?#

Откройте приложение «Терминал», которое уже входит в macOS: вызовите Spotlight сочетанием Cmd+Space и введите «Терминал». Затем выполните команду:

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

Команда загружает установщик с официального адреса Anthropic и устанавливает Claude Code. Node.js не требуется. Кроме того, нативный установщик умеет обновлять программу автоматически.

Если Homebrew уже установлен, можно выбрать другой способ:

brew install --cask claude-code

Способы отличаются обновлением: нативный установщик обновляется автоматически, а Homebrew нужно обновлять вручную командой brew upgrade claude-code. Устанавливается одна и та же программа, поэтому выбирайте привычный вариант. Если сомневаетесь, используйте первый способ.

Как проходит для Claude Code установка на Windows?#

Сначала определите, какая оболочка открыта. В PowerShell начало строки обычно выглядит как PS C:\>, а в командной строке CMD — как C:\> без PS.

Для 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

Если вы работаете в WSL — среде Linux внутри Windows, — установите Claude Code непосредственно в WSL по инструкции для Linux. Особенность работы Node.js в WSL описана ниже, в разделе о частых ошибках.

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

Для популярных дистрибутивов подходит автономный нативный установщик:

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

Node.js не нужен: программа устанавливается одним файлом и затем обновляется автоматически.

Тем, кто предпочитает устанавливать программы через системный менеджер пакетов, доступны официальные репозитории Anthropic: apt для Debian и Ubuntu, dnf для Fedora и RHEL, apk для Alpine. Репозитории подписаны ключом и предлагают стабильный и свежий каналы. Для большинства начинающих проще использовать команду выше; подробные инструкции приведены в документации из списка источников.

На недорогих серверах установка может прерваться из-за нехватки свободной памяти. Сообщение Killed с кодом 137 означает, что система остановила процесс. Освободите или добавьте память подкачки (swap): для установки Claude Code требуется около 512 МБ свободной памяти.

Как впервые запустить Claude Code?#

Первый запуск обычно занимает несколько минут. Действуйте по шагам.

1. Откройте папку проекта

   В терминале перейдите в нужную папку командой cd путь-к-проекту, затем введите claude.

2. Войдите в аккаунт

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

3. Дождитесь подтверждения

   После входа терминал выведет Login successful и предложит нажать Enter.

4. Задайте первый вопрос

   Например, спросите: «Что делает этот проект?» Claude изучит файлы и ответит.

5. Подтвердите первое изменение

   Когда вы попросите внести правки, Claude покажет план изменений и запросит подтверждение. Режимы доступа переключаются сочетанием клавиш Shift+Tab.

Сразу запомните основные команды сессии: /help выводит список команд, /clear очищает историю разговора, а /exit завершает работу. Выйти также можно двойным нажатием Ctrl+D. Список команд доступен и через /help.

Войти по подписке или API-ключу: что выбрать?#

Это один из первых вопросов, который возникает при входе.

Есть два способа авторизации, различающихся способом оплаты.

Для входа по подписке используйте аккаунт Claude.ai. Для авторизации по API-ключу получите его в Claude Console (platform.claude.com); оплата будет списываться с предоплаченного баланса по мере использования. Если задать ключ в переменной окружения ANTHROPIC_API_KEY, Claude Code не будет при каждом запуске открывать браузер.

Сменить аккаунт в сессии можно командой /login, а выйти из него — командой /logout.

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

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

Полезно знать три команды.

Сначала проверьте версию:

claude --version

Если всё работает, команда выведет номер в формате X.Y.Z (Claude Code). Конкретные цифры зависят от версии; важно, чтобы появился номер. Сообщение «команда не найдена» означает, что нужно проверить PATH; решение приведено в следующем разделе.

Вторая команда нужна для диагностики:

Третья команда — /status внутри сессии: она показывает способ входа, связанную почту или организацию и состояние доступа. Команда claude update устанавливает обновление сразу, не дожидаясь автоматического обновления.

Почему после установки терминал не находит команду claude?#

Такая проблема встречается часто и обычно решается просто. Терминал ищет программы только в каталогах, указанных в PATH. Claude Code устанавливается по пути ~/.local/bin/claude на Mac и Linux или %USERPROFILE%\.local\bin\claude.exe на Windows. Если соответствующий каталог не входит в PATH, оболочка не сможет запустить программу.

На Mac и Linux добавьте каталог в PATH. Откройте файл настроек используемой оболочки: ~/.zshrc для Zsh или ~/.bashrc для Bash. Вставьте в конец файла строку:

export PATH="$HOME/.local/bin:$PATH"

Затем перезапустите терминал или выполните команду source ~/.zshrc. После этого команда claude должна распознаваться.

Частые ошибки при установке и первом запуске#

Ниже перечислены типичные ситуации из официального каталога ошибок Anthropic.

1. Старая версия Node.js при установке через npm. Для пакета @anthropic-ai/claude-code требуется Node.js версии 22 или новее. В Windows npm может сообщить о запрете запуска скриптов: это ограничение политики PowerShell. В WSL ошибка exec: node: not found может возникнуть, если среда использует Windows-версию Node.js вместо Linux-версии. Если установка через npm вызывает сложности, воспользуйтесь нативным установщиком — Node.js ему не нужен.
2. Команда не соответствует оболочке. Сообщение 'irm' is not recognized означает, что команда PowerShell введена в CMD. Ошибка The token '&&' is not a valid statement separator обычно говорит об обратном: команду CMD запустили в PowerShell. Сообщение A parameter cannot be found that matches parameter name 'fsSL' означает, что команду для Mac или Linux выполнили в PowerShell. Проверьте начало строки: PS C:\ обозначает PowerShell, C:\ — CMD.
3. Старый API-ключ имеет приоритет над подпиской. Если подписка активна, но в профиле сохранился прежний ключ, может появиться ошибка API Error: 400 ... This organization has been disabled. Переменная с ключом имеет приоритет при входе. Удалите её командой unset ANTHROPIC_API_KEY (в PowerShell — Remove-Item Env:ANTHROPIC_API_KEY), проверьте файлы ~/.zshrc и ~/.bashrc, затем выполните /status.
4. Недостаточно памяти на сервере. Если установка прекращается с сообщением Killed и кодом 137, вероятна нехватка оперативной памяти. Нужно около 512 МБ свободной памяти; добавьте swap.
5. Установщик получил неожиданный ответ. Ошибки syntax error near unexpected token '<' и упоминание <!DOCTYPE html> означают, что вместо установочного скрипта вернулась веб-страница. Возможные причины — региональные ограничения, корпоративный фаервол или временный сбой. Проверьте подключение и доступность официального сервиса; затем можно выбрать другой официальный способ установки, например Homebrew или WinGet, либо повторить попытку позднее.

При таких ошибках сначала выполните claude doctor: диагностика покажет, что проверить дальше.

Одинаковый ответ 403 при установке может также выдать корпоративный фаервол или прокси. Если вы подключены к офисной сети, проверьте, не блокирует ли она доступ.

Что делать после установки: первые шаги#

Установка только открывает доступ к инструменту. В новом разговоре языковая модель не знает контекст предыдущих сессий: она получает только сведения, переданные в текущий контекст.

Поэтому после установки можно добавить в корень проекта файл CLAUDE.md. Это текстовый файл с правилами и описанием проекта, который Claude Code читает при запуске. Укажите в нём, чем занимается проект, как он устроен и какие условия важно соблюдать — тогда эти сведения не придётся каждый раз вводить заново.

Пошаговая инструкция по персональной настройке Claude приведена в материале как настроить Claude под себя. Общая карта инструментов вайб-кодинга на 2026 год доступна здесь.

Какие вопросы задают чаще всего?#