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 key」（APIキー）を読み取ります。キーはClaude Consoleから取得してください。

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

1回の呼び出しに限ってキーを上書きするには、--api-key を渡します。別のAPIホストを指定するには、ANTHROPIC_BASE_URL を設定するか --base-url を渡します。

個人キーまたはサービスアカウントキーなど、複数のワークスペースにスコープされたAPIキーを使用している場合は、コマンドを実行するワークスペースを指定する必要があります。これには、CLIが自動的に読み取る ANTHROPIC_WORKSPACE_ID 環境変数を設定するか、--workspace-id フラグを使用します。値は wrkspc_... 形式のIDである必要があります。SDKがフェデレーショントークン交換のために ANTHROPIC_WORKSPACE_ID で受け付けるリテラル default は、ここでは無効です。

ant messages create \
  --workspace-id wrkspc_01... \
  --model claude-opus-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リファレンスを参照してください。

次のステップ