settings.json

forceRemoteSettingsRefresh

リモート管理設定が正常に取得されるまでCLIの起動をブロックし、取得失敗時は終了します(管理設定専用)。

使い方・用途

  • 常に最新の組織ポリシーや制限事項が適用された状態でツールを開始することを保証し、キャッシュされた古い設定での動作を防止したい場合に使用します。
  • ネットワーク障害時などに設定なしで起動することを防ぐ「fail-closed」のセキュリティ運用を実現できます。
英語原文(公式ドキュメントより)

(Managed settings only) Block CLI startup until remote managed settings are freshly fetched from the server. If the fetch fails, the CLI exits (fail-closed) rather than continuing with cached settings. When not set, startup continues without waiting for remote settings. See https://code.claude.com/docs/en/server-managed-settings

公式ドキュメントを参照

関連する変更履歴

v2.1.92 (1件)

Added
Settings
ポリシー設定に forceRemoteSettingsRefresh を追加。有効にするとリモート管理設定の取得が完了するまで起動をブロックし、失敗した場合は終了します。
英語原文を表示
Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed)

変更前

CLI起動時にリモートの設定同期が間に合わない可能性があり、古い設定のまま動作し始めるリスクがありました。

変更後

設定取得が完了するまで起動を待機(fail-closed)させるため、常に最新の組織ポリシーや制限が適用された状態でツールを開始できます。

ユーザーへの恩恵

セキュリティポリシーの強制適用が確実になり、企業環境などでのガバナンスと安全性が向上します。

関連ドキュメント