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
MDM で設定されたポリシーヘルパーや管理設定ファイルがすでに実行済みの場合、起動時に管理設定の forceRemoteSettingsRefresh が無視される問題を修正
英語原文を表示
Fixed managed forceRemoteSettingsRefresh being ignored at startup when a policy helper configured by MDM or the managed settings file had already run

v2.1.191(1件)

Fixed
マネージド設定の 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

変更後

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

関連ドキュメント

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
ポリシー設定に 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)

変更後

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

関連ドキュメント