LearnAi

Як встановити Claude Code на Windows: покроково

Claude Code на Windows ставиться разом із застосунком Claude: підписка, Git for Windows, вкладка Code і перша сесія — без жодної команди в терміналі.

Редакція LearnAi11 хв читання

Claude Code на Windows більше не треба ставити командою в терміналі. Він приїжджає разом із застосунком Claude для компʼютера і відкривається у вкладці Code. Потрібні три речі: платна підписка, Git for Windows і сам застосунок. Далі ви вибираєте папку, пишете завдання звичайною мовою й дивитеся, що агент пропонує змінити.

Ця інструкція написана для читача без досвіду роботи в терміналі. Якщо ви поки не розумієте, навіщо вам агент, спершу прочитайте, що таке Claude Code простими словами, а потім повертайтеся сюди.

Порядок дій такий: оформити платну підписку, поставити Git for Windows, поставити застосунок Claude, увійти в акаунт, відкрити вкладку Code, вибрати папку проєкту й написати завдання. Жодної команди набирати не доведеться: Node.js, npm і WSL зі старих гайдів для цього шляху не потрібні. Найчастіші зупинки — відсутня підписка, невстановлений Git і незакритий після встановлення Git застосунок.

Маршрут установки: підписка, Git for Windows, застосунок Claude, вхід, вкладка Code, перше завдання

  1. Підписка Pro або Max
  2. з налаштуваннями за замовчуваннямGit for Windows
  3. інсталятор із claude.ai/downloadЗастосунок Claude
  4. той самий акаунтВхід в акаунт
  5. середовище Local, Select folderВкладка Code і папка проєкту
  6. звичайною мовою, без командПерше завдання
  1. Вкладка Code і папка проєкту
  2. підписки немає, вкладка не відкриєтьсяПідписка Pro або Max

Короткий словник

  • Застосунок Claude — програма для компʼютера з трьома вкладками: Chat, Cowork і Code.
  • Вкладка Code — той самий Claude Code, але з вікнами й кнопками замість командного рядка.
  • Git for Windows — безкоштовна програма, без якої вкладка Code не запустить сесію на вашій машині.
  • Сесія — одна робоча розмова про один проєкт: своя папка, свій контекст, свої зміни.
  • Режим дозволів — налаштування, яке вирішує, чи питає агент перед зміною файлів.

Що потрібно перед встановленням

Три речі, і жодна з них не про термінал: свіжа Windows, платна підписка та кілька хвилин на два інсталятори.

Підписка: без неї вкладка Code не відкриється

Чат у застосунку працює і на безкоштовному акаунті. А от Claude Code — ні: він доступний на платних тарифах Pro, Max, Team та Enterprise. Приватній людині вистачить Pro, Max беруть тоді, коли впираються в ліміти щоденної роботи.

Перевірка проста: якщо натиснути вкладку Code, а застосунок пропонує оновити тариф, активної платної підписки на акаунті немає. Заведіть її заздалегідь, щоб не зупинятися посеред установки. Якщо ви ще обираєте між сервісами, порівняння є в матеріалі Claude чи ChatGPT: що обрати новачку.

Яка Windows підійде і чому WSL більше не обовʼязковий

Потрібна Windows 10 або новіша. Окремих вимог до заліза немає: агент не малює важкої графіки, тому робочого ноутбука вистачить.

Плутанина новачків починається зі старих інструкцій. Раніше Claude Code радили ставити командою npm або всередині Linux-середовища WSL, і чимало гайдів досі відкривається саме цим кроком. Зараз це зайвий шлях. WSL лишився одним із варіантів середовища для тих, хто вже живе в Linux, а для старту вибирають звичайний Local.

Крок перший. Ставимо Git for Windows

Навіщо Git тому, хто не пише код

На Windows вкладка Code без Git просто не стартує: застосунок покаже повідомлення «Git is required» і зупиниться. Git тут виконує чорнову роботу — веде історію змін і робить кожній паралельній сесії окрему копію папки, щоб дві задачі не переписували файли одна одної.

Побічний бонус: разом із Git у систему ставиться Git Bash — той самий термінал зі старих інструкцій. Відкривати його не доведеться жодного разу, але агент користується ним під капотом.

Що натискати в інсталяторі

Інсталятор лежить на офіційному сайті git-scm.com, на сторінці завантаження для Windows. Далі найкраща стратегія — не чіпати нічого: усі значення за замовчуванням підходять. Тиснете «Next» до кінця і чекаєте пару хвилин.

Якщо застосунок Claude уже був відкритий, після встановлення Git закрийте його повністю і запустіть заново. Поки застосунок не перезапустили, він продовжує вважати, що Git у системі немає.

Крок другий. Встановлюємо застосунок Claude

Звідки качати і який файл обрати

Інсталятор лежить на офіційній сторінці завантаження claude.ai/download. Для звичайного ноутбука беріть версію для Windows x64. Окрема збірка ARM64 потрібна лише власникам компʼютерів на процесорах ARM: якщо ви не знаєте, який у вас процесор, майже напевно потрібна x64.

