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

Вхід в акаунт та автентифікація

Claude Code вимагає активної підписки або оплаченого доступу. Безплатні облікові записи на платформі claude.ai не підтримуються.

Доступні способи автентифікації:

1. Індивідуальні підписки: тарифи Claude Pro, Max або Ultra. Авторизація здійснюється через браузер за допомогою облікового запису claude.ai.
2. Командні та корпоративні плани: Claude for Teams або Claude for Enterprise. Учасники входять через обліковий запис claude.ai, до якого їх запросив адміністратор організації.
3. Claude Console: обліковий запис розробника з передплаченими кредитами. Починаючи з версії v2.1.242, підтримується рекомендований вхід без створення статичного ключа API: сесія зберігає OAuth-токен у профілі Anthropic та оновлює його автоматично. Також зберігається класичний варіант із генерацією API-ключа Console. Під час першого входу в Console автоматично створюється робочий простір «Claude Code» для обліку витрат.
4. Змінна оточення ANTHROPIC_API_KEY: якщо у вашій системі вже налаштовано цей ключ, Claude Code запитає підтвердження на його використання та пропустить відкриття браузера.
5. Хмарні провайдери: платформи Amazon Bedrock, Google Cloud’s Agent Platform (Vertex AI) або Microsoft Foundry. Налаштування виконується через змінні оточення або через пункт 3rd-party platform у стартовому меню.
6. Корпоративний шлюз (Cloud gateway): якщо компанія розгорнула власний шлюз для застосунків Claude, вхід відбувається через корпоративний SSO після введення команди /login.

Керування збереженими даними сесії виконується безпечно: на macOS дані зберігаються в macOS Keychain (якщо Keychain недоступний або заблокований, застосовується резервний файл ~/.claude/.credentials.json із правами доступу 0600), у Linux — у файлі ~/.claude/.credentials.json, на Windows — у шляху %USERPROFILE%\.claude\.credentials.json. Якщо в системі задано змінну CLAUDE_CONFIG_DIR, файл облікових даних записується всередині вказаної директорії.

Перший запуск у проєкті та перевірка роботи

1. Перевірка версії: відкрийте нове вікно термінала та запустіть команду перевірки:

   claude --version
   

   Успішна інсталяція поверне номер версії, наприклад 2.1.211 (Claude Code).

2. Запуск діагностики: виконайте команду діагностики для оцінки стану файлів, налаштувань та конфігурації:

   claude doctor
   

   Команда claude doctor у режимі тільки для читання виведе діагностичні дані про цілісність встановлення, валідацію файлів конфігурації та рекомендації щодо виправлення знайдених проблем.

3. Старт першої сесії: перейдіть у каталог вашого проєкту та викличте команду запуску:

   cd /path/to/your/project
   claude
   

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

4. Базові команди для роботи:

   • /help — перелік доступних команд активної сесії;
   • /clear — очищення поточної історії розмови;
   • /resume — відновлення попередньої розмови;
   • /status — перевірка статусу авторизації та активного облікового запису;
   • /logout — скидання збережених облікових даних та завершення сесії;
   • /exit (або подвійне натискання Ctrl+D) — вихід із Claude Code;
   • Shift+Tab — перемикання режиму дозволів дій (permission mode), які інструмент може виконувати без додаткового підтвердження.

Типові проблеми встановлення та їх розв'язання

• Помилка command not found: claude або 'claude' is not recognized: Свідчить про те, що шлях до директорії з файлом claude відсутній у системній змінній PATH. Нативний інсталятор розміщує програму за шляхом ~/.local/bin/claude на macOS/Linux або %USERPROFILE%\.local\bin\claude.exe на Windows. Переконайтеся, що файл фізично присутній у каталозі, додайте відповідний шлях до файлу конфігурації оболонки (~/.zshrc, ~/.bashrc, ~/.bash_profile або змінні середовища користувача у Windows) та перезапустіть термінал.
• Помилки роздільника && або відсутності команди irm у Windows: Повідомлення The token '&&' is not a valid statement separator вказує на спробу виконати команду для CMD всередині PowerShell. Помилка 'irm' is not recognized as an internal or external command означає, що команду для PowerShell запущено в інтерпретаторі CMD. Використовуйте команду, призначену саме для вашої поточної оболонки.
• Інсталятор повертає помилку 403, HTML-розмітку або App unavailable in region: Якщо сценарій повертає HTML-код сторінки або синтаксичні помилки парсингу XML/CSS, завантаження файлу заблоковано на рівні мережі або регіону. Текст «App unavailable in region» вказує, що сервіс недоступний у вашій країні. Також помилка 403 може бути наслідком блокування адреси downloads.claude.ai корпоративними проксі-серверами чи фаєрволами. У разі роботи за проксі задайте змінні HTTP_PROXY та HTTPS_PROXY перед викликом інсталятора або скористайтеся альтернативним методом встановлення через Homebrew чи WinGet.
• Помилки curl: (56) або curl: (23) Failure writing output to destination: Свідчать про розрив зв'язку під час передавання файлу інсталятора через конвеєр (pipe) або передчасне завершення роботи оболонки. Перевірте з'єднання з downloads.claude.ai та повторіть команду.
• Повідомлення Cask 'claude-code' is unavailable у Homebrew: Виникає, коли локальний індекс пакетів Homebrew застарів. Оновіть індекс командою brew update і повторіть інсталяцію.
• Конфлікти кількох інсталяцій: Одночасне встановлення Claude Code через нативний інсталятор, глобальний npm та системні менеджери спричиняє плутанину версій. За допомогою команди which -a claude (macOS/Linux) або where.exe claude (Windows) знайдіть усі наявні виконувані файли та видаліть дублікати, залишивши лише один підтримуваний варіант інсталяції.