Краткое резюме: Claude Code CLI устанавливается с помощью одной команды, которая автоматически загружает и настраивает инструмент. Пользователи macOS и Linux используют официальный скрипт оболочки из документации Anthropic, а пользователи Windows запускают команды PowerShell или WSL. После установки аутентифицируйтесь с помощью своего API-ключа, чтобы начать использовать ИИ-помощника для написания кода Claude в вашем терминале.
Claude Code — это агентурный инструмент для написания кода, который работает в вашем терминале и понимает всю вашу кодовую базу. Согласно официальной документации Claude Code, он может читать файлы, выполнять команды, редактировать код и интегрироваться с инструментами разработки посредством естественного языка.
Однако для начала работы требуется правильная установка. Вот все, что необходимо для установки Claude Code CLI и его корректной настройки.
Системные требования перед установкой
Перед установкой Claude Code убедитесь, что система соответствует базовым требованиям. Согласно официальной документации по расширенной настройке, удалите это предложение полностью.
Проверьте установку Node.js, открыв терминал и выполнив:
| node –version |
Если Node.js не установлен или версия ниже 18, загрузите его с официального сайта Node.js. Версия с долгосрочной поддержкой (LTS) отлично подходит для Claude Code.
Помимо Node.js, система должна соответствовать базовым требованиям: macOS 13.0 или выше для пользователей Mac, Windows 10 или выше для систем Windows, и большинство современных дистрибутивов Linux работают без проблем. Также для аутентификации после установки требуется учетная запись Claude от Anthropic.
Установка Claude Code на macOS и Linux
Процесс установки на macOS и Linux использует одну команду оболочки, которая автоматически обрабатывает все. Этот метод документирован в официальном руководстве по быстрому запуску Claude Code.
Откройте Терминал и выполните установочный скрипт:
| curl -fsSL claude.ai/install.sh | bash |
Скрипт загружает бинарный файл Claude Code, помещает его в нужный каталог и автоматически настраивает PATH. Весь процесс обычно занимает менее минуты.
Для пользователей macOS, предпочитающих Homebrew, существует альтернативный метод установки, хотя он официально не документирован в основных источниках. Метод curl остается рекомендуемым подходом согласно официальной документации.
Проверка установки
После завершения установки убедитесь, что Claude Code доступен:
| claude –version |
Эта команда должна отобразить номер установленной версии. Если появится ошибка "command not found", потребуется корректировка конфигурации PATH.
Согласно официальной документации по устранению неполадок, проблемы с PATH являются наиболее распространенной проблемой при установке. Исправление заключается в добавлении каталога установки Claude в файл конфигурации оболочки.
Установка Claude Code на macOS и Linux
Процесс установки на macOS и Linux использует npm (Node Package Manager). Согласно официальной документации, перед началом работы в вашей системе должен быть установлен Node.js 18+. В отличие от традиционных CLI-инструментов, использующих скрипты оболочки, Claude Code устанавливается глобально через терминал, чтобы обеспечить корректную обработку всех зависимостей.
Откройте ваш Терминал и выполните следующую команду для установки пакета:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Примечание: Переменная среды CLAUDE_CODE_RELEASE_ALPHA=1 в настоящее время требуется во время публичной бета-версии/альфа-фазы для признания статуса предварительной версии инструмента.
Эта команда загружает пакет из официального реестра npm и связывает исполняемый файл claude с глобальным каталогом bin вашей системы. Хотя некоторые пользователи могут пытаться найти формулы Homebrew, метод npm является единственным официально поддерживаемым и документированным путем установки.
Проверка установки
После завершения установки убедитесь, что CLI правильно сопоставлена с вашей средой, выполнив:
| claude –version |
Эта команда должна отобразить текущий номер версии (например, 0.2.9). Если вы столкнулись с ошибкой "command not found", это обычно означает, что ваш глобальный каталог npm не находится в PATH вашей системы.
Согласно официальной документации по устранению неполадок, вы можете исправить это, определив ваш npm prefix с помощью npm config get prefix и убедившись, что результирующий каталог /bin добавлен в ваш файл .zshrc или .bashrc.
Установка Claude Code в Windows
Установка в Windows предлагает два основных подхода: нативная установка через PowerShell или использование подсистемы Windows для Linux (WSL). Официальная документация рекомендует PowerShell для большинства пользователей.
Метод установки через PowerShell
Откройте PowerShell от имени администратора (щелкните правой кнопкой мыши по меню "Пуск" и выберите "Windows PowerShell (администратор)"). Выполните эту команду:
| irm claude.ai/install.ps1 | iex |
Скрипт PowerShell автоматически выполняет загрузку, установку и настройку PATH. После завершения закройте и снова откройте PowerShell, чтобы изменения PATH вступили в силу.
Метод установки через WSL
Разработчики, уже использующие WSL, могут установить Claude Code, используя метод установки для Linux. Откройте терминал WSL и выполните ту же команду curl, что и для Linux:
| curl -fsSL claude.ai/install.sh | bash |
Подход WSL работает идентично нативным установкам Linux. Одно из преимуществ: WSL предоставляет среду, более близкую к Unix, которая соответствует конфигурациям серверных сред.
Согласно официальной документации по устранению неполадок, пользователи WSL иногда сталкиваются с проблемами сетевого подключения. Если установка зависает, убедитесь, что WSL имеет доступ к внешним сетям и правила брандмауэра не блокируют трафик.
Найдите кредиты для Claude и ИИ-инструментов в одном месте
Установка Claude Code CLI — это первый шаг. Оплата ИИ-инструментов в долгосрочной перспективе — это другое. Get AI Perks собирает стартовые кредиты и скидки на программное обеспечение для ИИ и облачных инструментов в одном месте. Это дает основателям доступ к более чем 200 предложениям, включая предложения от Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom и других. Платформа также показывает условия предложений и руководства по их получению.
Ищете кредиты для Claude или Anthropic?
Проверьте Get AI Perks, чтобы:
- найти кредиты и скидки на ИИ-инструменты в одном месте
- просмотреть условия предложений перед подачей заявки
- получить доступ к руководствам по получению стартовых предложений
👉 Посетите Get AI Perks, чтобы просмотреть доступные предложения для Claude, Anthropic и других программных продуктов для ИИ.
Аутентификация и первоначальная настройка
После установки Claude Code требует аутентификации, прежде чем он сможет функционировать. Инструмент использует API-ключи от Anthropic для проверки доступа.
Запустите процесс аутентификации, выполнив:
| claude |
При первом запуске этой команды Claude Code запрашивает аутентификацию. Согласно официальному руководству по быстрому запуску, это открывает окно браузера для входа в учетную запись Anthropic.
После входа через браузер CLI автоматически получает токен аутентификации. Этот токен хранится локально и сохраняется между сессиями, поэтому повторная аутентификация не требуется.
Настройка параметров на уровне проекта
Claude Code поддерживает настройку на нескольких уровнях в соответствии с официальной документацией по настройкам. Наиболее распространенные уровни настройки:
| Область | Местоположение | Сценарий использования |
|---|---|---|
| Пользователь | ~/.claude/ directory | Персональные предпочтения для всех проектов |
| Проект | .claude/ in repository | Общая конфигурация команды |
| Локальный | .claude/settings.local.json | Переопределения для конкретной машины |
Для первоначальной настройки достаточно конфигурации на уровне пользователя. Параметры на уровне проекта становятся важными при работе с командами, которые используют общие стандарты кодирования.
Начало первой сессии Claude Code
После завершения установки и аутентификации запустите Claude Code, выполнив команду без аргументов:
| claude |
Это запускает интерактивный режим, где Claude отвечает на запросы на естественном языке. Официальная документация описывает интерактивный режим как основной способ использования Claude Code для задач разработки.
Попробуйте простую тестовую команду:
| Покажи мне структуру этого проекта |
Claude Code анализирует текущий каталог и предоставляет обзор структуры кодовой базы. Это демонстрирует, что установка работает корректно и Claude имеет доступ к чтению файлов.
Основные команды для ежедневного использования
Помимо интерактивного режима, Claude Code поддерживает несколько шаблонов команд, задокументированных в справочнике CLI:
| Шаблон команды | Назначение | Пример |
|---|---|---|
| claude | Запуск интерактивной сессии | claude |
| claude “задача” | Выполнение одноразовой задачи | claude “исправить ошибки линтинга” |
| claude -p “запрос” | Быстрый запрос без сессии | claude -p “что делает эта функция” |
Шаблон одноразовой задачи особенно полезен для конвейеров CI/CD и скриптов автоматизации, где интерактивная сессия не подходит.
Распространенные проблемы при установке
Даже с автоматизированными установочными скриптами иногда возникают проблемы. Официальная документация по устранению неполадок охватывает наиболее частые проблемы.
Ошибки "Command Not Found"
Если после установки в терминале отображается сообщение "command not found: claude", значит, конфигурация PATH не была завершена корректно. Для macOS и Linux добавьте местоположение бинарного файла Claude в файл конфигурации оболочки вручную.
Для пользователей bash отредактируйте ~/.bashrc или ~/.bash_profile и добавьте:
| export PATH=”$HOME/.local/bin:$PATH” |
Для пользователей zsh (по умолчанию в современных macOS) отредактируйте ~/.zshrc с той же строкой. После сохранения перезагрузите конфигурацию с помощью source ~/.zshrc или откройте новое окно терминала.
Проблемы с сетью и брандмауэром
Корпоративные сети и restrictive брандмауэры иногда блокируют установочный скрипт. Согласно документации по устранению неполадок, если установка зависает или возвращает HTML вместо выполнения, возможно, заблокирован сетевой доступ к серверам Anthropic.
Обходной путь включает загрузку установочного скрипта отдельно:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Этот подход обеспечивает большую наглядность того, что выходит из строя, если возникают ошибки во время загрузки или выполнения.
Проблемы, специфичные для WSL
Пользователи Windows, использующие WSL, иногда сталкиваются с проблемами подключения между подсистемой Linux и Windows. Официальная документация упоминает, что правила брандмауэра могут потребовать корректировки для разрешения трафика WSL.
Если Claude Code успешно устанавливается, но не может связаться с серверами Anthropic для аутентификации, убедитесь, что брандмауэр Windows разрешает сетевой доступ WSL. Руководство по устранению неполадок содержит конкретные команды PowerShell для настройки правил брандмауэра.
Обновление Claude Code
Claude Code регулярно обновляется новыми функциями и улучшениями. Согласно официальной документации, обновления устанавливаются с использованием той же команды, что и первоначальная установка.
Снова выполните установочный скрипт:
| curl -fsSL code.anthropic.com/install.sh | sh |
Скрипт обнаруживает существующую установку и обновляет ее до последней версии. Никакая конфигурация или аутентификация не теряется в процессе обновления.
Проверьте текущую версию до и после обновления:
| claude –version |
Журнал изменений в официальной документации Claude Code содержит список всех изменений между версиями, что помогает определить, вводит ли обновление функции, имеющие отношение к конкретным рабочим процессам.
Следующие шаги после установки
После установки и настройки Claude Code становится возможным изучение расширенных функций. Официальная документация описывает несколько областей, заслуживающих внимания:
- Навыки и настройка: Согласно официальной документации по навыкам, Claude Code поддерживает пользовательские навыки, определяемые в файлах Markdown в каталоге .claude/skills/. Эти навыки расширяют возможности Claude с помощью команд и рабочих процессов, специфичных для проекта.
- Протокол контекста модели (MCP): Интеграция MCP позволяет Claude Code подключаться к внешним инструментам и службам. Это превращает Claude в центр, который может получать доступ к базам данных, API и другим ресурсам разработки.
- Командная работа: Файлы конфигурации на уровне проекта в каталоге .claude/ могут быть зафиксированы в системе контроля версий, разделяя настройки Claude Code между всеми командами разработчиков.
- Официальная документация содержит подробные руководства по каждой из этих областей, опираясь на базовую установку, описанную здесь.
Часто задаваемые вопросы
Нужна ли мне платная подписка Claude для использования Claude Code CLI?
Claude Code требует учетной записи Claude от Anthropic, но необходимый уровень подписки зависит от использования. Согласно официальной документации, аутентификация необходима, но детали ценообразования следует проверять на официальном сайте Anthropic, так как планы со временем меняются.
Могу ли я установить Claude Code без прав администратора?
На macOS и Linux Claude Code по умолчанию устанавливается в домашний каталог пользователя и не требует прав администратора. Пользователям Windows могут потребоваться права администратора для метода установки через PowerShell, хотя установки WSL не требуют прав администратора.
Работает ли Claude Code офлайн?
Нет. Claude Code — это инструмент на базе ИИ, который общается с серверами Anthropic для обработки запросов. Согласно официальной документации, для анализа кода и генерации ответов Claude требуется активное подключение к Интернету.
Как удалить Claude Code?
В официальной документации по расширенной настройке объясняется, что удаление включает в себя удаление бинарного файла и файлов конфигурации. На macOS и Linux удалите каталог ~/.claude и уберите модификацию PATH из файлов конфигурации оболочки. Пользователям Windows следует удалить каталог установки и очистить переменную среды PATH.
Может ли Claude Code получить доступ ко всей моей файловой системе?
По умолчанию Claude Code работает в пределах текущего рабочего каталога и его подкаталогов. Согласно официальной документации по правам доступа, доступ может быть дополнительно ограничен с использованием настроек песочницы в файлах конфигурации. Claude всегда запрашивает подтверждение перед выполнением потенциально разрушительных операций.
В чем разница между Claude Code CLI и Claude Desktop?
Claude Code CLI работает в терминале и фокусируется на рабочих процессах разработки с прямым доступом к файловой системе и выполнением команд. Claude Desktop — это отдельное приложение с графическим интерфейсом. Оба инструмента служат для разных целей, CLI оптимизирован для разработчиков, которые предпочитают рабочие процессы в терминале.
Как часто следует обновлять Claude Code?
Обновления можно устанавливать, когда это удобно. Официальный журнал изменений документирует новые функции и исправления ошибок. Для команд согласование обновлений гарантирует, что все используют совместимые версии, хотя Claude Code поддерживает обратную совместимость с файлами конфигурации между версиями.
Заключение
Установка Claude Code CLI занимает всего несколько минут независимо от операционной системы. Автоматизированные установочные скрипты обрабатывают настройку, настройку PATH и размещение бинарных файлов без ручного вмешательства.
После установки и аутентификации Claude Code становится мощным ИИ-помощником для написания кода, доступным из любого терминала. Команды на естественном языке позволяют разработчикам писать код, исправлять ошибки и автоматизировать задачи, не покидая командной строки.
Готовы испытать разработку с помощью ИИ? Выполните команду установки для вашей платформы и начните свою первую сессию Claude Code сегодня. Официальная документация на code.claude.com содержит исчерпывающие руководства по расширенным функциям после завершения базовой настройки.
