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.139(1件)

Fixed

認証情報の期限切れとポリシー設定が重なった際に、ログイン・ログアウト等の基本操作ができなくなるデッドロックを修正。

英語原文を表示

Fixed a deadlock where expired credentials and the forceRemoteSettingsRefresh policy setting blocked claude auth login/logout/status with no way to recover

変更前

ポリシーによってリモート設定の強制リフレッシュが必要なのに、認証切れでそれができず、結果としてログインすらできなくなることがありました。

変更後

認証に関連する基本コマンドはポリシーの制約を受けずに実行できるようになり、トラブル時の復旧が可能になりました。

ユーザーへの恩恵

万が一の認証エラー時も、詰まることなくスムーズに再ログインして作業に戻ることができます。

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)させるため、常に最新の組織ポリシーや制限が適用された状態でツールを開始できます。