Короткий виклад: Встановлення Claude Code на Windows вимагає налаштування WSL2 (Підсистема Windows для Linux), встановлення Ubuntu та запуску простого сценарію встановлення. Цей процес дозволяє користувачам Windows отримати доступ до помічника зі створення коду на базі ШІ від Anthropic через їхній термінал. Доступні нативні бінарні файли для Windows, однак WSL2 все ще є найкращою практикою для встановлення на Windows.
Claude Code — це помічник зі створення коду на базі ШІ, який працює безпосередньо в терміналі, допомагаючи розробникам створювати функції, виправляти помилки та автоматизувати завдання розробки. Але для користувачів Windows є нюанс.
Claude Code доступний як нативний виконуваний файл для Windows і може бути встановлений через npm або пряме завантаження бінарного файлу без WSL2. Однак він вимагає Підсистеми Windows для Linux (WSL2), і офіційний метод встановлення досі спирається на WSL2.
Ось як це налаштувати на Windows 11 або Windows 10.
Системні вимоги
Перед початком встановлення переконайтеся, що комп’ютер з Windows відповідає цим вимогам:
- Windows 10 1809+ або Windows Server 2019+
- Windows 11 (будь-яка версія)
- Принаймні 4 ГБ оперативної пам’яті
- Адміністративні права в системі
- Підключення до Інтернету для завантаження WSL2 та Ubuntu
Для встановлення потрібен дисковий простір для WSL2, Ubuntu та Claude Code.
Крок 1: Увімкніть Підсистему Windows для Linux
WSL2 надає середовище Linux безпосередньо в Windows. Це основа, яка дозволяє Claude Code працювати.
Відкрийте PowerShell від імені адміністратора. Клацніть правою кнопкою миші на кнопку "Пуск" і виберіть "Windows PowerShell (Адміністратор)" або "Термінал (Адміністратор)" у Windows 11.
Виконайте цю команду:
wsl –install
Ця команда вмикає необхідні функції Windows і встановлює Ubuntu як дистрибутив Linux за замовчуванням. Система, ймовірно, запропонує перезавантажити.
Після перезавантаження WSL2 автоматично завершить налаштування. Ubuntu запуститься і попросить ввести ім’я користувача та пароль. Ці облікові дані призначені лише для середовища Linux — вони не повинні збігатися з обліковими даними Windows.
Крок 2: Перевірте встановлення WSL2
Після перезавантаження системи та завершення початкового налаштування Ubuntu перевірте, чи WSL2 працює належним чином.
Відкрийте термінал Ubuntu (шукайте "Ubuntu" у меню "Пуск") і виконайте:
wsl –version
Це відобразить інформацію про версію WSL. Шукайте "WSL version: 2.x.x" у виводі.
Якщо команда показує WSL1, оновіть до WSL2 за допомогою:
wsl –set-default-version 2
Крок 3: Встановіть Claude Code
Тепер перейдемо до фактичного встановлення Claude Code. Офіційна документація надає однорядковий сценарій встановлення.
У терміналі Ubuntu виконайте:
curl -fsSL claude.ai/install.sh | bash
Сценарій завантажує бінарний файл Claude Code, налаштовує необхідні дозволи та додає його до системного PATH. Тривалість встановлення залежить від швидкості інтернету та специфікацій системи.
Згідно з офіційною документацією Claude Code, інсталятор автоматично визначає архітектуру системи та завантажує відповідну версію бінарного файлу.
Поширені проблеми встановлення
Деякі користувачі Windows повідомляють про появу повідомлення "command not found: claude" після встановлення. Це зазвичай трапляється через те, що змінна PATH не оновилася.
Закрийте та знову відкрийте термінал Ubuntu, а потім спробуйте ще раз. Якщо проблема не зникає, це налаштування шляху може допомогти як неофіційний обхідний шлях:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”’ >> ~/.bashrc
source ~/.bashrc
Крок 4: Автентифікуйте Claude Code
Claude Code вимагає автентифікації за допомогою облікового запису Anthropic перед використанням.
Виконайте цю команду:
claude
У терміналі відобразиться URL-адреса та запит на автентифікацію. Процес трохи відрізняється для індивідуальних користувачів та командних облікових записів:
| Тип облікового запису | Метод автентифікації | Що потрібно |
|---|---|---|
| Індивідуальний | Особистий ключ API | Обліковий запис Anthropic з доступом до API |
| Команда/Організація | Токен організації | Токен автентифікації, наданий адміністратором |
Відкрийте наданий URL-адресу в браузері, увійдіть до облікового запису Anthropic та авторизуйте Claude Code. Термінал підтвердить успішну автентифікацію.
Робота з проектами Windows у WSL2
Ось де все стає складніше. Файлові системи Windows та WSL2 є окремими.
Файли Windows доступні з WSL2 за шляхом /mnt/c/ (для диска C:), /mnt/d/ (для диска D:) тощо. Але це пов’язано з втратою продуктивності. Обговорення в спільноті вказують на відмінності у продуктивності між каталогами, змонтованими з Windows, і рідними каталогами WSL2.
Для найкращої продуктивності скопіюйте файли проекту до домашнього каталогу WSL2:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Компроміс? Інтеграція IDE стає складнішою. Visual Studio Code добре справляється з цим за допомогою розширення Remote-WSL, але інші IDE можуть мати труднощі.
Тестування встановлення
Перевірте, чи Claude Code працює належним чином, простим тестом.
Перейдіть до каталогу проекту (або створіть тестову папку):
mkdir ~/claude-test
cd ~/claude-test
claude “створити простий Python-скрипт hello world”
Claude Code повинен відповісти, створити файл і відобразити код. Це підтвердить успішне встановлення.
Перестаньте переплачувати, спочатку отримайте доступні кредити ШІ
Встановлення Claude Code на Windows зазвичай відбувається швидко. Реальна вартість з’являється пізніше, коли розробники починають тестувати запити, запускати сценарії та інтегрувати модель у програми. Цей етап експериментів може генерувати багато викликів API, і багато команд усвідомлюють витрати лише після початку розробки.
Перш ніж витрачати гроші на використання, варто перевірити, чи ви маєте право на отримання кредитів ШІ або партнерських програм. Get AI Perks збирає ці можливості в одному місці, перераховуючи кредити та знижки від постачальників ШІ, хмарних платформ та інструментів для розробників, а також надає прості інструкції щодо їх отримання.
Перед запуском першого проекту Claude Code перевірте Get AI Perks та отримайте кредити ШІ, які можуть покрити ваші витрати на розробку.
Часті запитання
Чи може Claude Code працювати нативно на Windows без WSL2?
Так, але WSL2 все ще залишається найкращим методом встановлення для Windows.
Чи працює Claude Code з терміналом Windows?
Так. Термінал Windows може відкривати вкладки Ubuntu, забезпечуючи доступ до Claude Code без перемикання на окреме вікно Ubuntu. У терміналі Windows натисніть стрілку спадного меню та виберіть Ubuntu зі списку профілів.
Чи працюватимуть мої існуючі інструменти розробки Windows з Claude Code?
Це залежить від інструменту. Visual Studio Code добре інтегрується через розширення Remote-WSL. IDE JetBrains та інші інструменти можуть вимагати додаткового налаштування. Офіційна документація згадує VS Code та JetBrains як підтримувані платформи.
Як оновити Claude Code на Windows?
Claude Code оновлюється автоматично за замовчуванням. Для ручного оновлення виконайте claude update у терміналі Ubuntu. Функція автоматичного оновлення може бути вимкнена через конфігураційні файли, якщо це потрібно для корпоративних середовищ.
Яка різниця між Claude Code та API Claude?
Claude Code — це помічник зі створення коду на базі терміналу, який виконує команди та редагує файли. API Claude надає програмний доступ до мовної моделі Claude для створення власних програм. Вони виконують різні функції та вимагають різних процесів налаштування.
Чи можу я використовувати Claude Code з проектами .NET на Windows?
Так, але з застереженнями. Обговорення в спільноті вказують на те, що підтримка .NET SDK у WSL2 працює, але вимагає встановлення версії .NET SDK для Linux всередині Ubuntu. .NET, встановлений у Windows, не буде доступний з WSL2.
Скільки коштує Claude Code?
Ціни залежать від використання та типу облікового запису. Перевірте офіційний веб-сайт Anthropic для актуальних тарифних планів та командних пакетів, оскільки витрати варіюються залежно від споживання API та вимог організації.
Наступні кроки після встановлення
Після встановлення Claude Code почніть досліджувати його можливості. Документація по швидкому початку роботи рекомендує почати з простих завдань, таких як пояснення коду, перш ніж переходити до більш складних операцій.
Спробуйте ці команди, щоб ознайомитися:
- claude “поясни цю функцію” – Отримайте пояснення коду
- claude commit – Генеруйте повідомлення комітів Git
- claude -c – Продовжити останню розмову
Офіційна документація надає детальні посібники з інтеграції IDE, встановлення плагінів та розширених параметрів конфігурації. Для команд серверне керування налаштуваннями та відстеження аналітики пропонують додатковий контроль над розгортанням Claude Code.
Налаштування WSL2 може здатися додатковими кроками порівняно з нативними програмами Windows, але це на даний момент єдиний шлях для запуску Claude Code на Windows. Хороша новина? Після налаштування він працює безперебійно та інтегрується з більшістю робочих процесів розробки.
