policyHelper

settings.json型object記述場所管理者設定のみ

MDM やシステムの managed-settings.json から動的に管理設定を計算する実行ファイルを指定します。

含まれる設定

3件
  • pathstring管理設定を起動時に動的に計算して出力する、ポリシーヘルパー実行ファイルの絶対パスです。
  • refreshIntervalMsintegerポリシーヘルパーをバックグラウンドで再実行する間隔をミリ秒単位で指定します(0 で無効、最小 60000)。
  • timeoutMsintegerポリシーヘルパーの応答を待機する最大時間をミリ秒単位で指定し、これを超えると実行失敗として処理されます。

記述例

{
  "policyHelper": {
    "path": "/usr/local/bin/claude-policy",
    "timeoutMs": 5000,
    "refreshIntervalMs": 300000
  }
}

使い方・用途

  • MDM ポリシーやサーバー管理設定を動的に生成し、起動時に適用する
  • policyHelper.timeoutMs でタイムアウト時間を設定する(デフォルト: 10000ms)
  • policyHelper.refreshIntervalMs でバックグラウンドでの再実行間隔を設定する(デフォルト: 未設定、起動時のみ実行)
英語原文

Admin-deployed executable that computes managed settings dynamically at startup. Honored only from MDM or the system managed-settings.json. Requires Claude Code v2.1.136 or later. See https://code.claude.com/docs/en/settings#available-settings

関連する変更履歴

v2.1.257(2件)

policyHelper の timeoutMs と refreshIntervalMs がタイマーの最大値(2147483647)を超えると、失敗や毎ミリ秒の再実行が起きる問題を修正した。これらの値はクランプされるようになった
英語原文を表示
Fixed policyHelper timeoutMs and refreshIntervalMs values above the timer maximum (2147483647) causing failures or re-runs every millisecond; they are now clamped
MDM または managed-settings.json にある policyHelper が起動時にキャッシュされたサーバー管理設定によって上書きされている場合、次回起動時ではなくフェッチでそれらが削除されたと報告された時点で実行(または終了)するようになった
英語原文を表示
Changed a policyHelper in MDM or managed-settings.json shadowed at launch by cached server-managed settings to run (or exit) as soon as the fetch reports them removed, not at the next launch

変更後

MDM や managed-settings.json で設定した policyHelper が、キャッシュされたサーバー管理設定によって起動時に上書きされていた場合でも、その設定が削除されたことをフェッチが検知した時点で直ちにヘルパーが実行(または終了)され、次回の起動を待たずに組織のポリシー設定を適用できる。