Skip to content
← リリースに戻る · 2.1.259
新機能 / v2.1.259

--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

変更の詳細