settings.json

forceRemoteSettingsRefresh

型boolean既定値false記述場所管理者設定のみ

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

記述例

{
  "forceRemoteSettingsRefresh": true
}

使い方・用途

  • 常に最新の組織ポリシーや制限事項が適用された状態でツールを開始することを保証し、キャッシュされた古い設定での動作を防止したい場合に使用します。
  • ネットワーク障害時などに設定なしで起動することを防ぐ「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.259(1件)

Fixed
Settings
MDM またはマネージド設定ファイルで構成された policyHelper が起動時に実行済みの場合、managed forceRemoteSettingsRefresh が無視される問題を修正しました
英語原文を表示
Fixed managed forceRemoteSettingsRefresh being ignored at startup when a policy helper configured by MDM or the managed settings file had already run

変更前

MDM またはマネージド設定ファイルで構成された policyHelper が起動時に実行された後でも、managed forceRemoteSettingsRefresh 設定が適用されず、強制的なリモート設定の更新がスキップされることがありました。

変更後

起動時に policyHelper が実行済みの場合でも、MDM またはマネージド設定ファイルで設定された managed forceRemoteSettingsRefresh が正しく認識され、強制的なリモート設定の更新が適切にトリガーされるようになりました。

ユーザーへの恩恵

管理者が MDM または設定ファイルで fail-closed モードを強制した際、意図した通りに起動時の設定更新が行われるようになります。

関連ドキュメント

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

ユーザーへの恩恵

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

関連ドキュメント