settings.json

forceLoginMethod

型string記述場所どの設定ファイルでも可

"claudeai" で Claude.ai アカウントのみ、"console" で Claude Console アカウントのみ、"gateway" でクラウドゲートウェイ経由のログインのみに制限する。

既定値: 未設定の場合、ユーザーはログイン方法を選択できる

取りうる値

claudeaiclaude.ai アカウントのみログインできる
consoleClaude Console アカウントのみログインできる
gatewayClaude Code がファーストパーティのログインの代わりにクラウドゲートウェイへ誘導する

記述例

{
  "forceLoginMethod": "claudeai"
}

使い方・用途

  • ログイン方法を claudeai(claude.ai アカウント)/ console(Claude Console アカウント)/ gateway(クラウドゲートウェイ)に制限する設定
  • 組織のマネージド設定・MDM・ポリシーヘルパーで配布する運用を想定。ユーザーの ~/.claude/settings.json に設定しても効果はない
  • "gateway" を使うには forceLoginGatewayUrl でゲートウェイ URL を指定する必要がある
  • v2.1.212 以降は VS Code 拡張・Agent SDK・claude setup-token・/install-github-app を含むすべてのファーストパーティログイン経路に適用される(それ以前はターミナルログインのみ)
  • claude.ai ログインを特定の Anthropic 組織に限定するには forceLoginOrgUUID と組み合わせる
  • デフォルトは未設定で、ユーザーはログイン方法を選択できる
英語原文(公式ドキュメントより)

Use "claudeai" to restrict login to Claude.ai accounts, "console" to restrict login to Claude Console accounts, or "gateway" to restrict login to a cloud gateway. On Claude Code v2.1.212 or later, every first-party login path enforces the restriction, including the VS Code extension, the Agent SDK, claude setup-token, and /install-github-app; before v2.1.212, only terminal logins enforced it. See https://code.claude.com/docs/en/authentication#restrict-login-to-your-organization

関連する変更履歴

v2.1.299(1件)

Fixed
MDM または managed-settings ファイルの forceLoginOrgUUID と forceLoginMethod が、サーバー管理の設定によって隠されたり上書きされたりする問題を修正した
英語原文を表示
Fixed forceLoginOrgUUID and forceLoginMethod from MDM or the managed-settings file being hidden or replaced by server-managed settings

v2.1.296(1件)

Fixed
マネージド設定で forceLoginMethod が gateway に設定され、forceLoginGatewayUrl が指定されていないマシンにおいて、保存済みの Claude アプリゲートウェイのサインインが無視される問題を修正した(2.1.295 でのリグレッション)
英語原文を表示
Fixed a saved Claude apps gateway sign-in being ignored on machines whose managed settings set forceLoginMethod to gateway with no forceLoginGatewayUrl (regression in 2.1.295)

v2.1.295(1件)

Added
管理設定がないマシンのユーザー設定で forceLoginMethod: 'gateway' と forceLoginGatewayUrl をサポート:/login がその Claude apps gateway で開く
英語原文を表示
Added support for forceLoginMethod: "gateway" and forceLoginGatewayUrl in your own user settings on machines with no managed settings, so /login opens on that Claude apps gateway

変更後

管理設定が配布されていないマシンでも、各自の ~/.claude/settings.json に forceLoginMethod: 'gateway' と forceLoginGatewayUrl を設定できるようになり、/login を実行するとそのまま Claude アプリのゲートウェイ画面にURL入力済みの状態でアクセスできる。

v2.1.284(1件)

Improved
マネージド設定がサインイン(forceLoginMethod または forceLoginOrgUUID)と API キー・トークン・apiKeyHelper の設定を要求する場合の起動時の拒否を改善した。現在使用中の認証情報、その設定場所、削除方法を示すようになった
英語原文を表示
Improved the startup refusal when managed settings require a sign-in (forceLoginMethod or forceLoginOrgUUID) and an API key, token or apiKeyHelper is configured: it now names the credential in use, where it is set, and how to remove it

変更後

組織のポリシーでサインインが強制されている環境で API キーやトークンなどの資格情報が原因で起動できなかったとき、どの資格情報がどこで設定されていて、どう削除すればよいかがエラーメッセージから分かるようになり、問題を素早く解消して起動できる。

関連ドキュメント

v2.1.265(1件)

