--- title: CLI認証オプション url: https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/authentication description: ant CLIをインタラクティブログイン、APIキー、名前付きプロファイル、Workload Identity Federationで認証します。 --- `ant` CLIは複数の認証情報ソースをサポートしています。[クイックスタート](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/quickstart#authentication)では、1コマンドで完結する基本的な流れ（`ant auth login`）を説明しています。このページでは、すべてのオプションを完全に説明します。 ## インタラクティブログイン `ant auth login` を使用すると、APIキーを作成または管理することなくAPIを呼び出せます。これはClaude Consoleに対してブラウザベースのOAuthフローを開き、結果として得られる認証情報を `$ANTHROPIC_CONFIG_DIR` の下に保存します（OS固有のデフォルトについては[設定ディレクトリ](https://platform.claude.com/docs/ja/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 ``` ブラウザフローの間に、組織を選択し、次に[ワークスペース](https://platform.claude.com/docs/ja/manage-claude/workspaces)を選択します。発行されるトークンは[そのワークスペースにスコープされる](https://platform.claude.com/docs/ja/manage-claude/workspaces#api-keys-and-resource-scoping)ため、CLIはそのワークスペースに属するリソースのみを参照できます。`--workspace-id` を渡すと直接バインドし、ピッカーをスキップできます。複数のワークスペースで作業するには、[ワークスペース間の切り替え](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/authentication#switch-between-workspaces)を参照してください。 インタラクティブログインは、自分のマシン上でのローカル開発やスクリプティングを目的としています。CI、サーバー、コンテナなどの非インタラクティブなワークロードには、代わりに[Workload Identity Federation](https://platform.claude.com/docs/ja/manage-claude/workload-identity-federation)を使用してください。 ログインは認証情報を `credentials/.json` に書き込みます。プロファイルの最初のログインでは `configs/.json` も作成され、それがアクティブなプロファイルとして設定されます。保存された認証情報を削除するには、`ant auth logout` を実行するか、すべてのプロファイルをクリアするには `ant auth logout --all` を実行します。 ## 管理者アクセス デフォルトでは、`ant auth login` はワークスペースにスコープされたトークンを要求します。[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)ページに記載されているリソースを管理するには、専用のプロファイルの下で `org:admin` スコープを要求します。 ```bash CLI 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](https://platform.claude.com/settings/keys)からキーを取得してください。 ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc source ~/.zshrc ``` ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc source ~/.bashrc ``` ```powershell setx ANTHROPIC_API_KEY "sk-ant-api03-..." ``` 変更を有効にするには、新しいターミナルを開いてください。 単一の呼び出しでキーを上書きするには、`--api-key` を渡します。別のAPIホストを指定するには、`ANTHROPIC_BASE_URL` を設定するか、`--base-url` を渡します。 [個人またはサービスアカウントキー](https://platform.claude.com/docs/ja/manage-claude/authentication#key-types)のように、複数のワークスペースにスコープされたAPIキーを使用している場合は、コマンドを実行する[ワークスペースを指定](https://platform.claude.com/docs/ja/manage-claude/authentication#select-a-workspace)する必要があります。これは、CLIが自動的に読み取る `ANTHROPIC_WORKSPACE_ID` 環境変数を設定するか、[`--workspace-id` フラグ](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using#global-flags)を使用して行います。値は `wrkspc_...` IDである必要があります。 ```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/ja/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/ja/cli-sdks-libraries/cli/authentication#check-authentication-status)を実行して、どのプロファイルとワークスペースがアクティブかを確認してください。 プロファイルは、APIキーが設定されていない場合にのみ参照されます。環境に `ANTHROPIC_API_KEY` が存在する場合、それはすべてのプロファイルを上書きし、これらのコマンドはすべてそのキーのワークスペース（または、複数ワークスペースキーの場合は `ANTHROPIC_WORKSPACE_ID` または `--workspace-id` で設定されたワークスペース）を使用します。プロファイルを切り替える前に、それを解除してください。 ## プロファイルの管理 `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/ja/manage-claude/wif-reference#profile-configuration-file)を参照してください。Workload Identity Federationについては、[認証の概要](https://platform.claude.com/docs/ja/manage-claude/authentication)と[WIFリファレンス](https://platform.claude.com/docs/ja/manage-claude/wif-reference)を参照してください。 ## 次のステップ コマンド構造、出力形式、GJSON変換、およびリクエストボディ APIリソースのバージョン管理、スクリプティングパターン、およびClaude Codeからの使用 CI、サーバー、コンテナ向けの非インタラクティブ認証