Як встановити Claude Code: повний гайд для всіх систем

Коротко (TL;DR)

Claude Code — це ІІ-агент від Anthropic на основі моделей Claude, який працює просто в терміналі та в редакторі коду: ви ставите завдання словами, а він читає файли проєкту, править їх і запускає команди. Щоб ним користуватися, програму потрібно один раз встановити. Встановлення Claude Code займає 10–15 хвилин і на всіх системах зводиться до однієї команди.

Що важливо знати перед стартом:

• Безкоштовного доступу немає. Потрібна підписка Claude Pro ($20/міс) або Max ($100–200/міс), або акаунт Claude Console з оплатою API за токенами. Безкоштовний тариф Claude.ai доступу до Claude Code не дає (станом на 9 липня 2026).
• Рекомендований спосіб — нативний інсталятор. Один рядок у терміналі, жодних додаткових програм. Метод через npm офіційно позначено як застарілий.
• IDE — за бажанням. Claude Code працює і в чистому терміналі. Розширення для VS Code та плагін для JetBrains додають панель чату всередині редактора, але це окремий, необов’язковий крок.

Нижче — як встановити Claude Code на Windows, macOS і Linux, як підключити його до VS Code та JetBrains, як увійти в акаунт і що робити, якщо після встановлення команда claude «не знайдена». Усі команди та вимоги звірені з офіційною документацією Anthropic станом на 9 липня 2026 (актуальна версія — v2.1.205).

Підготовка: акаунт і системні вимоги

Claude Code — це програма-агент (її ще називають CLI, від command-line interface — «інтерфейс командного рядка»). Вона запускається в терміналі — текстовому вікні, куди вводять команди: на macOS це застосунок «Термінал», на Windows — PowerShell, на Linux — будь-який емулятор термінала.

Який акаунт потрібен

Увійти в Claude Code можна з одним із варіантів доступу:

Як влаштовані ліміти Claude Code і як їх розтягнути

Як диктувати промпти та вставляти скріншоти в Claude Code

Як зробити сайт за допомогою Claude Code за 30 хвилин

Скільки коштує Claude Code і як оплатити підписку

Чому ШІ забуває й плутається в довгому діалозі: контекстне вікно простими словами

Одна підписка Pro або Max одразу відкриває і Claude у вебі/застосунку, і Claude Code в терміналі — це єдиний доступ. Окремі нюанси оплати та доступу з України розбираємо в гайді про підписку й оплату Claude Code.

Системні вимоги

Окрема третинна стаття вказувала macOS 12+ замість 13.0+ — це застаріле формулювання, офіційна сторінка вимог (звірено 9 липня 2026) називає мінімумом саме macOS 13.0.

Встановлення Claude Code на Windows

Встановлення Claude Code на Windows найпростіше проходить нативним інсталятором. Відкрийте PowerShell (натисніть «Пуск», почніть друкувати PowerShell, відкрийте застосунок) і виконайте одну команду:

irm https://claude.ai/install.ps1 | iex

Інсталятор завантажить бінарний файл і покладе його в папку C:\Users\ВашеІм'я\.local\bin. Після завершення перезапустіть PowerShell, щоб система «побачила» нову команду.

Міф про обов’язковий Git for Windows

У кількох свіжих гайдах за 2026 рік трапляється твердження: «на Windows спочатку обов’язково встановіть Git for Windows, інакше інсталятор впаде». Це неправда. За офіційною документацією (звірено 9 липня 2026) Git for Windows рекомендується, але не обов’язковий: з ним Claude Code використовує Bash як інструмент запуску команд, а без нього — просто перемикається на PowerShell. Встановлення і вхід працюють в обох випадках, тож новачку не варто лякатися зайвого кроку.

Native Windows, WSL2 чи WSL1

WSL (Windows Subsystem for Linux) — це вбудована в Windows можливість запускати Linux-оточення. Claude Code працює в усіх трьох режимах, але вони відрізняються за одним важливим пунктом — підтримкою пісочниці (sandboxing, ізоляції, у якій агент безпечніше виконує незнайомий код):

Висновок простий: якщо плануєте давати агенту автономно виконувати незнайомий код, ставте Claude Code всередині WSL 2. Для звичайної роботи «правимо свій проєкт» вистачить і нативного встановлення на Windows. Всередині WSL команда встановлення — як для Linux (див. нижче).

Є і альтернатива через менеджер пакетів WinGet — але він, на відміну від нативного інсталятора, не оновлюється автоматично (про це нижче, у розділі про оновлення).

Встановлення Claude Code на macOS

На macOS відкрийте «Термінал» і виконайте нативне встановлення — один рядок:

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

Бінарник потрапить у ~/.local/bin. Це той самий шлях, що й на Linux, тому і рішення типової помилки з PATH буде однаковим (див. розділ про помилки).

Другий варіант — Homebrew (популярний менеджер пакетів для macOS): brew install --cask claude-code. У Homebrew-версії є нюанс: вона не оновлюється сама, і для найсвіжішої збірки передбачено окремий cask. Точні назви cask’ів наведено на офіційній сторінці setup — якщо не користуєтеся Homebrew спеціально, беріть нативний інсталятор: він простіший і оновлюється автоматично.

