環境変数

CLAUDE_CODE_GOAL_CHECKIN_MINUTES

バックグラウンド処理によりアクティブなゴールが待機状態になっている際、Claude CodeがClaudeに状況確認を求めるまでの時間（分単位、デフォルトは30、無効化は0、最大10080、v2.1.234以降が必要）。

使い方・用途

  • バックグラウンドのサブエージェントやシェルコマンドが長時間実行されている際、処理状況を確認してスタックしたタスクを修復または停止させる間隔を制御したい場合に使用します
  • デフォルト値は 30 分で、0 に設定すると定期確認をオフにでき、最大 10080 分（1週間）まで整数で指定可能です
  • 本機能を利用するには、Claude Code v2.1.234 以降が必要です
英語原文(公式ドキュメントより)

How many minutes background work can keep an active goal waiting before Claude Code asks Claude to check on it. Default 30. Set 0 to turn check-ins off. Give whole minutes in plain digits, at most 10080, which is one week. Claude Code treats any other value as unset and uses the default. Requires Claude Code v2.1.234 or later

関連する変更履歴

v2.1.234(1件)

Changed
/goal: バックグラウンドタスクによってゴールが 30 分以上待たされている場合、Claude は無期限に待機するのではなくタスクの状況を確認するようになった(CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0 を設定すると無効化できる)
英語原文を表示
/goal: when background tasks keep a goal waiting for 30+ minutes, Claude now checks in on them instead of waiting indefinitely (set CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0 to opt out)

変更後

バックグラウンドタスクの完了を /goal が30分以上待ち続けて塞ぎになるのを防ぎ、Claude が30分経過時にそのタスクの状態を確認しに行くことで、ゴールへの進行が止まらずに進むようにした。

関連ドキュメント