settings.json

statusLine.refreshInterval

integer

イベント駆動の更新に加えて、ステータスラインのコマンドをN秒ごとに再実行します。

使い方・用途

  • 時計のような時間ベースのデータや、バックグラウンドのサブエージェントが変化させた Git の状態などを、AI がアイドル中であっても最新に保ちたい場合に使用します。
  • デフォルトではイベント発生時のみ更新されますが、定期実行により外部リソースの変化を常に反映させることが可能になります。
英語原文(公式ドキュメントより)

Re-run the status line command every N seconds in addition to event-driven updates. Leave unset to run only on events. Useful for time-based data like clocks, or when background subagents change git state while the main session is idle. See https://code.claude.com/docs/en/statusline

関連ドキュメント

関連する変更履歴

v2.1.257(1件)

Fixed
2147483647 を超える policyHelpertimeoutMsrefreshIntervalMs 値がタイマーの最大値を超えていたため、失敗や毎ミリ秒ごとの再実行が発生していました。これらは現在制限値にクランプされます。
英語原文を表示
Fixed policyHelper timeoutMs and refreshIntervalMs values above the timer maximum (2147483647) causing failures or re-runs every millisecond; they are now clamped

変更前

設定ファイルやレジストリで timeoutMsrefreshIntervalMs に 2147483647 以上の値を指定すると、内部の 32 ビットタイマーがオーバーフローし、ヘルパーの実行が失敗したり、毎ミリ秒ごとに異常な再実行が発生したりしていました。

変更後

これらの値がタイマーの最大値を超えた場合、ヘルパーは正常に動作するように制限値(2147483647)にクランプされます。これにより、タイマー溢れによる失敗や過度な再実行が防止されます。

ユーザーへの恩恵

ヘルパーの設定値がタイマーの上限を超えても、意図せぬ失敗や過度な再実行が発生しなくなり、安定した動作が保証されます。

v2.1.97(1件)

Added
ステータスラインの設定に、コマンドをN秒ごとに再実行するrefreshIntervalを追加しました。
英語原文を表示
Added refreshInterval status line setting to re-run the status line command every N seconds