--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ツールが該当します。フラグやpermissions.denyInsteadOfPrompting設定を指定しない場合、実行は権限要求のたびにホストの応答を待ちます。
このフラグを指定すると、ホストへの問い合わせも応答待ちも行いません。確認が必要な操作は、PermissionRequestフックが許可した場合を除いて拒否されます。Claudeには、承認できる人がいないことと、その要求を再試行しないことが伝えられ、実行は続行されます。ホストのない-p実行では、このような要求はいずれにせよ拒否されますが、フラグを指定すると再試行しないこともClaudeに伝わります。各呼び出しは、引き続き権限ルール、PermissionRequestフック、設定した権限モードによって先に判定されます。Claude Codeが拒否するのは、それらのどれでも判断が確定しない要求だけです。
[!NOTE]
--permission-prompts noneフラグは1回の実行にのみ有効です。後続の実行でも権限確認待ちになる呼び出しを拒否するには、ユーザー設定または管理設定でpermissions.denyInsteadOfPromptingをtrueに設定してください。
次の例では、自動モードでタスクを無人実行します。分類器は通常どおり各操作を審査し、確認を求める処理に進むはずだった操作は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に一覧で記録されます。
[!NOTE]
--permission-promptsフラグにはClaude Code v2.1.259以降が必要です。それより前のバージョンでは、不明なオプションとしてエラーになります。
取得日 · 2026-11-20