Запустіть завантажений файл, дочекайтеся кінця установки і відкрийте Claude через меню «Пуск». Далі вхід у той самий акаунт, де активна підписка.

Windows може попередити про щойно завантажений файл: так захист поводиться з будь-якою новинкою, у якої ще немає накопиченої статистики запусків. Качайте лише з офіційної сторінки і підтверджуйте запуск у діалозі. Вимикати антивірус заради установки не треба.

Три вкладки застосунку і навіщо кожна

Вкладка Що робить Коли відкривати
Chat Звичайна розмова без доступу до ваших файлів Питання, тексти, ідеї
Cowork Фоновий агент, що працює у власному середовищі Довгі задачі, поки ви зайняті іншим
Code Claude Code: працює з файлами у вибраній папці Усе, де треба щось змінити на диску

Ця стаття про третю вкладку. Робота з документами в чаті й проєктах розібрана окремо, у гайді про Claude Desktop і Projects.

Крок третій. Відкриваємо вкладку Code і вибираємо папку

Натисніть Code угорі вікна. Якщо застосунок попросить увійти онлайн, зробіть це і перезапустіть його. Перед першим повідомленням у рядку введення налаштовують чотири речі.

1

Середовище

  • оберіть Local — агент працює на вашій машині з вашими файлами
2

Папка проєкту

  • натисніть «Select folder» і вкажіть теку
  • саме її файли агент бачить
3

Модель

  • список біля кнопки надсилання
  • модель можна змінити посеред роботи
4

Режим дозволів

  • вирішує, чи питає агент перед зміною файлів
  • для старту беріть Manual

Яку папку відкривати першою

Тестова папка потрібна саме для того, щоб помилка нічого не коштувала. Не починайте з теки, де лежить бухгалтерія, договори або єдина копія сайту. Зробіть окрему папку, покладіть у неї копії кількох документів і працюйте з ними.

Назвіть папку латиницею і без пробілів, наприклад C:\dev\test. Кирилиця та пробіли у шляху дають найдивніші помилки на Windows, а виправляти їх доводиться перейменуванням посеред роботи.

Крок четвертий. Перша сесія: завдання словами

Напишіть у рядку введення, що треба зробити, і натисніть Enter. Окремої мови команд немає: «переклади цей файл українською і збережи копію поруч» — нормально поставлене завдання.

Щоб показати конкретний файл, наберіть @ і почніть вводити його назву. Скріншот, PDF чи фото можна просто перетягнути у вікно застосунку.

Коли агент щось змінив, поруч зʼявиться індикатор на кшталт +12 -1. Натисніть на нього — відкриється порівняння: що саме додано і видалено, файл за файлом.

Як зупинити або перенаправити агента

Пішов не туди — натисніть кнопку зупинки, і поточна дія обірветься. Якщо зупиняти не хочеться, просто напишіть уточнення і надішліть його: агент прочитає поправку, щойно закінчить поточний крок, і врахує її далі.

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

Режими дозволів: хто вирішує, коли міняти файли

Від Manual до Auto: коли переходити на вільніший режим дозволів

  1. Manual — підтверджуєте кожну зміну
  2. коли стало зрозуміло, що агент пропонуєAccept edits — правки без запиту
  3. коли задача стала рутинноюAuto — діє сам, перевірки у фоні
  1. Manual — підтверджуєте кожну зміну
  2. У порівнянні видно, що саме зміниться у файлі
  1. Accept edits — правки без запиту
  2. Команди в терміналі агент усе одно питає
  1. Auto — діє сам, перевірки у фоні
  2. Ризиковані дії відсіює фонова перевірка
Режим Що робить агент Кому підходить
Manual Питає перед кожною зміною файлу і командою, показує порівняння Першим сесіям
Accept edits Правки у файли вносить сам, інші команди все одно питає Коли ви вже бачили, як він працює
Plan Вивчає проєкт і пропонує план, файли не чіпає Перед великою переробкою
Auto Діє самостійно, ризиковані дії відсіює фонова перевірка Рутині, яку ви робили вже не раз

Режим перемикається будь-коли селектором біля кнопки надсилання. Auto зʼявляється не в усіх акаунтах, тож якщо ви його не бачите — нічого не зламалося.

Новачок утомлюється від запитів і ставить найвільніший режим одразу. Далі одне невдало сформульоване завдання переписує робочі файли, і повертати їх нема звідки.

Перші сесії проведіть у тестовій папці в режимі Manual, де кожну зміну видно у порівнянні. Коли стане зрозуміло, які дії агент пропонує, переходьте на Accept edits.

Тримайте робочий проєкт під контролем версій — Git ви для цього вже поставили. Тоді кожну правку видно окремим рядком, і будь-яку можна відкотити без нервів.

Перевіряємо, що все працює

1

Створити тестову папку

  • нова порожня тека з латинською назвою
  • відкрити її у вкладці Code
2

Попросити створити файл

  • «зроби текстовий файл з коротким описом цієї папки»
  • підтвердити зміну
3

