Перед початком роботи
Claude Code працює у терміналі вашого комп'ютера — це вікно, куди ви вводите команди. Вам також знадобиться платний план Claude (Pro або Max), бо безкоштовний тариф не включає Claude Code.
Хороша новина: з офіційним інсталятором вам не потрібно встановлювати Node.js. Це робиться однією командою.
Одне, що потрібно зробити першим, якщо ви на Windows: Claude Code потребує безкоштовний інструмент Git for Windows для роботи (він використовує його у фоновому режимі — вам не потрібно вивчати або використовувати Git самостійно). Якщо ви на Windows і ще не маєте його, встановіть його перед продовженням:
Перейдіть на git-scm.com/downloads/win і завантажте інсталятор.
Запустіть інсталятор. Натискайте "Next" на кожному екрані, щоб прийняти налаштування за замовчуванням — вам нічого не потрібно змінювати, хоча екранів кілька.
Якщо запитає, який редактор використовувати, залиште стандартний і натисніть "Next".
Коли дійдете до екрану "Adjusting your PATH environment", залиште вибраний варіант.
Не впевнені, чи у вас вже є Git? Встановіть його все одно — перевстановлення не спричинить проблем. Користувачі Mac можуть пропустити цей крок, нічого додаткового не потрібно.
Крок 1 — Відкрийте термінал
Відкрийте термінал на своєму комп'ютері. Спосіб залежить від вашої системи:
Windows 10: Натисніть клавіші Windows + R, введіть
cmdі натисніть Enter. Відкриється Командний рядок.Windows 11: Натисніть на рядок пошуку на панелі завдань (або натисніть клавішу Windows), введіть
Terminalі натисніть "Термінал" у результатах. Або ж клацніть правою кнопкою миші на кнопку "Пуск" і виберіть "Термінал".Mac: Натисніть Cmd + Пробіл, щоб відкрити Spotlight, введіть
Terminalі натисніть Enter.
З'явиться вікно з порожнім рядком, куди ви можете вводити текст. Саме сюди слід вводити всі команди нижче.
Крок 2 — Запустіть інсталятор
Скопіюйте команду для вашої системи, вставте її в термінал і натисніть Enter.
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11 (та Windows 10, що використовують Terminal/PowerShell):
irm https://claude.ai/install.ps1 | iex
Windows 10 (якщо ви відкрили Командний рядок за допомогою cmd у Кроці 1):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Ви побачите, як з'являється багато тексту, поки процес виконується. Коли він завершиться, ви побачите повідомлення про успішне встановлення Claude Code. Якщо натомість з'явиться помилка, перевірте розділ "Вирішення проблем" унизу.
Крок 3 — Відкрийте нове вікно терміналу
Цей крок легко пропустити, але він важливий. Повністю закрийте вікно терміналу та відкрийте нове (тим самим методом, що й у Кроці 1).
Інсталятор додає Claude Code до вашої системи, але термінал помічає зміни, лише коли ви запускаєте нове вікно. Пропуск цього кроку є найчастішою причиною того, що наступний крок здається "неробочим".
Крок 4 — Запустіть Claude Code та увійдіть
У новому вікні терміналу введіть:
claude
Під час першого запуску вас запитають, як ви хочете увійти. Виберіть увійти за допомогою свого облікового запису Claude (не за API-ключем). Відкриється вікно браузера, де ви зможете ввійти до свого облікового запису Claude. Після входу ви можете повернутися до терміналу — ваша підписка Pro або Max тепер працюватиме в Claude Code.
Ось і все. Тепер ви можете вводити запитання або команди безпосередньо в терміналі.
Вирішення проблем
Кроки встановлення однакові на всіх системах, але якщо щось піде не так, виправлення може відрізнятися залежно від того, що ви використовуєте. Ось найпоширеніші проблеми.
"claude is not recognized" або "command not found" після встановлення
Це майже завжди означає, що ви пропустили Крок 3. Повністю закрийте термінал, відкрийте абсолютно нове вікно і знову введіть claude. Термінал розпізнає нововстановлені команди лише під час запуску нової сесії.
Windows: "irm is not recognized" (ви перебуваєте в Командному рядку, а не PowerShell)
Якщо команда irm видає помилку "is not recognized as an internal or external command", це означає, що ви перебуваєте в Командному рядку (CMD), а не в PowerShell. Ви можете розрізнити, де саме знаходитесь, подивившись на початок рядка: PowerShell показує PS C:\..., а Командний рядок — просто C:\....
Натомість використовуйте версію команди для Командного рядка:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10: "Could not create SSL/TLS secure channel"
Це може статися на старих системах Windows 10. У PowerShell спочатку виконайте рядок нижче, а потім знову запустіть команду інсталятора:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows: "Claude Code on Windows requires git-bash"
Це означає, що Git for Windows не встановлено (або Claude Code не може його знайти). Поверніться до розділу "Перед початком роботи" вище та встановіть Git for Windows, потім закрийте термінал, відкрийте новий і знову запустіть claude.
Mac: повідомлення про безпеку або "дозвіл"
Оскільки офіційний інсталятор розміщує Claude Code у папці, що належить вам (у вашій домашній директорії), помилок дозволів, які спричиняли старі методи встановлення, тут не виникає. Якщо ваш Mac показує спливаюче вікно безпеки під час першого запуску claude, повідомляючи, що не вдалося перевірити програму, відкрийте Системні налаштування → Конфіденційність і безпека, прокрутіть вниз до повідомлення про claude та натисніть Дозволити в будь-якому випадку. Потім запустіть claude знову в терміналі.
Все ще застрягли?
Після встановлення ви можете виконати цю команду, щоб Claude Code перевірив себе та вказав на проблеми:
claude doctor
Він перевірить вашу інсталяцію та типові налаштування і зазвичай прямо вказує, що потрібно виправити.