Серія посібників Claude Code 5: Як встановити Claude Code?

Як встановити Claude Code

Встановлення Claude Code не має графічного інтерфейсу з кнопкою "Далі" — все робиться через командний рядок. Якщо ви звикли до npm, весь процес займе не більше двох хвилин.

Передумови

Перед початком переконайтеся, що у вас є:

Node.js 18 або новіша версія
Перевірка: виконайте node -v в терміналі. Якщо версія нижча за 18, оновіть за допомогою nvm, fnm або завантажте з nodejs.org.
Акаунт Anthropic
Зареєструйтеся на https://console.anthropic.com. Акаунт надасть API-ключ, який знадобиться після встановлення. Реєстрація безкоштовна, оплата за використання.
Доступ до API Anthropic через мережу
За замовчуванням домен — api.anthropic.com. Якщо потрібен проксі, налаштуйте змінні HTTP_PROXY або HTTPS_PROXY в терміналі.

Спосіб встановлення 1: глобальне встановлення через npm

Це найпоширеніший спосіб — встановлюєте один раз і використовуєте будь-де.

npm install -g @anthropic-ai/claude-code

Після завершення виконайте claude --version. Якщо з'явиться номер версії, встановлення успішне. Після глобального встановлення команду claude можна викликати з будь-якої директорії.

Якщо виникають помилки прав доступу (поширено на macOS через /usr/local/lib), є два варіанти:

Використати sudo для встановлення (просто, але є питання безпеки).
Налаштувати npm на використання домашньої директорії, щоб уникнути sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Потім додати ~/.npm-global/bin до PATH і перезапустити термінал.

Спосіб встановлення 2: використання npx без встановлення

Якщо ви не хочете нічого встановлювати глобально або просто хочете тимчасово спробувати, скористайтеся npx.

npx @anthropic-ai/claude-code

npx тимчасово завантажить останній пакет, запустить його і не залишить глобальної команди. Кожен раз перевіряє оновлення, тому завжди використовується найновіша версія. Недолік: трохи повільніше (щоразу завантаження) і не підходить для частих викликів у скриптах.

Підходить для: першого знайомства, тимчасового використання на чужому комп'ютері або рідкісного використання.

Перевірка запуску

Після встановлення не поспішайте з автентифікацією. Виконайте просту команду, щоб переконатися, що інструмент працює:

claude --help

Якщо з'явиться довідкова інформація, значить бінарний файл працює. Потім підключіть акаунт — про це в наступних розділах.

Обидва способи встановлення дають однакову програму, подальша автентифікація та використання ідентичні. Вибирайте, який зручніше.

Поширені питання

Занадто низька версія Node
Якщо версія нижче 18, виникне помилка, а не попередження. Оновіть Node — найпростіше рішення.
Тайм-аут мережі
Як завантаження пакетів npm, так і подальше підключення до API можуть блокуватися проксі чи брандмауером. Спочатку переконайтеся, що curl https://api.anthropic.com працює.
Використання оригінального cmd у Windows
Теоретично можливо, але рекомендується Git Bash, WSL2 або Windows Terminal, щоб уникнути проблем з екрануванням шляхів.