gatewayInternalNetworks

settings.json型string[]記述場所管理者設定のみ

組織が内部ネットワークに割り当てている公開 IPv4 ブロックを宣言し、/login がそこでクラウドゲートウェイを受け入れるようにする。Claude Code v2.1.268 以降が必要。

既定値未設定であるため、/login が受け入れるのはプライベートアドレス上のゲートウェイのみである。

記述例

{
  "gatewayInternalNetworks": ["203.0.113.0/24"]
}

使い方・用途

  • 組織がキャリアのアドレス空間やレガシーな /8 など自組織所有の公衆 IPv4 ブロックから内部ネットワークを採番していて、ゲートウェイにプライベートアドレスが割り当てられない場合に、そのブロックを宣言して /login での cloud gateway 接続を受け付けさせる。
  • 公衆アドレス空間を利用した内部ネットワーク上のゲートウェイを許可する際、gateway の access_control.allow_cidrs を同じブロックに設定して外部からの接続を拒否させ、ファイアウォールやロードバランサーのルールと合わせて多層的なアクセス制御を行う。
  • 管理者が managed-settings.json や macOS plist、Windows HKLM レジストリ、policy helper などのマシン上の管理ソースで設定を配布し、開発者の ~/.claude/settings.json に個別設定させずにゲートウェイ許可を統制する。
英語原文

Declare the public IPv4 blocks that your organization numbers its internal network from, so /login accepts a cloud gateway there. Requires Claude Code v2.1.268 or later.

関連ドキュメント

関連する変更履歴

v2.1.268(1件)

gatewayInternalNetworks 管理設定を追加し、管理者が自組織のパブリック IPv4 ブロック上の Claude アプリゲートウェイへの /login を許可できるようになった
英語原文を表示
Added the gatewayInternalNetworks managed setting, letting administrators allow /login to a Claude apps gateway on their organization's own public IPv4 block

変更後

組織が所有する public IPv4 ブロックを使って内部ネットワークを構築している環境でも、管理者が gatewayInternalNetworks を設定すれば開発者がそのネットワーク上の Claude apps ゲートウェイに /login でサインインできる。ゲートウェイをプライベート IP だけで運用する場合と同じように、所有するアドレス空間内のゲートウェイを安全に利用できる。

関連ドキュメント