--permission-prompts none
CHANGELOG 原文（英語）
Added --permission-prompts none for unattended headless hosts: anything that would prompt is denied automatically while the active permission mode (including auto mode) keeps deciding 公式の変更履歴を開く ↗ 日本語での補足
無人のheadlessホスト向け。プロンプトが発生する操作は自動的に拒否される（autoモードを含む有効な権限モードは判定を継続）
ドキュメント
ドキュメントの抜粋（参考訳）
無人実行時の権限確認を無効にする
スケジュールされたジョブなど、権限確認に応答する人がいない場合は --permission-prompts none を指定します。このフラグが特に重要になるのは、権限確認を処理するホストがある場合です。具体的には、canUseTool コールバックを持つ Agent SDK アプリや、--permission-prompt-tool で指定した MCP ツールが該当します。フラグを指定しない場合、実行は権限要求のたびにホストの応答を待ちます。
このフラグを指定すると、ホストへの問い合わせも応答待ちも行いません。確認が必要な操作は、PermissionRequest フックが許可した場合を除いて拒否されます。Claude には、承認できる人がいないことと、その要求を再試行しないことが伝えられ、実行は続行されます。ホストのない -p 実行では、このような要求はいずれにせよ拒否されますが、フラグを指定すると再試行しないことも Claude に伝わります。各呼び出しは、引き続き権限ルール、PermissionRequest フック、設定した権限モードによって先に判定されます。Claude Code が拒否するのは、それらのどれでも判断が確定しない要求だけです。
次の例では、自動モードでタスクを無人実行します。分類器は通常どおり各操作を審査し、確認を求める処理に進むはずだった操作は Claude Code が拒否します。
claude -p "Update the dependency pins and run the tests" --permission-mode auto --permission-prompts none
--permission-prompts none を指定すると、AskUserQuestion など、人の回答を必要とするツールが取り除かれ、Claude から呼び出せなくなります。MCP の追加情報要求は、どの Elicitation フックも応答しなければキャンセルされます。
--output-format stream-json を指定した場合、拒否は permission_denied システムメッセージとして出力され、最終結果メッセージの permission_denials に一覧で記録されます。
--permission-prompts フラグには Claude Code v2.1.259 以降が必要です。それより前のバージョンでは、不明なオプションとしてエラーになります。
取得日 · 2026-09-23