Навчальний посібник Claude Code, частина 6: Як автентифікуватися – вхід через браузер та ручне налаштування API-ключа

Процес автентифікації: вхід через браузер та ручне налаштування API-ключа

Після встановлення Claude Code потрібно пройти автентифікацію, щоб почати використання. Ви маєте прив'язати інструмент до свого облікового запису Anthropic. Є два способи прив'язки: вхід через браузер та ручне налаштування API-ключа. Обидва способи дають однаковий результат – оберіть той, який вам зручніший.

Спосіб 1: Вхід через браузер (рекомендовано)

Claude Code надає автоматичну команду автентифікації claude login, яка відкриває браузер, дозволяє вам авторизуватися на веб-сторінці, а потім автоматично записує облікові дані в термінал.

Кроки:

У терміналі введіть:

bash claude login

Система виведе підказку та автоматично відкриє сторінку авторизації Anthropic у вашому браузері за замовчуванням.
Якщо автоматичного відкриття не відбулося, у терміналі з'явиться посилання – ви можете вручну скопіювати його та відкрити в браузері.
Увійдіть у свій обліковий запис Anthropic у браузері (якщо ви вже ввійшли, ця сторінка одразу запитає авторизацію).
Натисніть «Дозволити» або «Авторизувати». Сторінка браузера покаже повідомлення «Авторизація успішна, можна закрити цю сторінку».
Поверніться до термінала – ви побачите повідомлення про завершення автентифікації. Тепер команда claude пов'язана з вашим обліковим записом.

Спосіб 2: Ручне налаштування API-ключа

Якщо ви працюєте на сервері без графічного інтерфейсу, у контейнері або не бажаєте проходити авторизацію через браузер, ви можете отримати API-ключ з консолі Anthropic та налаштувати його в Claude Code.

Кроки:

Відкрийте браузер, перейдіть на https://console.anthropic.com та увійдіть у свій обліковий запис Anthropic.
Перейдіть на сторінку API Keys (зазвичай у налаштуваннях або в розділі для розробників) і натисніть «Створити API-ключ».
Дайте ключу назву (наприклад, claude-code-local). Після створення одразу скопіюйте його.
Зверніть увагу: ключ показується лише один раз; після закриття сторінки його не буде видно. Якщо забули зберегти, видаліть старий і створіть новий.
Поверніться до термінала. Є два способи передати ключ Claude Code:

A. Через змінну середовища:

bash export ANTHROPIC_API_KEY=ваш-api-ключ

Додайте цей рядок у ваш ~/.bashrc або ~/.zshrc, щоб він застосовувався автоматично при кожному вході.

B. Запис у файл конфігурації:

Claude Code також зчитує власний конфігураційний файл. Відредагуйте ~/.claude/config.json (якщо файлу немає, створіть його) та додайте:

json { "apiKey": "ваш-api-ключ" }

Зверніть увагу: рекомендовано встановити права доступу до цього файлу 600 (chmod 600 ~/.claude/config.json), щоб інші користувачі не могли його прочитати.

Перевірте з'єднання:

bash claude "Привіт, відповідай 'OK'"

Якщо ви отримаєте нормальну відповідь, ключ налаштовано правильно.

Типові помилки при ручному налаштуванні:

Чи не починається ключ з sk-ant- або sk-? Ні, API-ключ Anthropic насправді починається з sk-ant-api03- і є довгим рядком. При копіюванні не пропустіть жодного символу.
Якщо ви встановили одночасно змінну середовища та файл конфігурації, змінна середовища має вищий пріоритет. Залиште лише один спосіб, щоб уникнути плутанини.
Ключ є платіжним засобом – не додавайте його до Git-репозиторію. Рекомендується додати весь каталог ~/.claude або файл конфігурації до .gitignore.

Зміна облікового запису або вихід

Якщо ви хочете змінити обліковий запис або очистити локальні облікові дані:

Якщо ви використовували claude login: виконайте claude logout, а потім знову claude login.
Якщо ви налаштували ключ вручну: видаліть старий ключ зі змінної середовища або файлу конфігурації та замініть його новим.

Перевірка успішної автентифікації

claude "Поясніть, що робить поточна директорія"

Якщо він зможе прочитати огляд вашого проекту, середовище готове до роботи.