CLI認証オプション

ant CLIは複数の認証情報ソースをサポートしています。クイックスタートでは、1コマンドで完結する基本的な流れ（ant auth login）を説明しています。このページでは、すべてのオプションを完全に説明します。

インタラクティブログイン

ant auth login を使用すると、APIキーを作成または管理することなくAPIを呼び出せます。これはClaude Consoleに対してブラウザベースのOAuthフローを開き、結果として得られる認証情報を $ANTHROPIC_CONFIG_DIR の下に保存します（OS固有のデフォルトについては設定ディレクトリを参照してください）。リモートホスト上、またはローカルブラウザのない環境では、--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"

# Authorizationヘッダー用のベアラートークンを出力します:
ant auth print-credentials --profile admin --access-token

org:admin スコープは、admin、owner、またはprimary ownerロールを持つ組織メンバーにのみ付与されます。発行されるトークンは組織全体へのアクセス権を持ち、プロファイル上のワークスペースバインディングはそれを制約しません。日常的なコマンドが昇格されたアクセス権で実行されることがないように、管理者プロファイルを日常的なプロファイルとは別に保ってください。

APIキー

CLIは ANTHROPIC_API_KEY 環境変数からもAPIキーを読み取ります。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キーを使用している場合は、コマンドを実行するワークスペースを指定する必要があります。これは、CLIが自動的に読み取る ANTHROPIC_WORKSPACE_ID 環境変数を設定するか、--workspace-id フラグを使用して行います。値は wrkspc_... IDである必要があります。

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リファレンスを参照してください。

次のステップ