Claude Code серија упатства 6: Како да се автентицирате - Најава преку прелистувач и рачно конфигурирање на 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-? Не, Anthropic API Key навистина започнува со sk-ant-api03- и претставува долга низа. При копирање, не испуштајте карактери.
Ако истовремено поставите и променлива на околината и датотека, променливата на околината има предност. Чувајте само еден начин за да избегнете забуна.
Клучот е наплатлив акредитив, не го комитирајте во Git складиште. Се препорачува да го игнорирате целиот ~/.claude директориум или конфигурациската датотека преку .gitignore.

Промена на сметка или одјавување

Ако сакате да смените сметка или да ги избришете локалните акредитиви:

Ако сте користеле claude login: извршете claude logout, потоа повторно claude login.
Ако сте рачно конфигурирале Key: избришете го стариот клуч од променливата на околината или конфигурациската датотека и заменете го со нов.

Тестирање дали автентификацијата работи правилно

claude "Објасни што прави тековниот директориум"

Ако може да го прочита прегледот на вашиот проект, околината е подготвена.