Попросити прочитати документ

  • покласти в папку свій файл
  • «перекажи, про що цей документ»
4

Попросити внести правку

  • «зміни друге речення на таке-то»
  • відкрити порівняння і звірити результат

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

Типові помилки на Windows і як їх усунути

Симптом Причина Що зробити
Вкладка Code пропонує оновити тариф На акаунті немає активної платної підписки Оформити Pro або Max і зайти заново
Повідомлення «Git is required» Git не встановлений або застосунок не перезапускали Поставити Git, повністю закрити застосунок і відкрити знову
Помилка 403 у вкладці Code Збій авторизації Вийти з акаунта в меню застосунку і зайти знову
Напис «Failed to load session» Папку перейменували, видалили або до неї немає доступу Вибрати папку заново або перезапустити застосунок
Порожній екран після запуску Не докотилося оновлення або мережа блокує застосунок Перезапустити застосунок, перевірити оновлення й налаштування фаєрвола

«Git is required» — найчастіша зупинка на Windows

Повідомлення означає рівно те, що написано: застосунок не знайшов Git. Причин дві. Перша — Git справді не встановлений, тоді поверніться до першого кроку. Друга, значно частіша — Git поставили, але застосунок Claude після цього не перезапускали.

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

Помилка 403 у вкладці Code

Спершу вийдіть з акаунта в меню застосунку і зайдіть знову: це лікує більшість випадків. Далі перевірте, що підписка активна саме на тому акаунті, під яким ви увійшли. Якщо не допомогло, закрийте застосунок повністю і запустіть заново.

Кирилиця і пробіли у шляху до папки

Шлях виду C:\Users\Олена\Мої проєкти виглядає нормально у провіднику і ламає частину інструментів, якими агент користується під капотом. Помилка щоразу виглядає по-різному, тому причину видно не одразу.

Рішення просте: тримайте робочі папки за коротким латинським шляхом, наприклад C:\dev\, і всередині вже розкладайте проєкти.

А що з терміналом, Git Bash і WSL

Ці три слова тягнуться зі старих інструкцій, тому варто сказати, де кожне лишилося.

Термінал. Він нікуди не подівся: у застосунку є власна панель терміналу, і її можна відкрити, коли захочеться подивитися, які команди агент запускає. Для роботи це не обовʼязково.

Git Bash. Приїжджає разом із Git for Windows. Агенту він потрібен, вам — ні.

Консольна версія і WSL. Якщо колись знадобиться запускати агента прямо з командного рядка, консольна версія ставиться окремо. Для старту вона не потрібна: застосунок уже містить Claude Code повністю, і Node.js під нього ставити не треба. WSL так само лишається варіантом на потім, для тих, кому потрібні Linux-шляхи.

Що робити далі після встановлення

Установка це вхідний квиток. Далі корисно навчитися ставити завдання так, щоб агент розумів вас із першої спроби: формулювання дає більше, ніж будь-які налаштування.

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

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

Часті питання

Чи треба ставити Claude Code окремо, якщо вже є застосунок Claude?

Ні. Claude Code вбудований у застосунок Claude для Windows і живе у вкладці Code. Окремо ставити Node.js чи консольну версію не потрібно: усе приїжджає одним інсталятором.

Навіщо для вкладки Code потрібен Git for Windows?

На Windows без Git вкладка Code не запускає сесію на вашому компʼютері й показує повідомлення «Git is required». Git веде історію змін і дає кожній паралельній сесії окрему копію папки. Поставте його з налаштуваннями за замовчуванням і перезапустіть застосунок.

Чи можна користуватися Claude Code без платної підписки?

Ні. Чат у застосунку працює і на безкоштовному акаунті, а вкладка Code доступна лише на платних тарифах Pro, Max, Team або Enterprise. Якщо застосунок пропонує оновити тариф при натисканні на Code, активної підписки на акаунті немає.

Чи потрібен WSL, щоб встановити Claude Code на Windows?

Ні. WSL лишився одним із варіантів середовища для тих, хто вже працює в Linux. Для звичайного старту вибирають середовище Local, і агент працює прямо з вашими файлами у Windows. Інструкції, які починаються зі встановлення WSL, описують старіший шлях.

Застосунок показує помилку 403 у вкладці Code. Що робити?

Спершу вийдіть з акаунта в меню застосунку і зайдіть знову: це лікує більшість випадків. Далі перевірте, що підписка справді активна. Якщо не допомогло, закрийте застосунок повністю, а не просто вікно, і відкрийте його заново.

Чи може агент змінити мої файли без дозволу?

Це залежить від режиму дозволів. У режимі Manual агент показує порівняння і чекає, поки ви приймете або відхилите кожну зміну. Вільніші режими вносять правки самі. Перші сесії проводьте в режимі Manual і в окремій тестовій папці.

Як зупинити агента посеред завдання?

Натисніть кнопку зупинки — поточна дія обірветься. Якщо зупиняти не потрібно, просто надішліть уточнення: агент прочитає поправку, щойно закінчить крок, і врахує її далі. Зміни, які він устиг зробити з вашого дозволу, лишаються на диску.