Варианты аутентификации 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

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

setx ANTHROPIC_API_KEY "sk-ant-api03-..."

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

Если вы используете ключ API, ограниченный несколькими рабочими пространствами, такой как персональный ключ или ключ сервисного аккаунта, вы должны указать рабочее пространство, в котором выполнять вашу команду. Сделайте это, установив переменную окружения ANTHROPIC_WORKSPACE_ID, которую CLI считывает автоматически, или используя флаг --workspace-id. Значение должно быть идентификатором wrkspc_....

ant messages create \
  --workspace-id wrkspc_01... \
  --model claude-opus-5-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

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

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.

Следующие шаги