Встановлення Claude Code на Linux

На Linux працює та сама нативна команда, що й на macOS:

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

Доступні й системні пакети через apt (Debian/Ubuntu), dnf (Fedora) та apk (Alpine) — точні команди і репозиторій Anthropic вказані на офіційній сторінці setup. Пам’ятайте: пакети з менеджерів не оновлюються автоматично, на відміну від нативного бінарника.

Alpine та інші musl-дистрибутиви потребують доустановити залежності вручну:

apk add libgcc libstdc++ ripgrep

і виставити в settings.json параметр USE_BUILTIN_RIPGREP у значення 0 — вбудований ripgrep (утиліта швидкого пошуку по коду) на musl не працює.

Метод через npm (застарілий, але іноді потрібен)

Раніше Claude Code часто ставили через npm — менеджер пакетів Node.js. Зараз офіційний README репозиторію прямо позначає цей спосіб як Deprecated (застарілий) на користь нативного інсталятора. Команда все ще працює:

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

Два важливих моменти:

• Node.js потрібен версії 22 і новіше — починаючи з v2.1.198. Багато сторонніх гайдів за березень–травень 2026 досі пишуть «Node 18+»: це застаріла цифра. На старому Node встановлення не впаде: npm видасть попередження EBADENGINE, але сама команда claude все одно запрацює — пакет ставить нативний бінарник, який під час роботи Node.js не використовує. Актуальна вимога >=22.0.0 підтверджується прямим запитом до реєстру npm (звірено 9 липня 2026), і оновити Node усе ж варто — заради чистого встановлення без зайвих попереджень.
• Навіщо він тоді потрібен. Розумних сценарії два: у вас уже налаштоване оточення Node і хочеться однаковості, або встановлення в CI (автоматичній збірці). У решті випадків нативний інсталятор кращий — він узагалі не тягне Node і оновлюється сам.

Перший запуск і вхід в акаунт

Після встановлення перейдіть у папку будь-якого проєкту і просто запустіть:

claude

Під час першого запуску відкриється браузер із вікном авторизації Anthropic — увійдіть під своїм акаунтом Pro/Max або Console, підтвердіть доступ, і термінал сам продовжить роботу. Змінити акаунт пізніше можна командою /login уже всередині сесії.

Ще один поширений міф — нібито для встановлення «обов’язково підключити GitHub». Це не так: GitHub потрібен лише для окремих функцій (наприклад, автоматичних перевірок коду в CI), але не для самого встановлення і не для входу. Не підключайте його, якщо він вам не потрібен, — на зайвому кроці легко застрягнути на порожньому місці.

VS Code: розширення Claude Code

Якщо ви працюєте в редакторі VS Code, до нього є розширення Claude Code — воно додає панель чату з агентом просто у вікно редактора. Що варто знати:

• Версія VS Code — 1.98.0 або новіша. API-ключ не потрібен: достатньо платної підписки (Pro, Max, Team, Enterprise) або акаунта Console.
• Встановлення — як у будь-якого розширення: відкрийте вкладку Extensions (Ctrl+Shift+X), знайдіть «Claude Code», натисніть Install.
• Тонкість про «розширення проти окремого CLI». Розширення VS Code містить власну вбудовану копію CLI для панелі чату — тобто чат запрацює і без окремого встановлення. Але якщо хочете запускати команду claude у вбудованому терміналі VS Code, standalone-CLI (той, що ставиться нативним інсталятором вище) все одно потрібен окремо. Простіше поставити нативний CLI одразу — тоді працюють обидва варіанти.

JetBrains: плагін Claude Code

Для середовищ розробки JetBrains є плагін Claude Code. Він підтримує більшість IDE родини: IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand.

Головна відмінність від VS Code: плагін JetBrains не містить CLI всередині себе. Він запускає команду claude у вбудованому терміналі IDE і підключається до неї — тому обидві частини потрібні обов’язково: спершу поставте нативний CLI (команда встановлення вище), потім плагін через Settings → Plugins → Marketplace → «Claude Code».

Граблі на WSL2. Якщо IDE стоїть у Windows, а Claude Code — всередині WSL2, плагін часто видає «No available IDEs detected». Причина — мережева ізоляція WSL2 (NAT) і брандмауер Windows. Лікується або ручним правилом у брандмауері, або увімкненням дзеркального режиму мережі (mirrored networking доступний у Windows 11 22H2 і новіших).

Перевірка встановлення

Переконатися, що встановлення Claude Code пройшло успішно, можна двома командами:

claude --version   # швидка перевірка: покаже номер версії
claude doctor      # детальна діагностика

claude doctor — недооцінений інструмент: він перевіряє конфігурацію, коректність PATH і результат останнього автооновлення однією командою. Якщо щось працює не так, починайте діагностику саме з нього.

Типові помилки і як їх виправити

