環境変数
CLAUDE_CODE_STARTUP_FAILURE_RESULTS
1 を設定すると、--output-format stream-json で開始したセッションが、stderr のみで終わる起動失敗について、Claude Code が起動を拒否した理由を示す result メッセージを書き出す。Claude Code v2.1.274 以降が必要。
使い方・用途
- 既定では、既知の一部の起動失敗以外は stderr 出力と非ゼロ終了コードだけで終わり、result メッセージが出ないため、本変数を 1 に設定するとすべての SDKStartupFailureReason について result メッセージを受け取れる
- result の error_during_execution には startup_failure_reason フィールドが付与され、アプリケーションはリトライではなく修正をユーザーに提示できる。合計値はゼロ化され、errors 配列は stderr と同じテキストを保持する
- Agent SDK v0.3.274 以降 / Claude Code v2.1.274 以降が必要
英語原文(公式ドキュメントより)
Set to 1 to have a session started with --output-format stream-json write a result message naming why Claude Code refused to start for startup failures that otherwise end with stderr alone. Requires Claude Code v2.1.274 or later