Claude Code серия руководств 6: Как пройти аутентификацию — вход через браузер и ручная настройка API Key

Аутентификация: вход через браузер и ручная настройка API Key

После установки Claude Code необходимо пройти аутентификацию, чтобы начать использование. Вам нужно привязать инструмент к своей учетной записи Anthropic. Существует два способа привязки: вход через браузер и ручная настройка API Key. Оба способа дают одинаковый результат — выбирайте тот, который удобнее.

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

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

Шаги:

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

bash claude login

1. Система выведет подсказку и автоматически откроет страницу авторизации Anthropic в вашем браузере по умолчанию.
   Если страница не открылась автоматически, в терминале будет показана ссылка, которую можно скопировать и открыть в браузере вручную.

2. Войдите в свою учетную запись Anthropic в браузере (если вы уже вошли, страница сразу запросит авторизацию).

3. Нажмите «Разрешить» или «Авторизовать». На странице браузера появится сообщение «Авторизация прошла успешно, можете закрыть эту страницу».

4. Вернитесь в терминал — вы увидите уведомление об успешной аутентификации. Теперь при запуске claude команда будет связана с вашей учетной записью.

Способ 2: Ручная настройка API Key

Если вы используете сервер без графического интерфейса, контейнер или не хотите проходить авторизацию через браузер, вы можете получить API Key из консоли Anthropic и настроить его в Claude Code.

Шаги:

1. Откройте браузер, перейдите на https://console.anthropic.com и войдите в свою учетную запись Anthropic.

2. Перейдите на страницу API Keys (обычно в разделе «Настройки» или «Параметры разработчика») и нажмите «Создать API Key».

3. Дайте ключу имя (например, claude-code-local) и сразу скопируйте его после создания.
   Важно: ключ отображается только один раз; если закрыть страницу, его уже не увидеть. Если забыли сохранить, удалите старый ключ и создайте новый.

4. Вернитесь в терминал. Есть два способа передать ключ в 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), чтобы другие пользователи не могли его прочитать.

1. Проверьте соединение:

bash claude "Привет, ответь 'OK'"

Если получен нормальный ответ, значит ключ настроен правильно.

Частые ошибки при ручной настройке:

• Ключ не начинается с sk-ant- или sk-? Нет, API-ключ Anthropic действительно начинается с sk-ant-api03- и представляет собой длинную строку. При копировании не пропускайте символы.
• Если вы одновременно задали переменную окружения и записали ключ в файл, приоритет имеет переменная окружения. Используйте только один способ, чтобы избежать путаницы.
• Ключ является платёжным credential'ом, не добавляйте его в Git-репозиторий. Рекомендуется игнорировать всю директорию ~/.claude или конфигурационный файл через .gitignore.

Смена учётной записи или выход

Если нужно сменить учётную запись или очистить локальные учётные данные:

• Если вы использовали claude login: выполните claude logout, затем снова claude login.
• Если вы настроили ключ вручную: удалите старый ключ из переменной окружения или конфигурационного файла и замените его новым.

Проверка аутентификации

claude "Объясни, для чего нужна текущая директория"

Если Claude Code сможет прочитать информацию о вашем проекте, значит среда готова к работе.