Урок 6 от поредицата Claude Code: Как да се удостоверите – влизане през браузър и ръчно конфигуриране на API Key

Процес на удостоверяване: влизане през браузър и ръчно конфигуриране на API Key

След като инсталирате Claude Code, трябва да се удостоверите, за да го използвате. Трябва да свържете инструмента с вашия акаунт в Anthropic. Има два начина за свързване: влизане през браузър и ръчно конфигуриране на API Key. И двата начина водят до същия резултат – изберете този, който ви е по-удобен.

Начин 1: Влизане през браузър (препоръчително)

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

Стъпки:

В терминала въведете:

bash claude login

Системата ще изведе серия от инструкции и автоматично ще отвори страницата за разрешение на Anthropic в браузъра по подразбиране.
Ако не се отвори автоматично, в терминала ще се отпечата връзка, която можете ръчно да копирате и отворите в браузъра.
Влезте в своя акаунт в Anthropic в браузъра (ако вече сте влезли, страницата ще поиска разрешение директно).
Натиснете „Разрешаване“ или „Оторизиране“. Страницата ще покаже „Оторизацията е успешна, можете да затворите тази страница“.
Върнете се в терминала – ще видите съобщение, че удостоверяването е завършено. Сега, когато изпълните командата claude, тя вече е свързана с вашия акаунт.

Начин 2: Ръчно конфигуриране на API Key

Ако използвате сървър без графичен интерфейс, контейнер или просто не искате да използвате оторизация през браузър, можете да получите API Key директно от конзолата на Anthropic и да го конфигурирате в Claude Code.

Стъпки:

Отворете браузър и отидете на https://console.anthropic.com, влезте в своя акаунт в Anthropic.
Отидете на страницата API Keys (обикновено в настройките или под опциите за разработчици) и натиснете „Create API Key“.
Дайте име на ключа (например claude-code-local) и веднага го копирайте след генерирането.
Забележка: Този ключ се показва само веднъж; ако затворите страницата, няма да го видите отново. Ако не го запишете, изтрийте стария и генерирайте нов.
Върнете се в терминала. Има два начина да подадете ключа на Claude Code:

A. Чрез променлива на средата:

bash export ANTHROPIC_API_KEY=вашия-api-key

Добавете този ред във вашия ~/.bashrc или ~/.zshrc, за да се прилага автоматично всеки път.

B. Чрез запис в конфигурационен файл:

Claude Code също чете своя конфигурационен файл. Ръчно редактирайте ~/.claude/config.json (създайте го, ако не съществува) и запишете:

json { "apiKey": "вашия-api-key" }

Забележка: Препоръчително е да зададете права на файла 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 "Обясни за какво служи текущата директория"

Ако може да прочете информация за вашия проект, значи средата е готова.