Параметры аутентификации CLI

CLI ant поддерживает несколько источников учётных данных. В разделе Быстрый старт описан простейший путь из одной команды (ant auth login). На этой странице подробно рассматриваются все варианты.



Интерактивный вход

ant auth login позволяет вызывать API без создания ключа API и управления им. Команда открывает браузерный OAuth-поток через Claude Console и сохраняет полученные учётные данные в $ANTHROPIC_CONFIG_DIR (значение по умолчанию для конкретной ОС см. в разделе Каталог конфигурации). На удалённом хосте или в любой среде без локального браузера передайте --no-browser, чтобы вывести URL авторизации и вставить возвращённый код обратно в терминал.

ant auth login

# На удалённом хосте без браузера:
ant auth login --no-browser

# Привязка к конкретному рабочему пространству без выбора в браузере:
ant auth login --workspace-id wrkspc_01...

# Если именованный профиль, переданный через --profile, не существует,
# будет создан новый именованный профиль с этим именем.
ant auth login --profile <profile-name>

В ходе браузерного потока вы выбираете организацию, а затем рабочее пространство. Выданный токен привязан к этому рабочему пространству, поэтому CLI видит только принадлежащие ему ресурсы. Передайте --workspace-id, чтобы выполнить привязку напрямую и пропустить выбор. Чтобы работать более чем в одном рабочем пространстве, см. раздел Переключение между рабочими пространствами.

Интерактивный вход предназначен для локальной разработки и написания скриптов на вашей собственной машине. Для неинтерактивных рабочих нагрузок, таких как CI, серверы и контейнеры, используйте вместо этого Workload Identity Federation.

Вход записывает учётные данные в credentials/<profile>.json. Первый вход для профиля также создаёт configs/<profile>.json и устанавливает его в качестве активного профиля. Чтобы удалить сохранённые учётные данные, выполните ant auth logout или ant auth logout --all, чтобы очистить все профили.



Административный доступ

По умолчанию ant auth login запрашивает токен, привязанный к рабочему пространству. Для управления ресурсами, описанными на странице Admin API, запросите область действия org:admin под отдельным профилем:

ant auth login --profile admin --scope "org:admin"

# Вывести bearer-токен для заголовков Authorization:
ant auth print-credentials --profile admin --access-token

Область действия org:admin предоставляется только участникам организации с ролью администратора, владельца или основного владельца. Выданный токен имеет доступ на уровне всей организации, и любая привязка к рабочему пространству в профиле его не ограничивает. Держите административный профиль отдельно от повседневного, чтобы обычные команды никогда не выполнялись с повышенным доступом.



Ключ API

CLI также считывает ваш ключ API из переменной окружения ANTHROPIC_API_KEY. Получите ключ в Claude Console.

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
source ~/.zshrc

Чтобы переопределить ключ для одного вызова, передайте --api-key. Чтобы указать другой хост API, установите ANTHROPIC_BASE_URL или передайте --base-url.



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

ant auth status выводит источник учётных данных, выбранный CLI (переменная окружения с ключом API, вход через OAuth, федерация или профиль), активный профиль, рабочее пространство, к которому привязан активный токен, и пути к каталогу конфигурации. Используйте эту команду, чтобы выяснить, почему рабочая нагрузка выбрала неверные учётные данные или рабочее пространство.

ant auth status

Active profile:  default
Config dir:      ~/.config/anthropic
Profile config:  ~/.config/anthropic/configs/default.json
Credentials:     ~/.config/anthropic/credentials/default.json

Credentials
  (active) * Profile (user_oauth) [via active_config]       sk-ant-oat01-EXA...
...

Workspace
  (active) * Workspace                                      wrkspc_01... (Engineering)

Смотрите строки с пометкой (active), чтобы увидеть, какой источник учётных данных и какое рабочее пространство были выбраны. Команда сообщает статус, а не выполняет проверку работоспособности, поэтому не полагайтесь в скриптах на код завершения. Полный порядок приоритета источников учётных данных см. в разделе Приоритет учётных данных.



Переключение между рабочими пространствами

Токен интерактивного входа привязан к одному рабочему пространству. Чтобы использовать CLI с несколькими рабочими пространствами, войдите в каждое из них под собственным именованным профилем, а затем переключайтесь между ними:

# 1. Создайте профиль (интерактивно; выберите другое рабочее пространство в
#    браузере или передайте --workspace-id, чтобы пропустить выбор):
# ant auth login --profile other-ws

# 2. Сделайте его профилем по умолчанию для последующих команд:
ant profile activate other-ws

# 3. Или выберите его для одной команды, не меняя значение по умолчанию:
ant --profile other-ws models list
ANTHROPIC_PROFILE=other-ws ant models list

Выполните ant auth status, чтобы убедиться, какой профиль и рабочее пространство активны.



Управление профилями

Подкоманды ant profile позволяют просматривать и редактировать состояние профиля напрямую:

ant profile list
ant profile get --profile other-ws
ant profile set workspace_id wrkspc_01... --profile other-ws

Доступные для записи ключи для ant profile set: workspace_id, base_url, organization_id, scope, client_id и console_url. Установка workspace_id записывает целевое рабочее пространство в конфигурацию профиля, но не перепривязывает уже выданные учётные данные; выполните ant auth login снова под этим профилем, чтобы выпустить токен для нового рабочего пространства.

Схему файла профиля и блок федерации см. в разделе Файл конфигурации профиля. О Workload Identity Federation см. в разделах Обзор аутентификации и Справочник по WIF.



Дальнейшие шаги