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

Fixed
Settings
マネージド設定の forceRemoteSettingsRefresh がMDMやファイルポリシー経由でも適用されるようになり、キャッシュ制御で古い設定の読み込みを防止しました
英語原文を表示
Fixed managed settings: forceRemoteSettingsRefresh now takes effect when set via MDM or file policy, and the fetch sends Cache-Control: no-cache to prevent proxies from serving stale responses

変更前

強制更新設定が反映されにくく、プロキシ等による古い設定のキャッシュが問題となることがありました。

変更後

Cache-Controlヘッダーにより常に最新のポリシーが取得され、管理者設定が即座に反映されます。

ユーザーへの恩恵

組織全体でのポリシー適用がより確実になり、コンプライアンス管理や一貫した開発環境の提供が容易になります。

関連ドキュメント

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

ユーザーへの恩恵

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

関連ドキュメント