Changed
管理対象設定に forceLoginGatewayUrl があるマシンを、起動時から forceLoginMethod: 'gateway' と同様に Claude アプリのゲートウェイセッションとして扱うよう変更した。残存する claude.ai ログインや API キーは使用されない
英語原文を表示
Changed machines with forceLoginGatewayUrl in managed settings to be Claude apps gateway sessions from startup, like forceLoginMethod: "gateway"; a leftover claude.ai login or API key is not used

変更後

管理者が forceLoginGatewayUrl を設定したマシンでも、起動時から必ず Claude アプリのゲートウェイで認証されるようになり、以前の claude.ai ログインや API キーが残っていてもそれが使われなくなるため、組織のポリシーどおりのログイン状態を確実に保てる。

v2.1.261(1件)

Changed
マネージド設定で forceLoginMethod: 'gateway' が固定されているマシンでは、残存する API キーや claude.ai のログインを無視して /login を要求するようにした。Bedrock・Vertex AI・Foundry のセッションには影響しない。
英語原文を表示
Changed machines whose managed settings pin forceLoginMethod: "gateway" to ignore a leftover API key or claude.ai login and ask for /login; Bedrock, Vertex AI, and Foundry sessions are unaffected

変更後

管理者が forceLoginMethod: 'gateway' を設定したマシンで、以前のログイン情報が残っていても無視され、必ず /login によるゲートウェイ認証を求められるため、古い認証情報を使わずにゲートウェイ経由で確実にログインできる。

v2.1.212(1件)

Changed
Enterprise 版の forceLoginMethod を VS Code 拡張機能や SDK など全インターフェースで強制適用するようにしました。
英語原文を表示
Changed Enterprise forceLoginMethod to be enforced for VS Code extension, SDK, setup-token, and install-github-app logins, not just the terminal

変更後

全社的な認証ポリシーを確実に適用でき、セキュリティリスクを低減します。

関連ドキュメント

v2.1.161(1件)

Fixed
管理設定ポリシー(forceLoginOrgUUID/forceLoginMethod)が、サードパーティプロバイダー(Bedrock、Vertex、Foundry、Mantle)を使用するセッションまで誤ってブロックしていた問題を修正。
英語原文を表示
Fixed forceLoginOrgUUID/forceLoginMethod managed-settings policies blocking third-party provider sessions (Bedrock, Vertex, Foundry, Mantle) alongside the org pin (regression in 2.1.146)

変更後

エンタープライズ環境のセキュリティ設定を維持したまま、業務に必要な様々な AI インフラを柔軟に活用できるようになります。

関連ドキュメント

v2.1.147(1件)

Fixed
エンタープライズ向けのログイン制限設定(forceLoginOrgUUIDおよびforceLoginMethod)が、サードパーティプロバイダーやAPIキーを使用したセッションでも正しく適用されるよう修正されました。
英語原文を表示
Fixed enterprise login restrictions (forceLoginOrgUUID and forceLoginMethod managed-settings) not being enforced against third-party-provider and API-key sessions

変更後

組織全体のセキュリティポリシーが一貫して適用されるため、管理者はアクセス権限をより確実に制御でき、企業のコンプライアンス維持に役立ちます。

関連ドキュメント

v2.1.146(1件)

Fixed
管理設定ポリシーの forceLoginOrgUUID と forceLoginMethod が、サードパーティプロバイダーや API キーによる接続時にも強制適用されるよう修正されました。
英語原文を表示
Fixed forceLoginOrgUUID and forceLoginMethod managed-settings policies not being enforced against third-party-provider and API-key sessions

変更後

企業の管理者は、認証経路を問わず特定の組織アカウントへの利用を確実に制限でき、組織全体のセキュリティとコンプライアンスを維持しやすくなります。

関連ドキュメント

v2.1.144(1件)

Fixed
forceLoginMethod と forceLoginOrgUUID が設定されている場合に、リモートセッションへのログインが「Can't access this organization」で失敗する問題を修正しました
英語原文を表示
Fixed remote-session login failing with "Can't access this organization" for users with forceLoginMethod and forceLoginOrgUUID set

変更後

エンタープライズユーザーが会社のガバナンスを維持したまま、全ての Claude Code 機能を利用できるようになります。

関連ドキュメント

v1.0.32(1件)

Added
Added forceLoginMethod setting to bypass login selection screen