起動時にリモート設定を強制取得したい
5. 設定・カスタマイズコマンド / 機能
"forceRemoteSettingsRefresh": truemanaged設定の即時反映
概要
settings.json の forceRemoteSettingsRefresh を true にすると、Claude Code起動時に毎回リモートのmanaged設定を強制的に再取得します。組織のポリシー変更を全ユーザーに素早く反映させたい場合に有効です。
設定例
// managed-settings.json（管理者が配備）
{
"forceRemoteSettingsRefresh": true
}こんな時に使う
- enforceAvailableModelsやrequiredMinimumVersionの変更を即座に全社に反映したい時
- キャッシュされた古いmanaged設定が使われ続けるのを防ぎたい時
- セキュリティインシデント対応で緊急の設定変更を配布したい時
使い方
- 1managed-settings.json に forceRemoteSettingsRefresh: true を追加
- 2有効化すると起動のたびにリモート設定取得が行われる
- 3起動時間がわずかに増える可能性があるためポリシー変更時のみの一時利用も検討
Tips
- v2.1.191 で追加された管理者向け設定
- 通常運用では設定はキャッシュされるため、緊急時以外は常時有効にする必要はない
- 他のmanaged設定（enforceAvailableModels等）と組み合わせて使うと効果的