メインコンテンツへスキップ
見出し画像

Claude Codeの自動実行が確認待ちで止まらない権限設定

    結論:夜間や定期実行のClaude Codeが「確認待ち」で止まるなら、設定に permissions.denyInsteadOfPrompting を足すと、確認待ちになる呼び出しを拒否して作業を続けさせられます。

    ただしこれは「許可」ではなく「拒否」です。やらせたい作業は先に allow ルールで許可しておかないと、拒否されて何も進みません。

    この記事は2026年11月10日朝(日本時間)時点のClaude Code公式ドキュメントと更新履歴をまとめたもので、筆者は実機で試していません。

    何が起きているのか:無人実行は確認待ちで止まる

    Claude Codeは、ファイル編集やシェルコマンドの前に確認を求めることがあります。人が画面の前にいれば「はい」で進みますが、cronや定期実行、CIでは答える人がいません。

    公式のHeadless modeのページによると、v2.1.302以降の claude -p は、何も指定しなければManual(手動確認)モードで始まります。確認なしで動くのは、作業ディレクトリ内のファイル読み取りなどの確認不要な操作と、--allowedTools や allow ルールで許可済みの操作だけです。

    無人実行の止め方を3つ比べる


    画像

    確認待ちを拒否に置き換える方法は、公式ドキュメント上で3つあります。

    • --permission-mode dontAsk:確認が必要な呼び出しをすべて自動で拒否するモード。公式は「ロックダウンしたCI向け」と説明。インストールしたフックが一部の呼び出しを許可することはある

    • --permission-prompts none:その1回の -p 実行だけ、確認になる呼び出しを拒否する。v2.1.259以降。拒否したあと、Claudeには「承認できる人がいないので再試行しない」と伝わる

    • permissions.denyInsteadOfPrompting:設定ファイルに書いて常に有効にする。v2.1.319以降(2026年11月6日の更新履歴に記載)。-p だけでなく、対話セッション、VS Code拡張、Desktopアプリのローカルセッション、サブエージェント、エージェントチームにも効く

    1回限りの実験なら --permission-prompts none、毎晩動かす仕組みなら設定ファイル、と使い分けるのが分かりやすいと思います(これは筆者の整理で、公式の推奨ではありません)。

    設定の手順

    手順1:許可する作業をallowに書く

    拒否に切り替える前に、やらせたい作業を allow ルールに入れます。公式の例では、Bash(npm run *) のようにコマンドを指定します。許可は必要な範囲だけにし、広く開けすぎないのがコツです。

    手順2:触らせないものをdenyに書く

    公式のPermissionsのページによると、ルールは deny、ask、allow の順に評価され、最初に当てはまったものが結果になります。denyで止めたものは、後から狭いallowを書いても通りません。公式の例には Read(./.env) を deny に入れる書き方があります。秘密情報を含むファイルは先にdenyにしておくと安心です。

    手順3:ユーザー設定にdenyInsteadOfPromptingを書く

    公式の設定リファレンスにある例は次のとおりです。

    • ~/.claude/settings.json に permissions.defaultMode を auto、permissions.denyInsteadOfPrompting を true にする

    • 1回だけ試すなら、claude -p "…" --permission-mode auto --permission-prompts none

    この設定は、ユーザー設定、管理設定、--settings で渡したファイルでだけ有効です。リポジトリ内の設定ファイルには書けません。公式は「リポジトリはあなたに代わって設定できない」と書いています。

    手順4:何が拒否されたかを確認する

    拒否された呼び出しは、止まらずに記録だけ残ります。--output-format stream-json を付けると、permission_denied というメッセージが出て、最終結果の permission_denials に一覧が入ります。夜間実行のあとにこれを見て、「必要だったのに拒否された操作」を allow に足していくと、少しずつ安定します。

    拒否に切り替えると変わること


    画像

    公式の説明では、設定をオンにすると確認待ちを拒否するだけでなく、次のことも起きます。

    • AskUserQuestion、EnterPlanMode、ExitPlanMode のツールが使えなくなる(人への質問をClaudeができなくなる)

    • MCPの確認要求(elicitation)は、Elicitationフックが答えない限りキャンセルされる

    • 承認用のコールバックや --permission-prompt-tool には問い合わせない。コードで承認したいときは PermissionRequest フックで答える

    • autoモードでは、分類器や安全チェックに拒否された呼び出しが20回続くと、そのターンを終える。-p ではこれが error_during_execution として報告される

    つまり「止まらない」ことと「必ず終わる」ことは別です。拒否が続いて何も進まないまま終わる可能性があるので、結果の確認は必要です。

    見落としやすい注意点

    • 初回の確認ダイアログは残る:公式は、ワークスペースの信頼ダイアログと、プロジェクトのMCPサーバーの承認は待つことがあると書いています。放置する前に、一度手で開いて答えておきます

    • 信頼していないフォルダでは --bare を検討する:公式のHeadless modeのページによると、--bare なしの -p は、プロジェクトの設定ファイルのフックと .mcp.json のサーバーを、信頼していないフォルダでも読み込みます。他人のリポジトリで回すときは、--bare で読み込みを止める手があります

    • --bare は認証が変わる:bare modeはOAuthやキーチェーンを読まないため、APIキー(ANTHROPIC_API_KEY)か apiKeyHelper が必要です。サブスクのログインでは動きません

    今日やること

    • 1. claude --version で v2.1.319 以降か確認する(古ければ更新)

    • 2. 夜間に動かしている処理が、普段どの確認で止まっているか洗い出す

    • 3. 必要な操作だけを allow に、秘密情報の読み取りは deny に入れる

    • 4. ~/.claude/settings.json に denyInsteadOfPrompting を足し、stream-json で拒否の一覧を確認する

    サブエージェントを使う場合の設定はClaude Codeサブエージェント、使う場面と軽くする設定、AIにリポジトリを触らせる権限の分け方はAIエージェント専用GitHubアカウントの作り方と権限設定でも書いています。

    参考リンク

    この記事が参加している募集

     
     
    Claude Code・Codex・GeminiなどのAIエージェントを、開発の実務でどう使うかを書いています。設定手順、ツールの比較、ハマりどころを毎朝更新。エンジニアの仕事と働き方の話もときどき。

    あなたへのおすすめ