---
title: Варианты аутентификации CLI
url: https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/authentication
description: Аутентификация CLI ant с помощью интерактивного входа, ключей API, именованных профилей и Workload Identity Federation.
---

CLI `ant` поддерживает несколько источников учётных данных. [Быстрый старт](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/quickstart#authentication) охватывает простейший путь с одной командой (`ant auth login`). Эта страница описывает каждый вариант полностью.

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

`ant auth login` позволяет вам вызывать API без создания или управления ключом API. Он открывает браузерный поток OAuth к Claude Console и сохраняет полученные учётные данные в `$ANTHROPIC_CONFIG_DIR` (см. [Каталог конфигурации](https://platform.claude.com/docs/ru/manage-claude/wif-reference#configuration-directory) для значения по умолчанию, зависящего от ОС). На удалённом хосте или в любой среде без локального браузера передайте `--no-browser`, чтобы вывести URL авторизации и вставить возвращённый код обратно в терминал.

```bash CLI
ant auth login

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

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

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

Во время браузерного потока вы выбираете организацию, а затем [рабочее пространство](https://platform.claude.com/docs/ru/manage-claude/workspaces). Выданный токен [ограничен этим рабочим пространством](https://platform.claude.com/docs/ru/manage-claude/workspaces#api-keys-and-resource-scoping), поэтому CLI может видеть только принадлежащие ему ресурсы. Передайте `--workspace-id`, чтобы привязаться напрямую и пропустить выбор. Чтобы работать более чем в одном рабочем пространстве, см. [Переключение между рабочими пространствами](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/authentication#switch-between-workspaces).

Интерактивный вход предназначен для локальной разработки и написания скриптов на вашей собственной машине. Для неинтерактивных рабочих нагрузок, таких как CI, серверы и контейнеры, используйте вместо этого [Workload Identity Federation](https://platform.claude.com/docs/ru/manage-claude/workload-identity-federation).

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

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

По умолчанию `ant auth login` запрашивает токен, ограниченный рабочим пространством. Чтобы управлять ресурсами, описанными на странице [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api), запросите область `org:admin` под выделенным профилем:

```bash CLI
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](https://platform.claude.com/settings/keys).

<Tabs>
  <Tab title="zsh">
    ```bash
    echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="bash">
    ```bash
    echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell
    setx ANTHROPIC_API_KEY "sk-ant-api03-..."
    ```

    Откройте новый терминал, чтобы изменение вступило в силу.
  </Tab>
</Tabs>

Чтобы переопределить ключ для одного вызова, передайте [`--api-key-stdin`](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/using#global-flags) и направьте ключ команде через конвейер. Чтобы указать другой хост API, установите `ANTHROPIC_BASE_URL` или передайте `--base-url`.

Если вы используете ключ API, ограниченный несколькими рабочими пространствами, такой как [персональный ключ или ключ сервисного аккаунта](https://platform.claude.com/docs/ru/manage-claude/authentication#key-types), вы должны [указать рабочее пространство](https://platform.claude.com/docs/ru/manage-claude/authentication#select-a-workspace), в котором выполнять вашу команду. Сделайте это, установив переменную окружения `ANTHROPIC_WORKSPACE_ID`, которую CLI считывает автоматически, или используя [флаг `--workspace-id`](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/using#global-flags). Значение должно быть идентификатором `wrkspc_...`.

```bash CLI
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, федерация или профиль), активный профиль, рабочее пространство, к которому привязан активный токен, и пути к каталогу конфигурации. Используйте его для диагностики того, почему рабочая нагрузка выбрала неправильные учётные данные или рабочее пространство.

```bash CLI
ant auth status
```

```text
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)`, чтобы увидеть, какой источник учётных данных и рабочее пространство победили. Команда сообщает статус, а не выполняет проверку работоспособности, поэтому не пишите скрипты, опирающиеся на код выхода. Полный порядок источников учётных данных см. в [Приоритет учётных данных](https://platform.claude.com/docs/ru/manage-claude/wif-reference#credential-precedence).

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

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

```bash 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`](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/authentication#check-authentication-status), чтобы подтвердить, какой профиль и рабочее пространство активны.

<Note>
  Переменная `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` в вашем окружении имеет приоритет над любым профилем (см. [Приоритет учётных данных](https://platform.claude.com/docs/ru/manage-claude/wif-reference#credential-precedence)). Пока вы не сбросите эту переменную, запросы к API используют эти учётные данные независимо от выбранного профиля, и `ant` выводит об этом сообщение в stderr.
</Note>

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

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

```bash CLI
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` снова под этим профилем, чтобы создать токен для нового рабочего пространства.

Схему файла профиля и блок федерации см. в [Файл конфигурации профиля](https://platform.claude.com/docs/ru/manage-claude/wif-reference#profile-configuration-file). Для Workload Identity Federation см. [Обзор аутентификации](https://platform.claude.com/docs/ru/manage-claude/authentication) и [Справочник WIF](https://platform.claude.com/docs/ru/manage-claude/wif-reference).

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

<CardGroup cols={3}>
  <Card title="Использование CLI" icon="terminal" href="https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/using">
    Структура команд, форматы вывода, преобразования GJSON и тела запросов
  </Card>

  <Card title="Написание скриптов и автоматизация CLI" icon="code" href="https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/scripting">
    Контроль версий ресурсов API, шаблоны написания скриптов и использование из Claude Code
  </Card>

  <Card title="Workload Identity Federation" icon="cloud" href="https://platform.claude.com/docs/ru/manage-claude/workload-identity-federation">
    Неинтерактивная аутентификация для CI, серверов и контейнеров
  </Card>
</CardGroup>