Найчастіша проблема одразу після встановлення — Claude Code не запускається: термінал відповідає command not found: claude (macOS/Linux) або claude is not recognized (Windows). Причина майже завжди одна: нативний інсталятор кладе бінарник у ~/.local/bin, а цієї папки може не бути в PATH — списку каталогів, де система шукає команди.

Якщо жодне з рішень не спрацювало — запустіть claude doctor, він покаже, що саме не так із конфігурацією і шляхами.

Оновлення і видалення

Спосіб, яким ви поставили Claude Code, визначає, чи оновлюється він сам. Це ключовий момент, який майже ніде не зведено в одну таблицю:

Висновок: якщо не хочете думати про оновлення взагалі — ставте нативним інсталятором, він оновлюється сам.

Повне видалення нативного встановлення на macOS/Linux/WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
rm -rf ~/.claude && rm ~/.claude.json   # конфіги й налаштування

Важливий нюанс: папку ~/.claude/ пише не лише CLI, а й розширення VS Code, плагін JetBrains і десктоп-застосунок Claude. Якщо щось із них лишилося встановленим, каталог ~/.claude/ буде створено заново під час наступного запуску — видаляйте CLI та IDE-інтеграції разом, якщо хочете прибрати все.

Просунуті прийоми

Три речі понад базове встановлення, які стануть у пригоді, коли освоїтеся:

• Закріпити версію або канал оновлень. У settings.json є параметри autoUpdatesChannel (стабільний або свіжий канал) і minimumVersion — корисно в команді, щоб у всіх була однакова, перевірена збірка, а не «остання випадкова».
• Перевірити автентичність бінарника через GPG. Для параноїдальних чи корпоративних сценаріїв Anthropic публікує GPG-підпис інсталятора. Відбиток ключа для звірки — 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.
• Нестандартний шлях до Git на Windows. Якщо Git for Windows встановлено не в стандартну папку, вкажіть шлях до bash.exe через змінну середовища CLAUDE_CODE_GIT_BASH_PATH — тоді Claude Code знайде Bash-інструмент.

Ризики та запобіжні заходи

Встановлення Claude Code безпечне, але кілька моментів заслуговують на увагу — особливо якщо ви новачок.

• Команда curl … | bash (і irm … | iex) запускає скрипт з інтернету безпосередньо. Для офіційної адреси claude.ai/install.sh це норма, але беріть команду тільки з офіційної документації Anthropic — не з випадкових статей і не з чужих репозиторіїв. Підроблені «інсталятори Claude Code» — реальний ризик зараження системи.
• Агент виконує команди на вашому комп’ютері. За замовчуванням Claude Code запитує підтвердження перед діями. Але якщо плануєте дозволити йому автономно запускати незнайомий код (як це роблять більш самостійні термінальні агенти на кшталт OpenClaw), вмикайте пісочницю — тобто ставте Claude Code в WSL 2 на Windows. На нативному Windows ізоляції немає.
• Для корпоративних і параноїдальних сценаріїв — перевірка підпису. Має сенс звірити GPG-підпис інсталятора (відбиток — у розділі про просунуті прийоми), щоб переконатися, що бінарник справжній.

Жоден із цих ризиків не заважає звичайному встановленню — це запобіжні заходи на майбутнє, коли почнете давати агенту більше свободи.

FAQ

Чи можна користуватися Claude Code безкоштовно? Ні. Потрібна підписка Pro ($20/міс) або Max ($100–200/міс), або акаунт Console з оплатою API за токенами. Безкоштовний тариф Claude.ai доступу до Claude Code не відкриває (на 9 липня 2026).

Чи потрібно вміти програмувати, щоб встановити Claude Code? Ні. Встановлення — це одна команда в терміналі, скопіювати і вставити. Вміти писати код для самого встановлення не потрібно; агент якраз і потрібен, щоб допомагати тим, хто кодом володіє не глибоко.

Чи обов’язковий Git для встановлення на Windows? Ні. Git for Windows рекомендується (дає Bash-інструмент), але не обов’язковий: без нього Claude Code використовує PowerShell. Встановлення і вхід працюють і без Git.

Який спосіб встановлення обрати новачку? Нативний інсталятор (irm … на Windows, curl … на macOS/Linux). Він не вимагає Node.js, ставиться однією командою і оновлюється сам. Метод через npm офіційно застарів.

Claude Code не запускається після встановлення — що робити? Найімовірніше, папки ~/.local/bin немає в PATH. Додайте її командою з таблиці помилок вище під вашу систему і перезапустіть термінал. Якщо не допомогло — запустіть claude doctor.

Як оновити Claude Code? Нативне встановлення оновлюється саме. Для Homebrew, WinGet, apt/dnf/apk і npm потрібна ручна команда — див. таблицю оновлення вище.

Чим розширення VS Code відрізняється від плагіна JetBrains? Розширення VS Code містить вбудовану копію CLI для панелі чату (чат запрацює і без окремого встановлення). Плагін JetBrains CLI не бандлить — для нього нативний claude потрібно ставити окремо завжди.