Короткий виклад: 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 Subsystem for 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/ каталог | Особисті налаштування для всіх проектів |
| Проект | .claude/ у сховищі | Спільне налаштування команди |
| Локальний | .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` або відкрийте нове вікно терміналу.
Проблеми з мережею та брандмауером
Корпоративні мережі та обмежувальні брандмауери іноді блокують скрипт встановлення. Згідно з документацією з усунення несправностей, якщо встановлення зависає або повертає 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 працює в межах поточного робочого каталогу та його підкаталогів. Згідно з офіційною документацією щодо дозволів, доступ можна додатково обмежити за допомогою налаштувань sandbox у файлах конфігурації. 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 надає вичерпні посібники з розширених функцій після завершення базового налаштування.
